Documente Academic
Documente Profesional
Documente Cultură
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
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 . . . . . . . . . . . . . .
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 .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
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
6-1
6-1
6-1
6-2
6-3
.
.
.
.
.
.
.
.
.
.
.
.
.
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)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
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 . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
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
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
1.2
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
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
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:
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
INTERFACES / BIM
MAXIMA: Enveloping
DESIGN / POST-PROCESSING
Rhinoceros Interface:
3D FE models for complex geometries
PROCESSING / SOLVER
PRE-PROCESSING
SOFiSTiK 2016
2.2
Program Modules
2.2.1
Preprocessing
Interactive programs:
SOFiPLUS(-X)
Cross Section Editor
Batch-programs:
AQUA
SOFiMSHA
SOFiMSHC
SOFiLOAD
TENDON
CSM
2.2.2
Analysis Programs
ASE
HASE
TALPA
DYNA
ELLA
HYDRA
STAR2
RELY
DOLFYN
2.2.3
Design Programs
MAXIMA
AQB
Superposition
Design of Cross Sections
BEMESS
SOFiSTiK 2016
2-3
BDK
2.2.4
interactive programs:
Result Viewer
WiNGRAF
Batch-programs:
WING
RESULTS
DBPRIN
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
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
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
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
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:
SOFiSTiK 2016
2-7
o - Output medium
s - Structure (Eements)
l
- Loadcases
b - create a backup
d - Dump of records
e - Edit records
**
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
SOFiSTiK 2016
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 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
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:
SSD and TEDDY provides an option for the LOG files under Help.
2.8
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
.ERR
.TAB
.TAX
.TBB
.HTM
.CHM
.WTM
.DEF
.INI
2-10
SOFiSTiK 2016
.ERG
.PRT
.PLB
.CDB
.CDE
.$Dn
.zdn
.$0n
.z0n
.$$$
.zzz
.#nn
.ynn
.###
.yyy
SOFiSTiK 2016
2-11
.SDB
2.9
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
2-12
SOFiSTiK 2016
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.
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
[mm]
[mm] 1011
SOFiSTiK 2016
2-13
4
5
6
7
8
The conversion to imperial units follows a convention from 1 July 1959 which
has unified American and British definitions:
2-14
SOFiSTiK 2016
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
2-16
SOFiSTiK 2016
Interfaces | SOFiSTiK
Interfaces
3.1
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
SOFiSTiK 2016
3-1
SOFiSTiK | Interfaces
3.3
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
3.4
R
R
Extensions for Autodesk
Revit
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
divide of area load for checkerboard-like load distribution in the case of flat
slabs
3.5
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
SOFiSTiK 2016
3-5
SOFiSTiK | Interfaces
3-6
SOFiSTiK 2016
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
4.2.1
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
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
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:
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
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
4.3
Important changes
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
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
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
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
5.1
SOFiSTiK 2016
5-1
5.2
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
5-2
SOFiSTiK 2016
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.
SOFiSTiK 2016
5-3
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
5-4
SOFiSTiK 2016
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
SOFiSTiK 2016
5-5
A later changing of the code is possible if the template is stored with Save
tasks without Design Code dependant information.
The existing template directories are shown under directories. The saved file
name.sofistix is now available as a further template.
5-6
SOFiSTiK 2016
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
5.3
5.3.1
Calculation Status
Every task has its own symbol to show the actual calculation status.
5.4
Without calculation
no calculation required
blue arrow
blue cross
red cross
green cross
For special cases the user may start the program from a command shell by using
the following command lines:
5-8
SOFiSTiK 2016
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
5-10
SOFiSTiK 2016
6.1
General Hints
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
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.
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
6.3
Structure
SOFiSTiK 2016
6-3
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
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).
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 .
SOFiSTiK 2016
7-1
will create additional instances of TEDDY. The number will select the colour of the TEDDY-icon.
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
Important Commands
The most important functions are accessible via the function keys:
F1
F2
search
F3
search again
F4
F5
F6
F7
7-2
SOFiSTiK 2016
F8
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
Alt + L
Alt + B
Alt + H
Alt + R
Alt + W
Alt + Z
7.3.2
Ctrl + A
marks all
Ctrl + C
Ctrl + V
Ctrl + X
Ctrl + S
save file
Ctrl + Y
delete Line
Ctrl + Z
undo
7.3.3
A complete arrangement of all Ctrl commands, you will find in the TEDDY-help
menu Help Ctrl commands .
7.3.4
SOFiSTiK 2016
7-3
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.
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
+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.
7.5
7.5.1
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
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
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
7.7
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
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
7-8
SOFiSTiK 2016
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
8.1
8.1.1
The input consists of lines. Each line contains up to 255 characters and corresponds to one line on the screen.
8.1.2
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
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
The input record consists of the record name followed by data in the order
specified in the input description.
The record name can be omitted when the record is of the same type as the
preceding one.
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
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
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
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
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
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
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
8-6
SOFiSTiK 2016
(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
SOFiSTiK 2016
e.g.
1,2,7,9
8-7
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
Y=5.0[m]
Z=[mm]
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
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)
$
$
$
$
$
$
$
$
LET#4 ##10
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
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)
RCL#name cdbfile
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.
8-10
SOFiSTiK 2016
Variables of Array AQB_USAGE will be set by AQB with the usage factors of
the design tasks of the last input block.
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#
and
DBG# -2
8.2.15
Arithmetic Expressions
SOFiSTiK 2016
8-11
+ * /
** 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.
8-12
oder SIN30+3COS45
SOFiSTiK 2016
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
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(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
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
SOFiSTiK 2016
8-15
IF - Logical Conditions
8-16
SOFiSTiK 2016
....
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
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
8.2.19
8-18
or
@(no,position+offset)
SOFiSTiK 2016
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:
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
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
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
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.
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
8.3.1
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
Item
Description
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
SOFiSTiK 2016
TXB
Item
Description
Introductory text
8.3.4
Unit
Default
LT72
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
Bold
Italic
Underlining
SOFiSTiK 2016
8-23
8.3.5
<TEXT>
Item
Description
8.3.6
Unit
Default
LT72
</TEXT>
Item
Description
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>
8-24
SOFiSTiK 2016
<EDIT:name,Format=6.2>$(name) </EDIT>
ECHO
Item
Description
Unit
Default
OPT
Echo option
LT
FULL
LT
FULL
-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
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
Item
Description
TYPE
Unit
Default
Lt16
Lt16
LT
INOU
DIG
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
SOFiSTiK 2016
2
3
4
5
6
7
8
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
Item
Description
FIRS
Unit
Default
MARG
LANO
LANI
German
English
French
Spanish
German
English
UNIO
UNII
FORM
SOFiSTiK 2016
8-27
Item
PRIL
PAG
Description
multiline header
short header
-1
warnings as well
additional information
Identification of page
Unit
Default
LT12
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)
Page :
11
25.05.95
8-28
SOFiSTiK 2016
+------------------------------------------------------------+-----------+
+------------------------------------------------------------+-----------+
!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
Item
Description
Unit
Default
TYPE
Paper size
-URS
Positive value
landscape format
Scale
0
format filling
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
Item
Description
Unit
Default
LT
standard frame
ZTVK
ZTVK-88 frame
URS
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
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
A,-A
B,-B
C,-C
D,-D
HPA,-HPA
HPB,-HPB
HPC,-HPC
HPD,-HPD
HP4,-HP4
HP3,-HP3
HP2,-HP2
HP1,-HP1
WIN,-WIN
MP,-MP
LP,-LP
MPW
SOFiSTiK 2016
8-31
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>
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
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
SOFiSTiK 2016
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
Y1
X2
X1
Y2
Y1
....
...
...
X16
X15
Y16
Y15
SOFiSTiK 2016
8-33
8.4.5
GFA
Item
Description
Unit
Default
X1
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
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
X2
Y2
8-34
SOFiSTiK 2016
Item
Description
Unit
Default
....
....
....
X15
Y15
BUTT
ARC
VECT
8.4.7
GTXT
Item
Description
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
GSCA Dimensioning
GSCA
Item
Description
X1
Y1
X2
Y2
Unit
Default
TEXT
Text
VAL
Numeric value
DIM
Dimension
ND
Number of digits
8.5
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
8.5.1
GCOL
Item
Description
Unit
Default
COL
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
Item
Description
IND
Bundled SOFiSTiK-Index
COL
TYPE
Line type
Unit
Default
/ LT
LT
SOFiSTiK 2016
8-37
Item
Description
SOLI
solid
DASH
dashed
DOT
dotted
Unit
Default
DDOT dash-dotted
NDAS
narrow dashed
SCAT
small circles
arrow heads
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.
1 = continuous
2 = medium dashed
3 = medium dotted
4 = medium dotted dashed
5 = tightly dashed
6 = tightly dotted
8-38
SOFiSTiK 2016
GPMI
Item
Description
IND
Bundled SOFiSTiK-Index
COL
TYPE
Unit
Default
/ LT
LT
.+*oX
SIZE
Scale factor
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.
8.5.4
1 = . Point
2 = + Plus
3 = * Star
4 = o Circle
5 = x Cross
SOFiSTiK 2016
8-39
GTXI
Item
Description
IND
Bundled SOFiSTiK-Index
COL
Text height
BX
Writing direction
BY
HALI
Horizontal alignment
Unit
Default
/ LT
cm
LT
NORM
LT
NORM
LT
RIGH
VALI
LEFT
CENT
centred
RIGH
Vertical alignment
NORM default of PATH
PATH
TOP
top of cell
CAP
top of characters
HALF
centre line
BASE
writing line
BOTT
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
8-40
installation dependent
SOFiSTiK 2016
8.5.5
GFAI
Item
Description
IND
Bundled SOFiSTiK-Index
COL
STYL
TYPE
HOLL
Hollow
SOLI
Solid
PATT
Pattern
HATC
Hatch
BPAT
BHAT
Style index
Unit
Default
/ LT
LT
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
4/5/6
7-12
= as 1 to 6 dashed
8-41
8.6
8.6.1
13-24
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)
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
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
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
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
SOFiSTiK 2016
8-45
8-46
SOFiSTiK 2016
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
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
SOFISTIK_C
nation
00
Generic Europe
01
United states
SOFiSTiK 2016
9-1
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
language of output
level of messages
9-2
SOFiSTiK 2016
Variable
Parameters
possible values
(separated by comma)
Units of output
SOFISTIK_P
-2
-1
statistics
computing times
68
Type of formfeed
form-feed character
default
Type of linefeed
82
Pagenumber
default
-1
omit numbers
KOPF1
KOPF2
KOPF3
SOFISTIK_PRODIR
SOFISTIK_TMPDIR
Defaults to
SOFISTIK_PRODIR
PSJOBPAR
PSJOBINFO
CDBASEMEM
default: 1MB
CDACCESS
SINGLE = deactivate
NOWAIT = do not wait
if locked
(useful for
SOFiSTiK 2016
9-3
Variable
Parameters
possible values
(separated by comma)
remote analysis)
CDBASETEMP
CDBASEVER
Directoryname
for
temporary
scratch files
Version of CDBASE format
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
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
Hint
Processing a complete SOFiSTiK input file can be done either interactively
using WPS or alternatively as a batch-job using SPS.
10.2
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
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
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
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
#ENDDEF
End of block
#UNDEF name
#INCLUDE 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
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
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
SOFiSTiK 2016
END
10.5
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
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
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
10-6
SOFiSTiK 2016
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
SOFiSTiK 2016
10-7
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
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
+SYS command
command
-SYS command
command
e.g:
+SYS del $(PROJECT).$D1
10.9
Job History
10-8
SOFiSTiK 2016
=
=
=
=
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)
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
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
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
(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
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
10-11
Parameter
Description
-urs:xx
-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
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
11.1.2
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)
SOFiSTiK 2016
11-3
SOFiSTiK | Output
11.1.4
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
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.
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)
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
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.
11-8
SOFiSTiK 2016
Output | SOFiSTiK
11.1.7
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).
SOFiSTiK 2016
11-9
SOFiSTiK | Output
11.1.8
For special cases the user may start the program from a command shell by
using the following command lines:
Options
Explanation
-t
-g
Forces a graphical-view.
-r
-gkx
-urs:name.urs
-ssd:_xxx
-plbs:name1.plb;...
-hidden:urs1;urs2;...
-m
-close
11-10
SOFiSTiK 2016
Output | SOFiSTiK
Options
Explanation
-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
-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).
Options
Explanation
-1 bis -4
-nosingle
-test:nr
Strg + G
Go to page
Strg + L
Search further
Strg + D
Strg + U
Strg + N
Strg + Y
Remove a line
SOFiSTiK 2016
11-11
SOFiSTiK | Output
Open file
Ctrl + S
Save file
Ctrl + P
Ctrl + A
Select all
Ctrl + C
Ctrl + V
Ctrl + F
Search
11.2
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
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
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
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
Error messages of the Database CDBASE can occur for the following reasons:
Saving the data base periodically is quite wise especially for working with
large projects.
12-2
SOFiSTiK 2016
Troubleshooting | SOFiSTiK
12.3.2
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
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
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
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
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.
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.
Provide us with additional information besides your data files, describe your
workflow, send us scans of your hand calculation, every additional information helps.
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
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:
Support requests via SOFiSTiK Online Portal will be processed with higher
priority.
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
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
12.4.5
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
13
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.
SOFiSTiK 2016
13-1
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 ... .
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
13-2
SOFiSTiK 2016
13.4
VERiFiCATiON Manual
SOFiSTiK 2016
13-3