[Artwork] / [QisMLib] / [Programmer's Corner]

Gds2Dbload

A command-line utility to create DBLOAD cache (disk image) of a database created in QisMLib from GDSII files

Command-line reference

gds2dbload +gds:{gdsii_file_path} +outdir:{output_directory} [OPTIONS]

• DBLOAD files represent a disk image of a QisMFile database created from a GDSII source
• DBLOAD files can be loaded very quickly compared to the original GDSII source. They are best used in situations where large GDSII files need to be used multiple times
• DBLOAD files come in pairs (a .scan.l64 and a .dbload.l64 file)
• Both DBLOAD files MUST be present in the same directory
• The names of the DBLOAD files should not be changed once created

Required

+gds:{gdsii_file_path}

• Specify the path of a valid GDSII file to be used as a source for the .dbload

+outdir:{output_directory}

• Specify the path of an existing directory with write permissions where the .scan.l64 and .dbload.l64 files will be created
• The output file name format is {gdsii_file_name}.scan.l64 and {gdsii_file_name}.dbload.l64. E.g a GDSII file demo.gds will be converted as demo.gds.scan.l64 and demo.gds.dbload.l64
• These file names should not be modified and should be present in the same directory at all times. Their location can be changed as long as they reside in the same directory
• The version of the .dbload file is same as the major.minor version of gds2dbload. E.g gds2dbload v1.6.xx will create .dbload.l64 v1.06

Optional

[-layers:{list_of_layers}]

• Specify a comma-separated list of layer(s) or layer:datatype(s) to extract
• If not used (by default), all the layers present in the GDSII file will be extracted as-is
• If the :datatype is omitted for a layer, all datatypes for that layer are extracted
• E.g : -layers:1,2:10,3,4:20 will extract all datatypes for 1 and 3 and only datatypes 10 and 20 for layers 2 and 4 respectively. Data on all other layers and datatypes will be dropped

[-notext]

• If specified, no text elements are extracted. By default, any text if present is extracted as-is

[-igntxtscale]

• If specified, text scale information will not be used to compute cell extents. Any cell containing only TEXT will have zero extents and therefore it will be considered empty

[-loademptyrefs]

• If specified, empty cells (cells with zero extents) are loaded

[-log:{log_file_path} -OR- -log+:{log_file_path}]

• Create an execution log at the specified path (including file name). The directory component of the path must exist with suitable write permissions
• By default, no log is created
• If -log+ is used, an existing file at that path will be appended. With -log, an existing file will be overwritten

[-silent]

• If used, no messages are written to stdout/stderr
• If not used (by default), the execution log is written to stdout and error/ warning messages are written to stderr