https://github.com/petrkryslucsd/pystran

Python package for structural analysis with trusses and beams
https://github.com/petrkryslucsd/pystran

analysis beam python rigid rigid-body spring structural structural-analysis structure truss

Last synced: 22 days ago
JSON representation

Python package for structural analysis with trusses and beams

• Host: GitHub
• URL: https://github.com/petrkryslucsd/pystran
• Owner: PetrKryslUCSD
• License: mit
• Created: 2024-11-18T02:01:17.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-04-27T15:24:09.000Z (25 days ago)
• Last Synced: 2025-04-30T23:46:01.121Z (22 days ago)
• Topics: analysis, beam, python, rigid, rigid-body, spring, structural, structural-analysis, structure, truss
• Language: Python
• Homepage:
• Size: 3.94 MB
• Stars: 3
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)

[![Documentation pages](https://img.shields.io/badge/documentation-blue)](https://petrkryslucsd.github.io/pystran)

 

# pystran: Python for Structural Analysis

A simple structural analysis tool in Python, for structures consisting of truss

and beam members, springs, and rigid bodies, both in two dimensions and in three dimensions.

![Alt pystran capabilities in graphic abstract](docs/splash.png)

## News

- 03/13/2025: Update documentation for the sphinx system.

- 03/10/2025: Add rigid links and general springs.

[Past news](#past-news)

## Features & Limitations

- The package analyzes two-dimensional and three-dimensional structures made up

  of truss (axial) members and beams (possibly in combination), rigid links, and

  general springs. Concentrated masses can be added at joints.

- Linear statics and dynamics (free vibration) solvers are included.

- Only elastic models can be solved.

- For beams, only the Bernoulli-Euler model is implemented, so no shear

  deformation is taken into account.

- Only straight members are treated.

- It is assumed that the cross sections are doubly symmetric, and there is no coupling between the bending actions in the

  two orthogonal principal planes.

- Coupling of axial and bending action is not implemented. This means that the

  neutral axis must pass through the centroid.

- Warping of the cross sections is not modelled, hence only free torsion

  effects are included.

- Member loading is not considered. All member loading needs to be converted to

  nodal forces by the user.

- Member end releases (hinges)

  are not implemented. Internal hinges can be modelled with linked joints. 

- Degrees of freedom are only along the global Cartesian axes. Skew supports

  are not included (except with a penalty method based on springs)

- Offsets of the beams from the joints are currently not implemented.

- Rigid links between pairs of joints can be modeled with a penalty approach.

## Requirements

`pystran` depends on the following Python packages: 

- NumPy

- SciPy

- Matplotlib

These requirements can be easily satisfied by running the examples in the [Spyder IDE](docs/spyder/spyder.md).

## Documentation

Documentation of the package is provided in these [HTML pages](https://petrkryslucsd.github.io/pystran).

More details about the generation of the documentation are [here](docs/make_docs.md).

## Running

This package is not distributed through the official Python channels.

It needs to be downloaded from GitHub as a zip file, and expanded in some convenient location. 

The __`pystran` folder__ can be located by looking for this README.md file.

The easiest way to run a pystran example is to download and install Spyder 6.

[Detailed instructions](docs/spyder/spyder.md) are provided. 

It is also possible to run simulations using a [plain Python in a terminal](docs/terminal/terminal.md).

## Tutorials

Step-by-step tutorials are available in the [`tutorials`](./tutorials) folder. 

For example, run tutorials in the `pystran/tutorials` in the terminal  as 

```

py tutorials/01_three_bars_tut.py

```

Or, [use Spyder](docs/spyder/spyder.md), which makes the whole process a lot easier to set up.

## Testing

In the `pystran/tests` folder, run 

```

py unittests_planar_truss.py 

```

and analogously for the other unit test files.

## Past news

- 03/05/2025: Describe the operation of the scripts.

- 02/12/2025: Make it possible to use general joint and member identifiers.

- 02/05/2025: Add general springs to ground.

- 01/30/2025: Add tutorials.

- 01/22/2025: Implement initial functionality.