com.xilinx.rapidwright.design

Class NetTools

Object

com.xilinx.rapidwright.design.NetTools

public class NetTools
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NetTools.NodeTree

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTINUE_ELBOW
static String	LAST_ELBOW
static String	VERTICAL_BAR
static String	WHITE_SPACE

Constructor Summary

Constructors

Constructor and Description
NetTools()

Method Summary

Modifier and Type	Method and Description
static Node	findClockRootVRoute(Net net) Finds the clock root VROUTE node.
static String	getClockTreeSpine(Net net) Generates the clock tree up to the horizontal distribution nodes of the provided clock net up to the NODE_PINFEED nodes.
static String	getNetTreeString(Net net) Returns a string representation of the net's routing tree using tree characters (├─, └─).
static String	getNetTreeString(Net net, Function<Node,Boolean> filter) Returns a string representation of the net's routing tree using tree characters (├─, └─).
static String	getNetTreeString(Net net, Function<Node,Boolean> filter, Function<Node,String> customToString) Returns a string representation of the net's routing tree using tree characters (├─, └─).
static List<NetTools.NodeTree>	getNodeTrees(Net net) Compute the node routing tree of the given Net by examining its PIPs.
static List<NetTools.NodeTree>	getNodeTrees(Net net, Function<Node,Boolean> filter) Compute the node routing tree of the given Net by examining its PIPs.
static String	getVerticalClockTreeSpine(Net net) Gets a string representation of the vertical clock routing spine for the given net.
static boolean	hasClockSinks(Net net) Checks if the provided net drives a clock site pin input.
static boolean	isGlobalClock(Net net)

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONTINUE_ELBOW

public static final String CONTINUE_ELBOW

See Also:

Constant Field Values

LAST_ELBOW

public static final String LAST_ELBOW

See Also:

Constant Field Values

VERTICAL_BAR

public static final String VERTICAL_BAR

See Also:

Constant Field Values

WHITE_SPACE

public static final String WHITE_SPACE

See Also:

Constant Field Values

Constructor Detail

NetTools

public NetTools()

Method Detail

isGlobalClock

public static boolean isGlobalClock(Net net)

getNodeTrees

public static List<NetTools.NodeTree> getNodeTrees(Net net)

Compute the node routing tree of the given Net by examining its PIPs. Note that this method only discovers subtrees that start at an output SitePinInst or a node tied to VCC/GND (i.e. gaps and islands will be ignored). Nodes that are multiply-driven (indicative of routing loops) will have their NodeTree.multiplyDriven flag set.

Parameters:

net - Net to analyze.

Returns:

A list of NodeTree objects, corresponding to the root of each subtree.

getNodeTrees

public static List<NetTools.NodeTree> getNodeTrees(Net net,
                                                   Function<Node,Boolean> filter)

Compute the node routing tree of the given Net by examining its PIPs. Note that this method only discovers subtrees that start at an output SitePinInst or a node tied to VCC/GND (i.e. gaps and islands will be ignored). Nodes that are multiply-driven (indicative of routing loops) will have their NodeTree.multiplyDriven flag set.

Parameters:

net - Net to analyze.

filter - A function that when is applied to a node, if it returns true will be excluded from the tree.

Returns:

A list of NodeTree objects, corresponding to the root of each subtree.

hasClockSinks

public static boolean hasClockSinks(Net net)

Checks if the provided net drives a clock site pin input.

Parameters:

net - The net to examine.

Returns:

True if the net has a site pin clock input, false otherwise.

getNetTreeString

public static String getNetTreeString(Net net)

Returns a string representation of the net's routing tree using tree characters (├─, └─).

Parameters:

net - The net to generate the tree of nodes from.

Returns:

String representation of the net's routing tree with tree characters.

getNetTreeString

public static String getNetTreeString(Net net,
                                      Function<Node,Boolean> filter)

Returns a string representation of the net's routing tree using tree characters (├─, └─).

Parameters:

net - The net to generate the tree of nodes from.

filter - A function that when returns true for a node, the node should be excluded.

Returns:

String representation of the net's routing tree with tree characters.

getNetTreeString

public static String getNetTreeString(Net net,
                                      Function<Node,Boolean> filter,
                                      Function<Node,String> customToString)

Returns a string representation of the net's routing tree using tree characters (├─, └─).

Parameters:

net - The net to generate the tree of nodes from.

filter - A function that when returns true for a node, the node should be excluded.

customToString - A custom toString() function to be applied to the Node when printed.

Returns:

String representation of the net's routing tree with tree characters.

getClockTreeSpine

public static String getClockTreeSpine(Net net)

Generates the clock tree up to the horizontal distribution nodes of the provided clock net up to the NODE_PINFEED nodes.

Parameters:

net - The clock net

Returns:

A string tree representation from the source of the clock out to all horizontal distribution nodes.

getVerticalClockTreeSpine

public static String getVerticalClockTreeSpine(Net net)

Gets a string representation of the vertical clock routing spine for the given net. This method is similar to getClockTreeSpine but only includes vertical distribution nodes. Only the clock root VROUTE node is included; all other VROUTE nodes are filtered out.

Parameters:

net - The net to analyze

Returns:

A string tree representation showing only vertical clock routing nodes

findClockRootVRoute

public static Node findClockRootVRoute(Net net)

Finds the clock root VROUTE node. The clock root is the deepest (furthest from source) NODE_GLOBAL_VROUTE node in the tree.

Parameters:

net - The net to analyze

Returns:

The clock root VROUTE node, or null if none found