Sunteți pe pagina 1din 143

SOFiSTiK

Basics
SOFiSTiK 2016

SOFiSTiK
Basics
SOFiSTiK Manual, Version 2016-0
Software Version SOFiSTiK 2016
c 2015 by SOFiSTiK AG, Oberschleissheim, Germany.
Copyright

SOFiSTiK AG
HQ Oberschleissheim
Bruckmannring 38
85764 Oberschleissheim
Germany

Office Nuremberg
Burgschmietstr. 40
90419 Nuremberg
Germany

T +49 (0)89 315878-0


F +49 (0)89 315878-23

T +49 (0)911 39901-0


F +49(0)911 397904
info@sofistik.de
www.sofistik.de

This manual is protected by copyright laws. No part of it may be translated, copied or


reproduced, in any form or by any means, without written permission from SOFiSTiK AG.
SOFiSTiK reserves the right to modify or to release new editions of this manual.
The manual and the program have been thoroughly checked for errors. However, SOFiSTiK
does not claim that either one is completely error free. Errors and omissions are corrected as
soon as they are detected.
The user of the program is solely responsible for the applications. We strongly encourage the
user to test the correctness of all calculations at least by random sampling.

Front Cover
Project: MILANEO, Stuttgart, Germany | Client: Bayerische Hausbau and ECE | Architect: RKW Rhode Kellermann Wawrowsky
| Structural Engineering for Bayerische Hausbau: Boll und Partner | Photo: Dirk Mnzner

Contents | SOFiSTiK

Contents

Contents

Introduction
1.1
SOFiSTiK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2
Examples for the Use of the Software . . . . . . . . . . . . . .

How to use SOFiSTiK


2.1
Principles . . . . . . . . . . . . . . . . . . . . . .
2.2
Program Modules . . . . . . . . . . . . . . . . .
2.2.1
Preprocessing . . . . . . . . . . . . .
2.2.2
Analysis Programs . . . . . . . . . .
2.2.3
Design Programs . . . . . . . . . . .
2.2.4
Postprocessing . . . . . . . . . . . .
2.3
User Interface . . . . . . . . . . . . . . . . . . .
2.4
Input Files . . . . . . . . . . . . . . . . . . . . . .
2.5
Database . . . . . . . . . . . . . . . . . . . . . .
2.6
Interactive Modules . . . . . . . . . . . . . . .
2.7
News . . . . . . . . . . . . . . . . . . . . . . . . .
2.8
Name Conventions of the SOFiSTiK Files .
2.9
Backup of Data . . . . . . . . . . . . . . . . . .
2.10 SOFiSTiK Options . . . . . . . . . . . . . . . .
2.10.1 Language Settings . . . . . . . . . .
2.10.2 Units . . . . . . . . . . . . . . . . . . .

Interfaces
3.1
CDB Export to Excel . . . . . . . .
3.2
Export to DAT . . . . . . . . . . . . .
3.3
IFC Import and Export . . . . . . . .
3.4
Extensions for Autodesk R Revit R
3.5
SOFiSTiK Rhinoceros Interface .

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

Conversion of Projects (Structural & FEA)


4.1
Preliminary note . . . . . . . . . . . . . . . . . . .
4.2
Conversion of Project files . . . . . . . . . . . .
4.2.1
SSD Project files (.sofistik) . . . . . .
4.2.2
SOFiPLUS(-X) Project files (.dwg) .

SOFiSTiK 2016

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

1-1
1-1
1-1

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

2-1
2-1
2-3
2-3
2-3
2-3
2-4
2-4
2-6
2-7
2-9
2-10
2-10
2-12
2-12
2-13
2-13

.
.
.
.
.

3-1
3-1
3-1
3-2
3-3
3-4

.
.
.
.

4-1
4-1
4-1
4-1
4-1

SOFiSTiK | Contents

.
.
.
.
.
.
.

4-2
4-2
4-3
4-3
4-3
4-4
4-4

.
.
.
.
.
.
.
.

5-1
5-1
5-2
5-2
5-3
5-5
5-8
5-8
5-8

Graphical Input SOFiPLUS(-X)


6.1
General Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2
Work Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.1
Start out of the program Structural Desktop (SSD)
6.3
Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6-1
6-1
6-1
6-2
6-3

Input with TEDDY


7.1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2
Starting the Editor . . . . . . . . . . . . . . . . . . . . . .
7.3
Important Commands . . . . . . . . . . . . . . . . . . . .
7.3.1
Combinations with the Alt key (selection) .
7.3.2
Combinations with the Ctrl key (selection) .
7.3.3
Overview of all Ctrl- / Alt-Commands . . . .
7.3.4
Example with Column Block . . . . . . . . . .
7.4
Input of Data . . . . . . . . . . . . . . . . . . . . . . . . . .
7.5
Help and Interactive Manuals . . . . . . . . . . . . . . .
7.5.1
Activating the Help . . . . . . . . . . . . . . . .
7.5.2
Acrobat Reader . . . . . . . . . . . . . . . . . .
7.6
TEDDY the SOFiSTiK - Commander . . . . . . . . . .
7.7
TEDDY - Chapter and TEDDY - Label . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.

7-1
7-1
7-1
7-2
7-3
7-3
7-3
7-3
7-4
7-5
7-5
7-6
7-6
7-7

.
.
.
.

8-1
8-2
8-2
8-2
8-2

4.3

ii

4.2.3
Database (.cdb) . . . . . . . . . . . . . . . . . . . .
4.2.4
CADiNP Commands . . . . . . . . . . . . . . . . .
Important changes . . . . . . . . . . . . . . . . . . . . . . . .
4.3.1
Input of Cross Sections and Materials . . . . .
4.3.2
Cross Section Editor . . . . . . . . . . . . . . . . .
4.3.3
Superposition (MAXiMA) . . . . . . . . . . . . . .
4.3.4
Buckling Resistance of Steel Members (BDK)

SSD - SOFiSTiK Structural Desktop


5.1
User Interface SSD . . . . . . . . . . . . .
5.2
Basic Work Flow . . . . . . . . . . . . . .
5.2.1
Groups . . . . . . . . . . . . . . .
5.2.2
Tasks . . . . . . . . . . . . . . . .
5.2.3
Template Files name.sofistix
5.3
Structure and Function Mode . . . . . .
5.3.1
Calculation Status . . . . . . .
5.4
Special Features for Start . . . . . . . .

CADINP - Input Language


8.1
Definitions and Descriptions . . . . .
8.1.1
Lines (physical sentences)
8.1.2
Records (logical structure)
8.1.3
Separation Characters . .

.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

SOFiSTiK 2016

Contents | SOFiSTiK

8.2

8.3

8.4

8.1.4
Data . . . . . . . . . . . . . . . . . . . . . . . .
Input Syntax . . . . . . . . . . . . . . . . . . . . . . . .
8.2.1
Basic Input Format . . . . . . . . . . . . . .
8.2.2
Default Value . . . . . . . . . . . . . . . . . .
8.2.3
Repetition . . . . . . . . . . . . . . . . . . . .
8.2.4
Increments/Decrements . . . . . . . . . . .
8.2.5
Comments . . . . . . . . . . . . . . . . . . .
8.2.6
Record Continuation . . . . . . . . . . . . .
8.2.7
Record Partition . . . . . . . . . . . . . . . .
8.2.8
Positioning . . . . . . . . . . . . . . . . . . .
8.2.9
Defining Tables . . . . . . . . . . . . . . . .
8.2.10 Help-Record . . . . . . . . . . . . . . . . . .
8.2.11 Generation . . . . . . . . . . . . . . . . . . .
8.2.12 List of Values . . . . . . . . . . . . . . . . . .
8.2.13 Conversion of Units . . . . . . . . . . . . .
8.2.14 LET - and STO - Variables . . . . . . . . .
8.2.15 Arithmetic Expressions . . . . . . . . . . .
8.2.16 FUN - Definition of functions . . . . . . . .
8.2.17 LOOP, ENDLOOP - Loops and Jumps .
8.2.18 IF - Logical Conditions . . . . . . . . . . . .
8.2.19 @CDB - Selection of a CDBASE . . . . .
8.2.20 @KEY - Access to the CDBASE . . . . .
8.2.21 @() - Access to the CDBASE . . . . . . .
General Records . . . . . . . . . . . . . . . . . . . . .
8.3.1
HEAD Title Lines . . . . . . . . . . . . . .
8.3.2
END End of an Input Block . . . . . . .
8.3.3
TXB Introducing Text . . . . . . . . . . .
8.3.4
TXE Concluding Text . . . . . . . . . . .
8.3.5
<TEXT> Text block . . . . . . . . . . . .
8.3.6
</TEXT> End of a text block . . . . . .
8.3.7
ECHO Output Control . . . . . . . . . . .
8.3.8
UNIT Units for Input/Output . . . . . . .
8.3.9
PAGE Control of Input/Output . . . . .
8.3.10 SIZE Graphic Format . . . . . . . . . . .
Generation of Pictures . . . . . . . . . . . . . . . . .
8.4.1
<PICT> Start of a picture . . . . . . . .
8.4.2
GNT Scale of a picture . . . . . . . . . .
8.4.3
GPL Polyline . . . . . . . . . . . . . . . . .
8.4.4
GPM Polymarker . . . . . . . . . . . . . .
8.4.5
GFA Fill Area . . . . . . . . . . . . . . . .
8.4.6
GGDP Generalized Drawing Primitive
8.4.7
GTXT Text Label . . . . . . . . . . . . . .

SOFiSTiK 2016

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

8-2
8-3
8-3
8-3
8-4
8-4
8-4
8-4
8-5
8-5
8-5
8-6
8-6
8-7
8-8
8-8
8-11
8-14
8-14
8-16
8-18
8-18
8-18
8-21
8-22
8-22
8-22
8-23
8-24
8-24
8-25
8-26
8-27
8-29
8-32
8-32
8-32
8-33
8-33
8-34
8-34
8-35

iii

SOFiSTiK | Contents

8.5

8.6
8.7
8.8

8.4.8
GSCA Dimensioning . . . . . .
Attributes of Graphic Representations . .
8.5.1
GCOL Colour Selection . . . .
8.5.2
GPLI Polyline Attributes . . . .
8.5.3
GPMI Polymarker Attributes . .
8.5.4
GTXI Text Attributes . . . . . . .
8.5.5
GFAI Fill Area Attributes . . . .
Insertion of a Picture . . . . . . . . . . . . . .
8.6.1
<LINK> Insertion of a Picture
Parametric Input . . . . . . . . . . . . . . . . .
Compatibility of Data files . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

DEF - Environment Variables

10

Starting an Analysis
10.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.2 #DEFINE - Parameter Substitution . . . . . . . . . .
10.3 #INCLUDE - Block Definitions . . . . . . . . . . . . .
10.4 APPLY - Integration of data during the calculation
10.5 #IF - Conditional Input . . . . . . . . . . . . . . . . . . .
10.6 Templates . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.7 Iteractive Analysis with Multiple Modules . . . . . .
10.8 Operating System Commands . . . . . . . . . . . . .
10.9 Job History . . . . . . . . . . . . . . . . . . . . . . . . . .
10.10 Start of a Single Program . . . . . . . . . . . . . . . .
10.11 Special Features for Start . . . . . . . . . . . . . . . .

iv

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

8-36
8-36
8-37
8-37
8-39
8-39
8-41
8-42
8-42
8-42
8-44
9-1

.
.
.
.
.
.
.
.
.
.
.

10-1
10-1
10-2
10-3
10-4
10-5
10-6
10-7
10-8
10-8
10-9
10-11

.
.
.
.
.
.
.
.
.
.
.
.
.

11-1
11-1
11-1
11-2
11-2
11-4
11-6
11-7
11-9
11-10
11-12
11-12
11-12
11-12

Troubleshooting
12.1 General Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12-1
12-1

11 Output
11.1 Result Output with the Report Browser
11.1.1 General . . . . . . . . . . . . . . .
11.1.2 Activation of Report Browser .
11.1.3 Features . . . . . . . . . . . . . . .
11.1.4 Output in table format . . . . . .
11.1.5 Printing Dialogue . . . . . . . . .
11.1.6 Advanced Features . . . . . . . .
11.1.7 Functions in control tree . . . .
11.1.8 Special Features for Start . . .
11.2 Protocol File (.prt) . . . . . . . . . . . . . .
11.3 Result File (.lst and .erg) . . . . . . . .
11.4 Graphical Output Result Viewer . . . . .
11.4.1 General Hints . . . . . . . . . . .
12

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

SOFiSTiK 2016

Contents | SOFiSTiK

12.2
12.3

12.4

13

Standard Warnings and Error Messages . . . . . . . . .


Troubleshooting Strategies . . . . . . . . . . . . . . . . . . .
12.3.1 Problems with Database (*.cdb) . . . . . . . . .
12.3.2 Input Error in TEDDY Datafile . . . . . . . . . . .
12.3.3 Error in System Generation with SOFiPLUS .
12.3.4 Error during Calculation . . . . . . . . . . . . . . .
12.3.5 Problems with Results . . . . . . . . . . . . . . . .
Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.4.1 Support Accessibility . . . . . . . . . . . . . . . . .
12.4.2 Customers Obligation to Cooperate . . . . . .
12.4.3 Support Request via SOFiSTiK Online Portal
12.4.4 Support Request out of SSD / TEDDY . . . . .
12.4.5 Create a Diagnostic.xml File . . . . . . . . . . . .

Additional Information and Help


13.1 Infoportal . . . . . . . . . . . .
13.2 CADINP Samples . . . . . . .
13.3 Forum . . . . . . . . . . . . . .
13.4 VERiFiCATiON Manual . . .

SOFiSTiK 2016

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

12-1
12-2
12-2
12-3
12-3
12-3
12-4
12-4
12-4
12-5
12-6
12-6
12-7

.
.
.
.

13-1
13-1
13-2
13-2
13-3

SOFiSTiK | Contents

vi

SOFiSTiK 2016

Introduction | SOFiSTiK

Introduction

1.1

SOFiSTiK

The SOFiSTiK AG develops and distributes engineering software with particular


emphasis on civil and structural engineering.
The software has been developed following a sophisticated concept, allowing
the standard user to reach a quick and efficient solution to a given task. Despite
this the possibilities for a specialist with experience in numerical methods are
not restricted.
The software is made up of a modular structure and provides general available
open interfaces. The modules numerical kernels are classic batch programs,
these in turn are getting their input from small text files and a database.
For each program module there is an own manual. The manuals contain information about the theoretical backgrounds and descriptions for the input and
output of the programs. We recommend to inform about the respective program
module in the corresponding manual before using the program.

1.2

Examples for the Use of the Software

For each program there are introducing examples. The input files for these examples are to be found in the installation directory SOFiSTiK in the respective
subdirectories programmname english.
Furthermore the users have the possibility to get information about many features of SOFiSTiK-Software on the home page of the SOFiSTiK AG:
http://www.sofistik.com/Infoportal
Detailed examples do not only show the power of these programs but may be
used as templates for your own solutions.

SOFiSTiK 2016

1-1

SOFiSTiK | Introduction

Figure 1.1: Link Infoportal

You can find further information about examples and help for the programs in
this manual chapter: 13 Additional Information and Help..

1-2

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

How to use SOFiSTiK

2.1

Principles

The core of the SOFiSTiK analysis programs is a database (CDB). A set of programs, which are addressed by standard text files or by graphical user interfaces,
interchange all their information through this database.
SOFiSTiK-Software consists of numerous different modules. For all beginners
the SOFiSTiK-Structural-Desktop SSD is the best choice because it will handle many of the complex interactions between the modules. There is a separate tutorial available, a short introduction may be found in chapter 5 : SSD SOFiSTiK Structural Desktop.
To exploit the full power of the software it is useful to know the modular structure
and the CADINP-command language as this is the most powerful and the most
basic access method. An experienced user will never disaccustom himself from
the flexibility of applying CADINP macros, especially for large complex systems.
Especially the possibility to keep all secondary information in comments and
formulas is a very valuable feature.
There is the following organisation and operating structure:

Input file or database creation manually or using a generation program

Performing the Analysis

Output of results and graphics

The process is not ruled by any rigid system, which means that the software
is very flexible. The user can always choose the most effective form of input
for his purposes and is only constrained by minimal obligations in sequences of
analysis. Moreover it is possible to transfer data between different computers
and operating systems without difficulty.

SOFiSTiK 2016

2-1

2-2

Central Data Base


CDB

REPORT BROWSER: Documentation

RESULT VIEWER / RESULTS: Tabular and cross section results

WinGRAF / WING: FE results and plots

ANIMATOR: System- and deformation visualization

FOOTiNG: Eurocode design of R/C footings

COLUMN(-FD): Eurocode design of R/C columns (fire design)

BDK: Eurocode stability checks for beam members

AQB(S): Design for beams (P/T and composite)

Revit / Reinforcement Generation: 3D reinforcement from FEA

AutoCAD / SOFiCAD: .dwg/.dxf and 2D FE rebar results

IFC: Structural Analysis View (2x3)

C++, C#, FORTRAN: Programming interfaces to CDB

SIR: Integration of slab- and shell results

BEMESS: Design of slabs, shear-walls and shell elements

VBA / Excel: CDB export to Excel

INTERFACES / BIM

DYNA: Earthquake and dynamics for finite elements

ELLA: Influence line evaluation

HYDRA: Seepage and thermal simulation

HASE: Soil-structure interaction

TALPA: 2D finite elemente in geotechnics

ASE: Finite element solver

CSM: Construction stages and time dependent effects

TENDON: Pre- and Post-tensioning for beams and shells

MAXIMA: Enveloping

DESIGN / POST-PROCESSING

Teddy / Text Editor:


Parametric text input language CADINP

Rhinoceros Interface:
3D FE models for complex geometries

FEA Extension for Autodesk Revit:


3D FE models and 2D subsystems for buildings

AQUA: Materials and cross sections

SOFiPLUS(-X) for Autodesk AutoCAD:


Graphical system-, load- and cross section input
(incl. AutoCAD OEM)
SOFiLOAD(-V): Loads and loadfunctions (traffic loads)

PROCESSING / SOLVER

PRE-PROCESSING

SOFiSTiK | How to use SOFiSTiK

Figure 2.1: Program Structure

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

2.2

Program Modules

2.2.1

Preprocessing

Interactive programs:
SOFiPLUS(-X)
Cross Section Editor

Graphical input based on AutoCAD (-X: Incl. ACAD


OEM)
Graphical input of cross sections with AutoCAD R
(part of SOFiPLUS(-X))

Batch-programs:
AQUA
SOFiMSHA
SOFiMSHC
SOFiLOAD
TENDON
CSM
2.2.2

Analysis Programs

ASE
HASE

General Static Analysis of Finite Element Structures


Half-Space Analysis for Static Soil-Structure Interaction
2D Finite Elements in Geotechnical Engineering
Dynamic Analysis
Extended Live Load Analysis
Seepage and Thermal Analysis

TALPA
DYNA
ELLA
HYDRA

Statics of Beam Structures 2nd Order Theory


Structural Reliability powered by Strurel
Fluid Dynamics powered by Cyclone Fluid Dynamics
BV

STAR2
RELY
DOLFYN

2.2.3

Materials and Cross Sections


Import and Export of Finite Elements and Beam Structures
Geometric Modelling
Loads and Load Functions
Geometry of Prestressing Tendons
Construction Stage Manager

Design Programs

MAXIMA
AQB

Superposition
Design of Cross Sections

BEMESS

Design of Plates and Shells

SOFiSTiK 2016

2-3

SOFiSTiK | How to use SOFiSTiK

BDK
2.2.4

Buckling Resistance of Steel Members


Postprocessing

interactive programs:
Result Viewer

Graphical and Tabular Finite Element Postprocessing

WiNGRAF

Graphical Representation of Finite Elements and Beam


Structures

Batch-programs:
WING
RESULTS
DBPRIN

Graphical Representation of Finite Elements and Beam


Structures
Graphical and Tabular Finite Element Postprocessing
Print Results from the Database

SIR
DYNR
TEXTILE

