Metadata-Version: 2.4
Name: garisenda
Version: 0.1.0
Summary: Ground movements from tunneling and their effect on utilities and buildings, traceable, with figures for every result
Keywords: geotechnical,geotechnical engineering,tunneling,settlement,ground movement,utilities,pipelines,building damage
Author: Konner Horton
Author-email: Konner Horton <konnerhorton@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Requires-Dist: matplotlib>=3.8
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.1.1,<3
Requires-Dist: pint>=0.24.4
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/konnerhorton/garisenda
Project-URL: Source, https://github.com/konnerhorton/garisenda
Project-URL: Issues, https://github.com/konnerhorton/garisenda/issues
Project-URL: Specification, https://github.com/konnerhorton/garisenda/blob/main/SPEC.md
Description-Content-Type: text/markdown

# garisenda

Ground movements from tunneling and their effect on utilities and buildings: greenfield closed-form and empirical methods, made traceable. Every result records its inputs, its method, its source and the limits it was checked against, comes with a figure, and says when it falls outside a method's range, which is where a numerical model is needed.

The name is the Garisenda, the leaning tower in Bologna whose lean comes from settlement of its foundations.

> **Status:** pre-alpha. The transverse trough at the surface and below it, several tunnels by superposition, the movement along a utility with its critical distances, the figures and sweeps work; utility and building checks come next. The trough's sources aren't verified yet, so results are for trying the library, not for design. The plan is in [SPEC.md](SPEC.md).

**Docs:** [konnerhorton.github.io/garisenda](https://konnerhorton.github.io/garisenda/), with a [getting-started walkthrough](https://konnerhorton.github.io/garisenda/getting-started/).

## Install

```bash
pip install garisenda      # or: uv add garisenda
```

The release on PyPI can be behind the docs, which follow the latest version on GitHub; the [install page](https://konnerhorton.github.io/garisenda/install/) says how to install that.

## License

MIT. See [LICENSE](LICENSE).
