qed::merge_workspaces (::quartus::qed)
The following table displays information for the qed::merge_workspaces Tcl command:
| Tcl Package and Version |
Belongs to ::quartus::qed 1.0 |
|||
| Syntax | qed::merge_workspaces [-h | -help] [-long_help] [-files <files> ] [-pattern <pattern> ] | |||
| Arguments | -h | -help | Short help | ||
| -long_help | Long help with examples and possible return values | |||
| -files <files> | List of .sqlite files to import | |||
| -pattern <pattern> | Substitution pattern to guide how IDs are generated for the objects in each source .sqlite | |||
| Description |
Merges project and group data from one or more workspaces into this one.
This can be used in conjunction with the EXPLORATION_DASHBOARD_REPORT_SCRIPT
assignment to gather multiple databases that were generated during a compile
into a single workspace.
Use the -files argument to specify each workspace to merge as the .sqlite
path to that workspace's database file. The -files value must be formatted
as a Tcl list, defined using {} or the [list] command.
Use the -pattern argument to guide how IDs are generated in the current
workspace for the incoming objects from the other workspaces. It can be
any string, but likely needs to contain one or both of the following tokens
in order to produce unique IDs:
* %WORKSPACE_NAME% - gets substituted per file with an ID string derived
from the filepath
* %OBJECT_ID% - gets substituted per object from the source workspaces
with the original ID of the object in that workspace.
|
|||
| Example Usage |
::qed::workspace_new dest_workspace
qed::merge_workspaces -files {/path/to/source_workspace_1.sqlite /path/to/source_workspace_2.sqlite} -pattern "%WORKSPACE_NAME%_%OBJECT_ID%"
|
|||
| Return Value | Code Name | Code | String Return | |
| TCL_OK | 0 | INFO: Operation successful | ||