The GDS2HDP program converts a GDSII file to HDP format. Input GDSII layers may be merged or keep separate in the output file. If layers are kept separate the separate layers may reside in a single HDP file or separate HDP output files (one per output layer). It is thus possible to convert all device layers in a single program run and have them all ready to write or inspect.
The user must specify a root structure to start processing. The root structure must reside in the main GDSII file. Additional GDSII library files may be specified to search for structure definitions.
The user can specify the dimensions of the output layer window or have the system calculate the minimum window which will enclose the entire pattern. Windows can be calculated on a per layer basis or a single inclusive window for all layers can be calculated. The window is the "chip size" for the layer.
The user can associate a logical name (like Metal-1) with each output layer that can be referenced later when the HDP file is converted to Frame Format..
The user can choose to slice polygons into trapezoids during the conversion or defer this operation until HDP to Frame Format conversion time.
The user can rotate, scale, and reflect the root input structure.
Additional options are described below.

Basic Options:
| GDSII File: | The GDSII file to convert. |
| Root Structure | The name of the root structure (root of the structure tree). This is case sensitive. |
| Output File | The name of the output file (this will default to the input file name with an hdp extension). By conventions hdp files have an extension of ".hdp". If the "Output One File Per Layer" option is specified on the Layers panel then the output file is the name of the output directory in which multiple output layer files will reside. |
| Ignore unresolved references | Set to ignore unresolved structure references, otherwise an unresolved reference will be considered a fatal error. |
| Slice polygons into trapezoids | Polygons (boundaries) and pathes will be converted into trapezoids during the conversion. If the option is not set then the HDP file will contain polygons. |
LAYERS TAB - MERGE LAYERS MODE

Layer Options - Merge Layers Mode:
| Merge input layers | Set to merge input layers into single output layer. |
| Calculate minimum window | Set to automatically calculate device window. |
| Layers | List of input layers to merge into single output layer. Default is all layers. |
| Name | Name of output layer |
| X Min | If not doing automatic window - minimum X coordinate for window (microns) |
| Y Min | If not doing automatic window - minimum Ycoordinate for window (microns) |
| X Max | If not doing automatic window - maximum X coordinate for window (microns) |
| Y Max | If not doing automatic window - maximum Y coordinate for window (microns) |
LAYERS TAB - SEPARATE LAYERS MODE

Layer Options - Separate Layers Mode:
| Merge input layers | Unset to keep layers separate. |
| Calculate minimum window | Set to automatically calculate window |
| Calculate minimum window separately for each layer | Set to automatically calculate separate windows for each layer. |
| One output file per layer | Set to have multiple output files, with one file per layer. Output files are placed in a directory. Files are named: layer0,hdp, layer1.hdp, etc.. |
| Layer | Single GDSII Layer number |
| Name | Optional output layer name. |
| X Min | If not doing automatic window - minimum X coordinate for layer window (microns) |
| Y Min | If not doing automatic window - minimum Ycoordinate for layer window (microns) |
| X Max | If not doing automatic window - maximum X coordinate for layer window (microns) |
| Y Max | If not doing automatic window - maximum Y coordinate for layer window (microns) |
NOTE: Use the Add Row and Delete Row buttons to add and delete FF entries.

Advanced Options:
| Slice polygons with even/odd rule | Alternate rule for slicing polygons into trapezoids. With the even odd rule, a point is considered in the interior of a self intersecting polygon if and only if an odd number of polygon edges are traversed on a line through the point and extending in one direction to infinity. |
| Slice pathes using windpath rule | Alternate rule for converting pathes to polygons. Description TBD. |
| ARef rotate array lattice points | Consider the angle parameter in an AREF to rotate both the structures AND the array lattice points. If unset, only the structures are rotated. |
| Data types | List of GDSII datatypes to include. Default is all. |
| Reflect | Reflect the root structure (same as STRANS reflect n GDSII). |
| Rotation Angle | Rotate the root structure by the specified number of degrees (Same as STRANS angle in GDSII) |
| Magnification | Magnify the root structure by the specified amount(Same as STRANS mag in GDSII) |
| SRef to ARef Compress |
Controls if any attempt is made to convert GDSII structure references to array references. Choices:
|
| Bounding Box All Polygons | If HDP output file has polygons, include a bounding box information with each polygon. |
| Generate struct name table | Generate structure name table in HDP file. |
| List of GDSII libraries | List of GDSII library files to search for references. |

