Welcome to openpile’s documentation!

This package is an open source python library that provides users a toolbox 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!

Cite OpenPile in your research paper

You can refer to OpenPile in your research paper by citing the following:

Guillaume M. (2023). TchilDill/openpile: OpenPile version 0.7.0 (v0.7.0). Zenodo. https://doi.org/10.5281/zenodo.10116667

Contents:

• Getting started
  • System of units
  • Installation
  • Some more help on installing python before OpenPile
  • First model in OpenPile
• Usage
  • Example 1 - Create a pile
  • Example 2 - Calculate and plot a p-y curve
  • Example 3 - Create a soil profile’s layer
  • Example 4 - Create a soil profile
  • Example 5 - Run a winkler analysis
  • Example 6 - Visualize a model
• Background and Theory
  • Usage
  • Lateral soil models
  • Axial soil models
• API
  • Construct module
  • Pile
  • Layer
  • SoilProfile
  • Model
  • SoilModels module
  • API_clay_axial
  • Bothkennar_clay
  • Cowden_clay
  • Dunkirk_sand
  • API_sand
  • API_clay
  • Reese_weakrock
  • Custom_pisa_sand
  • Custom_pisa_clay
  • analyze module
  • beam()
  • winkler()
  • utils module
  • The Result class

License

Copyright (C) 2023 Guillaume Melin

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Disclaimer

This open source package is primarily provided for educational and research purposes. It is not intended to replace professional engineering advice or analyses. The analyses performed using this package may not accurately represent real-world situations or account for all possible variables and conditions.

Users of this package assume all responsibility and liability for any consequences resulting from its use. The developers and contributors of this package make no warranties or guarantees, expressed or implied, regarding its accuracy, reliability, or fitness for any particular purpose.

Users should exercise caution and use their professional judgement when interpreting and applying the results generated by this package. In addition, users should be aware that the laws and regulations governing the use of finite element analyses may vary depending on their location and industry, and should comply with all applicable laws and regulations.

By using this package, users acknowledge and agree to the terms of this disclaimer.

Indices and tables

• Index

• Module Index

• Search Page