Sectional Results
Transient Results and Response Spectra
Cutting Pattern Membrane Structures

2.3

User Interface

After the installation of the software the explorer has linked several file extension
types to SOFiSTiK programs and allows a direct start:

2-4

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

Figure 2.2: SOFiSTiK File Types

These file types recognized by the explorer have the following contents:
The extensions .SOFISTIK are the project files of the SDD
(SOFiSTiK Structural Desktop).

The extensions .DAT are input files. A double click will open the program TEDDY, with the right mouse button you have access to WPS
(run).

The extensions .CDB are database files. A double click will open the
program Animator, with the right button mouse you have access to:
Database Clean Locks
Database Information

Remove data base locks


Programmers diagnose tool

Export to DAT
Graphical Output (WinGRAF)
Post-Processing

SOFiSTiK Export
Graphical presentation of data
WinGRAF
Numerical presentation of data

(Result Viewer)

Result Viewer

SOFiSTiK 2016

2-5

SOFiSTiK | How to use SOFiSTiK

The extensions .PLB are output files containing text and graphics. A
double click will invoke Report Browser.

The extensions .PRT contain the log of the total analysis. They contain
information about error messages and warnings, statistics, parameters of the equation system, memory usage and analysis time.

The extensions .ERG are classical output files in text format. They
have the similar content as the .PLB, but do not contain pictures.

The extensions .LST are the components making the ERG file. The
LST file always contains the result of the last module and may be
helpful for fast error tracking.

GRA The extensions .GRA are CADINP input files of the program
WiNGRAF and can be opened and modified with TEDDY.

The extensions .RESULTS are CADINP input files of the program Result Viewer and can be opened and modified with TEDDY.

2.4

Input Files

The input files are in a free input form in the so-called CADINP-format (see
chapter 8: CADINP - Input Language). This is a programmable macro-language
which makes very efficient input handling possible. For a static position there
are multiple, even nested files possible.
The extensions .SIR are input files which are generated by the program SIR.
They can be opened and modified with TEDDY.
The extensions .SOFISTIX are special presentation files of the SDD (SOFiSTiK
Structural Desktop). Using these files you can get default inputs in the SSD for

2-6

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

selected systems for a further processing.

2.5

Database

For each position of an analysis system one database with a project name and
one or more data files are created. The database can be valuable in large
projects and therefore it should be saved via Backup.
In this context the term system is defined as the sum of all parts of a structure or substructure, which interact statically during their lifetime. The programs
SOFIMESH or SOFiPLUS generate the analysis system for the structure being
analyzed. The total number and the type of the elements are thus definitely defined. However for the analysis a partial system can be used. This is defined
by the group number. The user should keep this structuring in mind from the
earliest stages of the design.
Boundary conditions and material constants can be modified as desired. Load
cases can be analysed or superimposed by the use of certain modules. Design
can be carried out and results can be presented graphically. All results are
saved as the most recent values. The analysis of a load case with modified
loads overwrites the previous results. When cross-sections are modified, all the
results that depend on them (reinforcement, stresses, etc.) are deleted if not
specified otherwise.
The database is managed by the system CDBASE. Its index sequential structure allows an effective access via a double key. The description of the data is
given via the file CDBASE.CHM, the subroutines can be obtained by users for
programming purposes.
A database can be transferred in both ways to and from the AutoCAD based
system SOFiPLUS.
A fully interactive program named DBINFO is available for handling the
database. It not only prepares statistical information but also allows for various
output and editing possibilities and has a powerful copy function.
The program DBINFO can be called with one of the following possibilities:

from the SSD or TEDDY


- SOFiSTiK Database Tools Datenbase Information

from the Explorer


- Marking the database (name.cdb)
- right mouse button Database Information

SOFiSTiK 2016

2-7

SOFiSTiK | How to use SOFiSTiK

from the command shell


- call of the command shell in the TEDDY with icon
- call DBINFO
- input of the database name

After calling the program DBINFO the following menu appears:


a - Access history

o - Output medium

s - Structure (Eements)
l

- Loadcases

m - Merge 2nd database

b - create a backup

d - Dump of records

g - output with 8 Digits ON

e - Edit records

**

on your own risk only !

z - Clear the error flag


(Clear all locks if called via DBINFO project,Z)
q - quit
Please press the desired key

Option a prints a log file of all the programs that accessed the database. Options
s and l give information about the load cases and the elements stored in it.
Option m allows the import of load cases from another database. Although,
this only makes sense when both databases contain the same analysis system. Such a need exists mainly for very large systems when several colleagues
analyze different scenarios for the same system.
Option d displays content of the database. Option e allows the user to change
the content of the database. You only should do so on explicit order by a
SOFiSTiK supporter. A description of the content of the data base would be
advantageous for this purpose.
When running DBINFO project,Z all error flags and all the record locks will be
removed. These result from a program crash for example. The removing of the
locks is also possible in the SSD, TEDDY or in the Explorer:

2-8

from the SSD or TEDDY

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

- SOFiSTiK Database Tools Clean Locks

from the Explorer


- Marking the database (name.cdb)
- right mouse button Database Clean Locks
Hint
In the SOFiSTiK environment (see chapter 9: DEF -Environment Variables)
you can change the parameter CDACCESS=SINGLE. This will deactivate
the multitasking possibilities and no record logs are created.

2.6

Interactive Modules

The modular structure reflects itself in the conception of the interactive modules.
Instead of a single window which changes between input and output views, the
user can open several programs with different windows which exchange messages and have access to the same database. To change between the windows
there are function keys and icons in the tool bar within TEDDY, WPS, Report
Browser and other programs:
The program WPS (wps.exe) to perform the analysis

The program ANIMATOR for animated views of structures and results

The program Report Browser to view and manipulate the print-out including graphics
With TASKS it is possible to insert different analysis or design tasks
(in analog mode to the tasks SSD - SOFiSTiK Structural Desktop).
The program WinRAF to generate sofisticated true scale graphics of
the system, loading and results
The program Result Viewer to generate sofisticated true scale graphics of the cross sections and to create tables with numerical contents
of the database

SOFiSTiK 2016

2-9

SOFiSTiK | How to use SOFiSTiK

2.7

News

SOFiSTiK programs are under continuous development. The manuals are constantly being updated and they are packed together with the programs as PDF
files. The changes in the programs are gathered in HTML-LOG files, and are
available for the user in several ways:

SOFiSTiK publishes these files via the Internet.

SSD and TEDDY provides an option for the LOG files under Help.

The files can be subscribed as RSS-Feeds by the SOFiSTiK Homepage.

2.8

Name Conventions of the SOFiSTiK Files

The most important files of SOFiSTiK software are the input files (.SOFiSTiK
and .DAT) and the database (.CDB). The other types of files are:
The files of the SOFiSTiK programs have various extensions which have the
following meanings:
.EXE
.DLL
.CMD

Execution program (MS-DOS/Windows)


Shared dynamic link library (Windows)
Batch file

.ERR

Error file of a program module containing all error messages,


input records and output text in German and English
Contains other external data for programs (Tables)
Contains user specific attitudes

.TAB
.TAX
.TBB
.HTM

.PDF

Contains compiled data of the .TAB files.


Latest changes file
These files contain the changes to each program since the
last manual, as well as the corrected errors.
Adobe portable document format (Manuals)

.CHM
.WTM
.DEF
.INI

Compressed HTML help files


Windows macro file for TEDDY
Definition file for parameters
Parameter file for design codes

The following files result from an analysis:


.DAT
.DWG

2-10

Input file, (not mandatory)


Input file for plan from SOFiPLUS, in which the analysis sys-

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

tem and the load are entered


.SOFISTIK project files of the SDD (SOFiSTiK Structural Desktop)
.SOFISTIX template file of the SDD (SOFiSTiK Structural Desktop)
.GRA
Input file from WINGRAF generated
.RESULTS Input file from Result Viewer generated
.LST

Output file of the individual programs

.ERG
.PRT
.PLB
.CDB

Output file of the entire analysis


Protocol file of the entire analysis
Result file with text and graphics
Database, should not normally be deleted.

.CDE

Eigenforms of dynamic analysis

.$Dn
.zdn

As well as other files with $ (Windows) or z (Linux) and


a letter and number.
Restart files (e.g. stiffness matrix) may be deleted; however,
these files may have to be regenerated later, which can demand significant computing time.

.$0n
.z0n

As well as other files with $ (Windows) or z (Linux) and two


numbers.
Temporary work files can always be deleted. Usually these
files are deleted by the program itself if it finishes properly.
Files with wild number combinations in their names are auxiliary files of the operating system, which can no longer be
deleted due to a warm start of the computer.

.$$$
.zzz

Auxiliary files under Windows which can be deleted.


Auxiliary files under Linux which can be deleted.

.#nn
.ynn

Auxiliary files under Windows which can be deleted.


Auxiliary files under Linux which can be deleted.

.###

These are error-log files under Windows which can be


deleted.
These are error-log files under Linux which can be deleted.

.yyy

SOFiSTiK 2016

2-11

SOFiSTiK | How to use SOFiSTiK

.SDB

2.9

Shadow database: This file is usually deleted by closing of


all involved programs.

Backup of Data

Last but not least it must be mentioned that all valuable data can be destroyed
under certain circumstances. Beside clumsiness of the user, information on the
hard disk can be destroyed due to faulty hardware, operating system faults or
program errors.
Therefore, a regular backup of relevant data is highly recommended. The basic
rule is that valuable information should always be stored in three independent
medias, because an error during a Backup may destroy both the copy and the
original. Input data should be backuped daily. In the case of larger projects the
entire database, which is often the result of several weeks of analysis, should be
backuped in regular intervals.
Important data is are definitely your created DAT-files as well as the files
.SOFISTIK, the project file .DWG and the input files for the graphical postprocessing .GRA. and .RESULTS. If your CDB contains important information
you may create a condensed Backup-version via the program DBINFO. Within
TEDDY there is a function to delete unimportant files in your project directories
(clean up).

2.10

SOFiSTiK Options

For the SOFiSTiK programs there are three setting menus available for the specific SOFiSTiK settings.
Menu

Storage location

SOFiSTiK > User Options

Options for the individual PC

These settings are stored in the Registry


database.
SOFiSTiK > Project Options Options belonging to the project
These settings are stored in a file
SOFiSTiK.DEF in the current project directory.*
*

2-12

The settings of the file SOFiSTiK.DEF in the project directory overwrite


the default settings of the parent directory.

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

2.10.1

Language Settings

There is a difference between the language of the dialogues and the input and
output language of the files.
The language of the dialogues is stored within the Registry database on the local
computer and is adjustable under SOFiSTiK > User Options. The program
must be restarted to activate this change.

Figure 2.3: Dialogue Language

The input or output language of the files is saved in a file SOFiSTiK.DEF.


2.10.2

Units

The SOFiSTiK programs allow the input and output in the most suitable engineering units. The units used in the database are expressed in SI-units kN, m,
sec. However, other units can also be used for input and output (e.g. N, mm or
cm2 ) as well as a different number of decimals.
Three categories of units are distinguished:
mm

Fixed unit. Input is always required in the specified unit.

[mm]

Explicit unit. Input defaults to the specified unit. Alternatively, an


explicit assignment of a related unit is possible (eg. 2.5[m] ).

[mm] 1011

Implicit unit. Implicit units are categorised semantically and denoted


by a corresponding identity number (shown in green). Valid cat-

SOFiSTiK 2016

2-13

SOFiSTiK | How to use SOFiSTiK

egories referring to the unit length are, for example, geodetic


elevation, section length and thickness. The default unit for each
category is defined by the currently active (design code specific)
unit set. This input default can be overridden as described above.
The specified unit in square brackets corresponds to the default for
unit set 5 (Eurocodes, NORM UNIT 5).
Implicit units incorporate a semantic differentiation, e.g., system dimension,
cross-sectional dimension or geodetic height. They are coupled to a
(code specific) unit set, which is defined in the corresponding INI-file. Alternatively, the unit set can be specified explicitly in the System-dialog or via
CADINP NORM. The unit set then assigns the actual explicit units, e.g., [ m]
for system dimension, [ mm] for cross-sectional dimension and [ m] for
geodetic height. The choice of a unit set determines the corresponding units
for input and output (which is a change of version 2012 in comparison to earlier
versions). For each module run, however, it is still possible to define possibly
deviating temporary valid unit sets or single units via CADINP command UNIT.
The currently active input unit can be seen from the dialog context or - for script
based CADINP input - is provided in the TEDDY status bar via dynamic help
(Alternative: Enquiry of active units with CADINP command HELP.). A direct
unit assignment is always possible (see section 8.2.13 Conversion of Units).
Explicit units, on the contrary, are not controled by an underlying unit set. In
analogy to implicit units, however, they provide for an optional unit conversion at
input (see section 8.2.13 Conversion of Units).
Fixed units are deprecated and have been removed for the most part.
The following unit sets are provided:
0
1
2
3

= Standard units (m, kN, sec with some historic deviations)


= German buildings (sections in cm, system in m)
= German steel construction, (sections mm,cm2 ,dm4 , system in m)
= Bridge construction (like 0 but internal forces in MN instead of kN)

4
5
6
7
8

= Soil Mechanics (m, kN, sec)


= Structural Engineering (sections in mm, system in m)
= Metric system (All dimensions in mm, loads in kN)
= Mechanical (All dimensions in mm, loads in N)
= imperial (US-Units, inch, foot, lbs, kip)

The conversion to imperial units follows a convention from 1 July 1959 which
has unified American and British definitions:

2-14

SOFiSTiK 2016

How to use SOFiSTiK | SOFiSTiK

1 inch
1 yard
1 lb

= 0.0254 m (precisely!)
= 0.9144 m
= 0.45359237 kg

1 lbforce

(avoirdupois)
= 4.4482216 N

If the unit ton is used, it is always equal to the short ton (2000 lb).

SOFiSTiK 2016

2-15

SOFiSTiK | How to use SOFiSTiK

2-16

SOFiSTiK 2016

Interfaces | SOFiSTiK

Interfaces

3.1

CDB Export to Excel

The CDB Export to Excel is designed to display information of the SOFiSTiK


database CDB in Microsoft Excel. In addition to general information about the
CDB and the existing load cases also results for cross sections, nodes, beams
and quads are possible. The data can be selected by yourself and modified
after import. The supported versions of Microsoft Excel can be found in User
Options Excel. The idea behind CDB2Excel and SOFiSTiK programming
interfaces is to enable the access to the CDB Data.
Hint
More information about CDB2Excel and "SOFiSTiK Interface for VBA and
Visual Basic .NET" can be found in the CDB_INTERFACES Manual.

3.2

Export to DAT

With the Export to DAT it is possible to convert information from the cdbase
to a CADINP input for a further use with the text editor TEDDY. Thus CADINP
inputs can be generated from graphical and interactive inputs via the cdbase. An
input of the program SOFiMSHC can be produced for example from a system
generation with SOFiPLUS. The materials, the cross sections and the loads can
be selected material-, cross-section- and load-case-wise if desired.
The file call is done via the button

from the SSD or TEDDY.

Figure 3.1: Dialog: Export to DAT

SOFiSTiK 2016

3-1

SOFiSTiK | Interfaces

3.3

IFC Import and Export

SOFiSTiK allows to read and write data defined in the open standard of the Industry Foundation Classes (IFC). Materials, sections, structural elements and
loads can be exported from within the SSD using the menue entry File IFC
Import/Export.... Thereby SOFiSTiK supports the so-called Structural Analysis View of the IFC, version 2x3 (see e.g. www.buildingsmart.de/bim-knowhow/ifc). In the same manner, an IFC-file of the respective version can be read
in and converted to a SOFiSTiK database. The IFC-import generates a textfile in
the SOFiSTiK input language CADINP which can be integrated within the SSD
or a Teddy project.
However, most of the IFC-compatible software packages support only the Coordination View, which primarily consists of architectural building information and
which is not directly applicable for a structural analysis. IFC-files containing the
Coordination View can be read in using Autodesko Revito or Autodesko Architectural Desktop. An export of an IFC-file in this format is not possible, since the
necessary (volumetric) information is not contained within the SOFiSTiK model.
The following webpage provides a good overview about the different IFCformats: www.buildingsmart.de/bim-know-how/ifc.
After setting the conversion direction and the filename (*.cdb or *.ifc) to be read
in the Import/Export dialog, the conversion can be started using the command
Apply.

3-2

SOFiSTiK 2016

Interfaces | SOFiSTiK

Figure 3.2: IFC-Import / Export

3.4

R
R
Extensions for Autodesk
Revit

The SOFiSTiK Interface for Autodesk R Revit R Structure provides a seamless


integration of FE analysis with all features of the SOFiSTiK software package.
Automatic FE meshing, using one of the most powerful 3D meshgenerators,
can be started directly from Revit Structure to allow quick system changes of
the calculation model.

SOFiSTiK 2016

3-3

SOFiSTiK | Interfaces

R
R
Figure 3.3: SOFiSTiK Interface for Autodesk
Revit
Structure

The current version of the Interface also offers many functions which made easier both the communications between Revit Structure and the SOFiSTiK Software as well as the input in Revit Structure.
The following features simplify the workflow:

material mapping

cross section mapping

assign the SOFiSTiK group numbers directly in Revit Structure

SOFiSTiK load distribution area for area loads acting on girders

divide of area load for checkerboard-like load distribution in the case of flat
slabs

calculation of subsystems: export of a subsystem (e.g. plate with beams),


where connected members (e.g. walls, columns a.s.o.) are used as elastic
or fixed supports

Immediate review of the structural model is possible starting ANIMATOR and


WinGRAF directly from Revit. The system can then be integrated into a
SOFiSTiK Structural Desktop (SSD) project to perform further analysis and design steps. The modification of the model is also possible using SOFiSTiKts
AutoCAD add on SOFiPLUS.

3.5

SOFiSTiK Rhinoceros Interface

The SOFiSTiK Rhinoceros Interface extends the functionality of Rhino by the


3-4

SOFiSTiK 2016

Interfaces | SOFiSTiK

possibility to define and generate a finite element model for a structural analysis with SOFiSTiK. Geometric objects in Rhino like Points, Curves or Surfaces
can be extended by structural information, like cross-section or material properties. The generation of the finite element mesh, consisting of beam and shell
elements, can then be carried out from within the program.
A number of additional utilities, which will be combined in a SOFiSTiK toolbox,
offer the possibility to visualize cross-sections (e.g. for renderings), to show
structural properties as annotations or to select objects by specific attributes.
With the installation of the SOFiSTiK Rhinoceros Interface, Rhino will be integrated into the SOFiSTiK calculation environment (SOFiSTiK Structural Desktop), providing a seamless change between modeling, meshing and further calculation steps without having to manually convert data between different programs.
Similar as with nearly all other data in Rhino, also the structural information
can be further edited and changed using RhinoScript or user defined program
extensions. This allows to extend the functionality of the SOFiSTiK Rhinoceros
Interface and customize it to company or project specific needs.
More information are available in the manual RHINO_INTERFACE

Figure 3.4: SOFiSTiK Rhinoceros Interface

SOFiSTiK 2016

3-5

SOFiSTiK | Interfaces

3-6

SOFiSTiK 2016

Conversion of Projects (Structural & FEA) | SOFiSTiK

Conversion of Projects (Structural & FEA)

4.1

Preliminary note

This document compiles information and hints regarding the conversion of existing SOFiSTiK projects (version 2014) for processing with the new version
SOFiSTiK 2016.
Hint
We recommend not to switch the major release during one running project,
please contact support@sofistik.de for individual support if you have to do
so.

4.2

Conversion of Project files

4.2.1

SSD Project files (.sofistik)

When opening a project file into SSD SOFiSTiK 2016, the user is prompted to
authorize an automatic conversion process. During this process, all SSD related
data formats are upgraded.
Hint
After conversion, the project file can no longer be processed by earlier
versions than SOFiSTiK 2016 SSD version.
In addition, one automatic upgrade of the database (.cdb) is being performed
(see chapter subsection 4.2.3).
If tasks are no longer existing in the new version their respective input will be
converted in a simple Text-Task. This affects the 2014 tasks for BDK - Lateral
Torsional Buckling, for new input the new task Steel - Buckling Resistance of
Members is available.
4.2.2

