map_purpose
map_purpose
{-from_lpp s_lpp | -user_purpose s_purposeName}
-to_purpose s_purposeName
Description
Maps a user purpose or a layer purpose in the design to a predefined Space-based Router and Chip Optimizer purpose.
When a design is loaded, all user purposes map to drawing. If the user purpose name is bob, it is mapped to bob:drawing, and, by default, is ignored. Use map_purpose to make an explicit mapping to a predefined Space-based Router and Chip Optimizer purpose, or to map one layer purpose to another purpose.
The mapping must be set prior to loading the design and can be saved with the design as a CatenaUserPurposeMap property. Once saved, the mapping will automatically be loaded when the design is loaded, and can be removed using delete_purpose_map.
Mappings set using the map_purpose command apply to all designs that are subsequently loaded. If you load a design that has the CatenaUserPurposeMap property set, the mappings from that property will apply only to that design and will take precedence over mappings set using the map_purpose command. To prevent saved mappings from being loaded with a design, issue the following before loading the design:
setvar db.map_user_purposes false
For a listing of the predefined Space-based Router and Chip Optimizer purposes, use
help map_purpose
Arguments
Examples
The following example will cause objects on the Unknown user purpose of the design to appear as objects on the fill purpose in the workspace and as Unknown:fill in the Layer Object Display Panel.
map_purpose -user_purpose Unknown -to_purpose fill
Related Topics
Return to top