geolysis 0.3.0__py3-none-any.whl → 0.4.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,193 @@
1
+ Metadata-Version: 2.2
2
+ Name: geolysis
3
+ Version: 0.4.3
4
+ Summary: geolysis is an opensource software for geotechnical engineering analysis and modeling.
5
+ Author-email: Patrick Boateng <boatengpato.pb@gmail.com>
6
+ License: MIT License
7
+ Project-URL: Homepage, https://docs.geolysis.io
8
+ Project-URL: Documentation, https://docs.geolysis.io
9
+ Project-URL: Repository, https://github.com/patrickboateng/geolysis
10
+ Project-URL: Discussions, https://github.com/patrickboateng/geolysis/discussions
11
+ Project-URL: Issue Tracker, https://github.com/patrickboateng/geolysis/issues
12
+ Keywords: geotechnical-engineering,soil-classification,bearing-capacity-analysis,standard-penetration-test-analysis
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Intended Audience :: Education
16
+ Classifier: Intended Audience :: Science/Research
17
+ Classifier: License :: OSI Approved :: MIT License
18
+ Classifier: Natural Language :: English
19
+ Classifier: Operating System :: OS Independent
20
+ Classifier: Programming Language :: Python :: 3.11
21
+ Classifier: Programming Language :: Python :: 3.12
22
+ Classifier: Programming Language :: Python :: Implementation :: CPython
23
+ Classifier: Topic :: Scientific/Engineering
24
+ Requires-Python: >=3.11
25
+ Description-Content-Type: text/markdown
26
+ License-File: LICENSE.txt
27
+ Provides-Extra: dev
28
+ Requires-Dist: pytest; extra == "dev"
29
+ Requires-Dist: pytest-cov; extra == "dev"
30
+ Requires-Dist: coverage; extra == "dev"
31
+
32
+ <div align="center">
33
+ <img src="https://raw.githubusercontent.com/patrickboateng/geolysis/dev/docs/source/_static/branding/geolysislogo.svg"
34
+ alt="geolysislogo" width="75%" />
35
+ </div><br>
36
+
37
+ <div align="center">
38
+
39
+ [![PyPI Latest Release](https://img.shields.io/pypi/v/geolysis?style=flat&logo=pypi)](https://pypi.org/project/geolysis/)
40
+ [![PyPI Downloads](https://static.pepy.tech/badge/geolysis)](https://pepy.tech/projects/geolysis)
41
+ [![PyPI pyversions](https://img.shields.io/pypi/pyversions/geolysis.svg?logo=python&style=flat)](https://pypi.python.org/pypi/geolysis/)
42
+ [![license](https://img.shields.io/pypi/l/geolysis?style=flat&logo=opensourceinitiative)](https://opensource.org/license/mit/)
43
+
44
+ ![Coveralls Status](https://img.shields.io/coverallsCoverage/github/patrickboateng/geolysis?logo=coveralls)
45
+ [![Codacy Badge](https://app.codacy.com/project/badge/Grade/17f88084c6a84a08a20f9d8da1438107)](https://app.codacy.com/gh/patrickboateng/geolysis/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
46
+ [![Unit-Tests](https://github.com/patrickboateng/geolysis/actions/workflows/geolysis-unit-tests.yml/badge.svg)](https://github.com/patrickboateng/geolysis/actions/workflows/unit-tests.yml)
47
+ [![Documentation Status](https://readthedocs.org/projects/geolysis/badge/?version=latest)](https://geolysis.readthedocs.io/en/latest/?badge=latest)
48
+
49
+ </div>
50
+
51
+ `geolysis` is an open-source library for geotechnical analysis and modeling.
52
+ It offers tools for soil classification, Standard Penetration Test (SPT)
53
+ analysis, and bearing capacity estimation, among others.
54
+
55
+ The `geolysis` library is among four main projects: `geolysis.gui`,
56
+ `geolysis.excel`, and `geolysis.ai`. The geolysis library powers all of these
57
+ projects.
58
+
59
+ **_The `geolysis` projects are currently under developement and not yet
60
+ publicly available_**.
61
+
62
+ **_Active development of `geolysis` occurs on the `dev` branch. For more
63
+ information on the latest features of `geolysis`, switch to the
64
+ `dev` branch_**.
65
+
66
+ Here are brief descriptions of these projects:
67
+
68
+ <table>
69
+ <tr>
70
+ <td>
71
+ <strong>geolysis.gui</strong>
72
+ </td>
73
+ <td>A graphical user interface that allows users to interact with the
74
+ geolysis library. Through this interface, users can view generated reports
75
+ and visualizations, such as Particle Size Distribution (PSD) curves,
76
+ Atterberg Limits plots, and Compaction curves, among others.
77
+ Additionally, it enables users to conduct foundation analysis and
78
+ design, among other functionalities.
79
+ </td>
80
+ </tr>
81
+ <tr>
82
+ <td>
83
+ <strong>geolysis.excel</strong>
84
+ </td>
85
+ <td>An add-in for Microsoft Excel that performs simple geotechnical
86
+ analysis. It offers some features similar to <code>geolysis.gui</code>
87
+ within Microsoft Excel.
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td>
92
+ <strong>geolysis.ai</strong>
93
+ </td>
94
+ <td>Offers machine learning models that are trained using geotechnical data.
95
+ </td>
96
+ </tr>
97
+ </table>
98
+
99
+ ## Project Structure
100
+
101
+ .
102
+ ├── .github # GitHub Actions
103
+ ├── docs # Documentation files
104
+ ├── geolysis # Source files
105
+ ├── tests # Automated tests
106
+ └── README.md
107
+
108
+ ## Table of Contents
109
+
110
+ - [Installation](#installation)
111
+ - [Usage Example](#usage-example)
112
+ - [Features](#features)
113
+ - [Documentation](#documentation)
114
+ - [Contributing](#contributing)
115
+ - [License](#license)
116
+ - [Contact](#contact)
117
+
118
+ ## Installation
119
+
120
+ ```shell
121
+ $ pip install geolysis
122
+ ```
123
+
124
+ ## Usage Example
125
+
126
+ ```python
127
+
128
+ >>> from geolysis.soil_classifier import create_soil_classifier
129
+ >>> uscs_clf = create_soil_classifier(liquid_limit=34.1,
130
+ ... plastic_limit=21.1,
131
+ ... fines=47.88,
132
+ ... sand=37.84,
133
+ ... clf_type="USCS")
134
+ >>> clf = uscs_clf.classify()
135
+ >>> clf
136
+ SoilClf(symbol='SC', description='Clayey sands')
137
+ >>> clf.symbol
138
+ 'SC'
139
+ >>> clf.description
140
+ 'Clayey sands'
141
+
142
+ ```
143
+
144
+ ```python
145
+
146
+ >>> from geolysis.soil_classifier import create_soil_classifier
147
+ >>> aashto_clf = create_soil_classifier(liquid_limit=34.1,
148
+ ... plastic_limit=21.1,
149
+ ... fines=47.88,
150
+ ... sand=37.84, # Sand is optional for AASHTO classification
151
+ ... clf_type="AASHTO")
152
+ >>> clf = aashto_clf.classify()
153
+ >>> clf
154
+ SoilClf(symbol='A-6(4)', description='Clayey soils')
155
+ >>> clf.symbol
156
+ 'A-6(4)'
157
+ >>> clf.description
158
+ 'Clayey soils'
159
+
160
+ ```
161
+
162
+ ## Features
163
+
164
+ | | |
165
+ |----------------------------------------------|---------------------------------------|
166
+ | **Soil Classification** | AASHTO Classification System |
167
+ | | Unified Soil Classification System |
168
+ | **Standard Penetration Test (SPT) Analysis** | SPT Energy Correction |
169
+ | | SPT Overburden Pressure Correction |
170
+ | | Dilatancy Correction |
171
+ | | SPT N-Design Calculation |
172
+ | **Bearing Capacity Estimation** | Allowable Bearing Capacity Estimation |
173
+ | | Ultimate Bearing Capacity Estimation |
174
+
175
+ ## Documentation
176
+
177
+ Full documentation is available [here](https://docs.geolysis.io/en/latest/)
178
+
179
+ ## Contributing
180
+
181
+ Contribution guidelines can be
182
+ found [here](https://docs.geolysis.io/en/latest/dev_guide/index.html)
183
+
184
+ ## License
185
+
186
+ This project is licensed under the MIT License - see the
187
+ [LICENSE](https://github.com/patrickboateng/geolysis/blob/main/LICENSE.txt)
188
+ file for more details.
189
+
190
+ ## Contact
191
+
192
+ For questions or feedback, please contact us at
193
+ [boatengpato.pb@gmail.com](mailto:boatengpato.pb@gmail.com)
@@ -0,0 +1,9 @@
1
+ geolysis/__init__.py,sha256=Nyg0pmk5ea9-SLCAFEIF96ByFx4-TJFtrqYPN-Zn6g4,22
2
+ geolysis/foundation.py,sha256=KIZewS9-l_tSDtgy9Ym5ADHETTuho3GJPBguh3Y28fw,10149
3
+ geolysis/soil_classifier.py,sha256=GsT7qNwfXjZh0zo1O2e7iTN35ywdvzEs4vgaaqYA7Lo,26786
4
+ geolysis/spt.py,sha256=E8rg6wKL4jbX8Xz-p9KdyfGxcQr8TdoZR4ZA9eUU4aI,14246
5
+ geolysis-0.4.3.dist-info/LICENSE.txt,sha256=ap6sMs3lT7ICbEXBhgihwH1BTCVcjmCQkIkwVnil1Ak,1065
6
+ geolysis-0.4.3.dist-info/METADATA,sha256=-hGWQ3izaFfDhQ44lc7ZSM83WmllA-RbbQYuKqWKWUQ,7394
7
+ geolysis-0.4.3.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
8
+ geolysis-0.4.3.dist-info/top_level.txt,sha256=9mnQgOaCRr11dtXff8X-q3FfXjRONd6kHseSy5q2y8g,9
9
+ geolysis-0.4.3.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: bdist_wheel (0.43.0)
2
+ Generator: setuptools (76.0.0)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5
 
geolysis/core/__init__.py DELETED
@@ -1,9 +0,0 @@
1
- from geolysis.core import (
2
- abc_4_cohl_soils,
3
- constants,
4
- estimators,
5
- foundation,
6
- soil_classifier,
7
- spt,
8
- utils,
9
- )