Starter Command Line Argument

The RADIOSS Starter supports the following command line arguments.

Argument	Short form	Description
-help	-h	Print help message
-version	-v	Print RADIOSS release information
-input [FILE]	-i	Set RADIOSS Starter input file
-nspmd [INTEGER]	-np	Set number of SPMD domains
-nthread [INTEGER]	-nt	Set number of threads per SPMD domains
-notrap		Disable error trapping

Prints help information on the command line arguments.

RADIOSS Starter exits after the printout.

Example:

[user@machine]$ ./s_12.0_linux64 -help RADIOSS Starter version 12.0
-help	/ -h	: Print this message
-version	/ -v	: Print RADIOSS release information
-input [FILE]	/ -i [FILE]	: Set RADIOSS Starter input file
-nspmd [INTEGER]	/ -np [INTEGER]	: Set number of RADIOSS SPMD domains
-nthread [INTEGER]	/ -nt [INTEGER]	: Set number of SMP threads per SPMD domain
-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 Starter exits after the printout.

Example:

[user@machine]$ ./s_12.0_linux64 -version

RADIOSS Starter version 12.0

Platform release:

linux64

Radflex name:

radflex12_linux

Use Radflex version:

100090402 or higher

Time of build:

18:28:32

Date of build:

08/12/09

Build tag:

0479348_2413000

Sets the RADIOSS Starter input file.

The FILE argument must be a RADIOSS Starter 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.

e.g. CRA2V51_0000.rad

ROOTNAME: CRA2V51

RUN NUMBER: 0000

Note:

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

•	The dataset ROOTNAME and RUN NUMBER settings in /BEGIN 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 Starter opens standard input to read input.

Example:

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

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

** **

** RADIOSS STARTER 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. **

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

.. BLOCK FREE FORMAT

CRA2V51

.. CONTROL VARIABLES

.. UNITS SYSTEM

.. MATERIALS

.. NODES

.. PROPERTIES

.. 3D SHELL ELEMENTS

.. SUBSETS

.. ELEMENT GROUPS

.. NODE GROUP

.. BOUNDARY CONDITIONS

.. INITIAL VELOCITIES

.. ELEMENT GROUPS

.. ADDED MASSES

.. ELEMENT BUFFER INITIALIZATION

.. GEOMETRY PLOT FILE

.. RESTART FILE

NORMAL TERMINATION

------------------------

0 ERROR(S)

0 WARNING(S)

PLEASE CHECK LISTING FILE FOR FURTHER DETAILS

[user@machine]$

Sets the number of SPMD domains.

Where:

SPMD DOMAIN NUMBER: INTEGER is the number of SPMD domains

Example:

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

Note:

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

•	If -nspmd is set, the number of domains set in /SPMD input card is ignored. /SPMD card can be omitted, if other parameters are kept as default settings.

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

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]$ ./s_12.0_linux64 -nthread 2

Note:

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

•	If -nthread is set, the number of threads set in /SPMD input card is ignored. /SPMD card can be omitted if other parameters are kept as default settings.

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

Disables the trapping error of RADIOSS Starter.

By default, in case of error, RADIOSS Starter will display an error message that corresponds to the error occurred and stop properly. If –notrap is used, RADIOSS Starter will continue and potentially core dumps where the error occurs. This behavior is sometimes helpful to trace the error with external tools.

General behavior, error handling

•	1- -version 2- -help 3- -nspmd, -input, -nthread, -notrap Arguments 1, 2 and 3 cannot be used together

•	-nspmd, -nthread, -notrap and -input can be used together; and the order does not matter.

If an error is encountered like:

•	Missing argument to -input or –nspmd or -nthread

•	-input argument is not a RADIOSS file format

•	-nspmd or –nthread argument are not an integer value

•	unknown command line argument used

An error message is printed out with the -help printouts.

Example:

[user@machine]$ ./s_12.0_linux64 -nspmd foo -input foo *** ERROR in "-nspmd" argument: "foo" is not an integer value RADIOSS Starter version 12.0 Command line arguments help:
-help	/ -h	: Print this message
-version	/ -v	: Print RADIOSS release information
-input [FILE]	/ -i [FILE]	: Set RADIOSS Starter input file
-nspmd [INTEGER]	/ -np [INTEGER]	: Set number of RADIOSS SPMD domains
-nthread [INTEGER]	/ -nt [INTEGER]	: Set number of SMP threads per SPMD domain
-notrap		: Disable error trapping

[user@machine]$