Package: pcb-tools-extension
pcb-tools-extensionpcb-tools-extension is a Python library to panelize gerber files.
This library is designed based onpcb-toolswhich provides cool functionality to handle PCB such as generationg PCB image from gerber files.pcb-tools-extension adds following function  to pcb-tools.Rotate PCB dataWrite back loaded PCB data (original pcb-tools does not work in some condition)Merge multiple PCB dataTranslate DXF file to PCB dataOnly RS-274x format and Excellon drill format data can be handled by current version of this library.InstallationYou can install a stable version by following step.$pipinstallpcb-tools-extensionIf you have a intention to try latest developing version, please install as follows.$pipinstallgit+https://github.com/opiopan/pcb-tools-extension.gitHow to panelizeFollowing code is a example to panelize two top metal layer files.importgerberexctx=gerberex.GerberComposition()metal1=gerberex.read('board1.gtl')ctx.merge(metal1)metal2=gerberex.read('board2.gtl')metal2.to_metric()metal2.rotate(-20)metal2.offset(30,0)ctx.merge(metal2)ctx.dump('panelized-board.gtl')rotate()method can be used to rotate PCB data counterclockwise. you have to specify angle in degree.offset()method can be used to move PCB data. Specified offset values are interpreted according to unit setting of PCB data. In case of the above code,board2.gtlmove to 30mm left sinceto_metric()is called.In case of Excellon drill data, you have to useDrillCompositoninstead ofGerberComposition.importgerberexctx=gerberex.DrillComposition()drill1=gerberex.read('board1.txt')ctx.merge(drill1)drill2=gerberex.read('board2.txt')drill2.to_metric()drill2.rotate(-20)drill2.offset(30,0)ctx.merge(drill2)ctx.dump('panelized-board.txt')DXF file translationpcb-tools-extension hsa a function to load a DXF file and handle that as same as RX-274x gerber file or Excellon NC file.In this version, Only line, circle, arc, and polyline objects are recognized and are translated to gerber file or NC file.Two way to tranlate DXF fileBoth composition objects,GerberCompositionfor RX-274x andDrillionCompositionfor Excellon, can accept an object created as result of DXF file loaded. When composition object dump text stream, DXF data tranclate to appropriate format data.The object which represent DXF file, can also output translated data directly bysavemethod. In this case output format is specified byfiletypeargument. Iffiletypeargument is ommited, DXF data is translated to RX-274x gerber data.importgerberexdxf=gerberex.read('sample.dxf')# translate to RX-274x using composition objectctx=gerberex.GerberComposition()ctx.merge(dxf)ctx.dump('sample.gml')# translate to Excellon using composition objectctx=gerberex.DrillComposition()ctx.merge(dxf)ctx.dump('sample.txt')# translate to RX-274x directlydxf.save('sample2.gml')# translate to Excellon directlydxf.save('sample2.txt',filetype=dxf.FT_EXCELLON)Generating RectangleIf you want to arrange simple rectangle for PCB outline,gerberex.rectangle()is better solution. This generate a object representing a rectangle compatible with DXF file object.importgerberexoutline=gerberex.rectangle(width=100,height=100,units='metric')outline.write('outline.gml')Drawing ModePCB tools extension provide three type of translation method that affects geometric finish. These method are specified a value fordraw_modeattribute, asDM_LINE,DM_MOUSE_BITES, orDM_FILL.DM_LINEandDM_MOUSE_BITESare used to translate to both of RX-274x and Excellon, howeverDM_FILLis used to translate to only RX-274x.draw_mode = DM_LINEAll edge expressed as DXF line object, circle object, arc object and plyline objects are translated to line and arc applied a circular aperture in case of RX-274x. That circular aperture radius is specified bywidthattribute. Default value of width is 0.In case of Excellon, DXF objects are translated to routing path command sequence.This function is useful to generate outline data of pnanelized PCB boad.importgerberexdxf=gerberex.read('outline.dxf')dxf.to_inch()dxf.width=0.004dxf.write('outline.gml')draw_mode = DM_MOUSE_BITESIf DM_MOUSE_BITES is specified for draw_mode, filled circles are arranged at equal intervals along a paths consisted of DXF line, arc, circle, and plyline objects.
DXF file object in this state can be merged to excellon file also. That means you can arrange mouse bites easily.importgerberexctx=gerberex.DrillComposition()drill=gerberex.read('drill.txt')ctx.merge(drill)dxf=gerberex.read('mousebites.dxf')dxf.draw_mode=dxf.DM_MOUSE_BITESdxf.to_metric()dxf.width=0.5dxf.pitch=1ctx.merge(dxf)ctx.dump('merged_drill.txt')draw_mode = DM_FILLYou can translate DXF closed shapes such as circle to RX-274x polygon fill sequence.In order to fill closed shapes,DM_FILLhas to be set todraw_modeproperty. In this mode, All object except closed shapes listed below are ignored.circleclosed polylineclosed path which consists of lines and arcsIf a closed shape is completly included in other closed shape, The inner shape will be draw with reversed polality of container shape as above example image.I assume there are two typical use cases for this mode.One is to arrange logo design on silk layer. This is superior to other method generating raster image data since image data express as vector data.The other one is generating gerber data represented cropped area of panelized PCB.
By merging rectangle and PCB outline data, generate a file represented cropped area as below, and this kind of data is useful to make PCB image look good a little bit.This scriptwhich generate example image shown below, also uses this technic.importgerberexctx=gerberex.GerberComposition()rectangle=gerberex.rectangle(width=100,height=100,left=0,bottom=0,units='metric')rectangle.draw_mode=rectangle.DM_FILLctx.merge(rectangle)outline=gerberex.read('outline.dxf')outline.draw_mode=outline.DM_FILLoutline.negate_polarity()ctx.merge(outline)ctx.dump('cropped_area.gml')NOTE:DM_FILLcan be used only to generate RX-274x data, it cannot be used to generate Excellon data.Panelizing ExampleThis example board image is generated by following scripts fromthese source data.panelizing scriptimaging scriptNotesEquivalence of outputpcb-tools-extension generate data block stream to focus equivalence of final image, but not focus equivalence of data block sequence.
There are some difference between input data and output data as below.Aperture definition [RS-274x]When gerber data is rotated, it's necessory to rotate not only coordinates whilch indicate locations of drawing aperture, but also aperture geometory itself.
However, standard aperture templates, such as rectangle, cannot rotate. These standard aperture templates can be placed only horizontally or vertically.Threfore, pcb-tools-extension replace aperture definitions using standard aperture template to aperture macro that represent equivalent shape.For example, In case of rotating folowing aperture definition 20 degrees counter clockwise,%ADD10R,1X0.5X0.2*%pcb-toolse-extension generate a aperture macro definition and a aperture definition referencing that macro as below.%AMMACR*
21,1,$1,$2,0,0,20*
1,0,$3,0,0,20*%
%ADD10MACR,1X0.5X0.2*%File Scope Modifier [RS-274x]Commands that affect entire image and should be specified only once in a file, such asMI(Mirror Image) command, sometimes cause contradiction when multiple gerber file are merged.For example, when mergeing a file containing%MIA1B0*%command and a file containing%MIA0B1*command, which command should remain as output?
Of cause, it is impossible that generate correct merged image by specifiing anyMIcommand.pcb-tools-extension translate coordinate data reflecting these file socpe modifier  to address this probrem, then ommit these modifier command.MI,OF,SF,AS,IP, andIRare in a this category.Coodinate Normalizing [RS-274x, Excellon]RS-274x specification and Excellon specification allow various notation to express a coordinate. However pcb-tools-extension normalize coordinate notation in order to correct deprecated notation and ease internal process as below.Relative coordinates are translated to absolute coordinates.Ommited coordinate values are compensated.Leading zeros are ommited.Single Quadlant mode [RS-274x]Cercular interpolation coordinate data in single quadlant is difficult to rotate, because circular arc may pass across two quadlants after rotation.In order to avoid this problem, pcb-tools-extension change single quadlant mode coordinates specification to multi quadlangt mode.NC controll command [Excellon]Form histrical reason, Excellon NC controll format is used to specify drill information to PCB fabricator.On the other hand, from PCB fabricator point of view, they don't need information other than geometric information, such as drill speed. Because these NC controll sequence doesn't send to NC machine directly, PCB fabricator import customers excellon NC file to their CAD / CAM to pnaelize and check, then they export NC controll data for their NC machine.pcb-tools-extension ommit all NC command which do not contribute to geometry expression. Specifically, only tool definitions (diametor of drill), tool selections, drilling coordinates, and routing paths are output.Unimportant Command [RS-274x, Excellon]Commands not affecting final image such as comment are ommited.Negative image polaritySometimes,%IPNEG*%is specified at header of RS-274x file to create negative image.As mentionedabove,IPcommand is ommited when pcb-tools-extension generate output file. In this case, image polarity is nagated by usingLPcommand. However this generated file doesn't equal to original image since it does'nt contain base dark image.Please merge base dark rectangle explicitly when you handle negative image file as below.importgerberexctx=gerberex.GerberComposition()base=gerberex.rectangle(width=30,height=30,left=-5,bottom=-5,units='metric')base.draw_mode=base.DM_FILLctx.merge(base)metal=gerberex.read('negative_image.gtl')ctx.merge(metal)LimitationsRS-274xpcb-tools-extension cannot handle all commands that the RS-274x parser implemented inpcb-toolsdoesn't handle so far.From the imaging point of view, pcb-tools-extension has following limitations.Files containsIJandIOcommands, that affect entire image, cannot be handled correctly.Files containsSRcommand to specify repeated pattern cannot be handled correctly.Aperture block defined byABcommand cannot be handled correctly.Excellonpcb-tools-extension extends excellon parser inpcb-toolsto support routing operation. However following limitations still remain.User defined stored pattern defined byM99command cannot be handled.Canned text specified byM97command cannot be handled.Pattern defined byM25command cannot be handled.