-block_clearance {f_userunit | {f_left f_bottom f_right f_top}}

If one argument value is given, it must be a non-negative number for the clearance outward from the block boundary to the innermost ring.

If four values are given, they may be any real numbers for clearances to the left, bottom, right, and top, respectively. Positive values are measured outward from the block boundary to the innermost ring. Negative values indicate distance inward from the block boundary to the innermost edge of the innermost ring.

By default, the clearance is the greater of the minimum clearance of the two layers specified by -layers.

-channels [ true | false ]

When true, adds rails in the channels between blocks. By default, rails are not added between blocks. For an example using channels, refer to Example 3 — Contoured Block Ring Created Around a Pair of Blocks with Channels.

-contour [ true | false ]

If true, the block ring will follow the contour of the selected blocks. By default, the block ring will be rectangular.

-depopulate {[L] [B] [R] [T] [H] [V]}

Prevents one or more segments of the block ring from being added. This argument does not apply to channel segments between blocks.

B

Bottom segment

H

Horizontal segments

L

Left segment

R

Right segment

T

Top segment

V

Vertical segments

-ignore_obstacles [ true | false ]

When true, ignores all obstacles and creates power segments without regard to rule violations. This is useful to get a quick preliminary power layout or when it is known that there are no obstacles, such as on an empty layer.

Default: false

-ignore_purposes {s_purposeName…}

Similar to -ignore_obstacles, ignores objects on the given purposes. By default, no purposes are ignored.

-in_block_clearance f_userunit

Specifies the clearance inward from the block boundary to the outermost ring. The value must be non-negative. The block rings will be added inside the block boundary and will be rectangular.

-instances {s_instName…}

Encloses the instances given in the list.

-lattice [ true | false ]

When true, extends ring segments of duplicate nets to form a lattice. By default and when false, concentric rings are maintained. For examples, refer to Example 4 — Concentric Block Rings (Default) and Example 5 — Latticed Block Rings.

-layer_width {f_width1 f_width2…}

Specifies the width, in microns, to use for each layer given in the -layers list, respectively, for all nets.

-layers {s_layer1Name s_layer2Name …}

Specifies at least two orthogonal metal layers to use for the block ring of each net. One layer must have a preferred horizontal direction and one other layer must have a preferred vertical direction.

-min_jog f_length

Removes contour jogs shorter than the given length. The default value is equal to net_width plus net_clearance.

-net_clearance f_userunit

Specifies the spacing between the power nets routed. By default, this value is the greater of the minimum clearance of the two layers.

-net_width f_userunit

Specifies the total width for each net routed. By default, this value is the greater of the minimum widths of the two layers.

If you specify a net width value that is greater than the maxWidth of one of the given layers, multiple rings are added for each net such that the following are true:

• All added wire is equal in width.
• The width of the added wire is greater than or equal to the greater of the minWidth of the two layers and less than or equal to the lesser of the maxWidth of the two layers.
• The sum of the wire widths for each net in a ring set is equal to the given net width.

-nets {s_netName…}

Specifies the nets to route. One or more nets can be given. When more than one net is given, the list order of the nets determines the placement of the rings, with the first net on the innermost ring, followed by the second, and so on, to the last net of the list on the outermost ring.

-power_only [ true | false ]

If true (default), only power and ground nets are allowed. If false, signal nets are also allowed.

-set d_setObj

Specifies the set of instances to enclose.

-silent [ true | false ]

When true, outputs only error messages. When false, all message types are output.

Default: false

-undoable [ true | false ]

Permits this command to be undone. Default is the current setting for the proute.undoable environment variable which defaults to false on startup.