SOFiSTiK CDB Interfaces

https://docs.sofistik.com/2025/en/
Admin
SOFiSTiK CDB Interfaces provides programming interfaces and examples to read, manipulate, and...
Tokens:314,712
Snippets:5,310
Trust Score:9.1
Update:2 months ago
Show doc for...
Tokens:
Raw
### Example file path

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/vba/examples/vba_example2.html

Location of the example files within the SOFiSTiK installation directory.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\vba\read_nodes
```

--------------------------------

### Locate Python Example

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/python/examples/python_example5.html

Path to the example project within the SOFiSTiK installation directory.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\python\python_3.x\number2text
```

--------------------------------

### Locate Interface Examples

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/introduction/about_cdb/structure.html

Path to the directory containing language-specific interface examples.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\
```

--------------------------------

### Locate Python CDB Example

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/python/examples/python_example1.html

Path to the directory containing the connect_to_cdb.py example file.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\python\python_3.x\connect_to_cdb
```

--------------------------------

### SOFiSTiK 2025 Installation Configuration JSON

Source: https://docs.sofistik.com/2025/en/administration/_downloads/c4889a60a69d971d856e5355dd28f7d2/sample_install.json

Defines the installation path, product MSI parameters, and the command line sequence for installing SOFiSTiK 2025 components.

```json
{
  "target_directory": "C:\\Program Files\\SOFiSTiK",
  "product_msi_parameters": [
    "revit_rxa_2025",
    [],
    "cadx_2025",
    [],
    "soficad_2025",
    [
      "CURRENT_AUTOCAD",
      "SOFTWARE\\Autodesk\\AutoCAD\\R24.2\\ACAD-6101:409",
      "ACAD_ID",
      "ACAD", 
      "ACADDIR",
      "C:\\Program Files\\Autodesk\\AutoCAD 2025"
    ],
    "sofiplus_2025",
    [
      "ACADDIR",
      "C:\\Program Files\\Autodesk\\AutoCAD 2025",
      "ACAD_ID",
      "ACAD",
      "CURRENT_AUTOCAD",
      "SOFTWARE\\Autodesk\\AutoCAD\\R24.0\\ACAD-4101:409"
    ]
  ],
  "language": "en",
  "cmdline_to_install": [
    "codemeter",
    "webview2",
    "vc_redist_2022_x64",
    "windowsdesktop_runtime_win_x64",
    "sofistik_core_services",
    "sofistik_2025",
    "sofiplus_2025",
    "soficad_2025",
    "soficad_oem_deu_2025",
    "sofiplus_x_enu_2025",
    "revit_rxa_2025"
  ],
  "cmdline_to_remove": [
  ]
}
```

--------------------------------

### Execute Silent Installation via Command Line

Source: https://docs.sofistik.com/2025/en/administration/installation/inst_silent.html

Run the sam_apply.exe executable with a JSON configuration file to perform a silent installation.

```batch
"C:\Program Files\SOFiSTiK\common\SOFiSTiK Application Manager (SAM)\sam_apply.exe" --cli-input-json "C:\sofistik_mirror\sample_install.json"
```

--------------------------------

### Connect to CDB Example

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/fortran/examples/fortran_example1.html

Demonstrates the basic workflow of initializing a connection to a CDB file, checking its status, and closing it. Ensure the CDB path is correctly specified for your environment.

```fortran
program connect_to_CDB
implicit none

! Variables
integer :: nid, l, ie, index, istat
character(len=30)   :: filename
character(len=72)   :: text

index = 99
! input here the CDB name or the CDB path
filename = "S:\test\connect_to_cdb.cdb"

! Connect to CDB
! In this example 64bit debug DLL is used
call cdinit(filename, index)
if (nid > 0) then
    write(*,*) "  cdb_init of ", filename," succesfull ", nid
else
    write(*,*) "  cdb_init of ", filename," not succesfull ", nid
endif

! Check status
call cdstat(index, istat)
print *, "CDB status is: ", istat

! Lets close the CDB now
call cdclose(0)

! Check status again, if closed, status = 0
call cdstat(index, istat)
print *, "CDB status is: ", istat

! Press <ENTER> key to close the program
print *, "Press <ENTER> key to close the program"
read (*,*)

end program connect_to_CDB
```

```fortran
filename = "connect_to_cdb.cdb"
```

--------------------------------

### Locate C# Single Span Girder Example

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/c_sharp/examples/c_sharp_example4.html

