Stream to OpenAccess Translator (strm2oa)

Specifies the destination library for the Stream file contents. If the library does not exist, strm2oa creates it. For information about how the translator finds a library using the library definitions file, see How Translators Use Libraries.

Specifies the cell mapping file to use during translation. You must specify the complete path to the file. If you use the asterisk (*) character in the cellmap file in place of the library name, the translator searches all the reference libraries for the mapped cellname.

The format for the mapping file is:

<destination library name> <destination cell name> <destination view name> <stream structure name>

If you specify a cell mapping file, strm2oa creates stream structures and instances of that structure found in the map file as the destination library, cell, and view name specified. No case conversion is processed on these names. strm2oa translates stream structures and instances not found in the mapping file using the structure names in the Stream file.

Lines in the cellMap file that are blank and lines beginning with the comment character # are ignored.

Sample Cell Mapping File

Each stream name in the cell mapping file must be unique.

    strm2oa ... -DMAttributes "name1=value name2=value name3=value"

Specifies the via exclusion file to be used for via recognition during translation. If the –detectVia option is used, the GDS structures listed in the via exclusion file are not mapped to an oaStdVia even if they can be represented as an oaStdVia.

The via exclusion file contains one GDS structure per line. The wildcards ‘*’ and ‘?’ can also be used.

Blank lines and lines beginning with character # are ignored from the via exclusion file.

Sample Via Exclusion File

# List of structures to be excluded from via mapping

M1M2Wire                 # Do not map M1M2Wire to a via

M2M3Wire*              # Do not map cells starting with M2M3Wire to a via

Specifies the font mapping file to use during translation. You must specify the complete path to the file.

The format for the mapping file is:

   <stream id> <OpenAccess font name> 

If you specify a font mapping file, stream font values found in the map file translate as the OpenAccess font name specified. Stream font values not found in the mapping file translate as defined by the following defaults:

• Id 0 translates to a Fixed font
• Id 1 translates to a EuroStyle font
• Id 2 translates to a Gothic font
• Id 3 translates to a Math font

Valid values for Stream Font Ids are 0, 1, 2, and 3.

Valid values for OpenAccess Font Names are EuroStyle, Gothic, Math, Roman, Script, Stick, Fixed, Swedish, and MilSpec.

Lines in the fontMap file that are blank and lines beginning with the comment character # are ignored.

Sample Font Mapping File

Prints command-line help.

Specifies the hierarchical depth to translate to.
The default depth is 20.

Specifies a quoted, space-separated list of one or more layer mapping files to be used during translation. You must specify the complete path for each layer map file.

The format for the map file is:

   <oaLayerName> <oaLayerPurpose> <gdsLayer> <gdsPurpose> [<oaMaterial> [<oaMaskNumber>]] [<Qualifier>]

If you specify a layer mapping file, strm2oa creates Stream objects on the layer and purpose numbers found in the technology library using the gdsLayer and gdsPurpose names specified in the map file. Stream objects on layer and type combinations not found in the map file are not translated.

If strm2oa cannot find the layer or purpose in the technology library, a warning message is issued, but strm2oa attempts to create it.

By default, if you do not specify a mapping file, stream layers and types translate to the names L<gdsLayer>, and P<gdsPurpose> respectively. If the layer name or purpose name is not in the technology library, strm2oa attempts to add it.

Lines in the layerMap file that are blank and lines beginning with the comment character # are ignored.

The oaMaterial, oaMaskNumber, and Qualifier fields are optional. However, an oaMaskNumber may only be specified if the oaMaterial is also specified.

Currently, no qualifiers are supported by strm2oa. The Qualifier field is used by oa2strm and future enhancements. Any qualifiers specified are ignored.

Note: You cannot specify the same gdsLayer/gdsPurpose type combination for multiple entries. If you do, an error is issued and the entry is ignored. When you are merging layers, if gdsLayer and gdsPurpose combinations match the same layer and purpose combinations in the database, a warning is issued.

If you use -detectVias, the oaMaterial and oaMaskNumber columns are used for automatically detecting via structures. However, if -techLib is used, and the technology library includes the material and mask numbers for the physical layers, the information in the technology library is used to detect via structures unless the material and mask numbers differ with the layer map file. If material and mask numbers differ, the technology library is updated with the layermap material and mask number information, and a warning is issued.

If you do not use this option to specify oaMaterial and the -detectVias option, and the design has many different vias defined as cellViews, the translator will produce many new cellViews, which can adversely affect performance of both strm2oa and other applications running on the oaDesigns that are produced.

Sample Layer Mapping File

Specifies the log filename. If this option is omitted, the log filename defaults to strm2oa.log

