create_single_pass_run - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

Exports an intelligent design run result into a single run for the current project


create_single_pass_run ‑reference_run <arg> [‑quiet] [‑verbose] <name>


Run object


Name Description
-reference_run Intelligent design run for which the result has to be exported into a single run
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<name> Name for new run




Generates a single pass design run that will be equivalent to the multi-pass Intelligent Design Run. As Intelligent Design Runs can take the equivalent compile time of many single pass runs, the output run of this command allows faster iterations when the design changes.


-reference_run <arg> - (Required) The top level completed Intelligent Design Run name.

<name> - (Required) The new design run name for the single pass run to be created. The run name must not be a run that already exists.

-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.

Note: Any errors encountered on the command-line, while launching the command will be returned. Only errors occurring inside the command will be trapped.

-verbose - (Optional) Temporarily override any message limits and return all messages from this command.

Note: Message limits can be defined with the set_msg_config command.


The following example creates an implementation run call new_impl_1 from the completed run Intelligent Design Run i_impl_1_1:

create_single_pass_run -reference_run [get_runs i_impl_1_1] new_impl_1

See Also