SOFiPLUS(-X) Project files (.dwg)

When opening a project file into SOFiPLUS(-X) SOFiSTiK 2016, the user is
prompted to authorize an automatic conversion process. During this process, all
SOFiPLUS related data formats are upgraded.

SOFiSTiK 2016

4-1

SOFiSTiK | Conversion of Projects (Structural & FEA)

Hint
After conversion, the project file can no longer be processed by earlier
versions than SOFiSTiK 2016 SOFiPLUS(-X) version.
In addition, one automatic upgrade of the database (.cdb) is being performed
(cf. subsection 4.2.3).
4.2.3

Database (.cdb)

The data formats in databases of version 2014 and 2016 are compatible to a
large extent, but not identical.
Hint
Merging of data from different database versions is strongly discouraged;
in this case, quality and accuracy of data cannot be assured.
There is an automatic mechanism for the conversion of the data formats from
version 2014 to version 2016. This conversion is possible through:

Conversion of the SSD project files (.sofistik) or

Conversion of the SOFiPLUS project files (.dwg).

The conversion is also possible when opening directly the database into SSD
2016.
Hint
After conversion, the project file can no longer be processed by earlier
versions than SOFiSTiK 2016 version.

4.2.4

CADiNP Commands

Due to the generic symbols of the CADiNP language, an automatic conversion


is not possible and will not be supported (cf. subsection 4.2.3).
SOFiSTiKs strategy, regarding this issue, is the following:
In future, some CADINP commands are labeled as deprecated. For deprecated
commands the following actions hold:

They are (and remain) fully functional for the actual Major Release (Version
2016).

Support of these commands will not be provided at some point in the future

4-2

SOFiSTiK 2016

Conversion of Projects (Structural & FEA) | SOFiSTiK

(usually along with the next major release).

In most cases, documentation or input description for these commands is no


longer available for the actual Major Release (Version 2016).

Deprecated input commands are marked with a warning. Generally, this


warning also issues a specific hint regarding the recommended replacement.
Hint
For new or long-term projects, it is recommended to avoid deprecated input
commands and adopt the advised replacement instead.

4.3

Important changes

To facilitate orientation, this section contains a compilation of important changes


without making the claim to be complete with respect to Version SOFiSTiK
2014.
4.3.1

Input of Cross Sections and Materials

The boundary element procedure (BEM) for computation of thick-walled crosssections has been superseded by a novel approach based on the finite element
method (FEM). The BEM procedure is still available and can be activated by
respective controls. For further information, please refer to AQUA: CTRL.
Shear deformation areas are now always computed, independent of the material type, and accounted for consistently for beam analysis according to
Timoshenko-theory. This behavior can be overruled by explicit specification of
the respective shear deformation areas to 0.0, see AQUA: CVAL.
4.3.2

Cross Section Editor

In the Cross Section Editor the finite element section is preset for solid sections
in version 2016 according to the program AQUA. Thus all solid sections are
converted into a finite element cross section, if the version 2016 is used for a
file from version 2014. However, it is possible to switch to the integral equation
method if desired.
For cross sections with longitudinal reinforcements and corresponding layers it
is switched automatically to the new feature of the program AQUA record LAY.
It has only impact to the database and a possible export from the database to
AQUA.
Please refer to the help of the Cross Section Editor and the AQUA manual for

SOFiSTiK 2016

4-3

SOFiSTiK | Conversion of Projects (Structural & FEA)

further information.
4.3.3

Superposition (MAXiMA)

The following possibility to define the load case numbers of the results is no
longer available for reasons of the program stability:
Input of BASE in record COMB (BASE 100) and input of SUPP LC
Input files from the version 2014 with this variant of the definition of the load
case numbers of the results generate a message that only the BASE number
is used. In some cases, e.g. for the superposition of result sets or objective
functions, it can be necessary to modifiy the definition of the load cases of the
results manually.
Combinations and superpositions which were generated in the SSD with the
tasks Define Combinations and Superpositioning are not affected.
4.3.4

Buckling Resistance of Steel Members (BDK)

With this major relase, CADiNP input options have been revised. This may
lead to incompatibilities regarding existing data sets. Please refer to Section
Conversion of Projects in the BDK manual for further information.

4-4

SOFiSTiK 2016

SSD - SOFiSTiK Structural Desktop | SOFiSTiK

SSD - SOFiSTiK Structural Desktop

5.1

User Interface SSD

The SOFiSTiK Structural Desktop (SSD) represents a uniform user interface


for the total range of SOFiSTiK software. The module controls pre-processing,
processing and post-processing.
A double click on the program icon or on a file .SOFiSTiK will start
the program SSD.

The system can be entered graphically with SOFiPLUS(-X) or as parameterized


text input using TEDDY. The control of the calculation and design process takes
place using dialogue boxes, which are accessed via the task tree.
The screen is divided into the three main areas: task tree, table area and work.

Figure 5.1: Screen Areas

SOFiSTiK 2016

5-1

SOFiSTiK | SSD - SOFiSTiK Structural Desktop

5.2

Basic Work Flow

The SSD is task oriented. The tasks are arranged in groups (e.g. the group
System contains the tasks for materials, cross sections, geometry, loads and
combination rules). When creating a new project, the necessary groups and
tasks are set by default depending on the chosen problem.
5.2.1

Groups

The computational groups are organized in a tree-structure. This structure can


be changed by the user at any time, as the individual tasks can be dragged
to the desired place with the mouse. The user can remove or insert additional
groups at any time with associated tasks.
Example of a possible group-structure
of the SSD:
System:
- System, loads and combination
rules
Linear Analysis:
- Calculation and superposition
Design Area Elements:
- Design ULS and SLS

5-2

SOFiSTiK 2016

SSD - SOFiSTiK Structural Desktop | SOFiSTiK

5.2.2

Tasks

The tasks available are accessed via the right-click-menu in the task tree. They
can be normally inserted at any place within the tree. When you select the
command Insert Task with the right mouse-button, the following dialogue with
all available tasks appears.

Figure 5.2: Task Tree

SOFiSTiK 2016

5-3

SOFiSTiK | SSD - SOFiSTiK Structural Desktop

Task Tree
In the task tree the options are accessed via the right-click-menu which automatically adjusts itself to show only those available.
Right click menu in the task tree
The right click menu will provide relevant functions for the selected task.
Examples:
Process

Dialogue

Edit

Text Input

(name.dat)
Reports

Report viewer

(name.plb)

Table Area
The table area is used for information purposes and it is not editable.
Database information is written in the
table area:
Possible categories:
- Geometry
- Loads
- Results

These results can be copied into the


clipboard. A corresponding dialog is
opened via right click menu Copy
to Clipboard.
Possible format:
- EXCEL format
- Text format

5-4

SOFiSTiK 2016

SSD - SOFiSTiK Structural Desktop | SOFiSTiK

Work Area
The work area displays the ANIMATOR visualisation of the system by default.
The work area changes to WinPS during processing to show calculation status and the TEDDY for further text input prior to analysis. The graphical input
with SOFiPLUS(-X) operates within its own separate window making the best
possible use of dual monitors.
5.2.3

Template Files name.sofistix

For processing of frequently recurrent standard tasks, the Template


files of the type name.sofistix are provided.
General templates
are saved in a subdirectory of the SOFiSTiK directory, for example
C:\Programme\SOFiSTiK\2016\ANALYSIS_33_X64\SSD-Templates.
Adding User- defined Template Directories
For own Templates, the user can define further template directories.
SOFiSTiK User Options SSD-Template Path Fileopen Button and
Add
In this directory, further subdirectories can be created. These subdirectories
appear as tabs and template icons. There is only one level of subdirectories
available.

Figure 5.3: SSD-Template Path

SOFiSTiK 2016

5-5

SOFiSTiK | SSD - SOFiSTiK Structural Desktop

User Defined Template Files


Any file name.sofistik can be stored into the desired template directory as template name.sofistix.
All current project settings can be saved as templates including the arrangement
and sequence of the tasks. The materials and cross sections are dependent on
the chosen design code. A fixed design code cannot be changed within the
project. File Save Project As Template ...

Figure 5.4: Save Project As Template

A later changing of the code is possible if the template is stored with Save
tasks without Design Code dependant information.

Figure 5.5: Save Template

The existing template directories are shown under directories. The saved file
name.sofistix is now available as a further template.

5-6

SOFiSTiK 2016

SSD - SOFiSTiK Structural Desktop | SOFiSTiK

Usage of Template Files name.sofistix


File New Project from Template...
The existing templates from the template path are offered.
Root directory:
- General

Figure 5.6: SSD Templates

The desired file name.sofistix is selected and stored under a new data file name
with the button Save As ... into a project directory.
The new file contains all tasks of the template. In addition, the data (for example
cross sections, geometry... etc.) from the template are transferred into the new
file. The data is then immediately ready for calculation.
With Templates without Design Code, the design code can be altered. The
materials, cross sections, actions and if necessary other information which depends on the design code must be checked and amended.

SOFiSTiK 2016

5-7

SOFiSTiK | SSD - SOFiSTiK Structural Desktop

5.3

Structure and Function Mode

5.3.1

Calculation Status

Every task has its own symbol to show the actual calculation status.

Figure 5.7: Selective Calculation

5.4

Without calculation

Input is written directly into the database

green check mark

no calculation required

blue arrow

new input data calculation required

blue cross

old data calculation required

red cross

error message calculation required

green cross

warning message calculation possible necessary

Special Features for Start

For special cases the user may start the program from a command shell by using
the following command lines:

5-8

SOFiSTiK 2016

SSD - SOFiSTiK Structural Desktop | SOFiSTiK

Parameter

Description

+ or ++

Opens the last file or the last but one. Is used without
a switch - or / .
Starts the application as a separate instance (no single application).
A general test flag is set. This is only of interest for
the developers. Depending on the level of development, an individual message window is activated.
When starting the SSD the automatical opening of
the AnimatorView is suppressed.
When starting the SSD a complete DAT-file is created
and the SSD window is closed again immediately.

-nosingle
-test

-noani
-dat:name

SOFiSTiK 2016

5-9

SOFiSTiK | SSD - SOFiSTiK Structural Desktop

5-10

SOFiSTiK 2016

Graphical Input SOFiPLUS(-X) | SOFiSTiK

Graphical Input SOFiPLUS(-X)

6.1

General Hints

SOFiPLUS(-X) is a CAD-based preprocessor to define structures and loads for


analysis with SOFiSTiK programs. SOFiPLUS can be purchased as a pure
add-on to AutoCAD or included with an integrated AutoCAD OEM engine as
SOFiPLUS-X.
For the structural analysis SSD and SOFiSTiK structural programs are needed.
Hint
We recommend to work with structural elements and the automatic meshing, the workflow with direct modification of finite elements will be disabled
in a future release

Figure 6.1: SOFiPLUS Structure

6.2

Work Flow

The general work flow is described in the manual SOFiPLUS. Additionally you
can find examples and tutorial movies for the individual features at the link Info-

SOFiSTiK 2016

6-1

SOFiSTiK | Graphical Input SOFiPLUS(-X)

portal at the homepage of the SOFiSTiK AG


http://www.sofistik.com/Infoportal
or via our YouTube channel
http://www.youtube.com/user/SOFiSTiKAG/videos
6.2.1

Start out of the program Structural Desktop (SSD)

The program SSD is started via the Program Manager or from the link on the
desktop. Starting a new project the dialog box SOFiSTiK: System Information
start appears on the screen, because working without a database is not
possible. The kind of preprocessing is set to SOFiPLUS(-X) - graphical
Preprocessing. Therefore the part below is filled and additional settings for
working with SOFiPLUS(-X) can be configured.

Figure 6.2: SOFiSTiK System Information

After closing the dialog box with OK several tasks are inserted in the project tree
to the left. By double-clicking the task GUI for Model Generation (SOFiPLUS(X)) the program SOFiPLUS(-X) is started. Now the structural system and the
loads could be defined. Via the command export the elements for the system
generation and the loads are written into the SOFiSTiK database (-CDB) and so
are available for further analysis.
6-2

SOFiSTiK 2016

Graphical Input SOFiPLUS(-X) | SOFiSTiK

To set the default kind of preprocessing to SOFiPLUS(-X) - graphical


Preprocessing use the user options (pulldown menu SOFiSTiK - User Options
...).

Figure 6.3: SOFiSTiK - User Options

6.3

Structure

After starting SOFiPLUS(-X) the following screen will appear:

SOFiSTiK 2016

6-3

SOFiSTiK | Graphical Input SOFiPLUS(-X)

Figure 6.4: SOFiPLUS(-X) Screen

The commands can be accessed via different tools (menus, toolbars, ribbons).
Warnings and/or errors during writing into the database will be displayed in the
sidebar.
To become acquainted with the program SOFiPLUS(-X) you can retrieve an example project from the Infoportal or do an online training out of our YouTube
channel. Training courses - for SOFiPLUS(-X) as well as for the program SSD are offered regularly.

6-4

SOFiSTiK 2016

Input with TEDDY | SOFiSTiK

Input with TEDDY

7.1

Overview

TEDDY is a powerful control centre as well as an editor, which fully supports and
utilises the CADINP language (chapter 8 : CADINP - Input Language).

Figure 7.1: Teddy Control Center

TEDDY provides you with an integrated help system listing all the possible commands at the status line. By pressing F1 you will get the corresponding manual
to a specific command (PDF file) on your screen, without interfering with your
editor. The ESC key will close the help window.
Detailed explanations can be found at Help

7.2

Teddy Help .

Starting the Editor

TEDDY is a windows application and can be started by the standard methods.


A double click on the program icon or a DAT-file will start the program
TEDDY
For special cases the user may start the program from a command shell by using
the following command lines:

SOFiSTiK 2016

7-1

SOFiSTiK | Input with TEDDY

ted [ /options] [ filename] [ line column]


filename:
As a filename you may also enter a + or ++ this will load the last or
second last file respectively. By using abc*.dat the open file dialogue
will be started with the given pattern match. The following command
*.* will select the whole directory.
options:
/sSofistik-Pfad Path for the SOFiSTiK-executables (Change or set
the environment variable SOFiSTiK=...)
/1 to /4

will create additional instances of TEDDY. The number will select the colour of the TEDDY-icon.

Overview of the possible input commands:


Parameter

Description

+ or ++

Opens the last file or the last but one. Is used without
a switch - or / .
Allows the start of up to 5 instances

-0 -1 -2 -3 -4
-nosingle
-test

Line No.

7.3

Starts the application as a separate instance (no single application).


A general test flag is set. This is only of interest for
the developers. Depending on the level of development, an individual message window is activated.
The cursor is placed directly into the given line. The
line number must be the last transferred parameter.

Important Commands

The most important functions are accessible via the function keys:
F1

help to the current input record (quit with ESC key)

F2

search

F3

search again

F4

search and replace

F5

mark Block start or end

F6

copy marked block

F7

move marked block

7-2

SOFiSTiK 2016

Input with TEDDY | SOFiSTiK

F8

duplicate current line

F9

change window

F12

start analysis

Moreover there are a lot of special keys. These are combinations of the k ey
or Ctrl key and another key pressed simultaneously. These combinations are a
very useful feature for an experienced typist used to the touch typing method.
Some of the combinations are given below:
7.3.1

Combinations with the Alt key (selection)

Alt + L

marks several lines (block of lines)

Alt + B

marks several columns (column block)

Alt + H

remove block markers

Alt + R

read file as block

Alt + W

write (marked) block to a file

Alt + Z

copy marked block

7.3.2

Combinations with the Ctrl key (selection)

Ctrl + A

marks all

Ctrl + C

copy marked block

Ctrl + V

paste marked block

Ctrl + X

cut marked block

Ctrl + S

save file

Ctrl + Y

delete Line

Ctrl + Z

undo

7.3.3

Overview of all Ctrl- / Alt-Commands

A complete arrangement of all Ctrl commands, you will find in the TEDDY-help
menu Help Ctrl commands .
7.3.4

Example with Column Block

An empty column block will be created:

SOFiSTiK 2016

7-3

SOFiSTiK | Input with TEDDY

Alt + B -key for block start

drag the block

Alt + B - key for block start

The block is now marked with a certain colour.

Alt + Z - key

The column number dialogue is now active. Now you can do a lot of things with
the values in the column, like generating sequences or calculating the sum of
the values, just to mention a few.

Figure 7.2: Column Number Dialogue

7.4

Input of Data

Every SOFiSTiK-program expects input data. The data is supplied in text files.
The data is stored in a certain sequence, so that each program knows where to
get its data. An input segment thus starts with the reserved identifier PROG and
the name of the program for which the data is to be used. A file may contain
input to as many modules as desired or needed, e.g.
+PROG AQUA
Daten fr Programm AQUA
+PROG SOFIMSHA
Daten fr Programm SOFIMSHA

7-4

SOFiSTiK 2016

Input with TEDDY | SOFiSTiK

+PROG ASE
Daten fr Programm ASE
+PROG AQUA
Data for the AQUA program
+PROG SOFIMSHA
Data for the SOFIMSHA program
+PROG ASE
Data for the ASE program

TEDDY is able to recognize a file as an input file by the structure of the very first
line. It can for example look as follows:
PROG progname
+PROG progname
-PROG progname
$PROG progname

Further TEDDY assumes every file having the extension .DAT to be a SOFiSTiK
input file. You may specify other extensions via the option Extras File type.
Provided that the file progname.ERR exists, TEDDY can recognize all record
names and their corresponding commands. The status-line of the window displays the current record name and its commands as well as the name of the
module used and the current input language.

Figure 7.3: status-line record-name

7.5

Help and Interactive Manuals

7.5.1

Activating the Help

Help is activated with the F1 key. The page of the manual, matching the current
input command of the current program will be shown. The names of the manSOFiSTiK 2016

7-5

SOFiSTiK | Input with TEDDY

uals, which are in PDF format, are composed with the progname and a special
character sequence (_0 German or _1 English) indicating the language. They
have to be available of course.
In a navigation window you will see the table of contents, which allows you to
jump to the theoretical- or the example sections in the manuals. But as soon as
TEDDY becomes the active window again, the help will automatically switch to
the current manual page.
You may quit help with the Esc key, but only if TEDDY is the active window. As
an alternate method you can use the close (X) button of the Acrobat Reader.
It is possible to print out the complete manual or just a couple of pages. The
layout of the manual is optimised for a double sided print out.
7.5.2

Acrobat Reader

For viewing the manuals you will need the Acrobat Reader (Version 5.0 or
higher) This software is share ware. If the Acrobat software is already installed
on your computer no alterations are made by the SOFiSTiK setup.
You can also change the size and position of the help window. The best option is
not only a matter of taste but also of the screen resolution. The following options
are available:
Help F1
Close Help Esc
Freeze Keywords
Hint: If you close the Acrobat with an ESC from within the TEDDY window it will
stay in memory and pop up very fast the next time.

7.6

TEDDY the SOFiSTiK - Commander

Besides the editing features of TEDDY, it is used as a control centre of the total
analysis. From TEDDY you can start the calculations and call up the pre- and
post-processing modules. To execute these features a tool bar is supplied in
TEDDY, which consists of the following icons:
Program start WPS (F12)
Quick start WPS (without prompt)

7-6

SOFiSTiK 2016

Input with TEDDY | SOFiSTiK

Quick start WPS only current module of the input


+/-PROG (Change of module selection)
+PROG (activate all modules)
-PROG (deactivate all modules)
+/-PROG from to Cursor
SOFiSTiK data files
Input file *.DAT
Result file *.ERG
List file *.LST
Protocol file *.PRT

Animator (structure and results animated)


WinGRAF (graphical results)
Result Viewer (graphical results and output in lists)
Tasks (see also SSD)
Export to DAT
Archive
Clean up
Database Clean
Explorer
Command-Shell

7.7

TEDDY - Chapter and TEDDY - Label

