Running the GDSII to DXF Engine on Linux

Steve DiBartolomeo
created: September 14, 2005
revised: October 3, 2014


The ASM 3500 translator converts from GDSII to DXF and from DXF to GDSII. The programs consist of two parts: the user GUI which gathers the relevant information and the translation engine which actually does the work. The GUI collects information such as the file name, output file, and conversion parameters and launches the engine with a command line; it also must build an ascii configuration file for the engine to read. This app note describes how one would bypass the GUI and launch the engine directly; either from a script, framework or another program.

gds2dxf flow chart

To convert GDSII to DXF execute the gds2dxf engine with the correct command line options and the required configuration files. A step by step instruction follows:

Build Up The Configuration File

The gds2dxf engine reads an ASCII configuration file that contains layer mapping information and also translation controls. There are quite a few options; details are available on the configuration page. A typical configuration file is shown below:




TOP     30:1  1
BOTTOM  31:1  2
VIA     50:1  3

The gds2dxf command line

The translator is run from a command line. A quick summary of the command line syntax can be obtained by typing:

$ gds2dxf -h

The complete command line and arguments are shown below:

gds2dxf infile outfile topstr [[-q] [-iM,N,..] [-xM,N,..] [-cfg:file]]


gds2dxf      name of the translation engine

infile       name of the GDSII stream file to process.

outfile      name of the DXF file to produce.

topstr       name of the structure to start processing from. Generally
             this would be the top level structure in the GDSII file
             but not necessaryily so if you do not want to start at the

             If you do not know the name of the top level structure you
             can use the equal sign (=) and the engine will attempt to
             determine the top level automatically by choosing the 
             structure with the most dependents.

-q           this option tells the engine to run in quiet mode and not to
             output status to the stdout. If you are calling gdsdxf from 
             another program you generally will use this option.

-iM,N        layers to include. If -i is not listed then all layers will be
             converted. If -i is used, you must then list (comma delimited) 
             all layers to convert.

-xM,N        layers to exclude. this argument is more helpful if you wish to
             convert all but a few layers i.e. -X8,9 will convert all layers 
             in the GDSII file to DXF except for 8 and 9.

             you cannot use -i and -x at the same time.
-namlen:N    limits structure name lengths to N. Some versions of AutoCAD cannot
             support block names with more than 31 characters.

-cfg:file    instructs gds2dxf to read the specified file and to use the 
             directives found in that file for conversion. If you do not 
             specify  a .cfg file on the command line, gds2dxf will first  
             look in the  current working directory for a file called GDS.CFG  
             and then will look in its own bin directory for such a file. If  
             no file at all is found then program hardwired defaults are used.

Command Line Example







In this example we launched gds2dxf from its installed directory, selected the gdsii file called demo1.gds and had it translated to demo1.dxf. We requested the program to automatically use the top level structure (=) and to only convert layers 1,2,3 and to use a configuration file called demo1.cfg.

ARTWORK CONVERSION SOFTWARE, INC.                  Company Profile
417 Ingalls St.,     Santa Cruz, CA 95060         Tel (831) 426-6163     Fax 426-2824               email: