Product Documentation

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

Contents

1

File Commands

cellview_exists

read_annotations

read_view_contexts

write_annotations

write_view_contexts

Stream/OASIS-to-OpenAccess Layer Map File

write_stream_by_net

write_stream_by_set

2

Manipulate Sets

3

Edit Commands

add_object_to_net

add_object_to_set

copy_net_routes

create_highlight

delete_cellview

delete_floating_trims

delete_pin_halo_shapes

delete_trim_fill_shapes

find_composite_net

find_instance_of

find_neighbor_nets

find_net_portion

find_scenic_nets

find_shielded_nets

ge_to_rde_selection

get_cell_view_id

get_connected_net

get_current_highlight

get_inst_headers

get_num_highlights

get_occurrence_instances

get_occurrence_nets

get_occurrence_terms

get_selection_set

get_via_headers

hsm_to_rde_selection

inspect_getprop

inspect_setprop

remaster_instance

remove_highlight

remove_object_from_net

remove_object_from_set

select_nets_on_routes

select_routes_on_nets

set_current_highlight

split_oa_terminals

4

View Commands

create_view_context

delete_view_context

get_drawing_order

get_view_contexts

get_window_area

rename_view_context

set_drawing_order

set_layer_attributes

set_layer_opacity

show_view_context

5

Collaborate Commands

map_annotations

read_litho_errors

read_niagara_errors

remove_annotations

send_annotations

write_calibre_errors

6

Create Commands

create_blockage

create_fill_cell

create_instance

create_pin_halo_shapes

create_polygon_shape

create_rect_shape

create_routing_cell

geom_create_scratch_layer

geom_remove_scratch_layers

geom_scratch_layers_in_use

geom_tiles_on_scratch_layer

7

Design Configuration Commands

collapse_shape_term

convert_routing_shapes

create_derived_vias

create_no_pref_dir_region

create_pr_boundary

create_preferred_direction_region

create_soft_fence

delete_no_pref_dir_region

delete_preferred_direction_region

delete_soft_fence

get_current_design

extract_net_connectivity

get_placement_grid

get_preferred_layers

get_route_on_grid

get_route_via_info

get_routespec_taper

get_routing_grid

get_routing_style

get_soft_rule_adherence

get_sorted_route_via_list

get_treat_blockage_as_metal

get_treat_via_as_abstract

get_use_existing_shapes_for shielding

read_net_connectivity

set_net_fix_status

set_net_priority

set_net_signal_type

set_placement_grid

set_preferred_layers

set_route_fix_status

set_route_on_grid

set_route_style

set_route_topology

set_routespec_taper

set_routing_grid

set_routing_style

set_soft_rule_adherence

set_taper_width_nets

set_treat_blockage_as_metal

set_treat_via_as_abstract

set_use_existing_shapes_for_shielding

set_width_priority_nets

unset_preferred_layers

unset_taper_width_nets

8

Power Route Commands

proute_block_ring

proute_cell_row

proute_core_ring

proute_create_via_array

proute_pad_ring

proute_pin_to_trunk

proute_row_straps

proute_trim_stripes

proute_via_insertion

Power Router Troubleshooting

9

Specialty Route Commands

Bus Routing Commands

finish_bus_route

Segment-style Routing Commands

Spine-style Routing Commands

report_balanced_length

report_spine_nets

set_route_is_spine

unset_route_is_spine

unset_spine_nets

Star Routing Command

Custom Topology Routing Command

Pair Routing Commands

pair_create_topology

pair_report_stats

Shield Routing Commands

add_shield_wires

delete_shield_wires

report_shield_wires

route_shield_wires

set_route_noshield

Constraints Used When Shielding Nets

Configuring Shield Wires

Controlling Shield Options

Using Existing Power and Ground Shapes for Shielding

Sharing Shields

Preventing Shielding on Specific Layers

Shielding by Route

Setting the Shield Type

Shield Routing Script Examples

Parallel Shield Routing Script

Coaxial Shield Script

Tandem Above Shield Routing Script

Matched Length Routing Commands

Strand Routing Commands

Preparing for Strand Routing

Strand Routing Constraints

Examples for Strand Routing Using Constraints

10

ECO Route Commands

eco_connect_inst_term

eco_connect_term

eco_copy_implementation

eco_create_instance

eco_destroy_instance

eco_destroy_net

eco_disconnect_inst_term

eco_disconnect_term

eco_move_instance

eco_remaster_instance

eco_set_net_preferred_layers

eco_set_net_rule

get_changed_area

Buffer Insertion

Buffer Deletion

Instance Remastering

Routing ECO Changes

Point-to-Point Router

Search and Repair

Saving ECO Changes

Undoing ECO Changes

11

Preparing the Routing Environment

Choosing the Routing Mode

Specifying the Grids

Enabling/Disabling Routing on a Layer

Routing Poly Layers

Default Taper Settings

Setting Pin Width-based Tapering

Setting Custom Tapering

Removing Custom Tapers

Types of Valid Routing Vias

Getting Via Information

Determining Which Via the Router Will Use

Advanced Via Extension Control and Selection

Routing with Aligned Single-Cut Vias

Routing with On-Wire Multi-Cut Vias

Using Via Abstraction

Controlling Via Stacking

Handling Blockages

Using Dynamic Methods

Setting Spacing in Your Design

Setting the prBoundary Spacing

Setting Spacing for Subcells

Connecting IO Pins

Creating Fences

Setting Net Priorities

Hard and Soft Spacing Rules

Protecting Existing Routes

Setting the Routing Layer Direction in a Local Area

Modifying Internal Routing Costs

Minimizing Parallelism Effects

Classifying Neighbor Nets

Avoiding Crosstalk

Crosstalk Control Example

Shielding Group of Nets

Minimizing Potential Violations

A Tcl Routing Script Example

Checking and Fixing Routing Results

Fixing Unroutes

Fixing Violations

Checking for Setup or Data Translation Issues

12

Route Commands

congestion_analysis

create_chamfer_fill

create_wire_chamfer

delete_conflicts

extend_wire_to_pin_edge

optimize_routes

search_and_repair

show_congestion

wrongway_pin_escape

13

Optimize Commands

check_litho_errors

clear_redundant_via_mapping

create_density_fill_keepout

create_net_fill

create_step_via

fix_diff_track_errors

fix_litho_errors

map_redundant_via

read_check_area

show_redundant_via_mapping

14

InPlace Cover Obstruction Commands

create_inplace_cover_obstruction

get_inplace_cover_obstruction_bloat

get_inplace_cover_obstruction_blockage_attribute

get_inplace_cover_obstruction_blockage_model

get_inplace_cover_obstruction_doughnut_halo

get_inplace_cover_obstruction_layers

get_inplace_cover_obstruction_max_mask

get_inplace_cover_obstruction_min_mask

get_inplace_cover_obstruction_pin_remodeling

get_inplace_cover_obstruction_spacing_model

has_inplace_cover_obstruction

remove_inplace_cover_obstruction

set_inplace_cover_obstruction_bloat

set_inplace_cover_obstruction_blockage_attribute

set_inplace_cover_obstruction_blockage_model

set_inplace_cover_obstruction_doughnut_halo

set_inplace_cover_obstruction_pin_remodeling

set_inplace_cover_obstruction_spacing_model

15

Annotation Commands

add_net_annotation

delete_annotation

delete_annotations

find_annotations

get_annotation_group

group_annotations

16

Analyze Commands

17

Verify Commands

check_connectivity

check_discrete_width

check_extensions

check_large_via_arrays

check_layerpair_space

check_min_edge_length

check_routability

check_route_quality

check_strong_weak

check_vertex_spacing

get_shape_connectivity

update_net_connectivity

verify_connectivity

18

Window Commands

remove_tool_bar

restore_default_configuration

window_graphics_type

19

Report Commands

report_design_stats

report_net_stats

report_pin_via_escapes

report_routing_stats

report_scenic_nets

report_via_stackability

report_via_stats

report_wire_spacing_stats

report_wire_width_stats

20

Color Map Display Commands

create_map_coloring

create_map_tile

display_color_map

display_color_map_value

unload_color_map

21

Technology Commands

add_custom_via_def

add_physical_layer

check_custom_via_defs

delete_purpose_map

destroy_derived_cgs

get_dbu_per_user_unit

get_use_process_rules_only

report_purpose_map

set_net_implementation_purpose

set_tech_references

set_use_process_rules_only

set_via_stackability

22

System Commands

define_key_binding

disable_multithreading

enable_multithreading

get_license_info

hide_application

is_advanced_node_version

raise_application

show_system_info

undefine_key_binding

23

Space-based Router Tcl Environment Variables

abstract_view_name

allow_pin_to_pin_space_checking

check_constraints_basics

clearance_based_zoning

connect_array_insts

connect_IO_pin_shapes

connect_mustjoin_pins

create_inst_terms_in_subdesign

default_rule_spec_name

enable_blockage_constraints

enable_create_derived_vias

enable_effective_width_on_blockages

enable_min_spacing_on_blockages

ignore_routing_grid_check_for_via_metal_layers

load_as_detailed_abstract

load_blockages_start_level

load_blockages_stop_level

load_cdsDefTech

load_core_blockages

load_lower_level_wire_shapes_as_blockages

load_prboundary_shape_as_boundary

load_pushed_down_blockages_start_level

load_pushed_down_blockages_stop_level

make_prboundary_blockage

map_layout_to_abstract_view

mustjoin_skip_term_name

mustjoin_sorted_leader

one_shape_term_per_net

paths_as_routes

pause_stop_layer_trimming

poly_layer_name

prboundary_layer_name

prboundary_purpose_name

proute_tap_to_depth

preserve_routing_via_order

recursive_pg_label

save_original_via_master_property

suppress_warn_on_same_mask_num_layers

use_separate_pref_ext_dir

use_via_rules_from_via_def

use_worst_cut_blockage_spacing

zone_unplaced_instances

delay_read_pixels

disable_redraw_on_source

dimension.auto_complete

dimension.axis_lock

dimension.shape_snapping

fit_next_previous_changes_view_area_only

ignore_colors_file

max_track_size_in_pixels

preview_shape_limit

property_inspector.visibility

show_shape_overlaps

truncate_history_when_saving_view

use_vertex_arrays

zoom_out_factor

Command Environment

Interactive Environment

allow_pin_movement

save_new_wiring_as_special

via_list_length

Router Environment

adjustvias_in_localroute

check_pins_on_wsp

offset_transition_vias

shields_in_violation

snap_to_pin_center

vias_must_be_fully_enclosed

vias_must_be_fully_enclosed_on_layer

Power Router Environment

ignore_pin_blockage

Verify Environment

disable_check_trim_in_check_space

check_trim_spacing_oneshape_insideprboundary

24

Use of Tcl Commands

Loading and Running Tcl Scripts

Loading Tcl Scripts

Running Tcl Scripts

Examples of Tcl Core Commands and Virtuoso Space-based Router Commands

Example 1 - Finding and Highlighting a Net Using a Single Command

Example 2 - Finding and Highlighting an Instance Using a Stored Variable

Example 3 - Finding and Highlighting an Instance (Master) Using a Stored Variable

Example 4 - Creating a Procedure to Manipulate Display Levels

Example 5 - Finding and Highlighting Instances Matching a Pattern Name Using a Stored Variable

Example 6 - Finding and Highlighting a Subset of a Set Using Stored Variables

25

Inspecting Properties

Get a Property Value for an Object

Get a Property Value for Items in a Set

Tcl Examples for Inspecting Properties

Find Items in a Set

Find Elements of Items in a Set

Create a Set of Net Elements of a Specific Type

Create a List of Net Elements of a Specific Type

Find All Vias on Nets in a Set

Find All Vias with a Given Master on Nets in a Set

Get the Names of Nets in a Set

Get the Names of Nets with Guides

Create a Set Containing Nets with Guides

Select Nets from Route Segments

Create a Set of Nets Containing Route Segments from Another Set

Select Routes from Nets

Create a Set of Routes Containing Nets from Another Set

Create a Set Containing Instances Attached to Nets in a Set

Find Instance Connections for Nets Matching Net Name Expression

Create Annotations for Items in a Set

Annotate All Vias with a Given Master on Nets in a Set

⠀ X