Project Links

• Homepage
• PyPi
• Bug Reports
• Discussions

[!IMPORTANT] Project documentation is underway

Table of Contents

• What is geolysis?
• Installation
• Soil Classification Example
  • AASHTO Classification
  • USCS Classification
• Release History
• Code of Conduct
• Contributing
• License
• Contact Information

What is geolysis?

geolysis is an open-source software for geotechnical analysis and modeling. It provides features such as soil classifications (based on the USCS and AASHTO classification standards), estimating soil bearing capacity using SPT N-value, and estimating of soil engineering parameters such as Soil Unit Weight (moist, saturated, and submerged), Compression index, soil internal angle of friction, and undrained shear strength of soil.

Features to include in upcoming versions:

• Settlement analysis
• Discrete element method (DEM)

The motivation behind geolysis is to provide free software to assist geotechnical engineers in their day-to-day work and to expose civil engineering students (especially geotechnical students) to tools that can make them industry-ready geotechnical engineers right from college.

Installation

pip install geolysis

Soil Classification Example

AASHTO Classification

>>> from geolysis.soil_classifier import AASHTO
>>> aashto_cls = AASHTO(liquid_limit=30.2, plasticity_index=6.3, fines=11.18)
>>> aashto_cls.soil_class
'A-2-4(0)'
>>> aashto_cls.soil_desc
'Silty or clayey gravel and sand'

USCS Classification

>>> from geolysis.soil_classifier import USCS
>>> uscs_cls = USCS(liquid_limit=34.1, plastic_limit=21.1, fines=47.88,
...                 sand=37.84, gravel=14.8)
>>> uscs_cls.soil_class
'SC'
>>> uscs_cls.soil_desc
'Clayey sands'
>>> uscs_cls = USCS(liquid_limit=30.8, plastic_limit=20.7, fines=10.29,
...                 sand=81.89, gravel=7.83, d_10=0.07, d_30=0.3, d_60=0.8)
>>> uscs_cls.soil_class
'SW-SC'
>>> uscs_cls.soil_desc
'Well graded sand with clay'

Release History

Check the changelog for release history.

Code of Conduct

This project has a code of conduct that we expect all contributors to adhere to. Please read and follow it when participating in this project.

Contributing

If you would like to contribute to this project, please read the contributing guidelines

License

Distributed under the MIT license. By using, distributing, or contributing to this project, you agree to the terms and conditions of this license.

Contact Information

• LinkedIn

[!IMPORTANT] For questions or comments about geolysis, please ask them in the discussions forum