Engine Command Line Argument

RADIOSS Engine HMPP executables are available (as of version 11.0) with MPI and are fully Hybrid capable mixing SPMD and SMP parallelization.

Simplified executables also exist, which are only SMP capable but do not require MPI.

To distinguish easily between these two types of executables, MPI executables have a "_mpp" suffix.

•	For binaries compiled with MPI, they need to be run through the mpirun command. The general form is as follows:

mpirun [list of mpirun option] engine_executable_mpp [list of engine option]

Note:

The list of mpirun options depends on the MPI vendor. Refer to the MPI documentation.

•	For binaries compiled without MPI:

engine_executable [list of engine option]

Note:

The list of RADIOSS Engine options is the same for both types of executables.

RADIOSS Engine supports the following command line arguments. Each argument has a long and a short form. These are executable arguments.

Argument	Short form	Description
-help	-h	Print help message
-version	-v	Print RADIOSS release information
-input [FILE]	-i	Set RADIOSS Engine input file
-nthread [INTEGER]	-nt	Set Number of SMP threads per SPMD domain
-gpuid		Set GPU device number
-notrap		Disable error trapping

Prints help information on the command line arguments.

RADIOSS Engine exits after the printout.

Example:

[user@machine]$ ./e_12.0_linux64 impi -help RADIOSS Engine version 12.0: Command line arguments help:
-help	/ -h	: Print this message
-version	/ -v	: Print RADIOSS release information
-input [FILE]	/ -i [FILE]	: Set RADIOSS Engine input file
-nthread [INTEGER]	/ -nt [INTEGER]	: Set number of SMP threads per SPMD domain
-gpuid		Set GPU device number
notrap		Disable error trapping

Prints RADIOSS release information:

•	RADIOSS title

•	radflex name

•	version to use

•	build information (date, time of build and build tag)

RADIOSS Engine exits after the printout.

Example:

[user@machine]$ mpirun ./e_12.0_linux64 imp -version

RADIOSS Engine version 12.0

Platform release:

linux64 impi

Platform info:

Linux 64 bits, Intel compiler, Intel MPI

Radflex name:

radflex_12_linux64

Use Radflex version:

12009809402 or higher

Time of build:

18:28:32

Date of build:

08/12/12

Build tag:

0479348_2413000

Sets the RADIOSS Engine input file.

The FILE argument must be a RADIOSS Engine input file with the following format: [ROOTNAME]_[RUN NUMBER].rad

where:

ROOTNAME is the dataset rootname

RUN NUMBER is the run number expressed in four numbers.

Note:

•	ROOTNAME and RUN NUMBER are extracted from the input file.

•	The dataset ROOTNAME and RUN NUMBER settings in /RUN are ignored, when the -input command option is used.

•	If the file name doesn't have the correct format, the file is rejected.

•	The file is open. Standard input is no longer used.

•	If -input is not set, RADIOSS Engine opens standard input to read input.

Example:

[user@machine]$ mpirun -np 4 ./e_12.0_linux64 impi -nt 2 -input CRA2V51_0001.rad

************************************************************************

** **

** RADIOSS ENGINE 12.0 **

** **

** Non-linear Finite Element Analysis Software **

** from Altair Engineering, Inc. **

** **

** Linux 64 bits, Intel compiler, Intel MPI **

** **

** Build tag: 0479348_2413000 **

************************************************************************

** Contains trade secrets of Altair Engineering Inc. **

** Decompilation or disassembly of this software strictly prohibited. **

************************************************************************

ROOT: CRA2V51 RESTART: 0001

NUMBER OF HMPP PROCESSES 8

17/10/2008

NC= 0 T= 0.0000E+00 DT= 1.7916E-03 ERR= 0.0% DM/M= 0.0000E+00

ANIMATION FILE: CRA2V51A001 WRITTEN

NC= 100 T= 1.7826E-01 DT= 1.7700E-03 ERR= 0.0% DM/M= 0.0000E+00

