ADAPTIC PyProc

ADAPTIC PyProc is a repository that contains useful modules written in Python for pre-processing and post-processing data for finite element analysis software ADAPTIC.

Introduction

ADAPTIC is a finite element analysis (FEA) software developed by Prof. Izzuddin at Imperial College London. It is an adaptive static and dynamic analysis program, which accounts for material and geometrical nonlinearities. It has been successfully used in the analyses of extreme loadings such as earthquakes, blast explosions, fire and sudden column removals. Several special structural forms have been developed including RC and composite slabs, cables, membranes and curved shells. Some of its novel features and findings using the software have been published in the leading international scientific journals (see publications).

There is no modelling GUI available and it requires specially prepared input files. Once the analysis is completed, output files are produced and two graphics post-processing applications are available:

• ADAPTIC_graphs for plotting X-Y graphs.
• ADAPTIC_shapes for plotting deflected shapes.

The data syntax might be daunting for the new users, whilst for the experienced ones it could be time-consuming. ADAPTIC PyProc or aims to make the modelling and analysis easier. Processing of 2D and 3D models is available.

Navigation and modules arrangement

The repository is divided into four sub-folders:

1. assets
2. libraries
3. documentation
4. models

1. Assets

This folder contains images and miscellaneous data used to obtain certain properties of the model.

2. Libraries

These are all the python libraries .py that provide the necessary classes and functions to run the analyses. These were designed for pre-processing and post-processing data in ADAPTIC.

1. utils.py - contains miscellaneous functions and classes used through the entire project.
2. materials.py - material classes. Currently the following material models are available: stl1, con1, con2, stmdl2 and bond.
3. sections.py - section classes. Currently the following section models are available: rss, rccs, rcts and isec.
4. adaptic.py - this defines the adaptic class for post-processing.

3. Documentation

The documentation of the libraries is covered in the corresponding .ipynb notebooks.

1. materials.ipynb - covers the definition and application of different material classes available in materials.py.
2. sections.ipynb - describes different section classes available in sections.py.

4. Models

Sample models were created to show how ADAPTIC PyProc could be incorporated into a project. The definition of a model is done in preprocessor.ipynb. When running this notebook a .dat file is created and used as an input for ADAPTIC (see software documentation). The output files have to be then placed in the model folder to run postprocessor.ipynb_ notebook for post-processing. Each model contains the following folders and files:

2. preprocessor.ipynb - this notebook generates the .dat and pkl files. It reads the libraries defined in modules folder and modifies certain properties if necessary. It does not provide the overview of the model, which is covered in analysis.ipynb instead.
3. postprocessor.ipynb_ - this notebook describes the model, unpickles the objects from pre-processing stage and reads the ADAPTIC output from the num file. Next, post-processing of the data is carried out with an interpretation of the results.
4. .dat file - input file for ADAPTIC analysis.
5. .num file - output file from ADAPTIC that contains the numerical results at all requested load/time steps.
6. .log file - output file from ADAPTIC that contains solution progress log (not required by ADAPTIC PyProc).
7. .plt file - ADAPTIC output plot file used by the native ADAPTIC post-processing programs (not required by ADAPTIC PyProc).

Units

The units required in program are shown in the table below, unless stated otherwise.

Unit
mm
N
MPa
N/mm
N/mm³