OpenPile

Open-source PILE software.

Please see official documentation for more information.

This package is an open source python library that provides users a tool box for geotechnical pile calculations.

This package allows the user to:

Use basic Euler-Bernoulli beam theory (as well as Timoshenko's variation) to compute forces, deflection of a beam (or a pile) under adequate loading and support conditions.
Use Winkler's approach of a beam (or a pile) supported by linear or non-linear lateral and/or rotational springs to compute forces and deflection of the pile based on recognised soil models such as the widely used traditional API models for sand and clay or more recent models that stem from the PISA joint-industry project.

This library supports the following versions of python: 3.7-3.10. Python 3.11 is not supported!

Support

This package takes time and effort. You can support by buying me a coffee.

Installation Instructions

Prerequisites:

a version of python is installed on your machine (supported versions: 3.7-3.10)
pip is installed in your environment.

pip install openpile

Features

Python 3.7-3.10 support
Interactive structure perfectly suited for Jupyter Notebook
Integrated data validation to prevent wrong inputs with pydantic
very fast computations fueled by the Numpy, Numba and Pandas libraries
Calculations
- Beam calculation
- Winkler model (i.e. beam supported by soil springs)
  - Load-driven analyses
  - Displacement-driven analyses
- Out-of-the-box computation of individual soil springs
Friendly API interface with object-oriented approach
Matplotlib and Pandas libraries to facilitate post-processing of results.

Please share with the community

This library relies on community interactions. Please consider sharing a post about OpenPile and the value it can provide for researcher, academia and professionals.

Adding new pile materials

I was trying to add a new material type following the current implementation of Pile. Here's the code:

@dataclass(config=PydanticConfig)
class Pile:
    # ...
    material: Literal["Steel", "Concrete"]
    # ...

    def __post_init__(self):
        # ...
  
        # Create material specific specs for given material
        if self.material == "Steel":
            # unit weight
            self._uw = 78.0  # kN/m3
            # young modulus
            self._young_modulus = 210.0e6  # kPa
            # Poisson's ratio
            self._nu = 0.3
        elif self.material == "Concrete":
            # unit weight
            self._uw = 25.0  # kN/m3
            # young modulus
            self._young_modulus = 30.0e6  # kPa
            # Poisson's ratio
            self._nu = 0.2            
        else:
            raise UserWarning

When I try to add a test creating a concrete pile, there's a pydantic validation error:

pile = construct.Pile(
    name="",
    kind="Circular",
    material="Concrete",
    top_elevation=0,
    pile_sections={
        length": [20],
        diameter": [1.0],
        wall thickness": [0.5],
    },
)

E   pydantic.error_wrappers.ValidationError: 1 validation error for Pile
E   material
E     unexpected value; permitted: 'Steel' (type=value_error.const; given=Concrete; permitted=('Steel',))

pydantic\dataclasses.py:425: ValidationError

TestPile::test_concrete_pile - pydantic.error_wrappers.ValidationError: 1 validation error for Pile

Even if I define material as material: Literal["Concrete"], I still get the very same error saying that only "Steel" is a permitted value. Where're the permitted values defined?

tchildill / openpile Goto Github PK

openpile's Introduction

OpenPile

Support

Installation Instructions

Features

Please share with the community

openpile's People

Contributors

Stargazers

Watchers

Forkers

openpile's Issues

Adding new pile materials

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent