Teddy CADiNP Introduction
Teddy CADiNP Introduction
www.guidoaltersberger.com
TEDDY – Text Editor and CADiNP - Syntax
TABLE OF CONTENTS
Start Teddy 4
Sections 4
1 Menu 5
2 RIBBONS 5
File 6
Home 8
Edit 15
Insert 17
Help 18
3 Editbar 21
4 Module Bar 22
5 Interactive Help 23
6 Module Tree 24
7 Input Area 25
8 Taskbar - File / Project tabs 25
9 Status bar - Command Summary, active module name and unit information 26
1 Menu 27
2 Ribbons 28
Home 28
Calculation 28
Post-processing 28
Tools 29
View 29
File 29
Windows 29
User Interface 30
Help 30
3 Module Bar 30
4 Module List 30
5 Calculated Modules 31
6 Protocol 31
www.guidoaltersberger.com 1 | 58
TEDDY – Text Editor and CADiNP - Syntax
Open a DAT-File 33
Add a Text Editor Task to the Project 34
Insert a new Task 34
Types of available text editor tasks in SSD 35
Edit and Convert Graphical Tasks 36
Export to DAT 37
SOFiPLUS (AutoCAD) 39
Access automatically generated text files 39
Input Syntax 40
LET and STO Variables 41
Different types of Input Values 41
Arithmetic Expressions and Functions 42
FUN – Definition of Functions 43
Loops and Jumps 43
Example 1: Generation of nodes and springs along a semicircle at each 30° 43
Example 2: Run loop over all entries of an array 44
IF – Logical Conditions 45
Example 3: Interpolation 46
#DEFINE – Parameter Substitution 47
Example 4: Single-Span Beam using #DEFINE Parameter for system and cross-section dimensions 47
#INCLUDE – Block Definition 48
Example 5: Text Block Definition for simple Text Output 48
APPLY – Integration of Data During the Calculation 50
System Commands 50
Managing Units 51
PROGRAM MODULES 53
www.guidoaltersberger.com 2 | 58
TEDDY – Text Editor and CADiNP - Syntax
FOOTING – Foundations 56
MAXIMA – Superposition 56
www.guidoaltersberger.com 3 | 58
TEDDY – Text Editor and CADiNP - Syntax
TEDDY is a text editor which fully supports and utilises the SOFiSTiK CADiNP syntax. Along with functionalities
to create the project input, the text editor comes with an interactive user manual.
START TEDDY
TEDDY is a windows application and can be started by double-click on the program icon . After installing
SOFiSTiK on your system. Files with the extension *.dat are assigned to Teddy after the installation
automatically.
SECTIONS
Let’s have a closer look at the different section of the text editor Teddy.
www.guidoaltersberger.com 4 | 58
TEDDY – Text Editor and CADiNP - Syntax
1 MENU
The menu comes with standard commands you expect from any other application, as well as calculation
related commands.
2 RIBBONS
In version 2020 the navigation switched entirely to ribbons. Those ribbons are
• File
• Home
• Edit
• Insert
• View
• and Help.
Right-click anywhere at the Ribbon allows minimising the ribbon bar to the names. What gives you extra space
for the text input area.
www.guidoaltersberger.com 5 | 58
TEDDY – Text Editor and CADiNP - Syntax
FILE
The File menu contains the default commands such as
• New
• Open
• Save
• Save All
• Save As
• Printing
• and Exit.
+ EXAMPLES
The example menu command brings you straight to the available Teddy example files. These files are available
for almost all program modules and describe the Input of different topics.
The example browser, which opens on the left-hand side of the input area of Teddy, organises the module
names in separate folders.
www.guidoaltersberger.com 6 | 58
TEDDY – Text Editor and CADiNP - Syntax
As the example files are read-only – saving to a different folder is required and recommended
before running them.
+ USER OPTIONS
The user options of Teddy allow you to adjust the representation, paths, fonts to print the code or even to
switch between a comma “,” or point “.” for the decimal separator.
www.guidoaltersberger.com 7 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ PROJECT OPTIONS
Within the Project Options, settings such as generating a DOCX report, adjustments of the Report Browser
layout and input/output language are available.
HOME
The "Home" ribbon comes with the tabs "Calculation", "Postprocessing", "Tools", "Clipboard" and "Find".
+ CALCULATION
The command “Immediately” starts the calculation for all activated modules of the input file. Activated
Modules are those marked with a “+” in front of the PROG command.
The command “Current Modul” performs the calculation of the program module your cursor is active at that
moment.
The command “Calculation” opens the “SOFiSTiK Calculation 2020” window. To learn more about it, read
chapter SOFiSTiK Calculation 2020.
www.guidoaltersberger.com 8 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ POST-PROCESSING
Open the application relevant for the “Post-Processing” task you want to perform from here.
Command Description
+ TOOLS
Some of the in “Tools” available commands are related to the SOFiSTiK database. However, there are also
commands to access projects files more comfortable, or even to open the command line input of Windows.
www.guidoaltersberger.com 9 | 58
TEDDY – Text Editor and CADiNP - Syntax
- DATABASE TOOLS
• Export to DAT …
The “Export to DAT …” command allows converting information from the database to a text input file (*.dat
file).
You’ll get the possibility to refine the export in the “SOFiSTiK: Export 2020” window after starting the
command. After confirming the export, the program generates a *.dat file and saves it in the defined target
folder. The default folder is the project folder.
www.guidoaltersberger.com 10 | 58
TEDDY – Text Editor and CADiNP - Syntax
• IFC Export
• Database Information
The “Database Information” command allows getting insights into the database structure. It is useful when
extracting information through the available interfaces such as C#, Python or the @KEY access within CADiNP.
www.guidoaltersberger.com 11 | 58
TEDDY – Text Editor and CADiNP - Syntax
• Database Backup
Although you can generate the database at any time with the input file (*.dat), I recommend making a backup.
The “SOFiSTiK: Database Backup” is a useful tool to create this backup. Alternative, you can also copy the *.cdb
file, which is the SOFiSTiK database, to a backup folder.
• Database Clean
The “Database Clean” command allows you to remove elements, load cases, or actions which might not need
anymore in the project. Unfortunately, this won’t have any effect on the actual size of the database.
- CLEAN
The “Clean” command allows cleaning up your project folder, selecting the different files if possible, in the
dialogue box “SOFiSTiK: Clean”.
www.guidoaltersberger.com 12 | 58
TEDDY – Text Editor and CADiNP - Syntax
- ARCHIVE
A comfortable way to share project relevant files with colleagues, or even the SOFiSTiK support team, is the
“Archive” command. Select files in the dialogue box “SOFiSTiK: To Archive”, to forward them in an email as a
zip file.
- ADDITIONAL
There is a set of additional options available in this command.
- EXPLORER
The “Explorer” command is a quick way to open the project directory.
- COMMAND SHELL
“Command Shell” accesses the windows command line and navigates directly to the project folder.
www.guidoaltersberger.com 13 | 58
TEDDY – Text Editor and CADiNP - Syntax
- PROTOCOLS
Access the latest generated protocols saved in the project folder. You can open the *.dat, *.erg, *.lst and *.prt
files with a single click in the Text Editor.
+ CLIPBOARD
Especially when you are using the text input, the copy/paste command is a welcome option. The “Clipboard”
tab comes with the familiar commands Copy, Cut and Paste. Besides, you will get the capability to save
snippets temporally to a specific register—From where you can recall them at any time until you close the Text
Editor again.
www.guidoaltersberger.com 14 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ FIND
Allows finding and replacing text.
EDIT
The “Edit” Tab comes with plenty of selection and formatting tools.
+ SELECTED TEXT
www.guidoaltersberger.com 15 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ SELECT
www.guidoaltersberger.com 16 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ DELETE
+ CONVERT
INSERT
The insert menu comes with the “Insert Task” command to enter specific tasks based on the graphical user
interface. After completing the Input, the information gets translated automatically to text.
Besides that, you can define chapters and labels to organise the input file. There are also formatting options
available which occur in the text output.
www.guidoaltersberger.com 17 | 58
TEDDY – Text Editor and CADiNP - Syntax
HELP
Within the “Help” tab you can find “User Manuals”, “Logfiles” and the linked to the “Online Documentation”.
Also, useful applications such as the “License Manager” as well as the “Support Assistant” and “Remote
Support” can be accessed from here.
I recommend using the SOFiSTiK Support Wizard command to raise a support ticket request.
More specific commands of the text editor are available in the section “Teddy” and “Module: …”.
+ TEDDY
In this section, you will find shortcuts and the CDBASE Help, which is a must-read when planning to access data
from the SOFiSTiK database.
- CTRL COMMANDS
In addition to access commands through the ribbons and menu - shortcuts are available. I just listed a few of
the most used shortcuts in the below chapters.
• Function Keys
www.guidoaltersberger.com 18 | 58
TEDDY – Text Editor and CADiNP - Syntax
Key Description
Mark All
Save File
Delete File
Undo
Key Description
- CDBASE HELP
If you plan to read information from the SOFiSTiK database, the CDBASE Help is an essential document.
Basically, it is an address book for the information location of the entire project. This includes information such
as geometry, loads, results and lots more.
www.guidoaltersberger.com 19 | 58
TEDDY – Text Editor and CADiNP - Syntax
+ MODULE: …
The section “MODULE: …” gives you additional information about the current module. Depending on in which
program module you work - the “…” will be replaced with the module name. Also, the Interactive CADiNP Help
can be controlled from here.
Command Description
www.guidoaltersberger.com 20 | 58
TEDDY – Text Editor and CADiNP - Syntax
3 EDITBAR
The “Editbar” comes with commands to open recent used *.dat files, to navigate to specific locations in the
input file, to format the input text and to search for information.
Recent file
Autotab on/off
Errors during the calculation are highlighted in red letters in SOFiSTiK Result. You will get informed
about the cause of the error and its location in the input file. The position is described by the line
and column number, which can be used to jump to the position in the input file quickly.
Right-click on the “Editbar” opens the context menu to activate/deactivate the bar.
www.guidoaltersberger.com 21 | 58
TEDDY – Text Editor and CADiNP - Syntax
4 MODULE BAR
- Prog
From curser + Prog Activate all modules from the current to the last one
From curser – Prog Activate all modules from the current to the last one
Right-click on the “Modulebar” opens the context menu to activate/deactivate the bar.
www.guidoaltersberger.com 22 | 58
TEDDY – Text Editor and CADiNP - Syntax
5 INTERACTIVE HELP
Open the help manual from the “Help” ribbon and the tab “Module:”. It’s the last command “CADINP Help”.
Alternatively, hit the “F1. See Chapter
www.guidoaltersberger.com 23 | 58
TEDDY – Text Editor and CADiNP - Syntax
The page of the manual - matching the current input command of the current program opens. The names of
the manuals, which are in PDF format, are composed with the program name and a particular character
sequence (*_0 German or *_1 English) to indicate the language.
In a navigation window, you can see the table of contents, which allows you to jump to the theoretical - or the
example sections in the manuals.
The user manual is interactive. If you click on a command in the input, the user manual shows the command
description accordingly.
It is possible to deactivate this automatic tracking with the “Freezing Keyword” checkbox.
You can close the help manual with the “Close Help” command.
6 MODULE TREE
All defined modules, chapters, labels and system commands will show up in the task tree.
To activate od deactivate a module you can use the +/- toggle. You can either click on the symbol in the
module tree or just type the symbol in the input text.
Keeping the modules in a reasonable order is essential. No analysis can be performed if there is no
system or load defined.
www.guidoaltersberger.com 24 | 58
TEDDY – Text Editor and CADiNP - Syntax
7 INPUT AREA
This is the place where the syntax, CADiNP, is entered.
Right-Click somewhere at the input area opens the context menu with plenty of handy commands.
Confirming the selected command in the context menu can be done either by left-click or by right-
click.
www.guidoaltersberger.com 25 | 58
TEDDY – Text Editor and CADiNP - Syntax
9 STATUS BAR - COMMAND SUMMARY, ACTIVE MODULE NAME AND UNIT INFORMATION
The status bar divides into two parts
Right-click on the “Statusbar” opens the context menu to activate/deactivate the bar.
www.guidoaltersberger.com 26 | 58
TEDDY – Text Editor and CADiNP - Syntax
1 MENU
www.guidoaltersberger.com 27 | 58
TEDDY – Text Editor and CADiNP - Syntax
2 RIBBONS
This section comes with the available ribbons of “SOFiSTiK Calculation 2020”. The selection is slightly different
as in the Text Editor itself.
HOME
CALCULATION
POST-PROCESSING
Command Description
www.guidoaltersberger.com 28 | 58
TEDDY – Text Editor and CADiNP - Syntax
TOOLS
VIEW
FILE
The “Refresh” command does an update of the “Module List”.
WINDOWS
Arrange the windows in “Cascades”, horizontally, vertically or close them all.
www.guidoaltersberger.com 29 | 58
TEDDY – Text Editor and CADiNP - Syntax
USER INTERFACE
By default, all toolbars are activated. By unticking the checkboxes, you can switch them off individually.
HELP
The “Help” tab is almost similar to the one available in the Text Editor Teddy. Only the text Editor relevant
sections “Teddy” and “Module: Template” isn’t there.
3 MODULE BAR
The commands within the “Module Bar” allow you to activate/deactivate modules.
Command Description
4 MODULE LIST
The module list allows to double-check preselected modules as well as to activate/deactivate modules before
starting the calculation.
www.guidoaltersberger.com 30 | 58
TEDDY – Text Editor and CADiNP - Syntax
5 CALCULATED MODULES
Below the program module list, you will find three checkboxes.
Command Description
6 PROTOCOL
At every single calculation, a protocol is generated. It gives detailed information about the program module
performance as well as details about errors and warnings. The protocol is saved as *.prt file within the project
folder.
www.guidoaltersberger.com 31 | 58
TEDDY – Text Editor and CADiNP - Syntax
Besides the standalone application, TEDDY is accessible from almost all graphical applications such as SOFiSTiK
Structural Desktop, SOFiPLUS (AutoCAD), Autodesk Revit, McNeel Rhinoceros, SOFiSTiK Result and SOFiTiK
Graphic.
SOFiSTiK Structural Desktop allows to access and organise all available modules as graphical user tasks as well
as teddy input. The application controls pre-processing, processing and post-processing. Basically, the entire
project is organised with the SOFiSTiK Structural Desktop.
When using Teddy within SOFiSTiK Structural Desktop, you will get its same capabilities as when open the
application in a separate instance.
Let’s look into the section where you can access Teddy or generate data for the text input within SOFiSTiK
Structural Desktop.
Besides Autodesk Revit, SOFiPLUS (AutoCAD) and others, is the one to pick for a text-
based definition of the structure.
www.guidoaltersberger.com 32 | 58
TEDDY – Text Editor and CADiNP - Syntax
After confirming the SOFiSTiK System Information dialogue box by left mouse click, two yellow Teddy tasks will
show up in the left-handed “Project Navigation”.
OPEN A DAT-FILE
SSD supports opening *.dat files as teddy file/project tab within SOFiSTiK Structural Desktop. Leaving SSD isn’t
necessarily needed. This option is an excellent way to verify external and referred files. You can review and
edit the files straight away.
www.guidoaltersberger.com 33 | 58
TEDDY – Text Editor and CADiNP - Syntax
You can find the command in the “Home” ribbon within section “Tools”.
There are two different types of text editor tasks available. Both can be allocated to the “Project Navigation”
with the “Insert Task” command.
The above options open the “SOFiSTiK: Insert New Task” dialogue box, which represents the library of
available tasks.
www.guidoaltersberger.com 34 | 58
TEDDY – Text Editor and CADiNP - Syntax
• The task can be found in the task group “General”. It can be added at a random
location in the project tree.
www.guidoaltersberger.com 35 | 58
TEDDY – Text Editor and CADiNP - Syntax
Due to this fact, every graphical user task can be converted to a Text Editor task except the default tasks within
the group System at the very top of the “Project Navigation” tree.
www.guidoaltersberger.com 36 | 58
TEDDY – Text Editor and CADiNP - Syntax
The command
If a graphical task was converted to a text task by mistake, use the undo command. It restores the
graphical task and keeps the text input task too.
The command is for viewing purpose only. Any modification of the text input gets lost after
the task was reaccessed with the graphical user interface.
EXPORT TO DAT
Besides converting single graphical tasks to text input, SOFiSTiK allows to export data saved in the CDB (Central
Database) as *.dat file. This command is also available in the Teddy application.
Therefore, use the “Database Tools” command within the “Home” ribbon and tab “Tools.”
By left-click “SOFiSTiK: Export” opens, and allows to select the information by ticking the checkboxes to
generate the target file with the requested information.
www.guidoaltersberger.com 37 | 58
TEDDY – Text Editor and CADiNP - Syntax
www.guidoaltersberger.com 38 | 58
TEDDY – Text Editor and CADiNP - Syntax
SOFIPLUS (AUTOCAD)
SOFiPLUS represents one of the available pre-processors for graphical modelling of analytical systems.
Interfering with the application by text input isn’t necessary. However, extracting specific information and use
it as text input can be quite useful. Especially, when you just started learning the input syntax to set up
geometry, loads and tendons.
Go to the project directory and check it for *.dat files. You will find the default files
• name_aqa.dat
• name_ldf.dat
• name_msh.dat
• name_run.dat
If tendons are included in the project, additional files depending on the tendon type will show up in addition.
www.guidoaltersberger.com 39 | 58
TEDDY – Text Editor and CADiNP - Syntax
The core of the CADiNP input language is built on the back of CADINT. CADINT was a syntax developed during a
research project for the CAD industry back in 1976. The research project was sponsored by the Federal
Ministry of Research and Technology in Germany.
The founders of SOFiSTiK at that time recognised the advantages of its simplicity. Over time, further
improvements were made, and its capabilities extended, which require deviations from the standard of the
CADINT syntax. Which finally led in the CADiNP syntax we know today and is used across the SOFiSTiK FEA
product line.
The general Input divides into four main parts which are contained in the Block Definition.
• The begin or start of the Input block is initiated by PROG followed by the MODULE name. The prefix + or –
allows to activate or deactivate the input block.
• HEAD commences the start of the Input.
• The Input itself is done by different COMMANDS, ITEMS and VALUES depending on the selected module.
• END defines the final input line of the Input as well as the block definition.
INPUT SYNTAX
The CADiNP syntax is standardised for all available SOFiSTiK modules, which makes it much easy for you to
tweak information without learning different programming languages.
www.guidoaltersberger.com 40 | 58
TEDDY – Text Editor and CADiNP - Syntax
• LET# variables are valid within the module or block and are saved temporarily only.
• STO# variables are valid within as well as outside the module or block. They are global variables and
are saved in the CDB (Database).
Both are characterised by a # prefix followed by the name of the variable (up to 16 characters of an alpha-
numerical text, 1st character must be a letter) and an optional index.
The name of variables must not contain special characters or collide with a reserved sequence of characters
such as SIN, COS, SQR, VERSION.
The unit of a variable depends on the context, where this variable is used. Thus, it is not possible to use the
same variable for a section definition in [mm] and a system definition in [m]. However, it is possible to assign a
unit to a variable. The given value is converted immediately, and the value can be used everywhere.
• Numerical
LET#A 5.1 …Variable #A gets a single value 5.1[-] (No unit).
LET#A 5.1[mm] …Variable #A gets a single value 5.1[mm] (Unit will be considered).
LET#10 4,5,6 …generates #10 - value 4, #11 – value 5, #12 – value 6
• Text
LET# A’ Test’ …Variable #A gets the text ‘test’.
• Vector
LET#A 4,5,6 …Defines a vector A[4,5,6]
LET#A(0) 7 …Defines a vector A[7]
LET#A(2) 9 …Defines a vector A[0,0,9]
LET#A(0)+1 8 …Defines a vector A[0,8]
A more detailed description of variables, types of values and act and occupied variable names can
be found in the Basics Manual (sofistik_1.pdf) chapter 8.2.14.
www.guidoaltersberger.com 41 | 58
TEDDY – Text Editor and CADiNP - Syntax
• Allowed operator
Operator Description
+ - Addition, Subtraction
* / Multiplication, Division
** or ^ Exponentiation
& | And, Or
Functions Description
EXP(x) Exponents of e
www.guidoaltersberger.com 42 | 58
TEDDY – Text Editor and CADiNP - Syntax
A more detailed description of arithmetic expression can be found in the Basics Manual
(sofistik_1.pdf) chapter 8.2.15.
LET#F '=FUN(var,formulaexpression)'
LET#1 #F(1.234)
The variable x is substituted by the value of 1.234 and the result of the function
saved in variable #1.
The Literal has to start with the character sequence ‘=FUN(‘, followed by a formal parameter name, an
expression containing any variables defined so far. Put )’ to finish the Input at the end.
www.guidoaltersberger.com 43 | 58
TEDDY – Text Editor and CADiNP - Syntax
LET#1 1 LET#1 1
LET#2 0 LET#2 0
LOOP 7 LOOP
NODE #1 COS(#2) SIN(#2) NODE #1 COS(#2) SIN(#2)
SPRI #1 #1 DX COS(#2) DY SIN(#2) CP 1.E5 SPRI #1 #1 DX COS(#2) DY SIN(#2) CP 1.E5
LET#1 #1+1 LET#1 #1+1
LET#2 #2+30 LET#2 #2+30
ENDLOOP ENDLOOP #2<=180
END END
www.guidoaltersberger.com 44 | 58
TEDDY – Text Editor and CADiNP - Syntax
Input:
+PROG SOFIMSHA
HEAD
SYST 3D
LET#A1 10,22,34,55,76,83
A more detailed description of Loops and Jumps can be found in the Basics Manual (sofistik_1.pdf)
chapter 8.2.17.
IF – LOGICAL CONDITIONS
Conditional blocks are a vital element of every programming language. The execution of jumps (go to) is not
possible within CADINP.
The conditional block is executed if the expression following the IF is greater than zero. You might use the
logical expressions for this. Texts are compared with == and != operators only, the comparison is case
sensitive. As the complete string on both sides of the operator is considered, no parentheses are allowed, they
are part of the strings.
Principle 1 Principle 2
! #1 is the control variable with possible values +1/-1 IF #1==12
IF #1 ! These lines are Input when #1 equals 12
! These lines are input when #1 > 0 ! ...
! ... ELSE
ELSE ! These lines are Input when #1 does not
equal 12
! These lines are input when #1 < 0 or = 0
! ...
! ...
ENDIF
ENDIF
www.guidoaltersberger.com 45 | 58
TEDDY – Text Editor and CADiNP - Syntax
The generation of a CASE construction is available by using a series of additional ELSEIF statements:
IF (Condition_1)
....
ELSEIF (Condition_2)
....
ELSEIF (Condition_3)
....
ELSE
....
ENDIF
EXAMPLE 3: INTERPOLATION
VALUE ?
0.73
Input Output
+PROG TEMPLATE Output value of variable #VALUE = 0.59
HEAD
LET#A 0.73
www.guidoaltersberger.com 46 | 58
TEDDY – Text Editor and CADiNP - Syntax
A parameter in the input data or a block can be referred to by using the syntax $(name). Blanks are not
allowed between $ and “(“.
EXAMPLE 4: SINGLE-SPAN BEAM USING #DEFINE PARAMETER FOR SYSTEM AND CROSS-SECTION
DIMENSIONS
Input Output
#DEFINE LENGTH=3.70 Definition of the global parameter for system
length, cross-section width and height-
#DEFINE WIDTH=300
#DEFINE HEIGHT =500
www.guidoaltersberger.com 47 | 58
TEDDY – Text Editor and CADiNP - Syntax
Input Description
#DEFINE name Start of the block name
#ENDDEF End of block
#ENDDEF name End of Block
#UNDEF name Delete a defined block
#INCLUDE name Insert block name content from memory or file
www.guidoaltersberger.com 48 | 58
TEDDY – Text Editor and CADiNP - Syntax
END END
A more detailed description about #DEFINE and #INCLDUE can be found in the Basics Manual
(sofistik_1.pdf) chapter 10.2 and 10.3.
www.guidoaltersberger.com 49 | 58
TEDDY – Text Editor and CADiNP - Syntax
While the #INCLUDE command inserts data before the calculation is executed, the APPLY command executes
the referred file during the computation. Data can be generated during a calculation and inserted at the right
position in the timeline of the process.
As the program modules, the APPLY is controlled with the signs +/-. +APPLY execute the command, -APPLY
skips the command.
A more detailed description of APPLY can be found in the Basics Manual (sofistik_1.pdf) chapter
10.4.
SYSTEM COMMANDS
Any shell command can be integrated into the analysis. Parameter substitution is possible within the system
commands input lines. (The name of the project replaces character string $(PROJECT))
*SYS Will be executed as in any batch file if the last PROG line was active.
+SYS Will be executed as in any batch file.
-SYS Will not be executed, all following *SYS lines are deactivated.
Input Description
A more detailed description of system commands can be found in the Basics Manual
(sofistik_1.pdf) chapter 10.8.
www.guidoaltersberger.com 50 | 58
TEDDY – Text Editor and CADiNP - Syntax
MANAGING UNITS
The SOFiSTiK programs allow 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.
• mm – Fixed Unit
Input is always required in the specified unit.
• !#!Chapter
The chapter allows defining a Super-Block in Teddy. The entire block can be activated or deactivated by
double-click on the chapter icon in the module tree. The symbol changes to either !+! or !-!. !#!
has the same meaning as !+!. In the result file, PLB chapters can be opened and closed with the Report
Browser.
• !*!Label
Labels are for jump marks only and need to be placed within the Block definition (module). Result Browser
doesn’t consider labels for navigation.
www.guidoaltersberger.com 51 | 58
TEDDY – Text Editor and CADiNP - Syntax
TXB
Insert text on the very top of the module report.
TXE
Insert a text on the very end of the module report.
A more detailed description about TXA, TXE and <TEXT> can be found in the Basics Manual
(sofistik_1.pdf) chapter 8.3.4 to 8.3.6.
www.guidoaltersberger.com 52 | 58
TEDDY – Text Editor and CADiNP - Syntax
PROGRAM MODULES
AQB is used for stress analysis and design of cross-sections created with AQUA. The enhanced version AQBS
allows the consideration of the unique features of prestressed concrete and composite structures
(prestressing tendons, imposed secondary stresses, creep and shrinkage).
AQUA calculates the properties of cross-sections of any shape and material. The cross-section properties for
static analysis are determined, as well as characteristic magnitudes for the calculation of normal and shear
stress.
ASE calculates the static and dynamic effects of general loading on any structure.
The basic version of ASE performs the linear analyses of beams, cables, trusses, plane and volume structures.
Plain strain and rotational systems can be analysed with TALPA.
• Influence surfaces
• Non-linear analyses
• Pile elements with linear/parabolic soil coefficient distribution
• Creep and shrinkage
• Forces from construction stages
• Modal analysis, Time step method
• Material non-linearities
• Geometrical non-linearities
• Membrane elements
• Evaluation of collapse load
• Non-linear dynamics
BDK determines the stability eigenvalues for buckling of a straight individual member. The member, which is
taken from the entire system, is calculated with STAR2 or ASE and the buckling resistance check of steel
members is performed according to the selected design code.
www.guidoaltersberger.com 53 | 58
TEDDY – Text Editor and CADiNP - Syntax
BEAM collects all information from the database and analyses and designs the Ultimate Limit State and checks
the Serviceability Limit State. The program module works with the design elements only, which can be
generated by the module DECREATOR – Generation of Design Elements.
The result is a compact printout showing the required reinforcement the Serviceability Limit State verification.
The program BEMESS is used to design forces of the analysis programs ASE or superimposed forces of MAXIMA
according to various codes. BEMESS is as well capable of extracting extreme stresses from a set of load cases
according to the linear elastic theory. In addition to the ultimate limit design, serviceability checks can be done
such as crack width control, minimum reinforcement, stress and fatigue checks.
The SOFiSTiK Structural Desktop task “Column Design” provides the nominal curvature according to the
standard EN 1992-1-1:2004 Chapter 5.8.8. It can be applied to a single column or a whole structure with a
constant normal force distribution.
The nominal curvature is a simplified method, which calculates the approximate bending moment with
second-order effects. Though, the approximation is based on the linearisation of the dimensioning diagram.
The necessity of 2nd order effects is checked in consideration of the slenderness criteria according to the
standard EC 2 Chapter. 5.8.3.1.
The construction stage manager allows to set up and organise different stages of the project as well performs
creep analysis.
Program DBMERG allows to modify and transfer data within a database or between databases of the SOFiSTiK
software.
The program DECREATOR generates design elements along with structural members. Design elements are
independent of a member’s finite element discretisation and support defining design sections at any position
along a structural line.
www.guidoaltersberger.com 54 | 58
TEDDY – Text Editor and CADiNP - Syntax
DOLFYN has been developed by Henk Krüs from Cyclone Fluid Dynamics BV and is available as open-source
software (www.dolfyn.net). It performs analysis of
DOLFYN was adopted to the SOFiSTiK environment to extract the mesh, material and boundary conditions out
of the SOFiSTiK database as well to save results for postprocessing.
• Static analysis of load cases acting upon three-dimensional structures, as well as planar and axisymmetric
structures.
• Static analysis of load cases after second-order theory
• Computation of the natural frequencies of three-dimensional structures.
• Computation of the buckling eigenvalues of three-dimensional structures.
• Implicit direct integration of the equations of motion for structures with arbitrary damping
• Explicit direct integration of the nonlinear equations of motion
• Interaction with load trains and wind loading
• Soil structure interaction with the SBFEM
• Integration of the equations of motion by superposition of the mode shapes.
• Steady-state oscillations and excitation through spectra.
The program DYNR enables the graphical presentation of transient results from the programs DYNA and
HYDRA. It plots time-controlled, and frequency-controlled results as well as calculate response spectra of a
given history of loading and acceleration.
ELLA performs the analysis and evaluation of imposed loads acting on beam or shell structures. It is processed
by moving load trains along traffic lanes. The envelopes of the scalar variables for the entire structure are the
result. The evaluation of influence lines or influence surfaces is necessary to achieve an accurate analysis of
larger systems.
www.guidoaltersberger.com 55 | 58
TEDDY – Text Editor and CADiNP - Syntax
FEX-DYN is a FEM analysis kernel for explicit integration of motion equations inside the SOFiSTiK product line.
FEX-DYN is efficiently programmed to cope with the physically and geometrically non-linear problems and
conceptualised for multiprocessor machines.
FOOTING – FOUNDATIONS
The SSD task FOOTiNG allows based on given loads the calculation of required foundation dimensions – As well
to run design checks on existing foundation dimensions. Footing allows assigning vertical forces, moments and
horizontal forces. Necessary design combinations are automatically determined. And it is possible to consider
2nd order effects.
Based on the half-space theory, module HASE calculates the stiffness matrix representing the soil of the static
soil-structure interaction. The soil-structure interaction analysis itself is performed in module ASE.
The thermal analysis allows the evaluation of the temperature distribution within a solid due to steady or
transient heating or cooling or temperature gradient. Groundwater models are used to compute the
movement of water (seepage) within a porous solid needed for geology, hydrology, soil mechanics or
groundwater supply.
MAXIMA – SUPERPOSITION
MAXIMA performs the determination of extreme values of the internal forces, stresses, displacements and
support reactions.
Rely is an add-on to the SOFiSTiK program to perform reliability analysis, where the engineering system of
interest is modelled using one of the SOFiSTiK finite element modules. The standalone software package
Strurel (http://www.strurel.de/) powers the kernel of Rely.
www.guidoaltersberger.com 56 | 58
TEDDY – Text Editor and CADiNP - Syntax
The program SIR defines 3-dimensional sections in the structure and performs
• Representation of the intersected elements (TRUS, BEAM, CABL, QUAD, BRIC, SPRI) and the graphical
representation of their results
• Calculation of the resultant forces and moments including the support reactions
• Generation of a data record to run the design of the sections within the AQB
SIR generates cross-sections and internal forces and moments which can be used straight by AQUA and AQB or
AQBS.
SOFIMSHA exports and imports the total volume of nodes and elements. The capability of element generation
is available in CADiNP only. Complex structures should be defined via SOFIMSHC or SOFiPLUS.
SOFiMSHC is a tool for creating and processing geometric models and finite element structures. It can be used
as a standalone program within CADiNP as well as integrated as geometry processing module in the SOFiSTiK
program SOFiPLUS, Extensions for Revit and Rhinoceros Interface.
The programs of the STAR-modules enable the computation of the internal forces in any 3-dimensional beam
structure by 2nd or 3rd order theory taking into consideration shear deformations as well as various non-linear
material effects. (STAR1, STAR2, STAR3)
• CSG – The Construction Stage Manager Geotechnics performs the automatic generation of the calculation
process.
• FEA – Finite Element Analysis – calculation of analysis of different construction stages.
The program supports numerous non-linear material models (e.g. elastoplastic, viscoplastic). Accounting for
non-linear support effects, such as friction or slip, is possible, as well.
www.guidoaltersberger.com 57 | 58
TEDDY – Text Editor and CADiNP - Syntax
TENDON defines prestressing for beams, slabs and folded structures. In addition to the calculation of the
prestressing tendon geometry, the program computes the prestressing forces taking into consideration the
prestressing process and the friction losses. The Input of the tendon geometry can be done graphically as well
as numerically.
TEXTILE calculates the development of a 3D-curved surface. It includes the computation of the stressed
membrane to obtain the cutting pattern areas.
WinGRAF is used for the graphical output for the finite element and framework analysis modules. It is capable
of representing almost all information saved in the central database.
www.guidoaltersberger.com 58 | 58