Product Documentation
Virtuoso Space-based Router Command Reference
Product Version IC23.1, September 2023

read_stream

read_stream
-lib s_libName 
-cell s_topCellName 
[ -view s_viewName ] 
-layer_map s_fileName 
{ -gds s_fileName | -oasis s_fileName } 
[ -refgds {s_fileName…} | -refoasis {s_fileName…} ] 
[ -area {f_xlo f_ylo f_xhi f_yhi} ] 
[ -calibre_run_dir s_dir ] 
[ -calibre_run_prefix s_prefix ] 
[ -detect_vias [ true | false ] ]
[ -device_prop_number s_annotated_stream_device_prop_number ] 
[ -instance_prop_number s_annotated_stream_instanc_prop_number ] 
[ -load_layers {{i_layerNumber:i_dataTypeNumber}…} 
| -ignore_layers {{i_layerNumber:i_dataTypeNumber}…} 
| -load_layers_file s_fileName 
| -ignore_layers_file s_fileName ] 
[ -net_prop_number s_annotated_stream_net_prop_number ] 
[ -threads i_count] 
[ -gds2 s_fileName | -oasis2 s_fileName ] 
[ -cell2 s_topCellName ] 
[ -refgds2 {s_fileName…} | -refoasis2 {s_fileName…} ] 
[ -bump i_layerBump ] 

Description

Opens a GDSII or OASIS stream file and creates an OpenAccess technology library for the data.

Required Arguments

-cell s_topCellName

Specifies the top-level cell to load. If you want to stream in only part of a design, specifying a top cell is one way to accomplish this.

-gds s_fileName  

Specifies the name of the GDSII stream file to open. Cannot be used with the -oasis argument.

-layer_map s_fileName

Specifies the Stream/OASIS-to-OpenAccess Layer Map File to use to translate the stream layers and data types in the stream file to their respective OpenAccess layer names and purposes.

-lib s_libName  

Specifies the name of the OpenAccess technology library to create when processing the stream file.

If the library already exists, the technology information in the library will be overwritten by this command.

-oasis s_fileName

Specifies the name of the OASIS stream file to open. Cannot be used with the -gds argument.

Optional Arguments

-area {f_xlo f_ylo f_xhi f_yhi}

  

Loads only data in the rectangular area given by the lower left and upper right x and y coordinates.

Default: Loads entire area

-bump i_layerBump

Specifies the number by which the layer numbers in the secondary stream input files are incremented to find the corresponding layer purpose pair for Space-based Router.

-calibre_run_dir s_dir

  

If either -calibre_run_dir or -calibre_run_prefix is given, annotation files generated by Mentor Graphics® Calibre® LVS will be loaded, if they exist, including:

  • Calibre Layout Netlist Names (LNN) files that are used to change the names of nets from their stream property number annotation to their net list names.
  • Port cell files and Spice network files that are used to create instance terminals and device names for instances.

This argument specifies the directory to search for these files.

Default: current working directory

-calibre_run_prefix s_prefix

  

If either -calibre_run_dir or -calibre_run_prefix is given, annotation files generated by Calibre LVS will be loaded, if they exist. This argument limits the files to those that include the given prefix in their name (.s_prefix.lnn, s_prefix.devmap, s_prefix.port_cells, and s_prefix_pin-xy.spi).

Default: s_prefix is the top cell name given by the -cell argument.

-cell2 s_topCellName

Specifies the top-level cell to load for the secondary design given by -gds2 or -oasis2.

-detect_vias [ true | false ]

  

When true, enables the automatic detection of vias.

The layer map file, given by the -layer_map argument, must specify the appropriate material types, metal and cut, for the via metal and cut layers. Other layers can be type other.

The layer map file must also specify the fabrication order for the layers using ascending mask numbers. For example, metal1 would be 1, via1 would be 2, metal2 would be 3, and so on.

Default: Via detection is enabled.

-device_prop_number i_annotated_stream_device_prop_number

  

Specifies stream property number that is used to specify devices.

Default: 7

-gds2 s_fileName

Specifies the name of the GDSII stream file to open for a second design that will be merged with the primary design given by -gds or -oasis. Cannot be used with the -oasis2 argument.

-ignore_layers {{i_layerNumber:i_dataTypeNumber}…}

  

Excludes from loading the specified subset of layers, given by i_layerNumber:i_dataTypeNumber pairs.

For example,

{2:0 4:0 5:0} 

will exclude layer and data types for

  • Layer 2, data type 0
  • Layer 4, data type 0
  • Layer 5, data type 0

This argument cannot be used with -load_layers, -ignore_layers_file, or -load_layers_file.

Default: No layers are ignored.

-ignore_layers_file s_fileName

  

Specifies a file that contains the list of layers to be excluded, each represented by a pair of numbers, separated by a space, one per line.

i_layerNumber i_dataTypeNumber 

This argument cannot be used with -ignore_layers, -load_layers_file, nor -load_layers.

-instance_prop_number i_annotated_stream_instance_prop_number

  

Specifies stream property number that is used to specify instances.

Default: 6

-load_layers {{i_layerNumber:i_dataTypeNumber}}

  

Loads only the specified subset of layers, given by i_layerNumber:i_dataTypeNumber pairs. The listed pairs must be specified in the layer map file.

For example,

{0:0 1:0 2:0} 

will load only layer and data types for

  • Layer 0, data type 0
  • Layer 1, data type 0
  • Layer 2, data type 0

This argument cannot be used with -ignore_layers, -ignore_layers_file, nor -load_layers_file.

Default: All layers are loaded.

-load_layers_file s_fileName

  

Specifies a file that contains the list of layers to be loaded, each represented by a pair of numbers, separated by a space, one per line.

i_layerNumber i_dataTypeNumber 

This argument cannot be used with -ignore_layers, -ignore_layers_file, nor -load_layers.

-net_prop_number i_annotated_stream_net_prop_number

  

Specifies stream property number that is used to specify nets.

Default: 5

-oasis s_fileName  

Specifies the name of the OASIS stream file to open. Cannot be used with the -gds argument.

-oasis2 s_fileName  

Specifies the name of the OASIS stream file to open for a second design that will be merged with the primary design given by -gds or -oasis. Cannot be used with the -gds2 argument.

-refgds {s_libName…}

Specifies one or more GDSII libraries in which to search for master cells in the design given by -gds.

-refgds2 {s_libName…}

Specifies one or more GDSII libraries in which to search for master cells in the design given by -gds2.

-refoasis {s_libName…}

Specifies one or more OASIS libraries in which to search for master cells in the design given by -oasis.

-refoasis2 {s_libName…}

  

Specifies one or more OASIS libraries in which to search for master cells in the design given by -oasis2.

-threads i_count  

Specifies the maximum number of threads, or processors, to run in parallel for this command. Using multiple processors, if available, can decrease processing time.

Default: 1 (single processor)

-view s_viewName  

Specifies the input view name.

Default: layout

Value Returned

None

Related Topics

Stream/OASIS-to-OpenAccess Layer Map File

write_stream

write_stream_by_net


Return to top
 ⠀
X