geolysis 0.7.0__py3-none-any.whl → 0.7.2__py3-none-any.whl

geolysis/__init__.py

@@ -1,5 +1,5 @@
 from . import foundation, soil_classifier, spt
 
-__version__ = "0.7.0"
+__version__ = "0.7.2"
 
 __all__ = ["foundation", "soil_classifier", "spt"]

geolysis/foundation.py

@@ -320,7 +320,9 @@ class FoundationSize:
         """Returns the :attr:`effective_width`, :attr:`length`, and
         :attr:`footing_shape` of the foundation footing.
         """
-        width, length, shape = self.effective_width, self.length, self.footing_shape
+        width, length, shape = (self.effective_width,
+                                self.length,
+                                self.footing_shape)
 
         if not isclose(width, length) and shape != Shape.STRIP:
             shape = Shape.RECTANGLE
@@ -374,7 +376,8 @@ def create_foundation(depth: float,
     try:
         shape = Shape(str(shape).casefold())
     except ValueError as e:
-        msg = EnumErrorMsg(param_name="shape", param_value=shape,
+        msg = EnumErrorMsg(param_name="shape",
+                           param_value=shape,
                            param_type=Shape)
         raise ValueError(msg) from e
 

geolysis/utils/validators.py

@@ -1,6 +1,7 @@
 """validators"""
 import operator
 from typing import Callable, TypeAlias, Optional
+from functools import wraps
 
 from .exceptions import ValidationError
 
@@ -13,6 +14,7 @@ def _num_validator(bound: float, /, *,
                    exc_type: Callable,
                    err_msg: str):
     def dec(fn):
+        @wraps(fn)
         def wrapper(obj, val):
             if not compare_fn(val, bound):
                 msg = f"{fn.__name__} must be {compare_symbol} {bound}"
@@ -30,6 +32,7 @@ def _len_validator(bound: float, /, *,
                    exc_type: Callable,
                    err_msg: str):
     def dec(fn):
+        @wraps(fn)
         def wrapper(obj, val):
             _len = len(val)
             if not compare_fn(_len, bound):

{geolysis-0.7.0.dist-info → geolysis-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geolysis
-Version: 0.7.0
+Version: 0.7.2
 Summary: geolysis is an opensource software for geotechnical engineering analysis and modeling.
 Author-email: Patrick Boateng <boatengpato.pb@gmail.com>
 License: MIT License
@@ -49,53 +49,77 @@ alt="geolysislogo" width="75%" />
 
 </div>
 
-`geolysis` is an open-source library for geotechnical analysis and modeling.
-It offers tools for soil classification, Standard Penetration Test (SPT)
-analysis, and bearing capacity estimation, among others.
-
-The `geolysis` library is among four main projects: `geolysis.gui`,
-`geolysis.excel`, and `geolysis.ai`. The geolysis library powers all of these
-projects.
-
-**_The `geolysis` projects are currently under developement and not yet
-publicly available_**.
-
-**_Active development of `geolysis` occurs on the `dev` branch. For more
-information on the latest features of `geolysis`, switch to the
-`dev` branch_**.
-
-Here are brief descriptions of these projects:
-
-<table>
-  <tr>
-    <td>
-    <strong>geolysis.gui</strong>
-    </td>
-    <td>A graphical user interface that allows users to interact with the
-     geolysis library. Through this interface, users can view generated reports
-     and visualizations, such as Particle Size Distribution (PSD) curves,
-     Atterberg Limits plots, and Compaction curves, among others.
-     Additionally, it enables users to conduct foundation analysis and
-     design, among other functionalities.
-    </td>
-  </tr>
-  <tr>
-    <td>
-    <strong>geolysis.excel</strong>
-    </td>
-    <td>An add-in for Microsoft Excel that performs simple geotechnical
-     analysis. It offers some features similar to <code>geolysis.gui</code>
-     within Microsoft Excel.
-    </td>
-  </tr>
-  <tr>
-    <td>
-    <strong>geolysis.ai</strong>
-    </td>
-    <td>Offers machine learning models that are trained using geotechnical data.
-    </td>
-  </tr>
-</table>
+`geolysis` is an open-source python package (library) for geotechnical analysis
+and modeling. It offers tools for soil classification, Standard Penetration
+Test (SPT) analysis, and bearing capacity estimation, among others.
+
+The `geolysis` package is among three other projects, `geolysis.gui`,
+`geolysis.excel`, and `geolysis.ai`.
+
+Here are brief descriptions of the `geolysis` projects:
+
+1. `geolysis`
+
+   A python package (library) which provides the core functionalities for
+   `geolysis.gui` and the `geolysis.excel` applications. Current features
+   provided by the `geolysis` package are shown in the table below.
+
+   <table>
+    <tr>
+        <td><strong>Soil Classification</strong></td>
+        <td>AASHTO Classification System</td>
+    </tr>
+    <tr>
+        <td></td>
+        <td>Unified Soil Classification System</td>
+    </tr>
+    <tr>
+        <td><strong>Standard Penetration Test (SPT) Analysis</strong></td>
+        <td>SPT Energy Correction</td>
+    </tr>
+    <tr>
+        <td></td>
+        <td>SPT Overburden Pressure Correction</td>
+    </tr>
+    <tr>
+        <td></td>
+        <td>SPT Dilatancy Correction</td>
+    </tr>
+    <tr>
+        <td></td>
+        <td>SPT N-Design Calculation</td>
+    </tr>
+    <tr>
+        <td><strong>Bearing Capacity Estimation</strong></td>
+        <td>Allowable Bearing Capacity Estimation</td>
+    </tr>
+    <tr>
+        <td></td>
+        <td>Ultimate Bearing Capacity Estimation</td>
+    </tr>
+   </table>
+
+2. `geolysis.gui`
+
+   A graphical user interface that allows users to interact with the `geolysis`
+   package. Through this interface, users can view generated reports and
+   visualizations, such as Particle Size Distribution (PSD) curves, Atterberg
+   Limits plots, and Compaction curves, among others.
+
+3. `geolysis.excel`
+
+   An add-in for Microsoft Excel that performs simple geotechnical analysis.
+   It offers some features similar to `geolysis.gui` within Microsoft Excel.
+   Below is an example of the Microsoft Excel addin.
+
+   <div align="center">
+    <img src="https://raw.githubusercontent.com/patrickboateng/geolysis/main/docs/_static/geolysis_excel_example.gif" 
+    alt="geolysis excel example" width="100%" />
+   </div><br>
+
+4. `geolysis.ai`
+
+   Offers machine learning models that are trained using geotechnical data.
 
 ## Project Structure
 
@@ -162,43 +186,6 @@ SoilClf(symbol='A-6(4)', description='Clayey soils')
 Check out more examples
 [here](https://docs.geolysis.io/en/latest/user_guide/getting_started.html#quick-start)
 
-## Features
-
-<table>
-    <tr>
-        <td><strong>Soil Classification</strong></td>
-        <td>AASHTO Classification System</td>
-    </tr>
-    <tr>
-        <td></td>
-        <td>Unified Soil Classification System</td>
-    </tr>
-    <tr>
-        <td><strong>Standard Penetration Test (SPT) Analysis</strong></td>
-        <td>SPT Energy Correction</td>
-    </tr>
-    <tr>
-        <td></td>
-        <td>SPT Overburden Pressure Correction</td>
-    </tr>
-    <tr>
-        <td></td>
-        <td>Dilatancy Correction</td>
-    </tr>
-    <tr>
-        <td></td>
-        <td>SPT N-Design Calculation</td>
-    </tr>
-    <tr>
-        <td><strong>Bearing Capacity Estimation</strong></td>
-        <td>Allowable Bearing Capacity Estimation</td>
-    </tr>
-    <tr>
-        <td></td>
-        <td>Ultimate Bearing Capacity Estimation</td>
-    </tr>
-</table>
-
 ## Documentation
 
 Full documentation is available [here](https://docs.geolysis.io/en/latest/)
@@ -216,5 +203,5 @@ file for more details.
 
 ## Contact
 
-For questions or feedback, please contact us at
-[boatengpato.pb@gmail.com](mailto:boatengpato.pb@gmail.com)
+For questions or feedback, please
+contact [boatengpato.pb@gmail.com](mailto:boatengpato.pb@gmail.com)

{geolysis-0.7.0.dist-info → geolysis-0.7.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
-geolysis/__init__.py,sha256=Jci65l56vPOCLgyRSCpXTFEo-hZw93M-hUL26YUf3TM,122
-geolysis/foundation.py,sha256=E0d-hRoIa2EjyRW98UVAaGD02ekYh4TFABhQi1MloVw,11602
+geolysis/__init__.py,sha256=AvRgv11HmUiEzG07RQS3vGM6j234EtzUPJKnSGUBePo,122
+geolysis/foundation.py,sha256=gxI6bLbUrxQNhoKJis5glDysnI6PgqBkMM9m5CQztsg,11695
 geolysis/soil_classifier.py,sha256=2C-4hpgXNo2DUgXKcokUh3qjAH70qvgOCnxsL_NnmTw,26880
 geolysis/spt.py,sha256=7C8FPwwUej_YLkLAMMyUVhWYoh9FH4__6g5_G8NSas0,17507
 geolysis/bearing_capacity/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -16,9 +16,9 @@ geolysis/bearing_capacity/ubc/terzaghi_ubc.py,sha256=zoTf2pVTd1zN_6-yuNK9njo-8rn
 geolysis/bearing_capacity/ubc/vesic_ubc.py,sha256=zlFI26tY_L1LCb6T7q4NY4E0pTivdjYyTttp-VcIlvk,7405
 geolysis/utils/__init__.py,sha256=713rJNWVFLrP4CNon4i-xUf5rF5eA40Ydg-F1UV8o-0,2339
 geolysis/utils/exceptions.py,sha256=ivuyxqz0B7nmA5sXMfw4o7KPnQHoaGbLHmJCEiCEaAc,929
-geolysis/utils/validators.py,sha256=eHDHXJt8suncpyUUp4O2JIMaqusnLo2q5_VBGwkmJRs,3139
-geolysis-0.7.0.dist-info/licenses/LICENSE.txt,sha256=ap6sMs3lT7ICbEXBhgihwH1BTCVcjmCQkIkwVnil1Ak,1065
-geolysis-0.7.0.dist-info/METADATA,sha256=TOHlHHggMorq2vjf7exOONsNxSFC6NEjZpyiEWzHwPU,7368
-geolysis-0.7.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-geolysis-0.7.0.dist-info/top_level.txt,sha256=9mnQgOaCRr11dtXff8X-q3FfXjRONd6kHseSy5q2y8g,9
-geolysis-0.7.0.dist-info/RECORD,,
+geolysis/utils/validators.py,sha256=g18NIlLaNSIjlBwRLkUQr68qcYnwzo5qcfY5y_GoO1Y,3205
+geolysis-0.7.2.dist-info/licenses/LICENSE.txt,sha256=ap6sMs3lT7ICbEXBhgihwH1BTCVcjmCQkIkwVnil1Ak,1065
+geolysis-0.7.2.dist-info/METADATA,sha256=XjRf0LvX0IAhJgp2mkMk-uNTTsuwgHZ4iovkMwC2oUI,7235
+geolysis-0.7.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+geolysis-0.7.2.dist-info/top_level.txt,sha256=9mnQgOaCRr11dtXff8X-q3FfXjRONd6kHseSy5q2y8g,9
+geolysis-0.7.2.dist-info/RECORD,,

{geolysis-0.7.0.dist-info → geolysis-0.7.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (79.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any