...

NC= 13700 T= 1.9871E+01 DT= 1.4032E-03 ERR= -1.2% DM/M= 0.0000E+00

** CPU USER TIME **

#PROC	CONT.SORT	CONT.F	ELEMENT	MAT	KIN.COND	INTEGR.	I/O	TASK0	ASSEMB	RESOL
1	.0000E+00	.0000E+00	.1144E+02	.2910E+01	.7000E-01	.5600E+00	.3100E+00	.5000E+00	.3700E+00	.1364E+02
2	.0000E+00	.0000E+00	.1102E+02	.2870E+01	.7000E-01	.5600E+00	.0000E+00	.0000E+00	.3300E+00	.1364E+02

ELAPSED TIME : 7.79 s

RESTART FILE: CRA2V51_0001_0000.rst WRITTEN

NORMAL TERMINATION

TOTAL NUMBER OF CYCLES: 13793

[user@machine]$

Sets the number of SMP threads per SPMD domain. Each SPMD domain will be computed using a multi-threaded process composed of SMP THREAD NUMBER.

Where, SMP THREAD NUMBER: INTEGER is the number of SMP threads per SPMD domain.

Example:

[user@machine]$ mpirun -np 4 ./e_12.0_linux64 impi -nthread 2 -input CRA2V51_0001.rad

Note:

•	If the INTEGER value is not properly set, the RADIOSS Starter stops with error message.

•	If -nthread is set, the number of threads defined in the Starter run (/SPMD input card, -nthread command line) or previous Engine run is ignored.

•	The environment variable OMP_NUM_THREADS can also be used to change the number of threads. –nthread remains prior to OMP_NUM_THREADS.

•	For performance reason, it is recommended to use OMP_NUM_THREADS instead of –nt. This informs the system of the true number of threads used.

•	The total number of processes used for the RADIOSS Engine computation will be equal to SPMD DOMAIN NUMBER * SMP THREAD NUMBER.

General behavior, error handling

•	1- -version 2- -help 3- -input, -nthread, -gpuid, -notrap

•	The argument order in the command line does not matter.

If an error is encountered like:

•	Missing argument to -input or -nthread

•	-input argument is not a RADIOSS file format

•	-nthread argument is not an integer

An error message is printed with the -help printouts.

Coherency between MPI options and RADIOSS options

The -nspmd value (or Nspmd field of /SPMD Starter input card) must match the mpirun –np value. If this is not the case, RADIOSS Engine will stop with an appropriate error message.

Example of incorrect commands:

[user@machine]$ ./s_12.0_linux64 -nspmd 4 -input CRA2V51_0000.rad

[user@machine]$ mpirun -np 2 ./e_12.0_linux64 impi -input CRA2V51_0001.rad

In this case, RADIOSS will display an error message in standard output and listing file:

THE REQUIRED NUMBER OF MPI PROCESSES DOES NOT MATCH MPIRUN

PLEASE, RUN WITH THE PROPER NUMBER OF MPI PROCESSES

REQUIRED (NSPMD) = 4

AVAILABLE (mpirun -np) = 2

E R R O R T E R M I N A T I O N

TOTAL NUMBER OF CYCLES : 0

Example of correct commands:

[user@machine]$ ./s_12.0_linux64 -nspmd 4 -input CRA2V51_0000.rad

[user@machine]$ mpirun -np 4 ./e_12.0_linux64 impi -input CRA2V51_0001.rad

Specify the GPU device to use for the RADIOSS process.

Note:

•	Correct values for IDEVICE must be between 1 and total number of GPU devices matching the executables. For example, between one and the number of Nvidia GPUs for the executable e_12.0_linux64_cuda_impi.

•	If no GPU device is specified, by default, the first device is affected to the first MPI process on the given system, and so on.

•	-gpuid option has no effect for non-GPU executables.

Add this option to force core dump. This is a useful option to get call stack traceback.