Skip to content

Home > User Interface > Results Processing > Batch Post-Processing

Batch post-processing

You may run post-processing in batch mode through simple command files. The command files may be prepared by hand or the by GUI and follow a number of conventions detailed below. Using such batch commands is a convenient way to save time when requesting similar series of outputs for numerous analyses. Data can be saved in text format or SQLite database format.

Note

Batch post-processing instruction files may also 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 in the relevant 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. This can be edited by hand if you wish to make changes.

When running a batch post-processing command, all the graphic results requested from the various batch files will be computed, then added into the .DSS simulation files and finally exported into text files.

  1. The first thing to do is to create one set of batch post-processing instructions per analysis. Each set of instructions must be grouped into simple text file, the batch files. These files have special formatting which is detailed in the batch files format section.

  2. Finally, create one ASCII command file with the .CMD extension, with all the instructions necessary to run the user interface as a batch process. Your command file must have the following line format :

      EXEC_FILE -batch FILE_NAME

    where :

    • EXEC_FILE : the entire path to DeepLinesGUI executable file, by default C:\PRINCIPIA\DeepLines\DeepLinesV5R0\Exec\DeepLinesGUI.exe
    • FILE_NAME : the entire path to your batch instructions file.

    The results files are text files placed in the export_txt directory.

    To save data in SQLite format, change option -batch by -batch_sql and the results are recorded in a database file placed in the export_sql directory.

  3. Execute your .CMD command file. This may be done either by double clicking on the file from Windows explorer, or by loading the file into the Batch Processing form that is available from the Tools menu.