Introduction

pyvstress is a rudimentary geotechnical tool for computing vertical and lateral stresses in soil. The primary focus is computing vertical total stresses, and vertical effective stresses at specified points. The porewater pressure is determined from the groundwater depth. It also returns layer properties of the layer in which the point lies.

WARNING: Some tests are failing from code changes. And this document rendering is not working correctly, the module links are not working.

Motivation

The motivation was to have a simple tool to be able to compute vertical and lateral stresses, and extract layer properties at the locations of the points which can then be used for futher calculations.

Limitations

  • Can only compute vertical stresses below horizontal layers.

Installation/Usage:

There are three alternatives:

  1. There is a version published in PyPi. pip install pyvstress

  2. Put the files in pyvstress/pyvstress in the same directory as your source files and call from pyvstress import Point, SoilLayer, SoilProfile etc.

  3. Local installation

For local installation use the following procedures as guide.

  1. Clone the repository git clone https://gitlab.com/geosharma/pyvstress.git.

  2. cd in the cloned directory cd pyvstress.

  3. Create a .venv directory in the project folder, mkdir .venv.

  4. Make a virtual environment python -m venv .venv.

  5. Activate the virtual environment source .venv/bin/activate

  6. Install the requirements python -m pip install -r requirements.txt

  7. Install the package locally pip install -e .

Above (4) and (5) are run after activating the virtual environment. This will install the package to the virtual environment. Any changes your make to the source code will be reflected in the package.