Specifies the maximum number of cells that can be created in a library. If a limit value corresponding to this option is not specified, the maximum number of cells per library as supported by the DM system will be used. Specifying a limit that exceeds the maximum limit supported by the DM system will result in an error.

For example, the output library of FileSys data management system is limited to 20,000 cells to prevent exceeding UNIX limits on the number of files per directory.

When the number of cells for a library is exceeded, the translator creates additional libraries by appending an underscore and a number to the library name specified with the -lib option.

For example, if you specify:

strm2oa -lib GLib...

If the number of cells created in GLib exceeds the limit, strm2oa creates an additional library named GLib_n, where n starts at 1 and is incremented to create additional libraries as needed.

The name of the library directory is also modified in the same manner. For example, if the command includes:

strm2oa -lib GLib –libPath /data/lib/libGDS ...

When the number of cells in the first library exceed the limit, the second library is named GLib_1 and is created at /data/lib/libGDS_1. A new library and library directory is created each time the cell limit is exceeded.

The limit of cells in a library can be exceeded in certain cases. When translating an SREF or an AREF that cannot be characterized as an oaTransform class object applied to a cell (for example, if magnification is involved), strm2oa creates variants of the cell and all masters referenced from the cell. All the variants are placed into the same library, to ensure that the total number of cells in the library may exceed the specified limit.

When the translator creates multiple libraries, the cell named using the -cell option is always included in the first output library.

Specifies the property mapping file to use during translation. You must specify the complete path to the file.

The format for the map file is:

   <stream id> <object type> <destination property name>

If you specify a property mapping file, strm2oa creates Stream properties with id and object type combinations found in the map file using the property name specified. strm2oa creates stream properties on id and object type combinations not found in the mapping file with the name STREAM PROPERTY #<strmid>.

Valid objects types are: Dot, Line, Path, Polygon, Rect, Text, ArrayInst, and ScalarInst.

If you do not specify a mapping file, strm2oa interprets stream properties values as a list of properties separated by the property separator character with the form:

   <property name> = <property value>

For example, height=10,width=20 yields two properties, the first named height with a value of 10, and the second named width with a value of 20.

strm2oa creates all properties as oaStringProps.

Lines in the propMap file that are blank and lines beginning with the comment character # are ignored.

Sample Property Mapping File

Specifies the property separator character used to interpret property records.

If you specify a property map file, strm2oa ignores the propSeparator argument. The default value for this argument is a comma.

Specifies a file containing the list of libraries with cells referenced in the design. A library name in the file must match the library name in the cds.lib file.

If you do not use the refLibList argument, cells that are referenced in the Stream file but not defined are instantiated by name and remain unbound. If you specify a filename that does not exist, strm2oa issues an error.

• If the library being translated does not have a technology database, this option creates an incremental technology database that has references to the specified parentTechs.
• If the library being translated already has a standalone technology database, this option converts that technology database to an incremental type that has references to the specified parentTechs.
• If the library being translated has an attached technology database, that attached technology database must be included in the list of parentTechs, or the translator issues an error.
• If the library being translated already uses an incremental technology database, the current references from the incremental technology database must be included in the specified parentTechs, or the translator issues an error. Additional references can be provided.
• This option requires data model 3. If you use this option without setting the data model to 3 (by using the -dataModel option, the OA_DATAMODEL environment variable, or using the OA.DATAMODEL file), an error is issued and the translation stops.

Specifies a template file containing arguments to strm2oa. You can specify a template file instead of entering a string of arguments on the command line.

If you specify a template file, arguments on the command line have precedence over arguments specified in the file. So, if the same argument exists in the template file and in the command line, the translator uses the argument on the command line.

Specify arguments in a template file as follows:

• Enter arguments in the template file without a dash (-) before the argument.
• Enter each argument and value pair on a single line.
• Separate the argument from its value using a space or a tab.
• Designate comment lines with a # sign as the first character in the line.

Sample Template File

#strm2oa arguments for AC33

Specifies that strm2oa convert all cell and instance names to lower case. The toLower argument does not affect Stream structures found in the cell mapping file, if specified.
By default, strm2oa preserves the case.

The arguments toUpper and toLower are mutually exclusive. Specifying both arguments is an error.

Specifies that strm2oa convert all cell and instance names to upper case. This argument does not affect Stream structures found in the cell mapping file if specified.
By default, strm2oa preserves the case.

The arguments toUpper and toLower are mutually exclusive. Specifying both arguments is an error.

# Comment
# Blank lines are ignored
<Structure Name> <oaCustomViaDef Name> <Layer1 Name/Number> <Layer2 Name/Number>

# Custom Via Master List for aDesign
via1 m1m2via m1 10 m2 20
via2 m2m3via m2 20 m3 30

Specifies the destination view name for the cells.
If you omit this option, the default destination view name is layout.