Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 4/01/2024
Public
Document Table of Contents

4.1.31.48. qed::workspace_new (::quartus::qed)

The following table displays information for the qed::workspace_new Tcl command:

Tcl Package and Version

Belongs to ::quartus::qed

Syntax qed::workspace_new [-h | -help] [-long_help] [-directory <directory> ] [-overwrite] [ <id> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-directory <directory> Directory to cd into before creating the workspace. This directory must exist prior to invoking this command.
-overwrite Overwrite any pre-existing workspace database and ensure a fresh workspace is created
<id> Identifier associated with the object, must be unique
Description
Creates and opens a new QED workspace with the specified workspace name.
The command returns the ID of the new QED workspace object.

The "qed::workspace_new" command returns an error if a QED workspace
with the same name exists in the directory. Use the "-overwrite"
option to overwrite the existing workspace.

No QED workspace can be open when you create a new QED workspace;
it is an error if a QED workspace is open when you use the
"qed::workspace_new" command.
Example Usage
    if { ! [qed::is_workspace_open] } {
        qed::workspace_new my_workspace
    }
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful