STBatch

Version 2010
January 2010

Copyright © ATIR Engineering Software Ltd.

STBatch

Copyright © ATIR Engineering Software Ltd.

All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or
mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the
written permission of the authors.

Products that are referred to in this document may be either trademarks and/or registered trademarks of the
respective owners. The publisher and the author make no claim to these trademarks.

While every precaution has been taken in the preparation of this document, the publisher and the author assume no
responsibility for errors or omissions, or for damages resulting from the use of information contained in this
document or from the use of programs that may accompany it. In no event shall the publisher and the author be
liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or
indirectly by this document.

Disclaimer
The STBatch program has been written by a team of highly qualified engineers
and programmers and have been extensively tested. Nevertheless, the authors
of the software do not assume responsibility for the validity of the results
obtained from the programs or for the accuracy of this documentation

The user must verify his own results

The authors remind the user that the program is to be used as a tool for
structural design and analysis, and that the engineering judgement of the user
is the final arbiter in the development of a suitable model and the interpretation
of the results.

Special thanks to:

All the people who contributed to this document, the programmers, secretaries, STRAP dealers and users.

Last not least, we want to thank EC Software who wrote the help tool called HELP & MANUAL that was used to
create this document.
 Contents 3

Table of Contents
Foreword 0

Part I STBatch - General 4

1 Run file
...................................................................................................................................
format 5
2 Report...................................................................................................................................
file format 7
2.1 Report - com m..........................................................................................................................................................
ands 8
2.2 Report - variables
.......................................................................................................................................................... 11
2.3 Report - param ..........................................................................................................................................................
eters 12
3 Example
................................................................................................................................... 17

Copyright © ATIR Engineering Software Ltd.

3
 4 STBatch

1 STBatch - General
The STBatch program can be used for two purposes:
to generate ASCII files containing STRAP geometry, loads and results data in the format specified by
the user. For example, the format may be suitable for spreadsheet input (delimited) or may be
compatible to the input format requirements of any program. Files may also be generated in tabular
form suitable for printing.
to run models in “batch mode” without using STRAP’s graphic interactive mode. The program is
instructed to solve the model, using either data written in ASCII files, the current geometry/loads, or a
combination of both.

The program is run from the “Command Line” (DOS) without starting STRAP.

The user must create the following ASCII command file to run the program:
Run file
This contains the name/number of the model, the name of the “Report file” (details of the data to be
written in the output file). Refer to Run file - format 5 .

If input/output data is to be written to a file, the following ASCII file must be created:
Report file
An ASCII file that contains a series of commands detailing the data to be written to the output file and
the format in which to write them. Note that the command syntax is very general so that the same
report file can be used for may different models. Refer to Report file - format 7 .

How to use the program :

Create the "Run file" and the "Report file"
Display the Windows “Command line” on the screen (MS-DOS prompt)
type in the command
> stbatch run_file_name and press [Enter]

Note:
The program returns to Windows mode and displays the progress of the program
If the program solves the model, the screen showing the progress of the solution and any warning and/
or error messages is displayed.

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 5

1.1 Run file format

This file lists:
the name/number of the model and its location
the input files to be used
calculations required
the name of the output file and the “Report file” (contains details of the data to be written in the output
file).

The commands in the file are:

MODEL | CURRENT | ( DIR folder_name )
| NEW | ( DIR folder_name ) title
| nnn | ( DIR folder_name )

where:
folder_name = the path name of the folder with the model (does not require “\” at end). The
default is the current working directory
title = model name for - NEW models (must not start with “Dir....” )
nnn = model number (as displayed in right column of STRAP main screen)
Examples:
Create a report for model 27 in folder D:\User1\school :
MOD 27 DIR D:\User1\school
Create a report for a new model titled “Level +1.50" in the current directory:
MOD NEW Level +1.50

GEOM geoin_filename
Specify the geometry input file name.
Note:
The command is optional; if omitted the program will use the current geometry.
If GEOM is included without geoin_filename, the program will use the current [Link] file
the file must be in the [Link] format (refer to Batch Mode - Geometry)
the first line of the file must be either:
REPLACE : the program will use this file instead of the existing geometry, i.e it ignores the
[Link] file
ADD : the program adds the commands in this file to existing geometry; data in
geoin_filename will overwrite the existing data
The program will search for the file in folder_name unless a different path precedes geoin_filename.

LOADS loads_filename
Specify the load input file name.
Note:
The command is optional; if omitted the program will use the current loads.
The LOADS command (without loads_filename) will recalculate the applied loads and should be
included when the geometry has been revised. For example, if section dimensions have been
changed, this command will recalculate self-weight.
The program will search for the file in folder_name unless a different path precedes loads_filename.

Copyright © ATIR Engineering Software Ltd.

6 STBatch

SOLVE
Instruct the program to solve the model.
Note:
The command is optional; if omitted the program will use the current results.
It must be included for NEW models when results are requested in the Report file

REPORT report_filename| output_filename |

| *.ext header |
| * header |

Specify the names of the output file and report file.

Note:
The output_filename can have one of the following formats:
a file name
*.ext header - the program will prompt the user for a the name of a file with extension “ext”. The
header of this prompt will be “title”
* title - the program will prompt the user for a the name of a file (no default extension). The
header of this prompt will be “title”.
Refer to the following examples.

END
Must be the last command in the file

Examples:
Create an output file for the current model in the current folder with the data format in file REPORT1.
DAT. Use the current geometry, loads and results . The program should prompt for the output file
name (with extension DAT).
MODEL CURRENT
REPORT [Link] *.DAT STBatch : output file name
END
Create a new model from geometry and load batch files in a different folder. Generate two reports and
prompt for the output file names (no default extension)
MODEL NEW DIR D:\USER1
GEOM [Link]
LOADS [Link]
SOLVE
REPORT [Link] *.DAT STBatch : output file name
REPORT [Link] *.DAT STBatch : output file name
END
Generate an output file [Link] for model 47 in the current directory. Read geometry from the
[Link] and recalculate the applied loads.
MODEL 47
GEOM
LOADS
REPORT [Link] [Link]
END

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 7

1.2 Report file format

The report file specifies the data type and format to be written to the output file.

The general format for the file is:

[SECTIONS]
.
data format for each section type; used when writing section data in the [REPORT] section
.
[REPORT]
.
#IF a condition is met
#LOOP on a data type
.
write specified data to file in specified format
.
# ENDLOOP
#ENDIF
.
more #IF, #LOOP
.
[END]

[SECTIONS]
This section specifies the format for the beams section types output. When the program encounters a
#PROP_DEF command in [REPORT], it determines the section type and uses the relevant format
defined in [SECTIONS]

Format:

#TYPE type_name
.
output format for type_name
.
#END TYPE

The command is repeated for every section type required.

type_name can be one of:

Computed sections : RECT PIPE [ L I TUBE T CIRCLE
Section from table: : TABLE followed by one of -
I [ RHS L T PIPE 2L 2[ I+[ I_UNEQUAL L_EDGE_TO_EDGE I+PLATE
[+[ 2[FACE_TO_FACE I+I I+H
- or -
TABLE ALL for Table sections not included in [SECTIONS]
Cold formed sections : COLD followed by one of -
[ [+LIP HAT L Z Z+LIP
All other sections : OTHER
For details on the output format for each type_name, refer to Report file - parameters 12 .

Copyright © ATIR Engineering Software Ltd.

 8 STBatch

[REPORT]
The report file consists of lines with commands and parameters. All lines that are not commands will be
written to the output file as the appear in the report file (including punctuation), but the parameters will be
replaced by the model data.
All parameters and commands start with the character #. A different character may be selected (refer
to Report - commands 8 ) , but # will be used in this manual.

1.2.1 Report - commands

The following commands exist:
#IF
format:
#IF condition
.
... commands that are executed if condition is True ...
.
#ELSE (optional)
.
... commands that are executed if condition is False ...
.
#ENDIF

The following conditions are available:

Condition True if -
#IF NODE nodes have been defined
#IF BEAM beams have been defined
#IF ELEMENT elements have been defined
#IF SOLID solids have been defined
#IF REST restraints have been defined
#IF MATERIAL materials have been defined
#IF PROPERTY properties have been defined
#IF COMPOSITE current property is composite
#IF OFFSET offsets have been defined
#IF LOAD loads have been defined
#IF COMB combinations have been defined
#IF SPRING springs have been defined
#IF SYST local restraints systems have been defined
#IF RESULTS results have been calculated
Note:
- the #IF commands can be nested

#LOOP
format:
#LOOP looptype
.
.
#ENDLOOP

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 9

For example, if the loop type is NODES the program will loop on all nodes in the model and write the
lines in the loop to the output file for each node. The parameters will be replaced with the values for the
current node.

Loops may not be nested except the BYLOAD loop that may be inside a results loop (see below).

The following loop types exist:

looptype Loops on all ...
#LOOP NODES nodes
#LOOP BEAMS beams
#LOOP ELEMENTS elements
#LOOP SOLIDS solids
#LOOP RESTRAINT nodes with restraints
#LOOP MATERIAL materials
#LOOP PROPERTY defined properties
#LOOP OFFSETS offset types
#LOOP SYSTEM local restraints systems
#LOOP SPRING nodes with springs
#LOOP LOAD loads. Not used for results - only for displaying load case titles
#LOOP COMB combinations. Not used for results - only for displaying combination titles
#LOOP DEFLECT nodes for deflection results
#LOOP REACTIONS nodes with reactions
#LOOP SPDEFLEC beams, for span deflection
#LOOP AXIAL beams, for axial stresses
#LOOP SPSTRESS spring stresses
The result files contain only node results and all beam/element results must be computed:
#LOOP BRESULT (NEEDS (FORCES) ( DEFLECT) (AXIAL))
loops on all beams results. If the loop includes parameters for various beam results then the relevant
NEEDS must be added so that the program will compute them.

#LOOP ERESULT {NEEDS (MOMENT) (FORCE) (STRESS) (S-) (PRINCP-) (WOOD) (Q) (AREA) (NODES))
loops on elements results. If the loop includes parameters for various element results then the
relevant NEEDS must be added so that the program will compute them. If NODES is specified then
results at nodes will be available.

#LOOP SOLRESUL (NEEDS (STRESSES) (PRINCIPAL) (NODES))

loops on solid results. If the loop includes parameters for various solid element results then the
relevant NEEDS must be added so that the program will compute them. If NODES is specified then
results at nodes will be available.

#LOOP BYLOAD
All result loops by default assign the value of envelope results to the parameters. If results for each
load combination are required, add a #LOOP BYLOAD command inside the result loop. This is the
only case where nested loops are allowed.
If no combinations were defined, the #LOOP BYLOAD will display the results for load cases.

Copyright © ATIR Engineering Software Ltd.

10 STBatch

#SET
The #SET commands define the values of general parameters. A command applies to all lines following
it.

The following #SET commands may be written in the file:

#SET COMMAND char

This command instructs the program that char will be at the start of all following command lines and
parameters instead of #. A-Z, a-z and 0-9 cannot be specified.
For example:
#SET COMMAND &
&SET UNITS ........ (#SET UNITS . will not be considered a command)

#SET UNITS LENGTH {M CM MM IN FEET USER}

#SET UNITS WEIGHT {TON KG KN GRAM POUND KIP NEWTON USER}
Revise the length and force units, where USER returns to the units defined by the user in the
geometry

#SET NAME UNITS { M CM MM IN FEET TON KG KN GRAM POUND KIP NEWTON) name
Defines the text written in the output file for the unit variable specified. The default is the complete unit
name. For example, to write “mm.” instead of “millimeter”, write the command:
#SET NAME UNITS MM mm.

#SET FORMAT n1.d1 n2.d2 ….

Specify the format for real numbers in the output line where n1.d1 specifies the format for the first real
no., n2.d2 for the second, etc.

Note:
n1 = the total length of the number (including the decimal point and minus sign), d1 = is the no.
of digits after decimal point. For example, F7.3 is adequate for 123.456 or -12.345
If there are more numbers than formats, the last format applies to all the rest.
If the total length of a number with d1 digits exceeds n1, less digits will be added after the decimal.
For example, 12345.678 will be written as 12345.7 for F7.3.
The number will be padded with leading blanks if shorter.

#SET ZERO {YES NO}

if NO (default), integers with 0 value will not be written to the file.

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 11

1.2.2 Report - variables

Up to 99 variables may be defined for use in other commands. Each variable is defined in the form of an
equation; the program calculates the actual value before it is used. For example, variables can be used
when an item has a different value for every cycle in a loop.
Variable definitions may also be retrieved from the [Link] file.

Define a variable:
format: #DEFINE |R| n | equation |
|I | | INI |
|S|
where:
R : the variable is a ‘real’ value
I : the variable is an integer
S : the variable is a string (may be defined only in the [Link] file)
n = the variable number (1 to 99)
equation = equation used by the program for calculating the value of the variable is defined in the
report
INI = equation is retrieved from the [Link] file

Equations may include:

parameters
arithmetic functions: + - * /
math functions: ATAN ACOS ASIN LN TAN COS SIN ABS
a numerical value
a variable
A blank space must be entered before and after any of the arithmetic functions.

Example:
#DEFINE R 2 #BRES_M3 * #BEAM_C11 * 2.1

Initial values may be assigned to variables in the [Link] file, under the header [STBATCH], with the
format:
VARn=value

Equations cannot be stored in the file.

Use a variable:
Insert one of the following in the report line:
#VAR_Rn
#VAR_In

Example: Generate a table of beams, where each row is numbered sequentially, starting with 1:
#DEFINE I 1 0
.
#LOOP BEAMS
#DEFINE I 1 #VAR_I1 + 1
#VAR_I1 ...........
#ENDLOOP

Copyright © ATIR Engineering Software Ltd.

 12 STBatch

1.2.3 Report - parameters

The following parameters may be used. Most parameters can only be used inside certain loops as will
be indicated:
NODES
The node parameters are relevant for the following loops:
NODES, RESTRAINTS, SPRINGS, DEFLECTIONS, REACTIONS, SPRING STRESSES
Parameter Displays:
#NODE_NO node number
#NODE_X1, #NODE_X2, #NODE_X3 3 node coordinates
#NODE_R1, ..... , #NODE_R6 restraints in 6 directions - 0 if not restrained, 1 if restrained
#NODE_SYSTEM_NO restraint system no. for the node or 0 if no system.
#NODE_S1, ..... , #NODE_S6 spring values in 6 directions
BEAMS
The beam parameters are relevant for following loops:
BEAMS, BRESULT, SPDEFLEC, AXIAL
Parameter Displays:
#BEAM_NO beam no.
#BEAM_JA, #BEAM_JB beam end nodes
#BEAM_JC JC node of the beam or 0 if beta angle defines dir.
#BEAM_BETA Beta angle in degrees. Is defined even if direction is defined by JC
#BEAM_OFFSET_NO beam offset no.
#BEAM_RA, #BEAM_RJ, }
#BEAM_M2A, #BEAM_M3A, } the releases of the beam in each direction
#BEAM_M2B, #BEAM_M3B, } - 0 if not released
#BEAM_V2A, #BEAM_V3A, } - 1 if released in this direction
#BEAM_V2B, #BEAM_V3B }
#BEAM_PROPERTY_NO property no. for the beam
#BEAM_MATERIAL_NO material no. for the beam
#BEAM_LENGTH length of the beam
#BEAM_O1A, #BEAM_O2A, #BEAM_O3A offsets in beam JA in local coordinates
#BEAM_O1B, #BEAM_O2B, #BEAM_O3B offsets in beam JB in local coordinates
SYSTEM
The offset parameters are relevant for following loops: SYSTEM
Parameter Displays:
#SYS_NO restraints system no.
#SYS_JA, #SYS_JB, #SYS_JC 3 nodes defining the coordinate system.
#SYS_U1, #SYS_U2, #SYS_U3 unit vector in system X1 direction.
#SYS_V1, #SYS_V2, #SYS_V3 unit vector in system X2 direction.
#SYS_W1, #SYS_W2, #SYS_W3 unit vector in system X3 direction.
ELEMENTS
The element parameters are relevant for following loops: ELEMENTS and ERESULT
Parameter Displays:
#ELE_NO element number.
#ELE_TYPE 3 if a triangle, 4 if a quad.
#ELE_JA, #ELE_JB, #ELE_JC, #ELE_JD 4 element nodes. JD=0 for a triangle
#ELE_THICKNESS element thickness. (in model units)
#ELE_PROPERTY_NO property number for the element.
#ELE_MATERIAL_NO material no. for the element.
#ELE_AREA area of the element.

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 13

#ELE_R1, #ELE_R2, #ELE_R3, #ELE_R4 1if the edge is released, 0 otherwise

SOLIDS
The solids parameters are relevant for following loops: SOLID and SOLRES
Parameter Displays:
#SOLID_NO solid no.
#SOLID_JA, .... , #SOLID_JH solid 8 corner nodes.
#SOLID_MATERIAL_NO material no. for the solid.
#SOLID_NNODES no. of nodes in the solid.
#SOLID_VOLUME volume of the solid.
OFFSETS
The offset parameters are relevant for following loops: OFFSET
Parameter Displays:
#OFF_NO offset no.
#OFF_X1A, #OFF_X2A, #OFF_X3A, }
#OFF_X1B, #OFF_X2B, #OFF_X3B } offset in 3 directions at both ends.
#OFF_TYPE 1 = offset is in local coordinates; 2 = global.
MATERIALS
The material parameters are relevant for following loops: MATERIALS loop and in all loops were
BEAMS or ELEMENTS can be used.
Parameter Displays:
#MAT_NO material no.
#MAT_E , #MAT_PR, #MAT_DENSITY, }
#MAT_ALPHA, #MAT_G, #MAT_NAME } material properties.
PROPERTIES
The properties parameters are relevant for following loops: PROPERTY loop and in all loops were
BEAMS can be used.
#PROP_DEF - the format defined in [SECTIONS] will be used for the current property. Refer to
Report file - format 7
Parameter Displays:
#PROP_NO property no.
#PROP_A , #PROP_I2, }
#PROP_I3, #PROP_J , } property values
#PROP_SF2,#PROP_SF3 }
#PROP_TYPE -1 = property from table,
1= rectangle, 2 = pipe, 3 = tube, 4 = L, 5 = I, 6 = U, 7 = T, 8 =
CIRCLE
#PROP_MATERIAL_NO section type for section from table (1 I, 2 [, 3 RHS, 4 L, 5 T, 6 pipe, 7
#PROP_SEC_TABLE_TYPE 2L, 8 2[, 9 I+[, 10 - combined section, 12 I unequal flanges)
#PROP_CWIDTH topping width for composite section
#PROP_CHEIGHT topping height.
#PROP_CDIST topping distance to section.
#PROP_CERATIO ratio between E of concrete and E of steel.
#PROP_CMAT_NO material no. for topping.
#PROP_COMPOSITE 0 = normal section; 1 = composite
#PROP_TNAME_TABLE name of section type if from table.
#PROP_NAME_TABLE name of the section if from table.
#PROP_MAJOR 2 = M2 is about major axis; 3 = M3 about major axis.

Copyright © ATIR Engineering Software Ltd.

14 STBatch

The following are the dimensions for computed I,[,L,T sections.

#PROP_TW, #PROP_H, #PROP_TF (default - all flanges),
#PROP_TFD (bottom flange), #PROP_TFUR (top flange - right), #PROP_TFDR (bot. flange - right),
#PROP_BF (total length - top flange), #PROP_BFUL (length of top flange- left),
#PROP_BFUR (length of top flange - right), #PROP_BFD (total length - bottom flange),
#PROP_BFDL (length of bottom flange- left), #PROP_BFDR (length of bottom flange - right),

The following are dimensions for computed rectangle, tube, pipe, circle sections.
#PROP_B , #PROP_H, #PROP_T.

The following are for sections from table. The dimensions ending with 2 are for the second section in
combined sections.
#PROP_H, #PROP_TW, #PROP_BF, #PROP_TF, #PROP_RAD, #PROP_DIS, #PROP_H2, #PROP_TW2,
#PROP_BF2, #PROP_T1, #PROP_B1, #PROP_T2,#PROP_B2, #PROP_LIP
COMBINATION
The combination parameters are relevant for following loops: COMBINATION
Parameter Displays:
#COMB_NO combination no.
#COMB_L1, ....., #COMB_L16 loads no. in the combination (1 to 16)
#COMB_F1, ....., #COMB_F16 factors for each load case.
#COMB_NAME combination name.
LOADS
The loads parameters are relevant for following loops: LOAD
Parameter Displays:
#LOAD_NO load no. Can be used also in any BYLOAD loop and indicates the current load/
combination no.
#LOAD_NAME can be used only in the LOAD loop.
DEFLECTIONS
The deflection parameters are relevant for following loops: DEFLECT
Parameter Displays:
#DEFL_X1-#DEFL_X6 If outside the BYLOAD loop - indicates the maximal deflections. Inside the
BYLOAD loop - the deflection for the current load case.
BEAM RESULTS
The Beam result parameters are relevant for following loops: BRESULT

#BRES_AX, #BRES_V2, #BRES_V3, #BRES_MT, #BRES_M2, #BRES_M3

maximum results outside the BYLOAD loop, results at JA inside the BYLOAD loop.

#BRES_AXB-#BRES_M3B
minimum results outside the BYLOAD loop, results at JB inside BYLOAD.

#BRES_P (axial force), #BRES_PA (axial stress),

#BRES_PO2, #BRES_PO3 (x2/x3 axial stresses multiplied by omega)
can be used only if NEEDS AXIAL was defined in the loop command.

#BRES_DX2, #BRES_DX3
x2/x3 span deflections - can be used only if NEEDS DEFLECTION was defined in the LOOP
command.

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 15

REACTIONS
The Reaction parameters are relevant for following loops: REACTIONS
#REAC_X1, ..., #REAC_X6
maximum reactions outside the BYLOAD loop; reactions inside the loop.
#REAC_X1NEG, ..., #REAC_X6NEG
Minimum reactions; can be used only outside the BYLOAD loop.
ELEMENT RESULTS
The Element result parameters are relevant for following loops: ERESULTS
#ERES_MX, #ERES_MY, #ERES_MXY
Maximum result outside the BYLOAD loop, results at center inside the loop.

#ERES_MXA, #ERES_MYA, #ERES_MXYA

Minimum result outside the BYLOAD loop, results at JA inside the loop.
Inside the loop, use suffix B or C or D instead of A for nodes JB, JC, JD.
#ERES_FX, #ERES_FY, #ERES_FXY - FX,FY,FXY at centre
#ERES_FXA, #ERES_FYA, #ERES_FXYA
FX,FY,FXY at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.

#ERES_SX, #ERES_SY, #ERES_SXY SX,SY,SXY at +Z face at center

#ERES_SXA, #ERES_SYA, #ERES_SXYA
SX,SY,SXY at +Z face at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.

#ERES_SX-, #ERES_SY-, #ERES_SXY- SX,SY,SXY at -Z face at center

#ERES_SX-A, #ERES_SY-A, #ERES_XY-A
SX,SY,SXY at -Z face at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.
(Note the syntax #ERES_XY-A to #ERES_XY-D for SXY- at A to D)

#ERES_PMX, #ERES_PMN, #ERES_SMX, #ERES_ANG - principal stresses and max. shear at +z face
#ERES_PMXA, #ERES_PMNA, #ERES_SMXA, #ERES_ANGA
principal stresses and max. shear at +Z face at JA. Use suffix B or C or D instead of A for nodes
JB, JC, JD.

#ERES_PMX-, #ERES_PMN-, #ERES_SMX-, #ERES_ANG- - principal stresses and max. shear at -z face
#ERES_PX-A, #ERES_PN-A, #ERES_SM-A, #ERES_AN-A
principal stresses and max. shear at -Z face at JA. Use suffix B or C or D instead of A for nodes JB,
JC, JD. (Note the syntax #ERES_PX-A, #ERES_PN-A, etc)

#ERES_MX*, #ERES_MY* - Wood & Armer results at +Z at centre

#ERES_MX*A, #ERES_MY*A
Wood & Armer results at +Z face at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.

#ERES_MX*-, #ERES_MY*- - Wood & Armer results at -Z at centre

#ERES_X*-A, #ERES_Y*-A
Wood & Armer results at -Z face at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.
(Note the syntax #ERES_X*-A, #ERES_Y*-A, etc)

#ERES_QX, #ERES_QY - shear forces at centre

#ERES_QXA, #ERES_QYA
shear forces at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.

#ERES_ASX, #ERES_ASY - Reinforcement area at +Z at centre

Copyright © ATIR Engineering Software Ltd.

16 STBatch

#ERES_AXA, #ERES_AYA
reinforcement at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.

#ERES_ASX-, #ERES_ASY- - Reinforcement area at -Z at centre

#ERES_AX-A, #ERES_AY-A
reinforcement at JA. Use suffix B or C or D instead of A for nodes JB, JC, JD.
(Note the syntax #ERES_AX-A, #ERES_AY-A)
SOLID RESULTS
The Solid result parameters are relevant for following loops: SRESULT

#SRES_SX, #SRES_SY, #SRES_SZ, #SRES_SXY, #SRES_SYZ, #SRES_SZX

maximum results outside the BYLOAD loop, results at center inside the loop.
#SRES_SXA, #SRES_SYA, #SRES_SZA, #SRES_XYA, #SRES_YZA, #SRES_ZXA
can be used only outside the BYLOAD loop - minimum results.

SPRING STRESSES
The Spring stress parameters are relevant for following loops: SPSTRESS
#SPRES_X1-#SPRES_X6 maximum results outside the BYLOAD loop; stresses inside
the loop.
#SPRES_X1NEG-#SPRES_X6NEG can be used only outside the BYLOAD loop - minimum
stresses.
GENERAL PARAMETERS
These parameters can be used outside loops:
Parameter Displays:
#_HIBEAM highest beam no. or element no.
#_BEAM_NUMBER number of beams.
#_HINODE highest node no.
#_NODE_NUMBER number of nodes
#_ELE_NUMBER number of elements
#_HISOLID highest solid element no.
#_SOLID_NUMBER number of solid elements
#_HIPROPERTY highest property no.
#_PROPERTY_NUMBER number of properties
#_TYPE_OF_MODEL 0 = space, 1 = truss, 2 = plane frame, 3 = grid.
#_SYSTEMS_NUMBER number of restraint systems.
#_SPRINGS_EXIST 0 = no springs, 1 = springs defined
#_SLAVE_HI Number of rigid links
#_MATERIAL_NO Highest material no.
#_WUNITS weight units as defined in the SET command.
#_LUNITS length units as defined in the SET command.
#_TITLE Model title

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 17

1.3 Example
The following is a sample report file. An example of the output follows. Note that all text (commands or
parameters) not preceded by a # is written as it appears in the file, including all punctuation and text in a
line starting with a #.

[SECTIONS]
#TYPE RECT
#IF COMPOSITE
#PROP_NO,,45,#PROP_MAT,#PROP_MAJOR
#PROP_H,PROP_B,,,,,,,,,#PROP_CWIDTH,#PROP_CHEIGHT,#PROP_CDIST,#PROP_CMAT
#ELSE
#PROP_NO,,46,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_B
#ENDIF
#END TYPE

#TYPE I
#IF COMPOSITE
#PROP_NO,,1,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_BFD,#PROP_TFD,,,,,#PROP_CWIDTH,
#PROP_CHEIGHT,#PROP_CDIST,#PROP_CMAT
#ELSE
#PROP_NO,,50,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_BFD,#PROP_TFD
#ENDIF
#END TYPE

#TYPE TUBE
#PROP_NO,,3,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_T,#PROP_B
#END TYPE
#TYPE PIPE
#PROP_NO,,6,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_T
#END TYPE

#TYPE L
#PROP_NO,,4,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF
#END TYPE

#TYPE TABLE I
#IF COMPOSITE
#PROP_NO,"#PROP_TNAME #PROP_NAME",1,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_BF,#PROP_TF,,,,,#PROP_CWIDTH,#PROP_CHEIGHT,
#PROP_CDIST,#PROP_CMAT
#ELSE
#PROP_NO,"#PROP_TNAME #PROP_NAME",50,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_BF,#PROP_TF
#ENDIF
#END TYPE

#TYPE TABLE [
#PROP_NO,"#PROP_TNAME #PROP_NAME",2,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF

Copyright © ATIR Engineering Software Ltd.

18 STBatch

#END TYPE
#TYPE TABLE RHS
#PROP_NO,"#PROP_TNAME #PROP_NAME",3,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF
#END TYPE

#TYPE TABLE L
#PROP_NO,"#PROP_TNAME #PROP_NAME",4,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF
#END TYPE

#TYPE TABLE PIPE

#PROP_NO,"#PROP_TNAME #PROP_NAME",6,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW
#END TYPE

#TYPE COLD [
#PROP_NO,"#PROP_TNAME #PROP_NAME",19,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_RAD
#END TYPE

#TYPE COLD [+L

#PROP_NO,"#PROP_TNAME #PROP_NAME",23,#PROP_MAT,#PROP_MAJOR
#PROP_H,#PROP_TW,#PROP_BF,#PROP_TF,#PROP_RAD,#PROP_LIP
#END TYPE

[REPORT]
UNITS
1, #_LUNITS , #_WUNITS
2, #_LUNITS , #_WUNITS

NODES
#LOOP NODES
#NODE_NO , #NODE_X1 , #NODE_X2 , #NODE_X3
#ENDLOOP

RESTRAINTS
#LOOP RESTRAINTS
#NODE_NO ,#NODE_R1,#NODE_R2,#NODE_R3,#NODE_R4,#NODE_R5,#NODE_R6,#NODE_SYSTEM
#ENDLOOP

MATERIALS
#LOOP MATERIALS
#MAT_NO,"#MAT_NAME",#MAT_E,#MAT_PR,#MAT_DENS,#MAT_ALPHA,#MAT_G
#ENDLOOP

#SET UNITS LENGTH CM

PROPERTIES
#LOOP PROPERTIES
#PROP_DEF
#ENDLOOP
#SET UNITS LENGTH USER

#IF OFFSET
OFFSET

Copyright © ATIR Engineering Software Ltd.

 STBatch - General 19

#LOOP OFFSET
#OFF_NO,#OFF_TYPE,#OFF_X1A,#OFF_X2A,#OFF_X3A,#OFF_X1B,#OFF_X2B,#OFF_X3B
#ENDLOOP
#ENDIF

#IF BEAMS
BEAMS
#LOOP BEAMS
#BEAM_NO,#BEAM_JA,#BEAM_JB,#BEAM_BETA,#BEAM_RA,#BEAM_RJ,#BEAM_M3A,#BEAM_V2A,
#BEAM_M3B,#BEAM_V2B,#BEAM_PROP,#BEAM_OFFSET
#ENDLOOP
#ENDIF

#IF SPRINGS
SPRINGS
#LOOP SPRINGS
#NODE_NO,#NODE_S1,#NODE_S2,#NODE_S3,#NODE_S4,#NODE_S5,#NODE_S6,#NODE_SYSTEM
#ENDLOOP
#ENDIF

#IF RESULTS
LOADS
#LOOP LOADS
#LOAD_NO,#LOAD_NAME
#ENDLOOP
#LOOP DEFLECTION
#LOOP BYLOAD
#NODE_NO,#LOAD_NO,#DEFL_X1,#DEFL_X2,#DEFL_X3,#DEFL_X4,#DEFL_X5,#DEFL_X6
#ENDLOOP
#ENDLOOP

#IF BEAMS
BEAM RESULTS
#LOOP BRESULTS NEEDS FORCES
#LOOP BYLOAD
#BEAM_NO,#LOAD_NO,#BEAM_JA,#BRES_AX,#BRES_V2,#BRES_V3,#BRES_MT,#BRES_M2,#BRES_M3
#BEAM_NO,#LOAD_NO,#BEAM_JB,#BRES_AXB,#BRES_V2B,#BRES_V3B,#BRES_MTB,#BRES_M2B,
#BRES_M3B
#ENDLOOP
#ENDLOOP
#ENDIF

REACTIONS
#LOOP REACTIONS
#LOOP BYLOAD
#NODE_NO,#LOAD_NO,#REAC_X1,#REAC_X2,#REAC_X3,#REAC_X4,#REAC_X5,#REAC_X6
#ENDLOOP
#ENDLOOP
#ENDIF
[END REPORT]

Copyright © ATIR Engineering Software Ltd.

20 STBatch

The following is the output generated by the above file for a model consisting of a simply supported
beam:

UNITS
1, meter , ton
2, meter , ton

NODES
1 , 0.000 , 0.000 , 0.000
2 , 5.000 , 0.000 , 0.000

RESTRAINTS
1 ,1,1,1,1,1,1,

MATERIALS
1,"CONC",3000000.00,0.150,2.400,0.000010,1304347.88

PROPERTIES
1,,46,1,1
60.000,30.000

BEAMS
1,1,2,330.00,,,,,,,1,

LOADS
1,TEST1
1,1,0.000000,0.000000,0.000000,0.000000,0.000000,0.000000
2,1,0.000139,-0.004231,0.002443,0.000000,-0.000643,-0.001114

BEAM RESULTS
1,1,1,-150.000,50.000,0.000,0.000,0.000,125.000
1,1,2,150.000,0.000,0.000,0.000,0.000,0.000

REACTIONS
1,1,-150.000,43.301,-25.001,0.000,62.501,108.252

Copyright © ATIR Engineering Software Ltd.