geolysis.core

geolysis.core is an open-source software that provides features for analyzing geotechnical results obtained from laboratory and field tests. Some of the features implemented include soil classification, standard penetration test analysis (such as SPT $N_{design}$ and SPT N-value corrections),and calculating the allowable bearing capacity of soils from Standard Penetration Test N-values. There are more features underway, which include settlement analysis, ultimate bearing capacity analysis, etc.

geolysis.core is the foundation application on which other parts of the application will depend. Developers can also use geolysis.core to power their applications.

Check out the release notes for features.

Project Links

• Documentation
• Repo
• PyPi
• Bug Reports
• Discussions

Table of Contents

• Motivation
• Installation
• Getting Started
  • Soil Classification Example
• Release History
• Code of Conduct
• Contributing
• License
• Governance of this project
• Contact Information

Motivation

geolysis.core is a free software package designed specifically to assist developers in building applications that can solve complex geotechnical problems. Whether you're working on soil mechanics, rock mechanics, or any other geotechnical field, geolysis.core provides a powerful set of tools that can help you design and develop robust solutions. With an intuitive API and a wide range of features, this software is an essential tool for anyone who needs to work with geotechnical data on a regular basis. Whether you're a seasoned geotechnical engineer or a new developer just getting started in the field, geolysis.core is the ideal solution for all your software development needs.

Installation

pip install geolysis

Getting Started

Soil Classification Example

AASHTO classification

>>> from geolysis.core.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.core.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.

Governance of this project

geolysis.core is still developing relatively rapidly, so please be patient if things change or features iterate and change quickly. Once geolysis.core hits 1.0, it will slow down considerably.

Contact Information

• LinkedIn

Important

For questions or comments about geolysis.core, please ask them in the discussions forum