Starting SIMULIA Tosca Structure from Command Line | ||
| ||
Program Call
The program call in the command line is:
tosca --input_1 option_1 ... [--input_n option_n]
The user interfaces are started as follows:
| Tosca ANSA® environment | tosca_ansa_env |
| Tosca Structure.gui | tosca_gui |
The start script can be found in <install_dir>\bin\tosca_ansa_env or in <install_dir>\bin\tosca_gui.
Minimal Program Call
The minimal SIMULIA Tosca Structure call is
tosca <jobname>
The name of the parameter file can be derived directly from the jobname. The file <jobname>.par is loaded in this case. If it is needed that the jobname directory has a name different from the parameter file name, use the command line option --opt as follows:
tosca <jobname> --opt <parameterfilename>
In this instance, the name of the working directory is specified by the jobname. The file name for the input file of the FE analysis is entered in the parameter file using the command FEM_INPUT.
List of Command Line Options
The following command line options are most common used in SIMULIA Tosca Structure:
| Input | Option | Comment |
|---|---|---|
| --job | jobname | Jobname of the optimization job |
| --opt | parfilename | Name of the parameter file (if not <jobname>.par) |
| --help | Short command line help | |
| --loglevel | NOTICE
INFO (default) DEBUG TRACE |
Loglevel in logfile TOSCA.OUT
NOTICE - Least verbose general information INFO - Important information about running optimization DEBUG - more verbose output. TRACE - Extremely verbose output. Do not use with large models! |
| --loglevel_stdout | NOTICE (default) INFO DEBUG TRACE |
Change loglevel to command shell.
Loglevels are the same as above. --loglevel_stdout <value> must be higher or equal to --loglevel <value> |
| --stderr | Separates the stderr from the stdout. If used and the stderr is still output to stdout there will be doubled output for message with levels ERROR, FATAL and CRITICAL. | |
| --ow | Overwrite existing jobname directory. If this flag is not specified, SIMULIA Tosca Structure will move the existing job directory to a directory with a counter extension. When running in -report or -smooth mode all files will be overwritten if possible. | |
| --restart | Restart of a SIMULIA Tosca Structure optimization job. The restarted optimization job starts with the finite element analysis. | |
| --solver |
abaqus ansys marc mscnastran permas |
Specification of the finite element
solver
Abaqus ANSYS Marc MSC Nastran PERMAS |
| --fe_solver_version | fe solver version | Specification of the finite element solver version (optional) |
| --life | femfat onf |
Specification of the durability solver
Femfat
Any life-solver which delivers results in ONF-format |
| --life_solver_version | life solver version | Specification of the life solver version (optional) |
| --type | test1 test2 test3 test4 |
Several test levels to check the optimization run. |
| --smooth | Tosca Structure control runs only Tosca Structure.smooth and executes the SMOOTH commands in the given parameter file. Requires completed optimization job! | |
| --report | Tosca Structure control will run only Tosca Structure.report and executes the REPORT commands in the given parameter file. Requires completed optimization job! | |
| --view | Tosca Structure control will run only Tosca Structure.view and tries to find last generated optimization result file (vtfx-file) Requires completed optimization job! | |
| --cpus | <number cpus> | The number of CPUs SIMULIA Tosca Structure should use. SIMULIA Tosca Structure is mainly a single tread program so large speed ups should NOT be expected. |
| --logfile | <filename> | Will change the log file name to filename in job directory. |
| --loglevels_exes | <loglevel>: <executable>, <loglevel>: <executable> | To set loglevels for certain executables directly. To set more loglevel use comma separated list without spaces. |
| --print_tosca_includes |
no (default) yes only |
Prints include files necessary for SIMULIA Tosca Structure to run. If option only is used, file with include files is printed and SIMULIA Tosca Structure stops. |
| --reuse | Advanced option! Reuse work directory with ONF-files. Only changes in parameter file are regarded. For testing purposes only. | |
| --restart2 | Advanced option! Restart assuming solver run was successful. | |
| --restart3 | Advanced option! Restart assuming life-solver run was successful. | |
| --docu | Start the SIMULIA Tosca Structure documentation with Acrobat reader. | |
| --run | nohup | Run SIMULIA Tosca Structure in No Hangup Mode. |
| --cdb2classic | Convert FEM_INPUT file to ANSYS classic format using SIMULIA Tosca Structure interfaces. | |
| --modification_file | <modifiction>.onf file | Use SIMULIA Tosca Structure interfaces to apply modifications to FEM_INPUT files. |
The --job name is mandatory, all other parameters are optional. A default solver can be entered in the configuration file. Otherwise, --solver must be set. If only the jobname is given, the name of the parameter file is derived automatically (jobname.par) and the name of the analysis file is extracted from the FEM_INPUT command in the parameter file.
Note, For backwards compatibility commandline parameters may be given with a single minus, e.g.
$ tosca -input_1 option_1 ... [-input_n option_n]
Deprecated Command Line Options
| Input | Comment |
|---|---|
| --post | Use REPORT command in parameter file instead |
| --temp | Use FEM_INPUT command instead |
| --restart2 | |
| --restart3 | |
| --aio | |
| --out | Use --loglevel instead |