SGIO¶

Structure Gene (SG) I/O

Python package interfacing VABS and SwiftComp. The package is developed based on meshio, which is used for converting meshing data.

Features

The package can be used to:

• Read/write SG data from/to different formats

• Convert SG/mesh data between different formats

• Read structural property from VABS/SwiftComp output

• Create 1D SG from layup input

Supported Data Formats

• For complete SG data:

  • VABS, SwiftComp, Abaqus

• For mesh data only:

  • All formats supported by meshio

A structure gene (SG) is defined as the smallest mathematical building block of a structure.[^1] A cross-section (CS) is a type of 2D SG.

Online documentation

Installation¶

1. Download the package.

2. Install dependencies:

   pip install -r <INSTALL_DIR>/sgio/sgio/requirements.txt
   

3. Configure environment variables:

   • Add the package root directory to PYTHONPATH.

   • Add <INSTALL_DIR>/sgio/bin to PATH.

Usage¶

API¶

Example: Read Beam Properties from VABS Output File¶

import sgio

model = sgio.readOutputModel('my_cross_section.sg.k', 'vabs', 'BM1')

Command Line Interface¶

Example: Convert Cross-Sectional Data from Abaqus (.inp) to VABS Input¶

Suppose a cross-section has been built in Abaqus and output to cross-section.inp. To convert the data to the VABS input (Timoshenko model) cross-section.sg:

sgio convert cross-section.inp cross-section.sg -ff abaqus -tf vabs -m bm2

Complete Options¶

usage: sgio [-h] {build,b,convert,c} ...

CS/SG I/O functions

positional arguments:
  {build,b,convert,c}  sub-command help
    build (b)          Build 1D SG
    convert (c)        Convert CS/SG data file

optional arguments:
  -h, --help           show this help message and exit

Convert SG Data¶

usage: sgio convert [-h] [-ff FROM_FORMAT] [-tf TO_FORMAT] [-d SGDIM] [-m MODEL] [-mo] from to

positional arguments:
  from                  CS/SG file to be read from
  to                    CS/SG file to be written to

optional arguments:
  -h, --help            show this help message and exit
  -ff FROM_FORMAT, --from-format FROM_FORMAT
                        CS/SG file format to be read from
  -tf TO_FORMAT, --to-format TO_FORMAT
                        CS/SG file format to be written to
  -d SGDIM, --sgdim SGDIM
                        SG dimension (SwiftComp only)
  -m MODEL, --model MODEL
                        CS/SG model
  -mo, --mesh-only      Mesh only conversion

Check out the example examples/convert_cs_from_abaqus_to_vabs for more details.

License¶

Reference¶