lythoskinematic 0.1.0__tar.gz

lythoskinematic-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hdaltuntas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lythoskinematic-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: lythoskinematic
+Version: 0.1.0
+Summary: Rock slope kinematics and stability: Markland screening on a stereonet, Monte Carlo probability of failure, and limit-equilibrium analysis of wedge, planar and toppling failure with bolt design and PDF reporting.
+Author-email: Hasan Deniz Altuntaş <lythosfea@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hdaltuntas/lythoskinematic
+Project-URL: Repository, https://github.com/hdaltuntas/lythoskinematic
+Project-URL: Issues, https://github.com/hdaltuntas/lythoskinematic/issues
+Keywords: geotechnical,rock slope,slope stability,kinematic analysis,markland,stereonet,wedge,planar sliding,toppling,limit equilibrium,factor of safety,monte carlo,rock bolt,hoek brown,civil engineering,mining
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Turkish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.10
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: reportlab>=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+**English** | [Türkçe](README.tr.md)
+
+# Lythos Kinematic
+
+Rock slope kinematics and stability, driven from your browser. Two steps, one workflow:
+
+1. **Kinematic screening** — the Markland test on a stereonet, pole density and a Monte
+   Carlo probability of failure establish *which failure mechanism is possible*.
+2. **Limit equilibrium** — for the mechanism found critical, compute the *factor of
+   safety, the required support and the bolt design*.
+
+The two steps are bridged: the most critical discontinuity or intersection found during
+screening is written into the limit-equilibrium inputs with one click. The whole
+application — every label, result text, plot and PDF report — is bilingual in **Turkish
+and English**, switchable at runtime.
+
+The interface is a small HTTP server on your own machine, driven from a browser. That
+keeps the program usable over a remote session or inside a container, where a desktop
+toolkit would need a display it does not have, and it costs no dependency beyond the
+standard library.
+
+> This is the sibling of [LythosFEA](https://github.com/hdaltuntas/lythos) and follows
+> the same architecture. It merges two formerly separate desktop programs,
+> **SlopeKinematics** and **Kinematix**; see [Background](#background).
+
+## Screenshots
+
+| Kinematic screening | Bolt spacing × length matrix |
+|---|---|
+| ![Kinematic screening](assets/screening.png) | ![Bolt matrix](assets/bolts.png) |
+
+| Probabilistic analysis | Wedge analysis | English interface, dark theme |
+|---|---|---|
+| ![Probability](assets/probability.png) | ![Wedge](assets/wedge.png) | ![Dark theme](assets/english_dark.png) |
+
+## Install & run
+
+```bash
+pip install lythoskinematic
+lythos-kinematic                 # opens the interface in your browser
+```
+
+From a clone, with nothing installed but the scientific stack:
+
+```bash
+pip install numpy scipy matplotlib reportlab
+python main.py
+```
+
+Python 3.10+ is required.
+
+## Command line
+
+```bash
+lythos-kinematic                          # web interface (the default)
+lythos-kinematic web --port 9000 --lang EN --no-browser
+lythos-kinematic example -o inputs.json   # a starter input file
+lythos-kinematic screen inputs.json -o screening.pdf
+lythos-kinematic run inputs.json --mode wedge -o wedge.pdf
+```
+
+`screen` and `run` read the same JSON the interface saves, so a case set up in the
+browser can be re-run unattended.
+
+## What it computes
+
+### Kinematic screening
+- **Kinematic tests:** planar sliding, wedge sliding (Markland), flexural toppling
+  (Goodman & Bray)
+- **Stereonet:** equal-area (Schmidt) lower-hemisphere projection, pole density contour
+  (Kamb counting cone), critical zone sweep, friction / sliding limit cone
+- **Monte Carlo:** overall and component-wise probability of failure accounting for
+  discontinuity orientation uncertainty; runs on a background thread, the page stays live
+- **PDF report:** checks, probabilities and the stereonet in one file
+
+### Limit equilibrium
+- **Wedge (Swedge):** tetrahedral wedge geometry, Hoek & Bray vector limit equilibrium,
+  3D view and stereonet
+- **Planar (RocPlane):** tension crack, water pressure, seismic load, 2D section
+- **Toppling (RocTopple):** Goodman & Bray block toppling, water + seismic + toe anchor
+- **Support design:** force required for a target FS, a clickable bolt spacing × length
+  matrix, and a capacity/FS check for the design you pick
+- **PDF report:** project data, input tables, figures, force-balance tables
+
+### The bridge
+**"→ Send critical result to limit equilibrium"** transfers the most critical component:
+
+| Screening mode | Transferred inputs |
+|---|---|
+| Planar | sliding plane ψp, slope face ψf, friction angle φ |
+| Wedge | Joint 1 and Joint 2 dip/dip dir, slope face dip/dip dir, φ |
+| Toppling | discontinuity dip ψd, slope face ψf, φ |
+
+## Layout
+
+```
+main.py                    run from a clone without installing
+lythoskinematic/
+  cli.py                   command line (web · screen · run · example)
+  i18n.py                  language switch; bilingual text helper T("tr", "en")
+  forms.py                 input schema and readers — one definition per field
+  stereonet.py             shared lower-hemisphere projection (no extra deps)
+  render.py                figures as PNG, for the browser and the report alike
+  theme.py                 plot palette
+  kinematics/              screening core — independent of the interface
+    engine.py              Markland criteria + Monte Carlo
+    plots.py               screening stereonet
+    htmlreport.py          HTML report bodies
+    report.py              screening PDF report
+    i18n.py                TR/EN strings
+  rockslope/               limit-equilibrium core — independent of the interface
+    core.py wedge.py planar.py toppling.py bolts.py report.py style.py text.py
+  web/
+    server.py              HTTP routes (standard library only)
+    session.py             the one working session: analyses, figures, reports
+    strings.py             interface text, served to the page
+    static/                index.html · style.css · app.js
+tests/                     pytest suite
+```
+
+Forms are generated from `forms.py`: a field's key, label, unit, range and default are
+written once, in Python, and the page renders whatever the server sends. There is no
+second copy of the labels in JavaScript and nothing to keep in step by hand — switching
+language simply re-fetches the schema.
+
+## Background
+
+Lythos Kinematic began as two desktop programs, **SlopeKinematics** (kinematics and
+probability, PyQt5) and **Kinematix** (limit equilibrium, bolting and reporting,
+PySide6). Merging them required three changes worth recording:
+
+1. **One interface.** Two Qt bindings cannot share a process, and a desktop toolkit needs
+   a display. Both interfaces were replaced by this browser-driven one, which also brought
+   the two programs' workflows together behind a single set of inputs.
+2. **mplstereonet removed.** Stereonet drawing now comes from one shared implementation in
+   `stereonet.py` (equal-area/equal-angle projection, great and small circles, pole density
+   via the Kamb counting cone). Both modules plot on exactly the same geometry, and a
+   dependency that fails to build on current Python versions is gone.
+3. **One reporting path.** Screening reports used to be printed through Qt; everything now
+   goes through the same reportlab template as the limit-equilibrium report, so both
+   modules produce the same document, and no display is needed to make a PDF.
+
+While unifying the projection, **a radius normalisation bug in the equal-area projection
+was fixed**: horizontal lines (plunge = 0) landed at 70.7 % of the radius instead of on
+the primitive circle, so all data was squeezed into the inner part of the net. The fix is
+pinned by `tests/test_stereonet.py`.
+
+## Validation
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+The cores are pinned against closed-form solutions:
+
+- **wedge** — matches the Hoek & Bray closed-form short solution exactly
+  (dry 1.696 / flooded 1.065)
+- **planar** — c = 0, dry: tanφ/tanψp
+- **toppling** — Wyllie & Mah Chapter 9 example (block heights, failure modes,
+  limit-equilibrium φ ≈ 38°)
+- **kinematics** — the intersection line is cross-checked against the independent vector
+  implementation in the limit-equilibrium core; with zero uncertainty the Monte Carlo
+  result must reduce to the deterministic 0/100 answer
+- **stereonet** — projection radii against the analytical Schmidt/Wulff values, poles
+  against being perpendicular to the dip vector
+- **i18n** — every summary follows the language, the fixed-width label column stays
+  aligned in both, the numbers never change, and internal keys are never translated
+- **web** — the schema covers every field, the session's analyses reproduce the validated
+  results, background jobs finish without deadlocking the state poll, and the HTTP routes
+  return PNG figures, PDF reports and plain error messages rather than stack traces
+
+## Releasing
+
+`tools/upload_to_pypi.py` builds the distribution and uploads it, from a terminal
+or from an editor such as Thonny: run it and answer the questions. It makes its
+own environment for `build` and `twine`, refuses a version that is already on
+PyPI, and sends nothing before showing what it is about to upload. Set
+`TEST_PYPI = True` at the top to rehearse on TestPyPI.
+
+The token is never stored in the repository: it is read from `~/.pypirc` or typed
+in, and passed straight to twine. A project's **first** upload needs a token
+scoped to the entire account — a project-scoped token can only be created once
+the project exists.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

lythoskinematic-0.1.0/README.md

@@ -0,0 +1,188 @@
+**English** | [Türkçe](README.tr.md)
+
+# Lythos Kinematic
+
+Rock slope kinematics and stability, driven from your browser. Two steps, one workflow:
+
+1. **Kinematic screening** — the Markland test on a stereonet, pole density and a Monte
+   Carlo probability of failure establish *which failure mechanism is possible*.
+2. **Limit equilibrium** — for the mechanism found critical, compute the *factor of
+   safety, the required support and the bolt design*.
+
+The two steps are bridged: the most critical discontinuity or intersection found during
+screening is written into the limit-equilibrium inputs with one click. The whole
+application — every label, result text, plot and PDF report — is bilingual in **Turkish
+and English**, switchable at runtime.
+
+The interface is a small HTTP server on your own machine, driven from a browser. That
+keeps the program usable over a remote session or inside a container, where a desktop
+toolkit would need a display it does not have, and it costs no dependency beyond the
+standard library.
+
+> This is the sibling of [LythosFEA](https://github.com/hdaltuntas/lythos) and follows
+> the same architecture. It merges two formerly separate desktop programs,
+> **SlopeKinematics** and **Kinematix**; see [Background](#background).
+
+## Screenshots
+
+| Kinematic screening | Bolt spacing × length matrix |
+|---|---|
+| ![Kinematic screening](assets/screening.png) | ![Bolt matrix](assets/bolts.png) |
+
+| Probabilistic analysis | Wedge analysis | English interface, dark theme |
+|---|---|---|
+| ![Probability](assets/probability.png) | ![Wedge](assets/wedge.png) | ![Dark theme](assets/english_dark.png) |
+
+## Install & run
+
+```bash
+pip install lythoskinematic
+lythos-kinematic                 # opens the interface in your browser
+```
+
+From a clone, with nothing installed but the scientific stack:
+
+```bash
+pip install numpy scipy matplotlib reportlab
+python main.py
+```
+
+Python 3.10+ is required.
+
+## Command line
+
+```bash
+lythos-kinematic                          # web interface (the default)
+lythos-kinematic web --port 9000 --lang EN --no-browser
+lythos-kinematic example -o inputs.json   # a starter input file
+lythos-kinematic screen inputs.json -o screening.pdf
+lythos-kinematic run inputs.json --mode wedge -o wedge.pdf
+```
+
+`screen` and `run` read the same JSON the interface saves, so a case set up in the
+browser can be re-run unattended.
+
+## What it computes
+
+### Kinematic screening
+- **Kinematic tests:** planar sliding, wedge sliding (Markland), flexural toppling
+  (Goodman & Bray)
+- **Stereonet:** equal-area (Schmidt) lower-hemisphere projection, pole density contour
+  (Kamb counting cone), critical zone sweep, friction / sliding limit cone
+- **Monte Carlo:** overall and component-wise probability of failure accounting for
+  discontinuity orientation uncertainty; runs on a background thread, the page stays live
+- **PDF report:** checks, probabilities and the stereonet in one file
+
+### Limit equilibrium
+- **Wedge (Swedge):** tetrahedral wedge geometry, Hoek & Bray vector limit equilibrium,
+  3D view and stereonet
+- **Planar (RocPlane):** tension crack, water pressure, seismic load, 2D section
+- **Toppling (RocTopple):** Goodman & Bray block toppling, water + seismic + toe anchor
+- **Support design:** force required for a target FS, a clickable bolt spacing × length
+  matrix, and a capacity/FS check for the design you pick
+- **PDF report:** project data, input tables, figures, force-balance tables
+
+### The bridge
+**"→ Send critical result to limit equilibrium"** transfers the most critical component:
+
+| Screening mode | Transferred inputs |
+|---|---|
+| Planar | sliding plane ψp, slope face ψf, friction angle φ |
+| Wedge | Joint 1 and Joint 2 dip/dip dir, slope face dip/dip dir, φ |
+| Toppling | discontinuity dip ψd, slope face ψf, φ |
+
+## Layout
+
+```
+main.py                    run from a clone without installing
+lythoskinematic/
+  cli.py                   command line (web · screen · run · example)
+  i18n.py                  language switch; bilingual text helper T("tr", "en")
+  forms.py                 input schema and readers — one definition per field
+  stereonet.py             shared lower-hemisphere projection (no extra deps)
+  render.py                figures as PNG, for the browser and the report alike
+  theme.py                 plot palette
+  kinematics/              screening core — independent of the interface
+    engine.py              Markland criteria + Monte Carlo
+    plots.py               screening stereonet
+    htmlreport.py          HTML report bodies
+    report.py              screening PDF report
+    i18n.py                TR/EN strings
+  rockslope/               limit-equilibrium core — independent of the interface
+    core.py wedge.py planar.py toppling.py bolts.py report.py style.py text.py
+  web/
+    server.py              HTTP routes (standard library only)
+    session.py             the one working session: analyses, figures, reports
+    strings.py             interface text, served to the page
+    static/                index.html · style.css · app.js
+tests/                     pytest suite
+```
+
+Forms are generated from `forms.py`: a field's key, label, unit, range and default are
+written once, in Python, and the page renders whatever the server sends. There is no
+second copy of the labels in JavaScript and nothing to keep in step by hand — switching
+language simply re-fetches the schema.
+
+## Background
+
+Lythos Kinematic began as two desktop programs, **SlopeKinematics** (kinematics and
+probability, PyQt5) and **Kinematix** (limit equilibrium, bolting and reporting,
+PySide6). Merging them required three changes worth recording:
+
+1. **One interface.** Two Qt bindings cannot share a process, and a desktop toolkit needs
+   a display. Both interfaces were replaced by this browser-driven one, which also brought
+   the two programs' workflows together behind a single set of inputs.
+2. **mplstereonet removed.** Stereonet drawing now comes from one shared implementation in
+   `stereonet.py` (equal-area/equal-angle projection, great and small circles, pole density
+   via the Kamb counting cone). Both modules plot on exactly the same geometry, and a
+   dependency that fails to build on current Python versions is gone.
+3. **One reporting path.** Screening reports used to be printed through Qt; everything now
+   goes through the same reportlab template as the limit-equilibrium report, so both
+   modules produce the same document, and no display is needed to make a PDF.
+
+While unifying the projection, **a radius normalisation bug in the equal-area projection
+was fixed**: horizontal lines (plunge = 0) landed at 70.7 % of the radius instead of on
+the primitive circle, so all data was squeezed into the inner part of the net. The fix is
+pinned by `tests/test_stereonet.py`.
+
+## Validation
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+The cores are pinned against closed-form solutions:
+
+- **wedge** — matches the Hoek & Bray closed-form short solution exactly
+  (dry 1.696 / flooded 1.065)
+- **planar** — c = 0, dry: tanφ/tanψp
+- **toppling** — Wyllie & Mah Chapter 9 example (block heights, failure modes,
+  limit-equilibrium φ ≈ 38°)
+- **kinematics** — the intersection line is cross-checked against the independent vector
+  implementation in the limit-equilibrium core; with zero uncertainty the Monte Carlo
+  result must reduce to the deterministic 0/100 answer
+- **stereonet** — projection radii against the analytical Schmidt/Wulff values, poles
+  against being perpendicular to the dip vector
+- **i18n** — every summary follows the language, the fixed-width label column stays
+  aligned in both, the numbers never change, and internal keys are never translated
+- **web** — the schema covers every field, the session's analyses reproduce the validated
+  results, background jobs finish without deadlocking the state poll, and the HTTP routes
+  return PNG figures, PDF reports and plain error messages rather than stack traces
+
+## Releasing
+
+`tools/upload_to_pypi.py` builds the distribution and uploads it, from a terminal
+or from an editor such as Thonny: run it and answer the questions. It makes its
+own environment for `build` and `twine`, refuses a version that is already on
+PyPI, and sends nothing before showing what it is about to upload. Set
+`TEST_PYPI = True` at the top to rehearse on TestPyPI.
+
+The token is never stored in the repository: it is read from `~/.pypirc` or typed
+in, and passed straight to twine. A project's **first** upload needs a token
+scoped to the entire account — a project-scoped token can only be created once
+the project exists.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

lythoskinematic-0.1.0/lythoskinematic/__init__.py

@@ -0,0 +1,31 @@
+"""
+Lythos Kinematic — kaya şevi kinematiği ve stabilitesi (web tabanlı).
+
+İki adımlı bir iş akışı sunar:
+
+    1. Kinematik tarama  — Markland testi, stereonet, kutup yoğunluğu ve
+                           Monte Carlo olasılık analizi
+    2. Limit denge       — kama / düzlemsel / devrilme analizi, bulon karelaj ve
+                           boy tasarımı, PDF rapor
+
+Arayüz, tarayıcıdan sürülen yerel bir web sunucusudur (yalnızca standart
+kütüphane); bu sayede uzak oturumda veya kapsayıcı içinde de çalışır.
+
+Paket düzeni
+------------
+    lythoskinematic.i18n        dil anahtarı; çift dilli metin yardımcısı
+    lythoskinematic.stereonet   ortak alt yarımküre stereonet projeksiyonu
+    lythoskinematic.kinematics  kinematik tarama çekirdeği (Markland + Monte Carlo)
+    lythoskinematic.rockslope   limit denge çekirdeği (Hoek & Bray, Goodman & Bray)
+    lythoskinematic.forms       girdi şeması ve okuyucuları (arayüzden bağımsız)
+    lythoskinematic.web         yerel web sunucusu ve tarayıcı arayüzü
+
+Çalıştırma:  lythos-kinematic        (veya  python -m lythoskinematic)
+"""
+
+__version__ = "0.1.0"
+
+APP_NAME = "Lythos Kinematic"
+ORG = "Lythos"
+
+__all__ = ["__version__", "APP_NAME", "ORG"]

lythoskinematic-0.1.0/lythoskinematic/__main__.py

@@ -0,0 +1,6 @@
+"""`python -m lythoskinematic` ile arayüzü tarayıcıda açar."""
+import sys
+
+from .cli import main
+
+sys.exit(main())

lythoskinematic-0.1.0/lythoskinematic/cli.py

@@ -0,0 +1,93 @@
+"""Komut satırı arayüzü."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from . import APP_NAME, __version__
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="lythos-kinematic",
+        description="Rock slope kinematics and stability: Markland screening, "
+                    "Monte Carlo probability and limit-equilibrium analysis.")
+    parser.add_argument("--version", action="version", version=f"{APP_NAME} {__version__}")
+    sub = parser.add_subparsers(dest="command")
+
+    web = sub.add_parser("web", help="start the interface in a browser")
+    web.add_argument("--port", type=int, default=8778)
+    web.add_argument("--host", default="127.0.0.1")
+    web.add_argument("--lang", default="TR", choices=["TR", "EN"])
+    web.add_argument("--no-browser", action="store_true")
+
+    screen = sub.add_parser("screen", help="run a kinematic screening from an input file")
+    screen.add_argument("inputs", help="path to a .json input file")
+    screen.add_argument("-o", "--out", default=None, help="write a PDF report here")
+    screen.add_argument("--lang", default="TR", choices=["TR", "EN"])
+
+    run = sub.add_parser("run", help="run a limit-equilibrium analysis from an input file")
+    run.add_argument("inputs", help="path to a .json input file")
+    run.add_argument("--mode", default="wedge", choices=["wedge", "planar", "toppling"])
+    run.add_argument("-o", "--out", default=None, help="write a PDF report here")
+    run.add_argument("--lang", default="TR", choices=["TR", "EN"])
+
+    example = sub.add_parser("example", help="write a starter input file")
+    example.add_argument("-o", "--out", default="lythos_inputs.json")
+
+    args = parser.parse_args(argv)
+    command = args.command or "web"
+
+    if command == "web":
+        from .web.server import serve
+        serve(host=getattr(args, "host", "127.0.0.1"), port=getattr(args, "port", 8778),
+              open_browser=not getattr(args, "no_browser", False),
+              lang=getattr(args, "lang", "TR"))
+        return 0
+
+    if command == "example":
+        import json
+
+        from . import forms
+        with open(args.out, "w", encoding="utf-8") as fh:
+            json.dump({"format": "lythos-kinematic", "version": 1, **forms.defaults()},
+                      fh, indent=2, ensure_ascii=False)
+        print(args.out)
+        return 0
+
+    import json
+
+    from .i18n import set_language
+    from .web.session import Session
+
+    set_language(args.lang)
+    with open(args.inputs, encoding="utf-8") as fh:
+        values = json.load(fh)
+    session = Session()
+
+    if command == "screen":
+        result = session.screen(values)
+        if not result["ok"]:
+            print(result["error"], file=sys.stderr)
+            return 1
+        payload = result["result"]
+        print(f"{payload['mode_label']}: {payload['n_critical']} / {payload['n_items']}")
+        for item in payload["items"]:
+            print(f"  {item['name']:<16} {item['status']}")
+        if args.out:
+            import time
+            while session.state()["job"] == "running":   # Monte Carlo bitsin
+                time.sleep(0.05)
+            print(session.report("screening", args.out))
+        return 0
+
+    result = session.equilibrium(args.mode, values)
+    print(result["summary"])
+    if args.out:
+        print(session.report("equilibrium", args.out))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())