Skip to content

Open source · AGPL-3.0 · Python

Geotechnical engineering,one family of tools.

Lythos is a family of eight geotechnical engineering programs for slopes, foundations and retaining structures. They share one architecture: driven from your browser, bilingual in English and Turkish, reporting to PDF, HTML and Word, and tested against closed-form solutions.

$ pip install lythosbearing
$ lythos-bearing
Lythos Bearing 0.1.0 — http://127.0.0.1:8781/

$ lythos-bearing run project.bearing
Bearing capacity by method
  Terzaghi (1943)        q_ult = 516.8 kPa
  Meyerhof (1963)        q_ult = 466.0 kPa
  Brinch Hansen (1970)   q_ult = 474.2 kPa
  Vesić (1973) *         q_ult = 533.5 kPa
  EN 1997-1 Annex D      q_ult = 517.3 kPa
  Sliding: FS = 5.33 ≥ 1.50 — OK

Opens in your browser; your data never leaves your machine.

KinematicLEFEABearingSettlePileSPWAMSEW
Every structure in this section is analysed by one of the Lythos tools — point at one.
8programs
2languages — English and Turkish
3interfaces — browser, CLI, Python
3report formats — PDF, HTML, Word

The family

Each tool does one job in depth; together they cover the geotechnical design of a whole project.

Slopes and rock

Finite elements, limit equilibrium and rock slope kinematics.

LythosFEA

2D finite element analysis

2D finite elements for slopes, embankments and deep excavations: factor of safety by strength reduction, staged construction, internal forces in walls and piles, sections and construction sequence straight from DXF.

  • Strength reduction (SSR)
  • Staged construction
  • DXF import
  • Wall and anchor forces
pip install lythosfea

Lythos LE

Limit equilibrium slope stability

Method-of-slices stability of slopes and embankments: eight methods from Fellenius to Morgenstern-Price, critical surface search, water, seismic, reinforcement and tension cracks — with zero dependencies.

  • 8 limit equilibrium methods
  • Circular and non-circular
  • No dependencies
  • Validated against ACADS
pip install lythosle

Lythos Kinematic

Rock slope kinematics and stability

Markland screening on a stereonet and Monte Carlo probability of failure, then wedge, planar and toppling limit equilibrium, bolt design and PDF reports — in one workflow.

  • Markland test + stereonet
  • Monte Carlo probability
  • Wedge · planar · toppling
  • Bolt spacing × length matrix
pip install lythoskinematic

Foundations

Shallow foundation capacity, settlement and piles.

Lythos Bearing

Bearing capacity of shallow foundations

Terzaghi, Meyerhof, Hansen, Vesić, EN 1997-1 and Skempton side by side; eccentric and inclined loads, layered ground, SPT/CPT/pressuremeter, rock, earthquake and reliability studies.

  • 6 factor sets side by side
  • EN 1997-1 DA1/DA2/DA3
  • Punching and load spread
  • Probability of failure and β
pip install lythosbearing

Lythos Settle

Settlement of foundations and embankments

Boussinesq and 2:1 stress distribution, Steinbrenner and Schmertmann immediate settlement, primary consolidation and secondary compression, Terzaghi time–settlement and angular distortion checks.

  • Immediate + consolidation + secondary
  • Embankment (trapezoidal) loads
  • t50, t90 and time curve
  • Probability of exceedance
pip install lythossettle

Lythos Pile

Pile capacity, groups and settlement

Shaft friction by the α, β and λ methods, Meyerhof/Vesić/Janbu base resistance, group efficiency and block failure, required length, single and group settlement; rock sockets by twelve correlations.

  • α · β · λ methods
  • 4 group efficiencies + block
  • Equivalent raft settlement
  • 12 rock socket correlations
pip install lythospile · installs from GitHub

Retaining structures

Sheet pile walls and mechanically stabilised earth.

Lythos SPWA

Sheet pile wall analysis

Free-earth support limit equilibrium and staged Winkler beam-spring analysis side by side; Mononobe-Okabe seismic pressures, tension-only anchors and reliability studies.

  • Free-earth support
  • Staged beam-spring (Winkler)
  • Mononobe-Okabe + Westergaard
  • Sheet pile section database
pip install lythosspwa

Lythos MSEW

Mechanically stabilised earth walls

External and internal stability per FHWA-NHI-10-024 and AASHTO LRFD 11.10: sliding, overturning, bearing, tensile, pullout, connection; steel strips and geosynthetics, corrosion, earthquake, ASD or LRFD.

  • External + internal stability
  • Steel strips and geosynthetics
  • ASD or LRFD
  • Wall height study
pip install lythosmsew · installs from GitHub

One architecture, eight tools

Learn one and you know them all. Same interface layout, same files, same commands.

Driven from a browser

The interface is a small HTTP server on your own machine. It works over a remote session, in a container and on a headless server.

Bilingual

Every label, result, figure and report in English and Turkish; switch while it runs — the numbers never change.

One-source reports

PDF, self-contained HTML and Word reports come from one assembly, so all three say the same thing.

Project files

Inputs are saved as readable JSON. A case set up in the browser re-runs unattended from the command line.

Reliability studies

Sweep any input as a range or a distribution: LHS, Monte Carlo, sensitivities, probability of failure and β.

Validated

Every method is pinned with pytest against published tables, hand calculations and closed-form solutions.

Three ways in

One engine — click through it in the browser, drive it from the command line, or script it from Python.

The Lythos Bearing interface: six methods side by side, the checks and the width required.
The Lythos Bearing interface: six methods side by side, the checks and the width required.

All of them, on one project

Follow the design of an excavation, a fill, a piled foundation and an anchored wall on a port site end to end, with the right Lythos tool at every step.

Go to the end-to-end example →
  1. 1Lythos Bearing
  2. 2Lythos Settle
  3. 3Lythos Pile
  4. 4Lythos SPWA
  5. 5Lythos LE
  6. 6LythosFEA

Your first analysis is five minutes away.

Python 3.10+ and a single pip command.

Installation guide →

Released under the AGPL-3.0 licence.