Starter Keywords Syntax

Block Format Keyword

This section describes the general syntax rules for writing a Radioss Block Format input deck, including the Block Format syntax, required keywords, keyword examples, fixed format input, and default values.

These rules apply to all the options, which are individually defined in this manual.

Block Format Syntax

Each block begins with a forward slash (/), followed by a keyword and ends at the beginning of the next block.

As of Radioss V4, the blocks can be entered in any order except for:
  • /BEGIN - This must be the first keyword entered, see next section for more details.
  • /TRANSFORM - When multiple transformations are used, the transformation is applied in the order of the input.
  • /END - This is the last keyword read. Any input entered after will be ignored.

Each block defines one option, a set of flags or switches, or a set of nodes or elements.

The input deck finishes with the /END keyword.

The content of each block is entered in fixed format (see below).

Blank lines at the end of each block are ignored.

Lines with a # or $ in the first column are comment lines except for these 3 special options that begin with a #: #RADIOSS STARTER, #enddata, and #include.

Required Keywords

The first line of the input deck must be the header line with which starts with #RADIOSS STARTER followed by the /BEGIN keyword as shown here. Any number of comment lines that start with # or $ can be inserted between these two commands. The last keyword in a file should be /END.
#RADIOSS STARTER
#---1----|----2----|----3----|----4----|----5----|----6----|----7----|----8----|----9----|---10----|
#New drop test model
/BEGIN
Drop                                                                        
      2017         0
                   g                  mm                  ms
                   g                  mm                  ms  
...
...
/END

General Keyword Formats

There are 3 general keyword formats

General Flags, Switches, Global Parameters or Title
Syntax:
/KEYWORD
flag1      flag2      flag3 ...

Example: Global Parameters

Table 1. /IOFLAG
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
Ipri Irtyp   Ioutp OutyyFMT Irootyy       Irtyp_r
Keyword Definition with Numeric Option Identifier
Syntax:
/OPTION_KEYWORD[/SUBKEYWORD/…]/option_ID[/unit_ID]
option_title
option input ...

The option_ID is defined and the option_title is associated to this option_ID in the first line.

If the same option is used several times, a different option_ID and a different option_title have to be used each time.

The option_title can have a maximum of 100 characters and must not start with a forward slash ( / ).

Example: Keyword with option_ID

/IMPVEL/impvel_ID/unit_ID

impvel_title
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
fct_ID Dir Skew_ID sens_ID grnd_ID frame_ID        
Fscalex Fscaley Tstart Tstop  
Keyword Option without Numeric Option Identifier
Syntax:
/OPTION_KEYWORD[/SUBKEYWORD/…]/reference_ID[/unit_ID]
…
option input
…
Example 1: Keyword without Option
Table 2. /NODE/unit_ID
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
node_ID Xc Yc Zc      

The nodes can be defined in one or more blocks.

Example 2: Keyword without Option
Table 3. /SHELL/part_ID
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
Ishell node_ID1 node_ID2 node_ID3 node_ID4       Thick

In the above syntax, the part_ID is only used for element definition; but it is not defined in this block.

The part_ID's are defined in /PART option.

The list of elements belonging to one part can be defined in one or more blocks.

Example 3: Keyword without Option

/FAIL/Key/mat_ID/unit_ID

Submodel option
//SUBMODEL/submodel_ID/unit_ID
submodel_title
…
option input
…
//ENDSUB

Block Keyword Input Fixed Format

The content of any block is formatted in lines of 100 characters, divided into 10 fields of 10 characters.

A typical input line is described in this manual as:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
                   

The first row of the table gives the fields number. The second row shows the variables description.

Only the field with defined input should be used. All other fields and blank formats are reserved and must not be used. Users should not put comments in the fields that are not used, but instead should use comment lines that begin with a “#” or “$”.

Default Values

Any input field that is blank or a zero entered will use the default value listed in the manual. For example, when using an imposed displacement it is possible to scale the x and y values of the input curve. The default values are Scale_x=1 and Scale_y=1. In this example, Scale_x=0 and Scale_y = blank means that the default value of Scale_x=1 and Scale_y=1 is used by the solver.
/IMPDISP/7
compression
#   Ifunct       DIR     Iskew   Isensor   Gnod_id     Frame
         4         X                          1150         
#            Scale_x             Scale_y              Tstart               Tstop
                   0                  

The actual values used by the solver are written to the Starter output file, Runname_0000.out. For real number fields with default values that are not zero, it is not possible to define the field as zero since this would cause the default value to be used. Therefore, if a zero numerical value is needed a very small number, i.e. 1e-30, can be used as a zero-value entry.

Field Entry Input

  • All integers are given in one 10 digit field with a maximum of 9 digits.
  • All reals are entered in two fields with a maximum of 20 digits.
  • Characters can have variable length, the maximum length is given for each entry.
  • For boundary conditions, single-digit booleans (value 0 or 1) are used. The format is in this case, given by showing the place of each boolean in the field (see table below).
For example, on the line below the first field is defined as an integer, followed by six booleans, and then one real. The last six fields are unused. The position of the six booleans is given in the second table. A text is defined on a line (10 fields, 100 characters maximum).
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
Integer Boolean Real            
(2)-1 (2)-2 (2)-3 (2)-4 (2)-5 (2)-6 (2)-7 (2)-8 (2)-9 (2)-10
      VX VY VZ   ω X ω Y ω Z
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
Character