| Do NOT check GDSII Revision | Do not verify the GDSII file format is revision 6.0 or less. |
| Generate regression test file | Do not include any date information in the output file, so that the file can be diffed in regression tests. |
| Keep intermediate result in memory | Keep all intermediate processing results in memory. Do not use temporary disk files. |
| Do not delete temporary files | Do not delete temporary work files (useful for debugging). |
| Max output struct size | Do not output any structures whose size in bytes is greater than the specified number. These structures will be split into multiple substructures. |
| Properties to keep | Retain the listed GDSII properties in the HDP file. |
| -angle | Rotate the root structure by the specified number of degrees (Same as STRANS angle in GDSII) |
| -boxpolys | If HDP output file has polygons, include a bounding box information with each polygon. |
| -datatype | GDSII datatype to include.This options may be repeated. Default is all. |
| -dumpdictionary | Diagnostic option to dump structure dictionary. |
| -dumpinputs | Diagnostic option to dump command line inputs. |
| -extentlayers | In separate file mode, automatically calculate layer windows separately. |
| -evenoddrule | Alternate rule for slicing polygons into trapezoids. With the even odd rule, a point is considered in the interior of a self intersecting polygon if and only if an odd number of polygon edges are traversed on a line through the point and extending in one direction to infinity. |
| -fileperlayer | In separate layer mode, output a separate file for each layer. |
| -ignoreunresolved | Set to ignore unresolved structure references, otherwise an unresolved reference will be considered a fatal error. |
| -keeptempfiles | Do not delete temporary work files (useful for debugging). |
| -keepprop | Retain this GDSII property in the HDP file. This option may be repeated. |
| -layer | In merge mode, a layer to include in the input. This option may be repeated. Default is all. |
| -layername | In merge mode, the name assigned to the output layer in the HDP file. |
| -layerfile | In separate layer mode, a file containing the input layers along with optional naming and coordinate window information. The format of this file is beyond the scope of this document. |
| -mag | Magnify the root structure by the specified amount(Same as STRANS mag in GDSII) |
| -maxdepth | Diagnostic option. Only process structures above this level in the structure tree. |
| -nogds2revcheck | Do not verify the GDSII file format is revision 6.0 or less. |
| -noslice | Do not converet polygons (boundaries) and pathes will be into trapezoids during the conversion. |
| -nosreftoaref | Do not attempt to compress SREFS into AREFS. Default is to compress in X. |
| -out | Output file or directory |
| -reflect | Reflect the root structure (same as STRANS reflect n GDSII). |
| -reflib | GDSII library file to search for references.This option may be repeated. |
| -regression | Do not include any date information in the output file, so that the file can be diffed in regression tests. |
| -rootfile | The GDSII file to convert. |
| -rootstruct | The name of the root structure (root of the structure tree). This is case sensitive. |
| -snamemap | Generate structure name table in HDP file. |
| -structsplitsize | Do not output any structures whose size in bytes is greater than the specified number. These structures will be split into multiple substructures. |
| -tempmem | Do not delete temporary work files (useful for debugging). |
| -xysreftoaref | Compress structure references in both X and Y directions into AREFS when possible. |
| -x1 | In merge mode (one output layer), the lower left hand X coordinate of output window. |
| -x2 | In merge mode (one output layer), the upper right hand Xcoordinate of output window. |
| -y1 | In merge mode (one output layer), the lower left hand Y coordinate of output window. |
| -y2 | In merge mode (one output layer), the upper right hand Ycoordinate of output window. |
| -windpath | Use alternate rule for converting pathes to polygons. Description TBD. |