Path to the project files for the single span girder example within the SOFiSTiK installation directory.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\c#\single_span_girder
```

--------------------------------

### Connect to CDB in VB.NET

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/vb_net/examples/vb_net_example1.html

Full example demonstrating how to set environment variables, initialize the CDB connection, check status, and close the database.

```vbnet
Imports System.Runtime.InteropServices

Module main
   'In this example, 64bit DLLs are used
   Public Declare Function sof_cdb_init Lib "sof_cdb_w-2024.dll" Alias "VB_sof_cdb_init" (
      ByVal name As String,
      ByVal InitType As Integer
   ) As Integer

   Public Declare Function sof_cdb_status Lib "sof_cdb_w-2024.dll" Alias "VB_sof_cdb_status" (
      ByVal Index As Integer
   ) As Integer

   Public Declare Function sof_cdb_close Lib "sof_cdb_w-2024.dll" Alias "VB_sof_cdb_close" (
      ByVal Index As Integer
   ) As Integer

   Sub Main()
      Dim Filename As String
      Dim Index As Integer
      Dim Path As String
      Dim analysisPath As String
      Dim analysisPath2 As String

      'Path of the SOFiSTIK Directory
      analysisPath = "C:\sofistik_installation\trunk\SOFiSTiK trunk\interfaces\64bit"
      analysisPath2 = "C:\sofistik_installation\trunk\SOFiSTiK trunk"

      'Set the environment variable
      Path = Environment.GetEnvironmentVariable("path")
      Path = analysisPath2 + ";" + analysisPath + ";" + Path
      Environment.SetEnvironmentVariable("path", Path)

      'Filename = full path with name of the cdb
      Filename = "S:\test\test.cdb"

      ' To connect to the CDB we will use
      Index = sof_cdb_init(Filename, 99)
      If Index < 0 Then
            Console.WriteLine("ERROR: Index= " & Index & " < 0 - see clib1.h for meaning of error codes")
            Console.ReadKey()
            Exit Sub
      ElseIf Index = 0 Then
            Console.WriteLine("ERROR: Index= " & Index & " - The File is not a database")
            Console.ReadKey()
            Exit Sub
      End If

      ' Output the index and status
      Console.WriteLine("Index: " & Index)
      'This outputs the status of the CDB, please refer to cdbase.chm for more details
      Console.WriteLine("CDB Status: " & sof_cdb_status(Index))

      ' Close the CDB
      Call sof_cdb_close(0)

      'Check if CDB closed succesfully
      If sof_cdb_status(Index) = 0 Then
            Console.WriteLine("CDB closed succesfully, status = 0")
      End If

      ' Press any key to close the program
      Console.Write("Press any <key> to close the program")
      Console.ReadKey()

   End Sub
End Module
```

--------------------------------

### Example SOFISTIK.DEF Configuration

Source: https://docs.sofistik.com/2025/en/fea/basic/def_env_variable.html

A sample configuration file defining various environment variables for SOFiSTiK programs.

```text
SOFISTIK_C=49
GRAFSIZE=SIZE -HP 0
HEAD1=New HQ of Xyz-Insurance-Company
CDBASEVER=503
```

--------------------------------

### CDB Get Loop Condition

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/c_sharp/examples/c_sharp_example4.html

Example of the loop condition used to iterate through CDB records.

```csharp
while (sof_cdb_get(index, 1, 1, &mat_conc, ref datalen, 1) < 2)
```

--------------------------------

### Workbook Configuration Path

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/vba/examples/vba_example1.html

The default directory path for the configured workbook example within the SOFiSTiK installation.

```text
C:\<sofistik_installation>\2024\SOFiSTiK 2024\interfaces\examples\vba\configure_workbook
```

--------------------------------

### Sample Protocol File Output

Source: https://docs.sofistik.com/2025/en/fea/calculation/prt.html

Example of a standard protocol file output showing program execution steps, versioning, and timing information.

```text
*** Start: Program Calculation - Version 2023-0.0
*** Start: Program AQUA : Materials and Cross-Section

SOFiSTiK trunk-0.0.1970    AQUA   - GENERAL SECTIONS
Output on file scl_4_iterative.plb
Project data base scl_4_iterative.cdb  -    30. access
Project: Model and geometry
TIME NEEDED         2, TOTAL         2
DATE       2023-03-05, 13:28:53

*** Stop : Program AQUA : Materials and Cross-Section
*** Start: Program SOFIMSHC : Model and geometry

SOFiSTiK trunk-0.0.1970    SOFIMSHC - GEOMETRY + STRUCT
Output on file scl_4_iterative.plb
Project data base scl_4_iterative.cdb  -    31. access
Project: Model and geometry
Analysis and decomposition of structural model:
CPU-time [s]:    0.02,   geom. tolerance [m]:   0.040
TIME NEEDED         0, TOTAL         0
DATE       2023-03-05, 13:28:53

*** Stop : Program SOFIMSHC : Model and geometry
*** Start: Program SOFILOAD : Loading

SOFiSTiK trunk-0.0.1970    SOFILOAD - LOAD GENERATOR
Output on file scl_4_iterative.plb
Project data base scl_4_iterative.cdb  -    32. access
Project: Model and geometry
TIME NEEDED         0, TOTAL         0
TIME NEEDED         0, TOTAL         0
DATE       2023-03-05, 13:28:54

*** Stop : Program SOFILOAD : Loading
```

--------------------------------

### Initialize Fortran Program and Modules

Source: https://docs.sofistik.com/2025/en/cdb_interfaces/fortran/examples/fortran_example4.html

Sets up the program structure and imports necessary CDB interface modules.

```fortran
program single_span_girder
use cdbase
use CDB_TYPES           ! this are our included data types
use CDB_TYPES_CON       ! add the types into project / solution
use CDB_TYPES_GEO
use CDB_TYPES_LFC
use CDB_TYPES_MAT
use CDB_TYPES_LFC
use CDB_TYPES_TEN
use CDB_TYPES_SYS
use CDB_TYPES_SCT
implicit none
```

--------------------------------

### text_if Word Template Examples

Source: https://docs.sofistik.com/2025/en/soficad/cmdref/b/bewehrung_allgemein/stahlliste.html

Examples of the text_if function applied in Word templates under different variable assumptions.

```text
> {text_if([[Comment: ]], comment)} 
> {text_if([[Comment ]], comment, [[. And finish]])} 
> {text_if([[Comment: ]], comment, member)} 
> {text_if([[Comment: ]], comment)} 
> {text_if([[Comment: ]], comment, [[. And finish]])} 
> {text_if(comment, member)}
```

--------------------------------

### Command Line Syntax for Starting a Program

Source: https://docs.sofistik.com/2025/en/fea/calculation/start_single_program.html

Use this syntax to execute a program directly. Ensure the filename is enclosed in quotes if it contains spaces.

```text
program filename [-parm] [projekt]
```

--------------------------------

### Generated SOFiLOAD Input Example

Source: https://docs.sofistik.com/2025/en/fea/ssd/tasks/task_combine_loads/task_combine_loads.html

Example of the input generated for the SOFiLOAD program following the automatic combination process.

```text
PROG SOFiLOAD
HEAD Combine loads

LC NO 15010 TYPE (D)  TITL "LC 15010 comb + Imp 61"
COPY NO 1 FACT 1
COPY NO 2 FACT 1
COPY NO 11 FACT 1.5
COPY NO 37 FACT 1.05
COPY NO 39 FACT 1.05
COPY NO 40 FACT 1.05
COPY NO 47 FACT 1.05
COPY NO 49 FACT 1.05
COPY NO 50 FACT 1.05
COPY NO 61 FACT 1

LC NO 15011 TYPE (D)  TITL "LC 15011 comb - Imp 60"
COPY NO 1 FACT 1.35
COPY NO 2 FACT 1.35
COPY NO 10 FACT 0.9
COPY NO 21 FACT 0.75
COPY NO 34 FACT 1.5
COPY NO 35 FACT 1.5
COPY NO 36 FACT 1.5
COPY NO 38 FACT 1.5
COPY NO 44 FACT 1.5
COPY NO 45 FACT 1.5
COPY NO 46 FACT 1.5
COPY NO 48 FACT 1.5
COPY NO 60 FACT -1

LC NO 15012 TYPE (D)  TITL "(1)+(2)+1.5(34)+1.5(37)+1.5(40)+1.5(44)+1.5(47)+1.5(50)"
COPY NO 1 FACT 1
COPY NO 2 FACT 1
COPY NO 34 FACT 1.5
COPY NO 37 FACT 1.5
COPY NO 40 FACT 1.5
COPY NO 44 FACT 1.5
COPY NO 47 FACT 1.5
COPY NO 50 FACT 1.5

END
```
Tokens:
Raw