xslope
xslope is an open-source Python package for geotechnical slope stability and seepage analysis. It answers the question a slope engineer has to answer on every embankment, cut, dam, and levee — is this slope stable, and by how much? — with three analysis engines that share one input file:
- Limit equilibrium (LEM) — the method of slices with seven methods: Ordinary Method of Slices, Simplified Janbu, Bishop's Simplified, Corps of Engineers, Lowe & Karafiath, Spencer, and Morgenstern–Price. Circular and non-circular surfaces, automated critical-surface search, rapid drawdown, reinforcement, seismic loading, and Monte Carlo reliability analysis.
- Finite element seepage — saturated/unsaturated groundwater flow, steady-state or transient, on a mesh generated from the same slope geometry. It produces the pore pressure field used by the stability analyses, rather than assuming pore pressures from a piezometric line, and also serves as a standalone 2D groundwater flow solver.
- Finite element slope stability — elastic–perfectly plastic Mohr–Coulomb analysis with the Shear Strength Reduction Method, which lets the failure mechanism emerge instead of requiring an assumed failure surface.
Problems are defined in an Excel template, which keeps the workflow accessible to practitioners while the analysis and plotting run in Python. A companion desktop application, XSLOPE Studio, provides a point-and-click interface to the same engine.
Installation
xslope requires Python 3.9 or later and is published on PyPI:
pip install xslope
That installs everything needed for limit equilibrium analysis. Optional extras add the remaining capabilities:
pip install "xslope[fem]" # seepage and finite element analysis (adds gmsh)
pip install "xslope[gui]" # XSLOPE Studio, the desktop application
pip install "xslope[ai]" # Studio's AI assistant
pip install "xslope[cad]" # DXF import/export
pip install "xslope[gui,fem,ai,cad]" # everything
Studio is launched with the xslope-studio command. On Debian/Ubuntu Linux
(including Google Colab), gmsh needs system OpenGL libraries — run
apt-get install -y libgl1 libglu1-mesa before installing the fem extra.
Example
A problem is an Excel file. This example uses one of the sample problems from this repository, so download it into the current directory first:
curl -O https://raw.githubusercontent.com/njones61/xslope/main/docs/inputs/slope/xslope_simple1.xlsx
Then load it, build slices on its failure surface, solve for the factor of safety, and plot the result:
from xslope.fileio import load_slope_data
from xslope.slice import generate_slices
from xslope.solve import solve_selected
from xslope.plot import plot_solution
slope_data = load_slope_data("xslope_simple1.xlsx")
circle = slope_data['circles'][0]
success, result = generate_slices(slope_data, circle=circle, num_slices=20)
slice_df, failure_surface = result
results = solve_selected('bishop', slice_df)
print(f"FS = {results['FS']:.3f}") # FS = 1.279
plot_solution(slope_data, slice_df, failure_surface, results)
To search for the critical surface instead of analyzing a single one:
from xslope.search import circular_search
from xslope.plot import plot_circular_search_results
fs_cache, converged, search_path, circle_cache = circular_search(slope_data, 'bishop')
print(f"minimum FS = {fs_cache[0]['FS']:.3f}") # minimum FS = 1.215
plot_circular_search_results(slope_data, fs_cache, search_path)
More sample problems are in docs/inputs/slope/ in this
repository. To start a problem from scratch instead, a blank copy of the input
template ships inside the installed package, at the path returned by
xslope.fileio.default_template_path().
Documentation
Full documentation — theory, input template reference, worked examples, XSLOPE Studio, and verification against published benchmarks — is at xslope.org.
Support and contributing
Questions, bug reports, and feature requests go to GitHub Issues. Contributors should start with the contributing guide, which covers the development install, coding conventions, and the test suite.
Citation
If you use xslope in published work, please cite the archived release:
Jones, N. L. (2026). xslope (Version 0.2.1) [Computer software]. https://doi.org/10.5281/zenodo.21830232
Machine-readable metadata is in CITATION.cff.
License
This project is licensed under the Apache License, Version 2.0 - see the LICENSE.txt file for details.
Copyright
Copyright 2025 Norman L. Jones
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xslope-0.5.0.tar.gz.
File metadata
- Download URL: xslope-0.5.0.tar.gz
- Upload date:
- Size: 1.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
63b7c39839de548de04d72dc62d55665cc8b938e8a6357c14e473f3ece329d84
|
|
| MD5 |
dcfc56f52a2792c6fed960bd9ce11bbe
|
|
| BLAKE2b-256 |
f9ce1f7a0406c350e630715ad64079de195268c635217c37d85e868b4a6e2b8d
|
File details
Details for the file xslope-0.5.0-py3-none-any.whl.
File metadata
- Download URL: xslope-0.5.0-py3-none-any.whl
- Upload date:
- Size: 2.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d9bfaa525a89ea5d30d4e713639bd701961a10a544d80cf3310d6de7f1ae6286
|
|
| MD5 |
67095b92a68d272469927c888dfae44f
|
|
| BLAKE2b-256 |
5f465376758a4ab0a300e2324db1a7eb37908939cb13ca782d76f7609d4a09d8
|