A TEDDY input file can be structured by chapter entries and by label entries.
The chapters and labels are shown in the Teddy module tree and both are used
as jump labels.
Chapter
Label

SOFiSTiK 2016

7-7

SOFiSTiK | Input with TEDDY

In the result file PLB single chapters can be opened and can be closed with
Report Browser by mouse click. The labels are designed as jump labels only.
Chapter entries can be placed only outside of the data blocks PROG/END
PROG
...
END
! \#!Chapter Users text
PROG
...
END

With !+!Chapter in TEDDY a chapter is marked as open, with !-!Chapter it is


marked as closed (!#!Chapter is identical with !+!Chapter).
Label entries also can be placed within a data block PROG/END
PROG
HEAD
!*!Label Users text
...
END

7-8

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

CADINP - Input Language

The input language CADINP for free input format of data is the result of a further
development of a project CADINT, which originated from the Federal Ministry of
Research and Technology for the study in the CAD area (M.Ahn, K.H.Bckeler,
W.Haas / Eingabe Konventionen fr CAD-Programme, CAD-Bericht Kfk-CAD
39, Kernforschungszentrum Karlsruhe, 1976).
The variation of this format, which was developed by SOFiSTiK, includes several
additional capabilities. In certain points it therefore has some deviations from the
above mentioned CADINT standard.
The full capability of the language can be achieved in combination with SPS
and/or WPS, when functions for block building and parameter substitution are
used. CADINP and SPS represent a full programming language for the calculation of problems in structural engineering, which will outdo any guided GUI. The
processing occurs in two stages.

SPS or WPS use a single file or a set of sub-files to create an input file
for every program being used. This is called parsing. During this process
globally defined text elements are inserted and larger blocks are inserted or
skipped. Strings are addressed with $(name). The strings can be defined
or undefined in the input file or the SOFiSTiK-environment. At this stage no
calculations have take place, that is why there is a difference, whether the
string A = 2+2 is inserted at $(A)*3 or ($(A))*3.

Each computational program starts its own CADINP processor, which then
starts the arithmetic calculations. The variables used within CADINP are
marked with a # at the beginning. They do not need any brackets and represent numbers. They can be converted to text input data where needed,
especially within comments. However they can only be used within the local
scope of the single program.

The combination of these two stages allows the description of a complete analysis systems by means of manual calculations and documentation of the analysis
assumptions and the resulting computer calculations. This in turn produces a
complete analysis document in the computer.

SOFiSTiK 2016

8-1

SOFiSTiK | CADINP - Input Language

8.1

Definitions and Descriptions

8.1.1

Lines (physical sentences)

The input consists of lines. Each line contains up to 255 characters and corresponds to one line on the screen.
8.1.2

Records (logical structure)

Similar or logical connected data are put together in records. Each record has a
name. The records do not have to conform with the line separation.
8.1.3

Separation Characters

The individual values within a record are separated by the separation character.
One or more blank characters (space bar) serve as separation characters.
8.1.4

Data

Data can be numbers or text (=Literals). Numbers may have a sign and an
exponent. If an integer number is expected, the given number will be rounded
to the nearest integer, e.g.
2

0.04

-.5

3.7E8

-0.5E-3

Texts are arbitrary strings of characters. Only the first four characters are significant. Text should be delimited by apostrophes if there is danger of confusion with
numbers, record names or items, or if it includes blank spaces or the characters
, or ; or $, e.g.
ALFA

NODE

1S45

A B

1.45

A;B

"Ab"

With Version 2010 all international characters (UTF8) may be used, previous
versions allowed only the local code-page characters. However the short ident
keys with exactly 4 characters allow only for pure ANSI-characters (i.e. no Umlauts or accents).
Lower case characters are automatically converted to uppercase characters,
as long as they are not between apostrophes. However a few exceptions are
enforced to upper case (e.g. names of actions) to avoid ambiguites, these will
be marked as LITnn instead of Litnn in the column unit.
If a literal contains a variable (see ) there are three cases to be distinguished:

8-2

The literal has been defined with apostrophes and starts with an equal sign
(=). In that case the literal is passed unchanged but without the leading =
to the program allowing to define formulas. This if course only useful if the

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

program can handle the literal in that form as intended.

If the variable has been defined with a literal, this content will be inserted
instead of the variable.

If the variable has been defined with a value, this value will be formatted and
inserted instead of the variable in the literal.

For an optional literal i.e. instead of a number and for variables containing literals
only the form #name without any arithmetics or indices is allowed (e.g. A#1 with
#1=25 yields A25). Within a real pure Literal however you may use the #()
function with the format as a second parameter i.e. #(#ALPHA,8.3). The integer
part of the format selects the number of total characters (8), while the decimal
part selects the numbers of decimal digits (3). The first argument may be any
complex arithmetic expression.

8.2

Input Syntax

8.2.1

Basic Input Format

The input consists of records.

The input record consists of the record name followed by data in the order
specified in the input description.

Each record occupies one input line.

The record name can be omitted when the record is of the same type as the
preceding one.

A record can start at any position in a line.

The data is separated from each other by one or several separation characters.

8.2.2

Default Value

If the minus sign (-) is given instead of a data value, the program uses the corresponding default value as specified in the programs description. This has been
used in the past also to skip unwanted items. As this is strongly dependant on
the sequence of the items which may change sometimes, it shouldnt be used
any more.
If less data is entered for some record than its description demands, the corresponding default values will be used in the place of the missing data.
The minus sign must be embedded between separation characters.

SOFiSTiK 2016

8-3

SOFiSTiK | CADINP - Input Language

Default values can be redefined inside a header record that defines a table.
8.2.3

Repetition

If the equal sign (=) is entered in the place of a data value, the program will use
the corresponding value of the preceding record. However this is only possible
if the record name has not been changed.
If two equal signs (==) (with no blank spaces in between!) are entered, all of
the values in the following records will be the same. Positioning of the preceding
record is not considered.
If the value of the previous record is a generation instruction or a list of values,
the generation or the complete list will be repeated.
The repetition characters must be enclosed in separation characters.
8.2.4

Increments/Decrements

If a double plus or minus (++ or --) is entered in the place of a data value, the
program will use the corresponding value of the preceding record incremented
or decremented by 1. This will also work with Literals, Lists and Generation
sequences. However this is only possible if the record name has not been
changed.
The increment/decrement characters must be enclosed in separation characters.
8.2.5

Comments

The comment characters $ , ! or // turns the rest of a line into a comment, which
will be ignored by the program. All this comment operators should be separated
from the comment itself and the input data in the same line with a separation
character.
Within a +PROG-line (see SPS) only the $-character is allowed as a comment
and it must be separated by blancs. Within a +SYS-command line no comments
are allowed at all.
8.2.6

Record Continuation

A double dollar sign $$ means that the input record is continued in the next line.
The characters following $$ are considered as a comment.

8-4

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

A separation character must be entered right before $$. Thus it is not possible
to write expressions or a list of values extending more than one line.
8.2.7

Record Partition

More than one record can be in the same line.


The records must be separated by a semicolon (;).
The semicolon needs not to be between separation characters.
This feature is not valid for the input of text lines (e.g. HEAD).
8.2.8

Positioning

By entering a name of an item inside a record, you can provide the value for that
item regardless of its position.
Example:
A record is defined by the items K1 K2 K3 K4 K5. The following input is
then equivalent:
RECORD
RECORD
RECORD
RECORD
8.2.9

1.00 - - 2.00 3.00


1.00 K4 2.00 3.00
K1 1.00 K4 2.00 K5 3.00
K4 2.00 K1 1.00 K5 3.00

Defining Tables

The predefined order of the input data can be altered by entering a record consisting only of the names of the items. In this case the following records must
not contain a record name, as this would reinitialize the sequence of items.
The last example could have also been given as:
RECORD

K1
1.00

K4
2.00

K5
3.00

A table definition remains valid until a new record name is entered or the same
record name is repeated. Inside a table the positioning is still possible even for
those items not defined in the table definition.
The default values can be modified inside the header of a table by following the
item with an equal sign (=) and the new default value without any separation
characters.

SOFiSTiK 2016

8-5

SOFiSTiK | CADINP - Input Language

RECORD

K1
1
2
3

K2
2
5
6

K5=4
6

K1
1
2
3

K2
2
5
6

K5
6
4
4

is equivalent to
RECORD

Such a construct is also a nice suitable solution to the problem of ambiguous


literals. If a literal value exists (e.g. GRP) for the first item position which is also a
valid record name, a change of the sequence and perhaps a default assignment
may solve this problem without the need to use quotes:
BEAM

8.2.10

TO
1
2

TYPE
TEMP
TEMP

PA
30
25

FROM=GRP

Help-Record

A list of the possible record names can be obtained by entering HELP. HELP
followed by a record name prints a list of the items of the record. HELP followed
by a record name and an item name will print the allowable input values and
parameters for the corresponding position.
This option is meaningful especially during interactive error finding.
8.2.11

Generation

An instruction for automatic record generation can be given instead of a data


value. In this way a series of records can be created automatically.
When generating a record the command must be enclosed within parentheses.
Its elements must be separated by separation or underline characters.
There are two types of generation instructions:
primary automatic generation instruction
(Start_value End_value Increment)
secondary generation instruction

8-6

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

(Start_value Increment)
The primary generation instruction specifies the number of the individual records
to be generated. It can be used only once per record, yet in any position inside
the record. The corresponding secondary generation instruction can be defined
for every parameter.
The generation of literals is also possible. The increment is then also considered
as a literal but may contain only numbers.
The increment can also be negative.
Long sequences of generated data may accumulate numerical round off errors.
Thus if the specified end value of a primary generation instruction is not reached
with an accuracy of 0.0001 of the increment, or more than 9999 values would
be created an error message will be issued and the generation will not start.
Example:
NODE (1 5 1) 0 (0.5 -0.1)
generates the input records:
NODE
NODE
NODE
NODE
NODE

1
2
3
4
5

0
0
0
0
0

0.5
0.4
0.3
0.2
0.1

Example:
REIN (A0.1 D0.4 10.1)
generates the input records:
REIN
REIN
REIN
REIN
8.2.12

A0.1
B0.2
C0.3
D0.4

List of Values

A list of values can be given instead of a generation loop . This is a series of


values separated by commas or underline characters.
Value,Value,Value,Value

SOFiSTiK 2016

e.g.

1,2,7,9

8-7

SOFiSTiK | CADINP - Input Language

A list of values may not contain any separation characters and can not be spread
across multiple lines.
When several lists of values are defined within a single record, their number
of values must agree not only with each other, but also with any other defined
primary generation.
The maximum number of values per list is limited by an internal amount of memory. A list of 25 values is usually possible.
A list of values can also be built up by fixed literals (LIT). Combinations of numbers and literals or a list of freely defined literals are however not allowed.
8.2.13

Conversion of Units

For every numerical value, list of values or generation it is possible in general


to append the input unit explicitly in square brackets. So instead of definig a
length in the default unit m as 0.3048 it is also possible to specify 304.8[ mm] or
12[ in] . This option is available for explicit and implicit units (see section Units).
CADINP will check if the specified unit is permitted, i.e., belongs to the family of
related units.
If a unit is defined in a table header, this unit identifies the default unit for all
data in the respective column; it may be overwritten with an explict definition of
course. If only a default unit should be selected but no default value, the default
value may be omitted, e.g.,
NODE X=[m]
8.2.14

Y=5.0[m]

Z=[mm]

LET - and STO - Variables

One can define variables to be used in the following records. After the leadin
LET# (only valid within current program) or STO# (value will be saved to
database) the name of the variable is appended directly (up to 16 characters
of an alpha-numerical text, 1st character has to be a letter) and an optional index. For temporary variables a simple numerical positive value may be also
used as name. The variables can be used then instead of numbers. This item
is followed a separation character and the value to be assigned to the variable.
The value may be either numeric or a literal inclosed in quotes. LET# or STO#
do not alter the currently defined record name and thus must be given in each
assignment. Names of variables must not contain special characters or collide
with a reserved sequence of characters like (SIN, COS or SQR). Instead of one
numerical value a list of values or a primary generation instruction or a literal
may be entered. In this case the rest of the values is assigned to the variables

8-8

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

following the input variable. This defines an array if a named variable is used.
The unit of a variable is depending on the context, where this variable is used.
Thus it is not possible in general to use the same variable for a section definition
in [ mm] ] and a system definition in [ m] . But it is possible to assign a unit to a
variable, then the given value will be converted immediately and the value can
be used everywhere. If a variable has been assigned a unit, it will be inherited
to all other variables and expressions. However this will also trigger a check if
the obtained unit is allowed for the current use.
An array has for all members the unit which has been defined for the item with
index 0.
A variable is used if the item or an expression containing the variable is provided
with a leading = character. For special cases like the insertion within a literal, assignment of a default value, conflicts with identical function names, it is possible
to identify a string as a variable name with a leading # sign.
Examples of variable assignments:
LET#PI 3.1415
LET#TXT My Text
LET#11 4,5,6
LET#A 4,5,6
LET#A(2) 5.1
LET#A(3) 7,8
LET#1 =A(1)
LET#1 #(A+1)

$
$
$
$
$
$
$
$

Pi is assigned to variable #PI $


Assigning a literal $
assigned to variables 11,12,13 $
4,5,6 are assigned to A[0:2] $
Assignment to an array element $
Enlargement by 2 elements $
Using second element of array $
Using second element of array $

LET# #10 12.50

$ 12.50 is assigned to variable, $


$ whose number is stored in #10 $
$ (Indexing) $

LET#4 ##10

$ Value of the variable, whose $


$ number is stored in variable #10, $
$ is assigned to variable 4 $

LET#F(100) 0
$ Declaration of an array, $
LET#F 1,2,3,4,5,6,7 $$ $ filling via lists $
11,12,13,14,15,16,17 $$ $ and consecutive lines $
21,22,23,24,25,26,27
LET#B
LET#D
LET#A
LET#X

20[mm]
1.5[m]
#B*#D
#B*#D[-]

SOFiSTiK 2016

$
$
$
$

Assignment
Assignment
Assignment
Assignment

with unit $
with unit $
with unit: #A is 0.3[m2] $
without unit: #A is 0.3[-] $

8-9

SOFiSTiK | CADINP - Input Language

If a variable is assigned to an expression, the expression is calculated first and


then its value is assigned to the variable.
To print variables for debugging purpose you may use the construct PRT# with
a similar syntax for addressing the variable name. The name of the variable
is expected without separation characters immediately behind the #. For more
comfort one should use TXB / TXE or <TEXT> within literal text.
Variables with a name may be saved permanently in the database. The command STO#name will save the current or specified value of this variable in the
database, which then can be used by all other programs accessing the database
from that. E.g.
STO#c 30 $ assignment and storage of the variable $
$ in the database $

If a save variable should be removed from the database there is the command
DEL#name. For this case it is also allowed to specify wild card characters. The
commands DEL#OPT* or DEL#A?00 will delete all variables with that pattern.
The use of DEL# within a control construct like a loop or an IF-block may yield
unexpected results.
For special cases it is possible to reinitialize a variable with the last saved value
with the following commands:
RCL#ALL
RCL#name
RCL#name(3)

Read all named variables


Read one named variable/array
Read one entry of an array

RCL#name cdbfile

Read variable from another CDB data base

Reserved Variable-Names
There are some reserved Names, which are automatically created by a programm run. The user may use and redefine those names however within his
CADINP-data block with new values.

Variables VERSION(0) and VERSION(1) will be preset with the version number of the Release (dll) and the program itself, allowing to define common
input data for multiple versions.

Variable PI will be preset to 3.141593.

The arrays of variables GRP_MASS, SCT_MASS and MAT_MASS as well


as GRP_REIN and SCT_REIN are redefined after a print or evaluation of
system statistics. They contain the masses (MASS) and reinforcements

8-10

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

(REIN) of all groups (GRP_) and section numbers (SCT_) or Materials


(MAT_), where the index 0 contains the total sum.
All other variables start with the first three characters of the program creating
them followed by an underline:

ASE uses the array ASE_ITER as follows


ASE_ITER(0) = first load case number
ASE_ITER(1) = last load case number
ASE_ITER(2) = last achieved load factor

Variables of Array AQB_USAGE will be set by AQB with the usage factors of
the design tasks of the last input block.

All Variables starting with OPT_ are reserved for OPTIMA.

To trace the assignment of values, there is a command DBG#. This will toggle
test prints and an interactive debug mode. DBG# uses the variable #0, which
can not be used for other purpose therefore
DBG#0
DBG#1
DBG#2
DBG#3
DBG#4
DBG#8
DBG#

No output of intermediate values


Output of the generated input records
Additional output of all value
assignments
Additional output of selected
structures (CDB access)
Printout to console stream/window
Input from console stream/window
(interactive mode)
Switch between option 15 and option 0
(=break and continue)

and
DBG# -2

8.2.15

Immediate STOP of total program run,


although all outstanding
TXE-Lines will be printed after the
error message

Arithmetic Expressions

In place of a numerical value any desired arithmetic expression may be used.


The expression may contain parentheses, but no separation characters.
The allowable operators are:

SOFiSTiK 2016

8-11

SOFiSTiK | CADINP - Input Language

+ * /
** or ^

Addition, Subtraction
Multiplication, Division
Exponentiation

==
>=
>

<>
<=
<

&

Condition of equality/inequality
Relational condition
Relational condition
result: true (1.) or false (0.)
Bitwise logical operation on the
integer part with AND or OR

If no operator is given, a multiplication will be performed. The bindings of the operators are according to the mathematical rules. The logical operators have the
same weight, thus it is strongly recommended to use parentheses for combined
expressions.
The following functions are allowed inside an expression:
SIN(x),COS(x),TAN(x)
ATN(x),ATN(y,x)
ARC(x)
SQR(x)
ABS(x)
EXP(x)
LOG(x)
LGT(x)
DIV(x,y),xDIVy,DIV(x/y)
MOD(x,y),xMODy,MOD(x/y)
MIN(x,y,..),MAX(x,y,..)
RANDOM(x)
IIF(expr,val1,val2)

Trigonometric functions
Arc of tangent x or y/x
Convert angles to arcus
Square root
Absolute value
Exponents of e
Natural logarithm
Base 10 logarithm
Integer part of x/y
Division remainder of x/y
Minimum or Maximum numbers
random value between 0 and 1
(x=0 reinitialises the seed)
returns val1 if expr is not
equal zero and val2 if expr
equals to zero.

Arithmetic expressions may also appear within a list of values or generation


instructions. The functions DEG, GON and RAD may be placed before any
argument, but separated from it by a comma. Their definition is kept if an assignement contains only one of those names (e.g. LET#0 RAD).
Examples:
SIN(30.)+3*COS(45.)
SIN(RAD,2.435)

8-12

oder SIN30+3COS45

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

100.+MOD(354,32)

oder 100+354MOD32

120.+12.
3(5.0+4.0)
COS(#1) SIN#1
345*#11+##12
Interpolation and Tables:
A special feature is available when accessing arrays of variables. If the index
is not integer, but rational, an interpolation between the values of the array will
take place:
LET#A(0)
LET#A(1)
LET#A(2)
LET#A(3)
LET#B

10.0
14.0
16.0
17.0

=A(1.3)

=>

#B = 14.6

The same procedure is also available for higher interpolation schemes. Then
we need two arrays of the X and Y values with the same length. These variables
are then connected by a special assignement of a literal as a table definition:
LET#X
LET#Y
LET#SIG

0.0,2.0,3.5
0.0,100.0,100.0
TAB(X,Y)

The expression #SIG(1.73) interpolates for this X-value betwen the given Yvalues linearly. If higher functions are requested, a third array is needed, giving
the derivatives of the function:
LET#DY -,0,LET#SIG
TAB(X,Y,DY)
For the example above only the derivative at the middle point has been specified.
Thus we have quadratic parabulas for the interpolation function. If derivatives
are specified at both ends of an interval we have cubic splines as interpolation
functions.
Variables and Literals:

SOFiSTiK 2016

8-13

SOFiSTiK | CADINP - Input Language

In case it is required to store text in a variable this may be done with the LET/STO
command in the same way (The use of apostrophes is manadatory):
LET#TEXT

ABCDEFGHIJK

The text will be saved in blocks with 8 characters each in the name of the variable, #TEXT(1) would thus be equivalent to IJK in the above example and it
is possible to change that item only, but there is no storage of single characters.
However when using a text variable it is possible to use sub strings with the
format #TEXT(3:7) selecting the third to seventh character. (Instead of the numbers any arithmetic expresssionas are also valid of course). A text variable may
be read from the CDB and it is possible to convert with a LET/STO command a
text to numbers. The following example will save the two numbers in variables
#VALT(0) and #VALT(1):
LET#TEXT
LET#VALT
8.2.16

1.23,1.48
VAL(#TEXT)

FUN - Definition of functions

If an arithmetic expression is needed more often or the meaning of a variable


should be changed during the run, it is possible to define a function. Such
definition is done as a literal according to:
LET#F

=FUN(var,formulaexpression)

LET#F
LET#1

=FUN(x,3*#x**3-2*#x**2+5*#x)
#F(1.234)

e.g.

The Literal has to start with the character sequence =FUN( , followed by a
formal parameter name, followed by an expression containing any variables defined so far. If the formal parameters name has been defined already, it will not
be changed by the call. Recursive calls are allowed.
8.2.17

LOOP, ENDLOOP - Loops and Jumps

The most powerful form of generation is achieved through loops. This form corresponds to the FORTRAN DO-Loops or to the FOR NEXT loops of BASIC. The
loop is initiated by the record LOOP and terminated by the record ENDLOOP. A
loop is executed as many times as determined by the number following LOOP
(Default 9999). It may also be terminated if the expression following ENDLOOP
becomes zero or negative. If the name of a variable is given instead of the number after the LOOP, then the number of elements contained in that variable will
be used.

8-14

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

Loops can be nested up to 32 levels, containing any number of input elements.


If LOOP is not followed by a number, it will be performed at most 9999 times.
Each loop construction must not exceed 255 lines. Multiple records, however,
can be entered at the same line (separated by ;). If you still need more than 256
lines you have to specify before the first LOOP
LET#LOOPSIZE number_of_lines
It is possible to store the index of the loop in a variable, if the name is appended
to the LOOP keyword. The index starts counting at zero. The variable may be
changed within the loop, but it will be restored after evaluation of the terminating
condition in each cycle.
Example: Generation of nodes and springs on a semicircle at a distance of 30
degrees.
LET#1 1 , LET#2 0.
LOOP 7
NODE #1 COS(#2) SIN(#2)
SPRI #1 #1 DX COS(#2) DY SIN(#2) CP 1.E5
LET#1 #1+1
LET#2 #2+30.
ENDLOOP
Instead of LOOP 7 / ENDLOOP you could use LOOP / ENDLOOP #2 < =180.
With an endloop condition one can leave a loop prematurely.
Example for two-level generation:
LOOP#1 3
ADEF #1+1
LOOP 2 ; BDIV 0.5 #1+1 ; 0.2 1 ; ENDLOOP
ENDLOOP
creates:
ADEF 1 ; BDIV 0.5 1 ; 0.2 1 ; 0.5 1 ; 0.2 1
ADEF 2 ; BDIV 0.5 2 ; 0.2 1 ; 0.5 2 ; 0.2 1
ADEF 3 ; BDIV 0.5 3 ; 0.2 1 ; 0.5 3 ; 0.2 1
If you want to run a loop over all elements of an array, this may be done by giving
only the name of the array (without the # ):
LET#A 10,22,34,55,76,83
LOOP#1 A $ Only the name, #A would be the value 10!

SOFiSTiK 2016

8-15

SOFiSTiK | CADINP - Input Language

KNOT #1+1 X #A(#1)


ENDLOOP
With a small extension it is also possible to store the number of elements in a
variable, where the value of 0 is obtained if the variable does not exist:
LOOP#NUM DEF(A) ; ENDLOOP
8.2.18

IF - Logical Conditions

Conditional blocks are an important element of every programming language.


The execution of jumps (go to) is not possible within CADINP as it is proven
to be able to solve any problem without this feature. The conditional block is
executed if the expression following the IF is greater than zero. You might want
to use the logical expressions for this. Texts may be only compared with == and
!= operators, the comparison is case sensitive. As the complete string on both
sides of the operator is considered, no parentheses are allowed, they are part
of the strings.
Example:
$ #1 is the control variable with possible values +1/-1
IF #1
These lines are input when #1 > 0
...
ELSE
These lines are input when #1 < 0 or = 0
...
ENDIF
IF #1==12
These lines are input when #1 equals 12
...
ELSE
These lines are input when #1 does not equal 12
...
ENDIF
The generation of a CASE construction is available by using a series of additional ELSEIF statements:
if (Condition_1)
....
elseif (Condition_2)

8-16

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

....
elseif (Condition_3)
....
else
....
endif
Example:
IF (#A < 0.3) $ condition 1
LET#VALUE 0.50
ELSEIF(#A>1.0) $ or condition 2
LET#VALUE 0.70
ELSE
LET#VALUE 0.50+0.20*(#A-0.3) $ else this value
ENDIF

VALUE
0.7
0.5

0.3

1.0

Figure 8.1: VALUE depending on A

That means that only one possibility is chosen for VALUE depending on A.
In special cases it is possible to create the following input which can be used in
different SOFiSTiK environments with various versions:
IF (#VERSION>=2012)
....
ELSEIF (#VERSION==2010)
....
ELSE $ older SOFiSTiK Releases $
....
ENDIF

SOFiSTiK 2016

8-17

SOFiSTiK | CADINP - Input Language

8.2.19

@CDB - Selection of a CDBASE

CADINP allows the access to data of any SOFiSTiK-Database. Of course


you need a description of the contents of the database (cdbase.chm see 2.5
Database). The syntax has three parts. The @CDB selects the file name of the
data base:
@CDB filename
selects an arbitrary database filename.CDB. Default is the actual project
database. An explicit definition of this database is however not allowed.
All data within the CDB consists of multiple records with identical structures
organised within different 64-Bit indices KWH/KWL. In general each data
record has a part containing integer numbers and a second one containing the floating point data. The description of all structures is given for the
user within the file CBBASE.CHM and for the programs within the file CDBASE.CDB.
8.2.20

@KEY - Access to the CDBASE

@KEY KWH KWL [ SEL1 SEL2 SEL3

SEL4 SEL5 SEL6 IERR]

selects an access index KWH/KWL according to the CDBASE description.


KWH is a 8 character identifier while KWL is an optional number (e.g. load
case or section number). Values KWL and SEL1 to SEL6 are preset automatically.
For special purpose an optional filtering rule given by up to 6 integer or 4
character key values SEL1 to SEL6 may be specified. Key values which are
not important or will be defined with the access-function have to be specified
as -1. The keys correspond to the integer positions of the database.
The record index has to exist in the database. You will get an error otherwise.
The read position is set to the beginning of the index. If you specify for IERR
a number of a variable (for example 999), its value will be set to a positive
value if the given key exists. If the variable #CDB_IER has been defined, it
will contain the same value.
8.2.21

@() - Access to the CDBASE

A record is accessed by the use of an arithmetic function @() as special case of


an arithmetic expression:
@(position+offset)

8-18

or

@(no,position+offset)

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

reads from the database the next record, which passes the @KEY-filter
which is modified for the second case by no at the position of the last
defined KEYi. The value of the expression is the stored data with the name
position or if position is a number the value at the position relative to the
last selection value of the filter. The value 0 and negative values will therefore yield the integer values within the selection keys. An access to the index
of an array can be done via offset.
The access function will start at the current position. If you access a value
with the same or a lower position, CDBASE will read the next record. If
the end-of-file condition is encountered an error will occur if you have used
the form @(position), while for @(nr,position) a loop is used once and the
function jumps to the beginning.
You may also specify two state variables. If these variables have been defined non negative, the result values will be saved there and error messages
will not appear:

CDB_LEN for the actual length of the record

CDB_IER for the error-flag


(0=ok, 1=record to short, 2=end_of_file, 3=key_not_defined).
This is required to prevent the program to enter an infinite loop.
Example 1:
To get the effective Iy -value of cross section 5 from the actual projectdatabase, you enter:
@KEY SECT_EFF 5
LET#5 @(IY)
Example 2:
To use the support forces of node 101 and 102 of load case 12 as
loads you enter:
@CDB
@KEY
LOAD
LOAD

project1
N_DISP 12
1 PX @(101,PX) PY @(101,PY)
2 PX @(102,PX) PY @(102,PY)

Example 3:
To use shell forces of the nodes 101 and 102 of group 2 of load case
12 you enter:
@CDB project1
@KEY QUAD_NFO 12 2

SOFiSTiK 2016

$ Selector Group 2

8-19

SOFiSTiK | CADINP - Input Language

LET#101 @(101,mxx)
LET#102 @(102,myy)

$ moment m-xx
$ moment m-yy

Example 4:
To get all support forces of nodes with last digit 0 as loads you may
enter:
LET#CDB_IER 0
@CDB project1
@KEY N_DISP 12
LOOP
$ ALL RECORDS
LET#10 @NR,@PX,@PY,@PZ
IF (#CDB_IER < 2)\&(#10 < >0)
$ END OR HEADDER
IF 0==MOD(#10,10)
$ LAST DIGIT 0
LOAD #10 PX #11 #12 #13
ENDIF
ENDIF
ENDLOOP #CDB_IER < 2
$ TO TERMINATE THE LOOP
Example 5: To get the section number of the beam 101 (As we have
to read two different cases alternate, we can not use the predefined
literals):
LET#CDB_IER 0
@CDB projekt1
@KEY 100 0 -1 -1 -1 -1
LET#NR 0
LOOP
LET#10 @(-3),@(-2)
IF #10 ; LET#NR #10
ELSE
IF #NR==101
LET#Q #11
ENDIF
ENDIF
ENDLOOP #CDB_IER < 2

$ 4 Integer-Keys
$
$
$
$

ALL records
1. and 2. Integer
New BEAM
section of beam

$ TO TERMINATE THE LOOP

Example 6:
For text elements saved in the database special caution has to be
payed for the fact that we have to distinguish between pure ASCIItext [ chr] and unicode-text [ str] . In the following the first part reads
the CHR-Name of the design code with elementary functions, while
the second part reading the unicode designation of the material has
to use the names of the cdbase.chm see 2.5 Database:

8-20

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

@KEY 10 1 $ READ DESIGN CODE AND ACTIONS


let#NT LIT(@7,@8,@9,@10) $ DESIGNATION OF CODE
let#A1 LIT(@2) $ NAME OF ACTIONS
let#A2 LIT(@2)
let#A3 LIT(@2)
@KEY MAT 1
LET#MATTXT LIT(@TITLE)

8.3

General Records

The input consists of blocks. Each input block usually begins with the HEAD
lines and ends with an END record. Some programs allow the input of more
than one block. The analysis is ended in those cases when an empty block
(END/END) is found.
The same layout is used in all manuals for the input description of all records.
Apart from the record name, which is written in a special box at the upper right,
there are four columns in each table.

The first column contains the names of the items of the record.

Explanations and allowable literals are given in the second column.

The dimension of the input parameter can be found in the third column. The
- character stands for a dimensionless parameter, a * stands for values with different possibilities, that are selected via PAGE UNII. LIT is given
for items allowing only preddefined literals. LITnn defines input, which can
accept free text of up to nn characters. LITnn defines literals which are enforced to upper case.

The last column shows the default values. Here, the - character means
that no default value exists, and that the parameter itself is not necessary.
On the contrary, a ! means that a value must definitely be specified. Finally,
a * means that the default values depend on various conditions which are
explained in the text.

SOFiSTiK 2016

8-21

SOFiSTiK | CADINP - Input Language

8.3.1

HEAD Title Lines

HEAD
Item

Description

Title line

Unit

Default

LT72

Up to 10 title lines can be defined. The first one is reserved for the structure
description and can only be defined in the programs AQUA, SOFiMSHA/B/C
and in templates of the SOFiSTiK series. This line is imported by all other modules from the database, thus it can not be changed. The rest of the lines can
freely be defined by entering the record HEAD followed by a separation character and any desired text up to 72 characters. If no title lines are defined inside
a data block, the previous ones remain in use. See PAGE about specifying a
page headline. Title lines must not be delimited by apostrophes. Defaults of
the Heading lines may be specified in SOFiSTiK.DEF via the variables KOPF1,
KOPF2 and KOPF3.
8.3.2

END End of an Input Block

END
Item

Description

End of input or of an input block

Unit

Default

The record END closes each input block. Inside a data block for instance, each
single load case of the analysis can be defined. The end of the entire input is
defined by a double END record. If this record is missing and the input file is at
its physical end, this record is automatically generated by CADINP.
8.3.3

8-22

TXB Introducing Text

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

TXB
Item

Description

Introductory text

8.3.4

Unit

Default

LT72

TXE Concluding Text

TXE
Item

Description

Closing text

Unit

Default

LT72

Any desired explanatory text can be added to an input block by TXB and TXE, either before the analysis (TXB) or after it (TXE). The number of lines is unlimited.
For each of those two kinds of text, one may specify larger text blocks between
<TEXT> ... </TEXT> and pictures between the items <PICT> and </PICT>.
However a picture is not allowed within a <TEXT> ... </TEXT> block.
The TXB/TXE - lines should not be entered between apostrophes. Within the
text variables in the form of #(variable,dd) will be replaced by their current value
using the format dd.
HTML components may be used within the text. A component starts with a <
not followed by a blank or another < . Known components will be interpreted,
unknown will be discarded. SOFiSTiK programs know about (others will be
discarded):
<FF>

New Page

<LF>

Blank Line

<b> .... </b>

Bold

<i> .... </i>

Italic

<u> .... </u>

Underlining

SOFiSTiK 2016

8-23

SOFiSTiK | CADINP - Input Language

8.3.5

<TEXT> Text block

<TEXT>
Item

Description

Header of a text block

8.3.6

Unit

Default

LT72

</TEXT> End of a text block

</TEXT>
Item

Description

End of a text block

Unit

Default

LT72

You may define a continuous block of text within the special record names
<TEXT> and </TEXT> without the need of specifying record names. The text
will be appended to the region selected by the last TXB or TXE command. The
Text following the <TEXT> name will become part of the table of contents in
Report Browser.
The text block may be written to a file, by defining:
<TEXT,FILE=foobar.txt>
If a further text block should be added to the file, a + has to be input:
<TEXT,FILE=+foobar.txt>
For the definition of templates one can specify editable fields via special HTMLTags:
<EDIT:name>$(name) </EDIT>

Editable Reference on Parameter value

8-24

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

<EDIT:name,Format=6.2>$(name) </EDIT>

Editable Reference on Parameter value


with a format of ###.##
(total width.decimal digits)
Format=6 reserves 6 characters wide
Format=-6 places left adjusted
<EDIT:name,List=str1,str2,str3>$(name) </EDIT>

Editable Reference on Parameter value


with a list box of allowed values
<EDIT:name,List=str1,str2,str3,Update=Yes>$(name) </EDIT>

Enforces an update of the template


immediately after input of data
8.3.7

ECHO Output Control

ECHO
Item

Description

Unit

Default

OPT

Echo option

LT

FULL

LT

FULL

This parameter defines a set of output


or computing options, to which the record
ECHO applies. The actual list of the possible options can be found in the corresponding manual.
FULL stands for all output options.
VAL

-1 or OFF

no computation

0 or NO

no output

1 or YES

normal output

2 or FULL

extended output

3 or EXTR

extreme output

At the beginning of the program all options for new results are preset to 1. The
output parameter for already computed values (e.g. nodal coordinates in analysis programs) is set to 0. By entering ECHO NODE you can for example assign

SOFiSTiK 2016

8-25

SOFiSTiK | CADINP - Input Language

the value FULL to the option NODE. Therefore the default value for VAL will
only be activated if an ECHO record for this option is given. The exact effect
of all options can be found in the output description of the individual manuals.
You should generally note that the shortest possible output is achieved by YES,
while a rich output is obtained by FULL. By EXTR one achieves the output of
values, which are either useful in further computational steps or can use up a lot
of paper. Thus, use of this value should be made with care.
If the user wants to prevent the output of certain results, he must deactivate
them explicitly by NO. If for example one only wants the option REAC set, one
must enter:
ECHO FULL NO
ECHO REAC
8.3.8

UNIT Units for Input/Output

UNIT
Item

Description

TYPE

No of a complete unit set (0-8) or

Unit

Default

Lt16

Lt16

LT

INOU

No or designation of an implicit unit item


USE

The unit to be used for that item

DIG

Number of decimal digits


or E1 to E7 for exponential formats

SET

Effectiveness
OUT
Output
IN
Input
INOU Input and Output

The SOFiSTiK programs allow the input and output in the most suitable engineering units. The units used in the database are expressed in SI-units kN, m,
sec. However, other units can also be used for input and output (e.g. N, mm
or cm2 ) as well as a different number of decimals. The record UNIT allows to
specify within a current program run different units to be used for input or output.
It is possible either to select a complete unit set with TYPE:
0
1

8-26

= Standard units (m, kN, sec with some historic deviations)


= German buildings (sections in cm, system in m)

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

2
3
4

= German steel construction, (sections mm,cm2 ,dm4 , system in m)


= Bridge construction (like 0 but internal forces in MN instead of kN)
= Soil Mechanics (m, kN, sec)

5
6
7
8

= Structural Engineering (sections in mm, system in m)


= Metric system (All dimensions in mm, loads in kN)
= Mechanical (All dimensions in mm, loads in N)
= imperial (US-Units, inch, foot, lbs, kip)

It is also possible to select a specific object form the list of implicit units,
specified in the CDBASE.CHM see 2.5 Database description (e.g. 1001 or
GEO_LENGTH, see cdbase.chm) and to change the unit or number of decimal
digits just for this item.
8.3.9

PAGE Control of Input/Output

PAGE
Item

Description

FIRS

Number of the first page of the output

Unit

Default

Negative entries turn page numbering off


LINE

Number of lines per page

MARG

Column number for left margin

LANO

Output language, if implemented

LANI

German

English

French

Spanish

Input language, if implemented


0

German

English

UNIO

System of units for output

UNII

System of units for input

FORM

Format of page header

Table continued on next page.

SOFiSTiK 2016

8-27

SOFiSTiK | CADINP - Input Language

Item

PRIL

PAG

Description

single line header

multiline header

ZTVK with graphic char.

ZTVK without graphic char.

short header

Printout level in the output file


-2

error messages only

-1

warnings as well

additional information

computing times as well

Identification of page

Unit

Default

LT12

(e.g. page II/)

The record PAGE is somehow obsolete, because its parameters are derived
from the operating system or should be defined in the SOFISTIK.DEF file. All
parameters except the languages and units may be defined in Report Browser
at the time of printing.
0. single line header with long text
Dr.-Eng. Charly Brown * 9012 Newtown * 12, Software drive, Tel.08144/2725
AQUA
- General Cross Sections (V 1.0-97) 25.05.95
Page
11
Title of structure (1st and all further HEAD lines)

1. multiline header (only if provided explicitly)


Dr.-Eng. Charly Brown, Consulting Engineer
9012 Newtown * 12, Software drive, Tel.08144/2725
AQUA
- General Cross Sections ( 6087)
Title of structure (1st

Page :
11
25.05.95

and all further HEAD lines)

2. ZTVK header and title box


+------------------------------------------------------------+-----------+
!Bauteil : Bauteilbeschreibung (3.KOPF Zeile)
!Archiv Nr. !
!Block
: Blockbeschreibung (4.KOPF Zeile)
Seite:
11 !
!
+------------------------------------------------------------+
!
!Vorgang : Vorgangsbeschreibung (5. KOPF Zeile)
!
!

8-28

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

+------------------------------------------------------------+-----------+
+------------------------------------------------------------+-----------+
!Subsructure: Substructure description (3rd HEAD line)
!Archive No.!
!Block
: Block description (4th HEAD line)
page:
11 !
!
+------------------------------------------------------------+
!
!Method
: Method description (5th HEAD line)
!
!
+------------------------------------------------------------+-----------+

3. Short Header
AQUA
5.0-95 Dr.-Eng.Charly Brown
Title of structure (1st head line)

page 2
date 25.05.95

In the ZTVK Version only the first 48 characters of header lines are used. The
persistent name of the company can be changed only by SOFiSTiK. However
it is possible to change the name for a specific project within the SOFiSTiKEnvironment.
8.3.10

SIZE Graphic Format

SIZE
Item

Description

Unit

Default

TYPE

Paper size

-URS

Positive value

landscape format

Negative value portrait format


SC

Scale
0

format filling

engineering scale, best possible for filling the page

Paper width

cm

Paper height

cm

MARG

Draws a border

LT

FULL

NO
draws an inner border + scale
here W and H define the size
Table continued on next page.

SOFiSTiK 2016

8-29

SOFiSTiK | CADINP - Input Language

Item

Description

Unit

Default

LT

of the area to be drawn at


(for single sheet plotters and
laser printers)
YES
draws a free border around
the drawing W and H define
the size of the paper (2cm
margin, otherwise .5cm)
FULL
an additional border to cut the
drawing at the outer paper
limits is drawn (for drum
plotters)
FORM

Form of the border


STAN

standard frame

ZTVK

ZTVK-88 frame

URS

Report Browser definition

This record appears within all programs having a graphical output. It defines the
output format. In general, there are two variations of the task.

The user selects the paper format either implicitly using TYPE or explicitly by
the width W and the height H. The program can set the scale itself by picking
the largest possible scale with the common values of 1:1, 1:2 and 1:5 or
their multiples. An explicit setting of the scale SC will be used, if technically
feasible. Setting SC to 0 results in the largest possible drawing regardless of
the scale.

The user specifies the scale and by setting W and/or H to zero the appropriate paper size is automatically chosen. If only one of the two values is
set to zero, then the drawing size will be automatically calculated to fit in the
second direction, the scale does not need to be defined in this case.

When using TYPE you can also specify the American formats or the special
format for Hewlett-Packard Plotters instead of the DIN sizes. In this case a frame
is created around the picture using the inputs of FORM and MARG. This picture
8-30

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

will printed with program Report Browser in exactly this form. In the case of URS
or FORM URS a picture without a frame is created. Then the frame is drawing
from program Report Browser before printing. DINA URS correspond to a DINA4 paper, in this case W and H change the picture size. FORM URS calculates
the pictures size from the given paper size, e.g. SIZE 3 FORM URS; in this
case W and H set the paper size. A preceding minus sign selects the portrait
orientation:
URS,-URS

The maximum picture size usable within Report Browser

A,-A

ANSI Paper A (11 x 8.5 inch)

B,-B

ANSI Paper B (17 x 11 inch)

C,-C

ANSI Paper C (22 x 17 inch)

D,-D

ANSI Paper D (34 x 22 inch)

HPA,-HPA

Hewlett Packard Paper A (259 x 199 mm)

HPB,-HPB

Hewlett Packard Paper B (416 x 259 mm)

HPC,-HPC

Hewlett Packard Paper C (529 x 378 mm)

HPD,-HPD

Hewlett Packard Paper D (809 x 528 mm)

HP4,-HP4

Hewlett Packard Paper 4 (276 x 193 mm)

HP3,-HP3

Hewlett Packard Paper 3 (404 x 276 mm)

HP2,-HP2

Hewlett Packard Paper 2 (564 x 366 mm)

HP1,-HP1

Hewlett Packard Paper 1 (787 x 564 mm)

WIN,-WIN

Paper size of current WINDOWS printer

MP,-MP

Matrix printers with 8 x 12 inch (200 x 287 mm)

LP,-LP

Laser printers with A4 paper (198.4 x 280 mm)

MPW

Wider Matrix-printers 14 x 12 inch paper


For these formats the default is MARG NO.

SOFiSTiK 2016

8-31

SOFiSTiK | CADINP - Input Language

8.4

Generation of Pictures

With the following records true scale sketches may be inserted within the comments before or after the analysis. The classical GKS-primitives Polyline, Polymarker, fill area and text are available. Further there are the generalized Drawing
primitive and a special command to measure distances which provides extended
labelling possibilities.
8.4.1

<PICT> Start of a picture

<PICT>
Item

Description

Unit

Default

XCM

Horizontal size

cm

YCM

Vertical size

cm

TEXT

Heading of picture

Lt64

Every picture starts with the record <PICT> . It contains all elements up to the
next </PICT>. A transformation No 1 will be preset in cm as dimension.
8.4.2

GNT Scale of a picture

GNT
Item

Description

Unit

Default

NO

Number of transformation

SC

Desired Scale

XMIN

Window of user-coordinates

YMIN

XMAX

YMAX

cm

WYMI

cm

WXMA

cm

WYMA

cm

WXMI

8-32

Window of workstation (paper space)

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

A transformation is selected (only NO given) or defined with this record. The


program will automatically select an uniform scaling in all directions. If the user
wishes different scalings in X and Y-direction. he has to specify SC < 0 and all
four coordinates of the window. GKS supports three different transformations.
8.4.3

GPL Polyline

GPL
Item

Description

Unit

Default

X1

Coordinates of Polygon

X1

Y2

Y1

....

...

...

X16

X15

Y16

Y15

Y1
X2

8.4.4

(Alternate definition of polygons is via multiple records each containing only one single
vertex X1,Y1. This allows the definition of
up to 255 vertices)

GPM Polymarker

GPM
Item

Description

Unit

Default

X1

Coordinates of Polymarker locations

Y1

X2

X1

Y2

Y1

....

...

...

X16

X15

Y16

Y15

SOFiSTiK 2016

8-33

SOFiSTiK | CADINP - Input Language

8.4.5

GFA Fill Area

GFA
Item

Description

Unit

Default

X1

Coordinates of Fill area

X1

Y2

Y1

....

...

...

X16

X15

Y16

Y15

Y1
X2

8.4.6

(Alternate definition of polygons is via multiple records each containing only one single
vertex X1,Y1. This allows the definition of
up to 255 vertices)

GGDP Generalized Drawing Primitive

GGDP
Item

Description

Unit

Default

TYPE

Type of element

LT

CIRC

CIRC

Full circle

BUTT

Filled circle

ARC

circular arc

VECT

centred vectors

VEC1

starting vectors

VEC2

ending vectors

X1

Coordinates or

Y1

Increments of coordinates of element

X2

Y2

Table continued on next page.

8-34

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

Item

Description

Unit

Default

....

....

....

X15

Y15

The GGDP is a method provided by GKS to create more complex primitives.


With SOFiSTiK these are:
CIRC

A full circle with centre at (X1,Y1) and a point on the periphery


(X2,Y2). OPT is not used.

BUTT

A filled circle with centre at (X1,Y1) and a point on the periphery


(X2,Y2). OPT is not used.

ARC

A circular arc with centre at (X1,Y1) and a periphery from point


(X2,Y2) to (X3,Y3). OPT is not used.

VECT

A single vector at point (X1,Y1) with the directional components


(X2,Y2) or an array of vectors extending along the base line from
P1 to P3 to P5 etc in the direction P2, P4 P6 etc. VECT will draw the
vectors with its centre at the baseline, while VEC1 will put the starting point and VEC2 will use the end point with the arrow head at the
baseline.

8.4.7

GTXT Text Label

GTXT
Item

Description

Coordinates of insertion point

Unit

Default

TEXT

Text

VAL

numeric value

DIM

Dimension

ND

Number of digits

Text may be positioned in several ways. The displayed text itself may be composed from a given text and an numerical value. For the latter you may select a

SOFiSTiK 2016

8-35

SOFiSTiK | CADINP - Input Language

conversion and format according to the cdbase.chm see 2.5 Database.


8.4.8

GSCA Dimensioning

GSCA
Item

Description

X1

Coordinates of first point

Y1
X2

Coordinates of second point

Y2

Unit

Default

TEXT

Text

VAL

Numeric value

DIM

Dimension

ND

Number of digits

GSCA is a special form of labelling. A dimensioning line will be drawn and a


text will be written at the line. The default of the text is the distance between the
two points, but it may be specified as explicit number and/or a given text. The
combination of the default distance with a given text requires the text to end with
an equal = sign. For the shown value a conversion and format according to
the cdbase.chm see 2.5 Database may be selected.

8.5

Attributes of Graphic Representations

The drawing elements Line, Mark, Text and Area can have various attributes.
The user usually specifies all the attributes within the programs with graphical
output by entering bundled numbers. These are constructed according to the
following expression:
nd = 1000 co + 100 br + typ

For Windows programs different palettes are foreseen for screens with bright or
dark background as well as monochrome or coloured printers. You can change
these definitions via Report Browser Options in the Registry for all programs.
The following CADINP-records are only available within the picture definitions
<PICT> ... </PICT>. The comments and descriptions of the parameters are
valid however for all other graphical programs as well.

8-36

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

8.5.1

GCOL Colour Selection

GCOL
Item

Description

Unit

Default

COL

Pen number or colour name

Red component

Green component

Blue component

GCOL selects the colour for all primitives. For COL you have the choice between
one of the numbers from 1 to 15 or the literals for the standard colours from
below. If your device allows it, you may specify a colour (recommended 9 to 15)
by its RGB-components.
col = Colour Index

8.5.2

0 = background

STAN

1 = black or white

(Pen 1)

RED

2 = red

(Pen 2)

GREE

3 = green

(Pen 3)

BLUE

4 = blue

(Pen 4)

YELL

5 = yellow

(Pen 5)

MAGE

6 = magenta

(Pen 6)

CYAN

7 = cyan

(Pen 7)

BROW

8 = brown

(Pen 8)

GPLI Polyline Attributes

GPLI
Item

Description

IND

Bundled SOFiSTiK-Index

COL

Colour (as with GCOL)

TYPE

Line type

Unit

Default

/ LT

LT

Table continued on next page.

SOFiSTiK 2016

8-37

SOFiSTiK | CADINP - Input Language

Item

Description

SOLI

solid

DASH

dashed

DOT

dotted

Unit

Default

DDOT dash-dotted
NDAS

narrow dashed

NDOT narrow dotted


NDDO narrow dash dotted
WDAS wide dashed
WDOT wide dotted
WDDO wide dash-dotted
WIDT

Width factor of line

SCAT

Style of dimensioning GSCA

inclined small lines

small circles

arrow heads

For Polylines holds for the bundled index:


nd = 1000 co + 100 dt + type

widt = Line thickness factor

0 = normal thickness
1 = thickness times 1.4
2 = thickness times 2.0
3 = thickness times 2.8
4 = thickness times 4.0
5 = thickness times 5.6
etc.

type = line style

1 = continuous
2 = medium dashed
3 = medium dotted
4 = medium dotted dashed
5 = tightly dashed
6 = tightly dotted

8-38

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

7 = tightly dotted dashed


8 = sparsely dashed
9 = sparsely dotted
10 = sparsely dotted dash
8.5.3

GPMI Polymarker Attributes

GPMI
Item

Description

IND

Bundled SOFiSTiK-Index

COL

Colour (as with GCOL)

TYPE

Marker type (Number or Literal)

Unit

Default

/ LT

LT

.+*oX
SIZE

Scale factor

For Polymarkers hold:


nd = 1000 co + 100 sze + type

size = marker size

0 = normal size
1 = size times 1.4
2 = size times 2.0
3 = size times 2.8
4 = size times 4.0
5 = size times 5.6
etc.

type = Mark type

8.5.4

1 = . Point
2 = + Plus
3 = * Star
4 = o Circle
5 = x Cross

GTXI Text Attributes

SOFiSTiK 2016

8-39

SOFiSTiK | CADINP - Input Language

GTXI
Item

Description

IND

Bundled SOFiSTiK-Index

COL

Colour (as with GCOL)

Text height

BX

Writing direction

BY
HALI

Horizontal alignment

Unit

Default

/ LT

cm

LT

NORM

LT

NORM

LT

RIGH

NORM default of PATH

VALI

LEFT

aligned to the left

CENT

centred

RIGH

aligned to the right

Vertical alignment
NORM default of PATH

PATH

TOP

top of cell

CAP

top of characters

HALF

centre line

BASE

writing line

BOTT

lower bottom line

Writing direction
RIGH

to the right

LEFT

to the left

UP

upwards

DOWN downwards
EXPA

Expansion factor

1.0

SPAC

Additional spacing

0.0

FONT

Font number

For text the following hold for the bundled index:


nd = 1000 co + ont

font = Character style

8-40

installation dependent

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

8.5.5

GFAI Fill Area Attributes

GFAI
Item

Description

IND

Bundled SOFiSTiK-Index

COL

Colour (as with GCOL)

STYL

Fill area Style

TYPE

HOLL

Hollow

SOLI

Solid

PATT

Pattern

HATC

Hatch

BPAT

Pattern with boundary

BHAT

Hatch with boundary

Style index

Unit

Default

/ LT

LT

For areas (Fill Area) for the bundled index holds:


nd = 1000 co + 100 sty + type

ibr = Fill Area Style

0 = hollow (only boundary drawn)


1 = solid (entire area filled)
2 = pattern
3 = hatch

The effect of the parameter type is device dependent. Classical vector plotters for example cannot represent any bit patterns. Pattern 1 corresponds to
completely blank, whereas pattern 2 usually corresponds to a uniform sparse
shading, which gets more dense by increasing numbers. Special patterns are
reserved from type=11 and above. Adding a 32 to a pattern will make it opaque.
Different variations exist for opaque hatch lines, in one or two directions.
type

SOFiSTiK 2016

1/2/3

= vertical / horizontal / vertical+horizontal

4/5/6

= diagonal +45 deg / -45 deg / +45 and -45 deg

7-12

= as 1 to 6 dashed

8-41

SOFiSTiK | CADINP - Input Language

8.6
8.6.1

13-24

= as 1 to 12 with larger scale

25,26

= reinforced concrete

27

= earth

Insertion of a Picture
<LINK> Insertion of a Picture

<LINK>
Item

Description

filename.bmp

Unit

Default

LT72

Pictures with BMP-format can be inserted with <Link> in input files and templates.
The insertion of pictures is not possible in a block for texts with <Text> ...
</Text> or for pictures which should be generated with <Pict> ... </Pict>.

8.7

Parametric Input

The current version of the input language CADINP allows the definition of standard input with free parameters.
For example, a simple truss of the following type can be defined by:
type = Fill Area Style Index (only styl =2/3)

Figure 8.2: Truss

The parameters here are the span width, the height as well as the crosssectional area of the bars. An input for SOFIMSHA could be defined as follows:

8-42

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

HEAD TRUSS
$
LET#1
12.40
$ SPAN WIDTH
LET#2
2.30
$ HEIGHT
$
NODE
1 0 0 PP
(2 4 1) (#1/4 #1/4) 0
5 #1 0 PP
NODE
6 #1/4 -#2/2
7 #1/2 -#2
8 3*#1/4 -#2/2
TRUS
(1 4 1)
(1 1)
(2 1) NCS 1
TRUS
5 1 6 NCS 1
6 6 7 == ; 7 7 8 == ; 8 8 5 ==
TRUS
(11 13 1) (2 1)
(6 1) NCS 2
TRUS
(14 15 1) (6 2)
3
NCS 2
END
More powerful data generation is available using loops. For example, the following input allows the generation of a series of nodes on a hyperbolic arc:
PROG SOFIMSHA
HEAD Cooling Tower
$ Meridian Hyperbolic equation (r/r0)**2-((z-z0)/zz)**2 = 1
$ (r1/r0)**2-(-z0/zz)**2
= 1 => (1/zz)**2
$ (r2/r0)**2-((h-z0)/zz)**2 = 1
$ parameter:
sto#H
160.0 $ Total Height
sto#R0
30.0 $ smallest radius
sto#R1
55.0 $ Radius at bottom
sto#R2
35.0 $ Radius at top
let#1
SQR(#r1**2-#r0**2)
LET#z0 #H*#1*(SQR(#R2**2-#R0**2)-#1)/(#R2**2-#R1**2)
let#zz #z0/SQR((#r1/#r0)**2-1.0)
let#m
16
$ subdivision in height
TXB Generation of a hyperbolic cooling tower
TXB
height
radius
TXB
0.0
#(r1,9.1)
TXB
#(z0,9.1)
#(r0,9.1)
TXB
#(h,8.1)
#(r2,9.1)
TXB
TXB Parameter zz of hyperbolic equation = #(zz,9.3)
$

SOFiSTiK 2016

8-43

SOFiSTiK | CADINP - Input Language

let#2 #H/#m
$ delta-z
LOOP#1 #m+1 ; let#z #1*#2
NODE #1*50+1 #r0*sqr(1.+((#z-#z0)/#zz)**2) 0.0 #z
ENDLOOP
For the beginner these inputs are likely to be confusing, however, this is a very
powerful possibility which allows to automize frequently happening calculations.
Many macros have developed from simple beginnings.

8.8

Compatibility of Data files

Text based input data is suited to be used for long term storage of data, better
than any proprietary binary format. Unfortunately the input syntax is changed
some times,
SOFiSTiK has to trade the readability of the manual, the catch of data errors
and the compatibility of the data records.
Thus we have established the following guidelines:

Input records will be extended most likely at the end of the structure, but if
an entry fits in better at an other position (e.g. third coordinate added) it will
be inserted. Especially designations will remain the last entry in most cases.
Thus the user should use the names of the item as a prefix for all extended
data, eg.:
NODE 100 10.25 20.00 24.00 FIX PZ
For larger data volumes the use of a table is always favourable, the use of
explicit standard items - should be avoided. For exported data the deletion
of unnecessary data may help to reuse elder data records.

It is also possible that the names of a record or the items will be changed.
This is a strong indication for a changed syntax or data format. The general
procedure is that there will be a warning about an obsolete feature to be
removed in a future release. We recommend to change data records to be
intented to be used in upcoming versions rather soon. Althouh we try to keep
the obsoleted input as long as possible, it will be removed from the manuals
for the next major release.

The most critical issue is the change of the format for an unchanged item
name. We try to catch old data definitions (eg. mm instead of m) or to issue
a warning about possible old data (If a warning is issued, an explicit unit
definition might clearify the subject.) But the user should control his data
after a switch to a new major release thoroughly.

However a rather common case is that the defaults have to be changed. This

8-44

SOFiSTiK 2016

CADINP - Input Language | SOFiSTiK

may be triggered by change of the design codes, a better programming logic


or the demands of our customers. There is no golden way. If one specifies
only the minimum range of values, one may reuse the data more easily,
but it may happen that a new release will produce different results. The
default to select national dependant parameters depending on the settings
of the operating system is a nice feature, but it may create different results
on different computers and should be avoided therefore.

SOFiSTiK 2016

8-45

SOFiSTiK | CADINP - Input Language

8-46

SOFiSTiK 2016

DEF - Environment Variables | SOFiSTiK

DEF - Environment Variables

Some parameters of the SOFiSTiK programs can be influenced by means of


environment variables. The supported set of environment variables is listed at
the end of this section. Primarily, environment variables can be used to affect:

Settings for layout (paper size, output language etc)

Parameters for the database CDBASE (buffer, multitasking etc.)

Standard input records

The environment variables may be set using classical commands of the respective operating system, e.g.:
Windows Desktop

My ComputerPropertiesExtended

Windows CMD

SET parameter=value

Linux Bash

eport parameter=value

It is recommended, however, to gather these parameters in one configuration


file named sofistik.def., which can also be provided project-specific. In this file
all variables for SOFiSTiK-Environment as well as any definitions of input blocks
can be stored (see chapter 9: DEF -Environment Variables):
e.g.
SOFISTIK_C=49
GRAFSIZE=SIZE -HP 0
HEAD1=New HQ of Xyz-Insurance-Company
STDMAT=CONC 1 B 35 ; STEE 2 BST 500

The definition of the input file has priority. Then comes the definition in the
environment of the operating system, and at last a definition in SOFISTIK.DEF.
If for different projects different properties are requested, it is recommended to
save the SOFiSTiK.DEF file in the project directory. This should be done when
editing with TEDDY via SOFiSTiK Options.
The following table contains the currently used values:
Variable

Parameters

possible values

(separated by comma)
SOFISTIK_NAME

alternate user name

SOFISTIK_C

nation

00

Generic Europe

(International Telefon code)

01

United states

SOFiSTiK 2016

9-1

SOFiSTiK | DEF - Environment Variables

Variable

Parameters

possible values

(separated by comma)

ch_set

49

Germany

43

Austria

41

Switzerland

44

Great Britain

81

Nippon

86

China

91

India

30

Greece

31

Netherlands

32

Belgium

33

France

34

Spain

45

Danmark

46

Sweden

47

Norway

39

Italy

351 =

Portugal

352 =

Luxembourg

353 =

Ireland

358 =

Suomi/Finland

-2

utf8

German

English

one line

multiple lines

ZTVK grafical

ZTVK standard
chars

deutsch

englisch

franzsisch

spanisch

-3

nothing at all

(character set of computer)


Input language
SOFISTIK_A

Headder type in printout

language of output

level of messages

9-2

SOFiSTiK 2016

DEF - Environment Variables | SOFiSTiK

Variable

Parameters

possible values

(separated by comma)

Units of output
SOFISTIK_P

-2

only error messages

-1

errors and warnings

statistics

computing times

see cdbase.chm 2.5

Parameters for LST/ERG files


number of lines per page

68

No of columns left margin

No of lines bottom margin

No of lines top margin

Type of formfeed

blank lines only

form-feed character

default

convert UNIX to WIN

Type of linefeed

Total of printable columns

82

Pagenumber

default

-1

omit numbers

KOPF1

First Headder Line

KOPF2

Second Headder Line

KOPF3

Third Headder Line

SOFISTIK_PRODIR

alternate directory for the database


and project files

Saves all project files without


explicit pathname

SOFISTIK_TMPDIR

alternate directory for all temporary


project files

Defaults to
SOFISTIK_PRODIR

PSJOBPAR

Default Values for WPS/SPS

see Chapter 10.11.

PSJOBINFO

Time & File stamping for WPS/SPS

see Chapter 10.11.

CDBASEMEM

Size of Memory for CDBASE in


Bytes or MBytes

default: 1MB

CDACCESS

CDBASE multitasking feature

SINGLE = deactivate
NOWAIT = do not wait
if locked
(useful for

SOFiSTiK 2016

9-3

SOFiSTiK | DEF - Environment Variables

Variable

Parameters

possible values

(separated by comma)
remote analysis)
CDBASETEMP
CDBASEVER

Directoryname
for
temporary
scratch files
Version of CDBASE format

Using TEMP or TMP if not


defined
CDBASEVER=501
maximum 256 GB (Default)
CDBASEVER=503
maximum 1024 GB

SOF_NUM_THREADS Default number of threads to be


used

NUMBER_OF_PROCESSORS
or OMP_NUM_THREADS

The variables which are described in the above table have to be set in the
SOFISTIK.DEF at beginning before the first expression in parentheses:
SOFISTIK_C=...
SOFISTIK_A=...
SOFISTIK_P=...
[Layout-1]
....

9-4

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

10

Starting an Analysis

10.1

General

Each program expects its input data in a file. The input consists of records,
which have a name and are constructed in free format according to the CADINP
rules.
Generally several individual modules are executed while working on a project.
The interaction of these modules is necessary for a complete analysis. In this
case the normal procedure is to gather the entire data in one or a few files,
and through the appropriate records within the data make calls to the respective
programs.
In principle, an input file may be structured as follows:
PROG AQUA
$ Material and cross-section definition $
END
PROG SOFiMSHA
$ Input data for FE-system $
END
PROG ASE
$ Input data for analysis of 1st load case $
END
PROG ASE
$ Input data for analysis of 2nd load case $
END
SYS COPY *.plb d: $ copy the report file somewhere else ... $
PROG WING
$ System and result plots $
END

The first line should be a PROG line. Each module can be called as often as
desired. The order of execution of the programs corresponds to the order of
the PROG lines in the file. If -PROG is entered instead of PROG or +PROG, the
associated module will be omitted. Single modules can also be selected directly.

SOFiSTiK 2016

10-1

SOFiSTiK | Starting an Analysis

Hint
Processing a complete SOFiSTiK input file can be done either interactively
using WPS or alternatively as a batch-job using SPS.

10.2

#DEFINE - Parameter Substitution

SPS is further capable of making global replacements in the input file. The
declaration of text blocks must take place before they are used. This is done
via a line #define text=name. The name of a text block consists of up to 10
characters without $. The first character of a name of a text block has to be
a letter. The value of the text block is a text of arbitrary length. Parameters
within an assignment are not evaluated until the replacement. A redefinition of
an assignment is possible.
A parameter in the input data or in a block can be referred to by using the syntax
$(name). Blank spaces are not allowed between $ and (. Upper/lower case
letters have no influence. The replacement can be recursive. Definitions like
$(A$(INDEX)) are allowed.
Example:
$PROG
#define
#define
#define
#define

10-2

(extension for TEDDY)


LENGTH=3.70
WIDTH=30
HEIGHT=50
PLATE=50 20 10 80

PROG
CONC
STEE
SREC
SREC
END

AQUA
1 B 25
1 BST 500
1 $(HEIGHT) $(WIDTH)
2 $(PLATE) ASU 2.3

PROG
SYST
NODE
NODE
NODE
BEAM
BEAM
END

SOFIMSHA
GIRD
1 0.0 0.0 FIX PP
2 $(LENGTH)/2 0.0
3 $(LENGTH)
1 1 2 1
2 2 3 1

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

Unlike the CADINP variables #() the $() variables are replaced by strings, so we
can insert literals or generation macros.
There are two default parameters, namely $(NAME) containing the primary
name of the output file and $(PROJECT) containing the name of the project.
These can be helpful especially for SYS commands.
Text blocks which are not defined in the input file can be set with a SET-record.
When the command (e.g. in the environment) is given:
SET SIZE=LP O FORM ZTVK
SPS can insert in all the files the relevant format:
SIZE $(SIZE)
Moreover it is possible to describe global parameters for SPS in a
SOFISTIK.DEF file. This results in a hierarchy of three layers:
Firstly a definition in the input data
Secondly the definition with SET (to be avoided!)
Lastly a definition in SOFISTIK.DEF

10.3

#INCLUDE - Block Definitions

By the use of block building several lines of the data can be used more than
once at any point in the dataset. A maximum of 256 internal blocks and an
unlimited number of data blocks in an arbitrary order are allowed. Blocks can be
recursively built in a depth of up to 32 levels.
#DEFINE name

Beginning of block name (up to 8 characters)

#ENDDEF

End of block

#UNDEF name

Delete a defined block

#INCLUDE name

Insertion of block name from memory or file name

Using blocks does not only free the user from copying re-occurring input lines,
but also enables the use of subprograms.
Example:
#define SECT
$PROG AQUA
$ TRAPEZOIDAL CROSS-SECTION PARAMETER BO,BU,H

SOFiSTiK 2016

10-3

SOFiSTiK | Starting an Analysis

POLY UPZ
VERT 1 #1/2 -#3/2
2 #2/2 #3/2
CURF 3
#enddef
PROG AQUA
STEE 1 ST 37
SECT 1 ; LET#1 0.60,0.20,0.60
#include sect
SECT 2 ; LET#1 0.60,0.30,0.60
#include sect
SECT 3 ; LET#1 0.60,0.30,0.70
#include sect
END
When inserting files in UNIX it is important to consider the lower/uppercase letters used for the filenames! The old formats $BLOCK BEG/END/SET are still
supported, but should not be used anymore.

10.4

APPLY - Integration of data during the calculation

With the APPLY command a file can be included anywhere between two blocks
in the input data set, but not inside a module. This file should contain one or
more module calls +PROG.
While with #INCLUDE (see Section 10.3: #INCLUDE - Block Definitions) the
data are inserted before the calculation into the data set, the APPLY command
is executed during the computation, i.e. the data can be generated during a
calculation and thereafter be inserted at the right place.
Additionally APPLY is controlled with a sign +/- , that means with +APPLY the
command is executed, with -APPLY it will be skipped.
A typical example for the use of APPLY is the program CSM (Construction Stage
Manager). With the CSM a file $(NAME)_csm.dat is created. This file is inserted
with APPLY into the calculation.
+PROG CSM
...
END
+APPLY $(NAME)_csm.dat
+PROG ASE
...

10-4

$ contains at least one +PROG

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

END

10.5

#IF - Conditional Input

IF THEN ELSE constructions can be defined. This means that larger input
blocks can be inserted and removed, which is more difficult using the IF constructions in CADINP, and that several program calls can be grouped in one
block.
The relevant control lines are familiar to all C-Programmers. In the first column
the following possibilities can be used:
#if expression
any line, also PROG and SYS
#else
any line, also PROG and SYS

expression may be just the name of a block or a variable which is evaluated to

be true if it is defined and not empty and not equal to zero. But it might be also a
comparison $(MODE)==EC or $(MODE) < >EC or $(MEMBERS)>3. Be aware
however that the comparisons are purely lexically based on strings, adjusted to
the right for numbers, and to the left for all other cases. Therefore we have A <
B, AA < BA, 10 < 18 but unfortunately also 10.0 > 12.
If expression is not true, the first block will be skipped and the block after #else
will be used. Naturally the second block can be omitted if not needed.
These constructions can be nested in up to 32 levels. An unmotivated #else or
#endif will lead to errors, as well as an unfinished construction.
Example:
#define DOAQB=0
#if DOAQB
PROG AQB
HEAD .....
LC
.....
DESI .....
END
#endif

SOFiSTiK 2016

10-5

SOFiSTiK | Starting an Analysis

PROG STAR2
HEAD .....
#if DOAQB
$ Design with AQB
#else
DESI .....
#endif
.....
END
The indentation is only used for readability. In the above example STAR2 is used
for the design. If DOAQB=1, AQB is used for the design task.

10.6

Templates

A special form of input files is called a template. The structure of these files is
given as follows:
#DEFINE
#DEFINE
#DEFINE
#DEFINE

L1=10.0
L2=20.0
L3=30.0
P=12.0

PROG TEMPLATE (or any other program name)


LET#L1 $(L1)
LET#L2 $(L2)
LET#L3 $(L3)
LET#L #L1+#L2+#L3
TXA Introduction
<TEXT>
This is the analysis of a continuous beam with 3 spans:
L1 = <EDIT:L1>$(L1)</EDIT>
L2 = <EDIT:L2>$(L2)</EDIT>
L3 = <EDIT:L3>$(L3)</EDIT>
SUM = #(L,10.2)
</TEXT>
<PICT>
....
</PICT>
PROG AQUA
following al the data

10-6

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

In many cases this is like a normal dataset, which only includes the preface
of the total analysis. It is summarised under a special program name called
TEMPLATE. The input consists only of text and picture elements combined with
arithmetic expressions. But the mechanism is general available for all programs.
Now within Report Browser you may change the selected parameters and reanalyze this given module. This allows other users to benefit from these macros
which may contain rather complicated treatment, but need only a few problem
dependant parameters .

10.7

Iteractive Analysis with Multiple Modules

2nd Order Theory for nonlinear materials is contained in the programs


STAR2/AQB. However, only one method of computation of the reinforcement
can be considered by STAR2. A computation with different methods can be implemented by an iteration between AQB and STAR2. The iteration is controlled
by the parameter ITER of the record PROG.
PROG STAR2
1st Step for 1st Order Theory
CTRL I
Definition of loading cases
LC ....
END
PROG AQB ITER parm
parm separated by blank spaces
BEAM ....; LC....
1st selection and design definition
ULTI ....; NSTR....
END
BEAM ....; LC....
2nd selection and design definition
ULTI ....; NSTR....
END
PROG STAR2 ITER parm
HEAD ....
CTRL II 1
END
The maximum number of iterations to be made is regulated by ITER (e.g. ITER
30), default is 20 iterations.
This mechanism has been extended with Release 23 for other combinations of
general modules. To terminate the iteration it is required to specify within the
CADINP-definition explicitly EXIT_ITERATION.
PROG TEMPLATE
STO#TARGET 0 ; STO#PARAM 1.0
PROG AQUA ITER

SOFiSTiK 2016

10-7

SOFiSTiK | Starting an Analysis

RCL#PARAM
QNR ....
Definition of sectuion using #PARAM
PROG AQB ITER
BEME ....
Design and save results
ENDE
@KEY / LET# TARGET ...
Calculate a target function to
become zero
IF ABS(#TARGET) < 0.001
EXIT_ITERATION
ELSE
STO#PARAM new_target_value
ENDIF

10.8

Operating System Commands

Any desired shell commands can be integrated in an analysis. Parameter substitution is also active for these lines, for example the character string $(NAME) is
replaced by the primary name of the input or the output file, while $(PROJECT)
is replaced by the name of the project.
*SYS command

command

will be executed as in any


batch file, if the last PROG
line was active.

+SYS command

command

will be executed as in any


batch file.

-SYS command

command

will not be executed, all


following *SYS lines
deactivated.

e.g:
+SYS del $(PROJECT).$D1

deletes the stiffness matrix

+SYS wait name.exe parameter

WPS is initiated to wait with the


processing of the further modules
until the active process is finished
with +SYS -wait name.exe.

10.9

Job History

In an analysis with many individual programs it can become of importance to


make a reconstruction for the time-history of a problem. Therefore SPS adds
some auxiliary information to the generated input files. The information is con-

10-8

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

trolled by an environment variable:


SET PSJOBINFO=n
n
n
n
n

=
=
=
=

0
1
2
3

no information
filename and date
(only in data echo)
like 1, including job number (only in data echo)
like 2, yet in an additionally generated header

The default is 2. The job number consists of an 8-letter description of the computer and a varying number, which is stored in a PSJOBNR file. In a multiuser
environment PSJOBNR should be put in the current directory, if access conflicts
have occurred.
Examples for PSJOBINFO:
PROG AQUA
$ Datafile: D:\STATIC\P00\DAT0.DAT
HEAD .....
PROG AQUA
$ Datafile: D:\STATIC\P00\DAT0.DAT
$ Jobnumber: PC-Nr:17/8700063
HEAD .....

(.#01) 14:48:48 25/05/95

(.#01)

25/05/95
14:48:48

The file PSJOBNR is needed for cases with PSJOBINFO=2 or higher. The first
8 columns contain any desired text. They are not printed, if they are blank. If
SPS does not find a PSJOBNR file, it will create one in the local directory.

10.10

Start of a Single Program

Sometimes it can occur that one would like to start a program directly. This is
generally possible if the input file already contains all parameter replacements.
If you want to create a parsed file from a normal input file, you can do this by
using WPS with
#endif File > Save Parsed File ...
if you want to save the complete parsed file or alternatively with
File > Save Parsed Module: name ...
if only a single module is required to be parsed. The module selection is done
in the WPS-tree.

SOFiSTiK 2016

10-9

SOFiSTiK | Starting an Analysis

Figure 10.1: Start of a Single Program

The start of the single programs occurs then with


program filename [ -parm] [ projekt]
filename is the name of the input file; it indicates also the basic name of the
output files. If the name contains blanks, it must be enclosed with . project

is the name of the data base. In general the same parameters as for SPS are
used in parameter. Some extra parameters are added though. For example
in controlling, what type of metafile is to be created and whether an existing
metafile is appended or deleted.
If one starts an analysis program without using any parameters, the program
will start up by showing its name, version number and the list of the possible
parameters. The user is asked for the name of an input file. An empty input file

10-10

SOFiSTiK 2016

Starting an Analysis | SOFiSTiK

(or Return key) ends the program immediately. This procedure is helpful in order
to test the integrity of the program. The license and the version of the ERR-file
are checked.

10.11

Special Features for Start

For special cases the user may start the program from a command shell by using
the following command lines:
Parameter

Description

+ or ++

Opens the last file or the last but one. Is used without
a switch - or / .
Allows the start of up to 5 instances

-0 -1 -2 -3 -4
-nosingle
-test

-b

-e

-close

-noclose
-z
-run
-run:xx

SOFiSTiK 2016

Starts the application as a separate instance (no single application).


A general test flag is set. This is only of interest for
the developers. Depending on the level of development, an individual message window is activated.
WPS starts in batch mode. The calculation is started
immediately and at the end the window is closed automatically.
Generates a message window at the end of the calculation if an error occurs. Makes sense only in connection with -b or -run. If the parameter -e is not set
and the calculation ends with an error, no message
window is indicated. Nevertheless, WPS does not
end, so that the error can be read in the error protocol.
Closes the window after calculating regardless of
whether an error has occurred or not. Makes sense
only in connection with -b or -run and without -e.
After a calculation the window does not close. Makes
sense only in connection with -b or -run.
Attaches the result file (name.plb or name.erg) to a
perhaps available result file.
The calculation starts immediately (e.g. when calling
from Teddy with quick start).
The calculation starts immediately (e.g. when calling
from Teddy with quick start). xx is the number of
the PROG line, which is the only active module to be
calculated.

10-11

SOFiSTiK | Starting an Analysis

Parameter

Description

-urs:xx

Sets the module PROG module urs: xx active and


all other inactive.
Name of the CDB (if the name differs from DAT
name).

-cdb:name

10-12

SOFiSTiK 2016

Output | SOFiSTiK

11

Output

During calculation with WPS / SPS in general three output files are generated:
- the Report Browser output and graphic representations (.plb)
- the protocol file (.prt)
- the result file (.lst and .erg)
Hint
i

The recommended and officially tested Printer Fonts are Consolas 9pt
and Courier New 8pt.

11.1

Result Output with the Report Browser

11.1.1

General

With the Report Browser the printout from all SOFiSTiK programs conveniently
and easily is accumulated and sent to the printing device.
The Report Browser has a similar layout as the Windows-Explorer and
provides the user with various options for designing individual printout. e.g. in
the selective choice of the output volume (text / graphics) or in the layout design
(company logo, footer, etc.).
General settings, such as font or the maximum file size that can be fully
loaded, are defined in the menu SOFiSTiK User Option . Project related settings can be set globally with SOFiSTiK Global Options if they apply for multiple
projects, or with SOFiSTiK Project Options , if they only apply to one project (for
further explanations, see also chapter 2.10 (see SOFiSTiK Options).

SOFiSTiK 2016

11-1

SOFiSTiK | Output

Figure 11.1: Project Options setting for a page frame

11.1.2

Activation of Report Browser

After an analysis the printout (with the extension .plb) can be opened via
the Report Browser icon.
The output can be modified according to user preferences. The user-specified
settings are stored in a corresponding .urs file and are usually available after a
recalculation.
11.1.3

Features

Selecting the volume of the printout: The output volume can be configured
by the user to his requirements. With the bulb- icon in the Report Browser tree, the printout of the modules is activated or deactivated. With the bookicons you can switch on and off the sections. The settings for the output volume
are saved in the corresponding .urs file and are normally available again after
a recalculation. Individual sections can be temporarily moved in the Report
Browser - tree and the changes are considered when you print the file. However
the changed sequence is no longer available after a recalculation. Therefore the
requested module- order should be defined already in the input file.

11-2

SOFiSTiK 2016

Output | SOFiSTiK

Figure 11.2: Selecting the volume of the printout (1 - Activate / Deactivate the
Module Results)

Insert table of contents


With Insert Insert Table of Contents there is generated automatically a table of
contents of the complete printout. For the module- headings in the table of contents, the module text from the Report Browser - tree is inserted, or the module
name if no text is defined. Disabled sections are not included. Furthermore,
the page number of the printout is added. The setting Insert Table of Contents is
saved in the .urs file.

SOFiSTiK 2016

11-3

SOFiSTiK | Output

11.1.4

Output in table format

Starting with version SOFiSTiK 2016, the output in tabular form is increasingly
supported by the Report Browser. The readability of the output result has been
significantly improved.
Legend: If necessary, a legend to explain the output table is complemented. It
can be printed with a reduced font height and is also available in colored font.
Experienced users can hide the legend, but this is not generally recommended
SOFiSTiK menu User Options Report Browser .

11-4

SOFiSTiK 2016

Output | SOFiSTiK

Figure 11.3: Customizing the Report Browser

Footnotes: A further improvement of the readability of the result output is


achieved by explanatory footnotes. In contrast to the legend a footnote cannot
be hidden because it completes the printout results.

Figure 11.4: Footnotes

SOFiSTiK 2016

11-5

SOFiSTiK | Output

11.1.5

Printing Dialogue

Preview- Window: In the Print dialogue a preview window is added. Furthermore, the type and location of the selected printer is displayed.
Output to File: A printing output to a file is also possible. When selecting Generate PDF file, a PDF file created in the current directory with the associated
filename name.pdf. No additional Software from Adobe is required.

Figure 11.5: Output to File

Special Print Options: There can be printed several smaller pages on one
sheet. Temporarily the design of the page number or the date can be changed
for printing.

11-6

SOFiSTiK 2016

Output | SOFiSTiK

11.1.6

Advanced Features

Zoom handling: Besides the usual zoom functions, a slider is available, and
so a fast and continuous zooming in the current window is possible. With Ctrl +
MW (mouse wheel) a systematic-al zoom in or out is possible and with Ctrl +
mouse drag, a specific zoom window can be opened.
2

3
Figure 11.6: Zoom handling (1 - Zoom- functions; 2- Page zoom height / width; 3 continous zoom)

Options of Selection: By Report Browser following selection options are supported:

Line Block

Column Block

Table columns

Individual words

With Edit Copy , the selected area can be saved in the clipboard. A save
in Excel format also is possible Edit Copy to Excel , and in Excel Edit
Insert Contents .
The drawing of a line block with the mouse takes place
outside of the margin.

SOFiSTiK 2016

11-7

SOFiSTiK | Output

Figure 11.7: The drawing of a line block

The drawing of a column block with the mouse takes place within the margin. Alternatively first highlight a field in the header, now in connection with
right-click menu Select Select Column a full column block can be selected.

Figure 11.8: The drawing of a column block

11-8

SOFiSTiK 2016

Output | SOFiSTiK

11.1.7

Functions in control tree

Selection in the control tree: Similar as in the Explorer, several sections can
- key in connection with the mouse and can be
be selected with the Ctrl or
edited parallel in the right-click- menu.
Support of the chapters: If a result file is structured by chapter entries (
Input with TEDDY !#!Chapter), these chapters are supported by Report Browser.
The individual chapters can be activated or deactivated (at the disabled chapters
the icon is rotated by 90 ) and completely pushed together (in the right-clickmenu).

Figure 11.9: Support of the chapters

Assistance in troubleshooting: In case of warnings the affected modules and


the relevant sections of the printout are marked in the navigation tree by a green
cross.
Advanced editing capabilities of the .plb printout: Custom changes to the
result file (page breaks, blank lines, ...) are saved in the corresponding .urs file.
They are still available when the .plb is opened again. After a recalculation,
they will only be available in exceptional cases, because a unique assignment is
no longer possible.

SOFiSTiK 2016

11-9

SOFiSTiK | Output

11.1.8

Special Features for Start

For special cases the user may start the program from a command shell by
using the following command lines:

Start/access with filename

Request: ursula [/options] [filename]


filename

Instead of using the filename it is possible to use + or ++. Therewith


the last, respectively the next to the last file will be loaded.
With abc*.plb the File-Open-Dialog with the search screen will
show up. The input . is interpreted as *.* for the search screen.

Special access/start features

Options

Explanation

-t

Forces a text view.

-g

Forces a graphical-view.

-r

Forces an automatic refresh (without additional demand), if the


PLB has changed.

-stli:AutoCad-Version Supports steel schedule.


-txt:name.txt

Generates a text file.

-gkx

Only meaningful with -txt:name.txt, generates a text file, inclusive a graphic-dump.

-urs:name.urs

Explicit input of an URS-file.

-ssd:_xxx

_xxx = list of pseudo-extensions for an overall file.


Example: ursula name.plb -ssd:_002;_003;_006.
Creates from name_002.plb, name_003.plb and name_006.plb
an overall -PLB.

-plbs:name1.plb;...

Joins multiple PLBs into one final file.


Example: ursula name.plb -plbs:name1.plb;name2.plb
Generates from name.plb, name1.plb and name2.plb an overall
-PLB.
Doesnt show the Urs-Id enumerated modules.
Example: ursula name.plb -hidden:3.2;3.3

-hidden:urs1;urs2;...
-m

A possibility to work with large files.


First the modules for generating the module tree are loaded.

-close

Report Browser will close.


e.g.: ursula -stli:191 -close /mdb=mdb_name stl_name

11-10

SOFiSTiK 2016

Output | SOFiSTiK

Request for a direct printing

Options

Explanation

-print

File will be printed directly.

-printto:Druckername File will be printed directly on the already defined printer. The
instruction "PDF", defined as a printer name will generate a
PDF file, "name.pdf ".

-page:all

All pages are printed. Alternatively only one page or specific


range of pages can be printed as well.
Example: ursula name.plb -print -page:3-5

-picture:all

All pictures are printed. Alternatively only one picture or specific range of pictures can be printed as well.
Example: ursula name.plb -print -picture:3-5

-size:Ax

Sets the page size for the printer (possible is: A4, A3, A2, A1
or A0).

General calling parameters

Options

Explanation

-s:Sofistik-Pfad Path to the SOFiSTiK-EXE files (sets the environment variable


SOFiSTiK=...)

-1 bis -4

with this flags it is possible to run multiple Report Browser instances.

-nosingle

Starts Report Browser (past Ursula) as independent instance (no single


application).

-test:nr

Sets a general test-flag. Only for the developer of interest. Depending


on the level of development, single message windows are activated.

Special keyboard commands

Some special commands can be activated via the keyboard:


Command Short description
Strg + E

Copies the marked text in Excel format into clipboard.

Strg + G

Go to page

Strg + L

Search further

Strg + D

Generates a PLB-dump (only for developers)

Strg + U

Show the URS files (only for developers)

Strg + N

Insert a blank line

Strg + Y

Remove a line

SOFiSTiK 2016

11-11

SOFiSTiK | Output

Assignment of the Ctrl key button (Windows Standard)

Next Standard commands are supported:


Command Short description
Ctrl + O

Open file

Ctrl + S

Save file

Ctrl + P

Print

Ctrl + A

Select all

Ctrl + C

Copy the marked text/graphics into clipboard.

Ctrl + V

Insert the graphics from the clipboard into module tree.

Ctrl + F

Search

11.2

Protocol File (.prt)

The .prt file is a text file and nominated as protocol file and contains important
messages about the general operating situation. It will normally only be needed
in case of errors or performance problems. It contains for example: the startup
information, version numbers, consumed computing times, information about
errors, convergence conditions, files etc.

11.3

Result File (.lst and .erg)

The .erg file is a text file containing the entire text output in a form suitable for
printing. This file can also be examined or edited with a text editor or printed as it
is. Page numbering is performed automatically by the programs of the SOFiSTiK
series as determined by the database. Under Windows the output of the files
occurs over the Windows printer drivers. They are activated by option print or
by drag and drop onto a printer icon.

11.4

Graphical Output Result Viewer

11.4.1

General Hints

Result Viewer is a program for postprocessing of calculations with Finite Elements and frame and girder systems. It allows the tabular representation of the
values and information which are saved in the database, e.g. information about
structures, calculation and design results. Furthermore all section information
and section results can be visualised (see RESULTVIEWER).

11-12

SOFiSTiK 2016

Troubleshooting | SOFiSTiK

12

Troubleshooting

In the following chapters we will give you some hints in case of problems with
the usage of the software. Problems regarding the installation and the licencing
are described in the Administrator manual.

12.1

General Strategy

Please keep in mind the following points in case you encouter some incomprehensible errors:

The probability that an error has been caused by wrong input is significantly
large. The observation of warnings at any stage during the analysis or the
installation can supply valuable hints.

All programs, even those of SOFiSTiK, contain errors as long as the are
used. They will show up most likely if you are in hurry and start treating some
completely new application area of the programs. You should therefore first
examine how the program behaves, using small examples. One of the most
frequent causes of such errors is a misleading interpretation of the manual
or the implemented theory.

If the system was still working yesterday, think about what has changed since
then (new computer, new operating system, other inputs etc.)

In some cases an error message may not describe the real cause of the
error, although this is highly unlikely. It might occur when the error was not
correctly detected in a previous module. The programs do not stop at the
first error they encounter, but try to continue and to detect as much errors as
possible.

Rather than searching for hours, sent a support request via Email to
SOFiSTiK Support or your local supporter. Even if you may be charged
for extensive services, it usually will be more economical as SOFiSTiK has
better possibilities to locate the error.

12.2

Standard Warnings and Error Messages

The story of an analysis is stored in a protocol file of the file type (*.PRT). In
all special situations (program error or user error) this file must be examined.
The execution of the analysis is automatically stopped if such an error occurs.
Regular errors or Warnings have the form:

SOFiSTiK 2016

12-1

SOFiSTiK | Troubleshooting

Warnings, the program prints the message: ++++ WARNING NO. nnnnn IN
PROGRAM xxxx as well as one or more lines of explanations. The analysis
continues.

User or data error, the program prints the message: ++++ ERROR NO.
nnnnn IN PROGRAM xxxx as well as one or more lines of explanation. The
analysis continues or stops.

Finally, each program writes the number of warnings and errors in the .PRT-File.
If the program has been aborted this will also be visible in this file.
Warnings can be switched off with the input CTRL WARN number of the warning
in the individual modules.

12.3

Troubleshooting Strategies

In the following chapters we like to introduce a few strategies, how to deal with
program errors. In most cases you will be able to find and resolve your problem.
Minimize Input Datafile:
To minimize the SSD project files and SOFiPLUS drawings is the most important
strategy to find and eliminate input errors Please delete every ssd-task, structural elements, program blocks, load cases, etc. which are not involved with your
problem. Now you have a small and clear project, which can be checked easily.
In almost every case you will find out where the problem occurs and also you
will be able to solve it by yourself.
Please use this strategy also if you cant find the problem and send your minimized project file with your support request via Email to support@sofistik.de
.
12.3.1

Problems with Database (*.cdb)

Error messages of the Database CDBASE can occur for the following reasons:

Due to an abnormal termination of programs the file gets disorganised. If


only the locks are not released you may remove them with a special button
or with the command:
DBINFO projekt,Z
If the file is badly damaged, the best solution is to delete or restore the
database and repeat the analysis.

Saving the data base periodically is quite wise especially for working with
large projects.

12-2

SOFiSTiK 2016

Troubleshooting | SOFiSTiK

12.3.2

Input Error in TEDDY Datafile

In case of a wrong input in the TEDDY file, the program gives you an error
message. If you open the Report Browser output and go to the ECHO print,
the error message is plotted directly after the incorrect input line. Also the error
message gives you some hints what should be the correct input. This will help
you in most cases to find and eliminate the wrong input.
12.3.3

Error in System Generation with SOFiPLUS

If you run into errors while meshing your SOFiPLUS drawing you may use a very
simple algorithm to locate the problem. First mark randomly half of your structure
and delete it. Now start the meshing again. If the problem occurs again, mark
the next half of your structure,delete it, mesh again and so on. If the problem
does not occur, go back and mark the other half of your structure, delete it and
mesh again. With this principle of deleting stepwise half of the structure you will
minimize your system. Probably you will find the error by yourself and can solve
it. If the problem is solved you go back to your complete system and solve the
problem there as well.
If you cant solve the problem please send your minimized drawing to our support.
12.3.4

Error during Calculation

Normally we face two major problems in case the analysis will be aborted with
an error message. Either the system is instable or no convergence was found
during a non linear analysis.
System instable:
In case you use the program ASE for the analysis and have an instable system,
the program calculates Eigenvalues using a numerical trick. Now you can check
the displacements of the Eigenvalues with the ANIMATOR. Then you will see
very quick, what causes the instability.
Normally the instability problems occur in large 3d systems with lots of hinges
and kinematic constraints. Therefore we recommend the following procedure:
Create your system Step by Step and avoid to define any hinges and kinematic
constraints in the first Steps. Now define a load case self weight and start the
linear analysis. If you get some reasonable results go further on and start to
define the first few hinges. Now export your system and start the linear analysis
again. If everything works fine, go on with this procedure until everything is
defined. If you work Step by Step, you always know the last changes and can
easily go back. Possible input errors will be found very fast.

SOFiSTiK 2016

12-3

SOFiSTiK | Troubleshooting

In case you cant find the problem, please send your minimized file to our support.
Non-linear Analysis:
The most common problem during a non linear analysis is, that no convergence
will be reached. Either the structure is to weak for the applied loads, or the chosen algorithm has some numerical problems. In the first case you may change
dimensions and therefore enforce the structure. In the second case you may
change the iteration method. In both cases the program gives you detailed information about possible changes in your non linear analysis. With this hints
you may solve the problem. In other cases please reduce your system to one
single load case and delete everything, which is not necessary to reproduce the
convergence problem. Sent this reduced file to our support.
12.3.5

Problems with Results

The interpretation of the results may cause some questions. Every manual contains a chapter Theoretical Principles. Inside this chapter the basics of the
design algorithms are explained so that a manual check of the design results
will be possible. In case there are still some questions open, please send a
small example and also the results of your hand calculation to our support.

12.4

Support

In case the above discussed strategies does not solve your problems, please
contact our support via Email support@sofistik.de . You will find the General
Terms of Support Conditions on our website:
http://www.sofistik.com/fileadmin/FILES/support/
Support_Service_Explanations_09_2011.pdf
12.4.1

Support Accessibility

As you know, you may contact us via our SOFiSTiK Online Portal, via E-Mail, via
Fax or via phone. In order to work most efficient without any interruption from
incoming phone calls, you cant contact our supporters directly.
Our primary target is, to help you as soon as possible and to increase our response quality level continuously.
Most support requests are very complex and cant be solved in a short time. For
that we work us into your problems and data files and contact you via E-Mail or
phone call. Either we have a solution or we reproduced your problem and can
start directly into a detailed discussion to find a common solution or at least a

12-4

SOFiSTiK 2016

Troubleshooting | SOFiSTiK

work around.
12.4.2

Customers Obligation to Cooperate

In order to avoid time consuming mails and phone calls, would you please consider the following issues in your support requests. This assistance is very important for a fast and direct solution to your support request.

We always need to know your customer number. For example you will find
the number printed in the html-file of your last support request, or on your
last Software Service Invoice.

We always need to know the used program versions. For example


SOFiCAD-Detailing 2016 with AutoCAD 2016, or SOFiPLUS 2016 with AutoCAD 2016. Using the FEA package every analysis creates a protocol file
*.prt containing all version numbers of the used programs. Please send us
this file.

Information about the operation system (for example Windows 7 (32bit /


64bit), Windows 8, Linux).

Please note, we are not involved in your project and have no more information than what you sent to us. Therefore it is very helpful to get condensed
data files and a precise problem description.

Minimize your drawing or the project input data file. Delete everything which
is not necessary to reproduce your problem.

Please try to describe your problem as precise as possible. Under which


circumstances does the problem occur? What did you do, which clicks? Example FEA: I checked the beam element 2037, x=0.00 m in loadcase 2031.
I cant reproduce the amount of reinforcement computed by AQB (SOFiSTiK
2016-1 AQB) = 12.35 cm2 . The result of my hand calculation gives me only
8.50 cm2 . Please find attached my hand_calculation.pdf. Why are the results
different?

Provide us with additional information besides your data files, describe your
workflow, send us scans of your hand calculation, every additional information helps.

Please send us every necessary file, so we can reproduce your problem.


FEA: files *.sofistik, *.dwg, *.dat, *.prt, diagnostic.xml and if necessary *.gra
and *.plb. Please zipp all files

We ask kindly for your understanding, but without all relevant data, we cant start
working on your request.

SOFiSTiK 2016

12-5

SOFiSTiK | Troubleshooting

12.4.3

Support Request via SOFiSTiK Online Portal

With a valid maintenance contract you have also the possibility to use our
SOFiSTiK Online Portal.
Using this portal you will have the following benefits:

Submit support requests directly in our system

Submit support request out of the normal business hours

Support requests via SOFiSTiK Online Portal will be processed with higher
priority.

Access to FAQ-database to investigate for solutions

Investigate in all your support requests

Check the actual status of current support requests

Every customer has one user account with administration rights. This
main user can manage his company data, address, contact persons and
SOFiSTiK Online user.

For all this reasons we recommend to use this portal. You will find the portal
via www.sofistik.com/support on the left hand side > Links > SOFiSTiK Online
(Portal). A short description is also available on this website.
Access Online Portal:
http://www.sofistik.com/en/support/sofistik-online-login/
For clarity reasons it is very important to use a new support ticket for every
question. Please reply only for direct questions to the key issue. For additional
questions use a new ticket even if you refer to the same project files. This is very
important if you like to investigate in old support requests.
12.4.4

Support Request out of SSD / TEDDY

Both SSD and TEDDY have a special function to create automatically a support
request with all necessary description and attachments. Go to the menu HELP
> SOFiSTiK Support Wizard ...
Nevertheless we recommend to use our SOFiSTiK Online Portal

12-6

SOFiSTiK 2016

Troubleshooting | SOFiSTiK

Figure 12.1: Support Request out of SSD / TEDDY

12.4.5

Create a Diagnostic.xml File

All necessary information about installation, licences, program libraries are


saved in a diagnostic.xml file. This file is very important for our supporters.
To create this file go to TEDDY or SSD menu Help > Diagnostic. Please save the
file with the command File > Save as Diagnostic. This file will be created automatically if using the command SOFiSTiK Support Wizard... describe above.

Figure 12.2: Create a Diagnostic.xml File

In special cases please start the program out of the program directory:
e.g. C:\Program Files (x86)\SOFiSTiK\2016\ANALYSIS_33_X64\diagnose.exe

SOFiSTiK 2016

12-7

SOFiSTiK | Troubleshooting

12-8

SOFiSTiK 2016

Additional Information and Help | SOFiSTiK

13

Additional Information and Help

For a better understanding our software we provide the user with additional information, documents and examples. As a first choice we recommend to use
our Infoportal on our website.

13.1

Infoportal

On our website
http://www.sofistik.com/Infoportal
you may navigate through all sort of information. You may search in our document data base using the categories Document Type, Product Group,
Subject and Application. A Search for Keywords is also possible. For example most program features of SOFiPLUS are shown in small Tutorial Movies.

Figure 13.1: Infoportal

SOFiSTiK 2016

13-1

SOFiSTiK | Additional Information and Help

13.2

CADINP Samples

We provide the user with a large sample library sorted by program names. All
samples are using the numerical CADINP input language. You will find all samples via TEDDY menu Help > Samples ... .

Figure 13.2: CADINP Samples

13.3

Forum

Our User Group is open for all registered SOFiSTiK user and a place for discussion. Please send support requests exclusive via Email to
support@sofistik.de
and do not poste them into the User Group.
You will reach our User Group via
http://www.sofistik.com/forum

Figure 13.3: Forum

13-2

SOFiSTiK 2016

Additional Information and Help | SOFiSTiK

13.4

VERiFiCATiON Manual

The primary scope of the VERiFiCATiON Manual (VERIFICATION_MANUAL_MECHANICAL and VERIFICATION_MANUAL_DESIGN)


is to verify the capabilities of SOFiSTiK in nontrivial but also straightforward
problems which are bound to reference solutions, in order to provide the users
with assurance of the SOFiSTiK solutions. A further purpose is to demonstrate
the wide range of analysis options for the most of the elements and major
solution features and thus provide guidance on a class of a common types of
problems.
This manual contains a compilation of a number of selected computational
benchmarks, each benchmark focusing on a specific mechanical topic or a design code. The obtained results from the SOFiSTiK analysis are contrasted with
corresponding reference solutions.

SOFiSTiK 2016

13-3

S-ar putea să vă placă și