Skip to content

Home > User Interface > Overview > Batch Commands

Batch commands

The GUI may be run in batch mode through simple text-based command files (.CMD). This allows for launching the GUI in quiet mode - without the GUI displays on your screen - with different options, as detailed below.

General syntax

Each ASCII command file may comprise several batch running instructions, with one command per line. The syntax of each batch command must be as follows :

EXEC_FILE    FLAG    FILE_NAME
EXEC_FILE    FLAG    FILE_NAME
...
EXEC_FILE    FLAG    FILE_NAME

with

  • EXEC_FILE : the complete path to DeepLinesGUI executable file - this path defaults to C:\PRINCIPIA\DeepLines\DeepLinesV5R3\DeepLinesGUI.exe

  • FLAG : the flag is used to specify which running mode will be used. The flag must be one of the following :

    -console
    -generate
    -export
    -batch
    -batch_sql
    -excel
    -generateZS
    -generateDSF
    -generateDSSLOG
    -Statis
    -clashcheck

  • FILE_NAME : the complete path to the file to be opened. This file may be of the following types : Simulation results file (.DSS), Fatigue results file (.DSF), Code check study file (.DSC), Model file (.DSK) or ASCII batch file.

"-console" flag

If this flag is selected, the FILE_NAME must be either a Simulation results file (.DSS), a Fatigue results file (.DSF) or a Code check study file (.DSC). When this option is selected, the specified document is opened in quiet mode (no interface window displayed) and the graphic results (.DSS), the fatigue analysis (.DSF) or the code check study are processed. This allows for instance for running fatigue or code check post-processing in batch mode.

"-generate" flag

If this flag is selected, the FILE_NAME must be a Model file (.DSK). When this option is selected, all the .LOG and .DSS files contained in the model document will be created.

Note

This feature is also available in the interface (through the icon : or through the popup menu of the analysis set folder).

"-export" flag

If this flag is selected, the FILE_NAME must be a Simulation results file (.DSS). When this option is selected, all the graphic results will be exported into text files located in the same folder than the Simulation results file. Text file names are automatically generated according to the type of the result.

The syntax of text file names is as follow:

DSS_FILE_NAME + - + RESULT_TYPE + .txt

"-batch" flag

This flag may be used for running user-specified batch post-processing instructions. The FILE_NAME must be a text file containing all the results requests. More details are available from the Batch post-processing section.

Note

Batch post-processing instruction files may be defined automatically from the model browser, provided that the post-processing instructions have been defined first in the Predefined results item from the analysis. To create one batch command file this way, you must : 1. Create your post-processing instructions from the Predefined results item from the analysis. 2. Right click the name of the analysis. 3. Select Generate batch file from the pop-up menu that displays. The ASCII instruction file will be automatically generated by the GUI with the correct syntax.

"-batch_sql" flag

This flag may be used for running user-specified batch post-processing instructions. The FILE_NAME must be a text file containing all the results requests. More details are available from the Batch post-processing section.

The difference with the -batch flag is that the export format file is a SQLite database. There is one database file per analysis, containing all variables specified in the batch file. The batch file should concern only one analysis. The disk space is about 3 times shorter than text files. There are also specific tables for statistics. The Batch file creation section gives more details of how to create a batch file for outputting results in a SQlite database.

"-excel" flag

This flag may be used to export all the graphics contained in a Simulation results file (.DSS) to an Excel file. The Excel file name is automatically set to that of the Simulation results file. This avoids you opening all the Simulation results files with the GUI and clicking the Export to Excel button. The FILE_NAME must be a Simulation results file (.DSS).

"-generateZS" flag

If this flag is selected, the FILE_NAME must be Model file (.DSK). When this option is selected, all ZS.txt files associated with Zone Study post- processing requests will be created.

"-generateDSF" flag

If this flag is selected, the FILE_NAME must be a Model file (.DSK). When this option is selected, all DSF files associated with the fatigue post-processing requests will be created.

"-generateDSSLOG" flag

If this flag is selected, the FILE_NAME must be a Model file (.DSK). When this option is selected, all the .LOG and .DSS files contained in the model document will be created.

"-Statis" flag

If this flag is selected, the FILE_NAME must be a Simulation results file (.DSS). When this option is selected, the outputs statistics stored in the DSS file are exported in a text file.

"-clashcheck" flag

If this flag is selected, the FILE_NAME must be a Clearance Check file (.CLC). When this option is selected, all the clearance checks requests included in the .CLC file are processed.