Metadata-Version: 2.1
Name: ogstools
Version: 0.2.0
Summary: A collection of Python tools aimed at evolving into a modeling toolchain around OpenGeoSys.
Author-email: OpenGeoSys Community <info@opengeosys.org>
License: BSD-3-Clause
Project-URL: Documentation, https://ogs.ogs.xyz/tools/ogstools
Project-URL: Bug Tracker, https://discourse.opengeosys.org
Project-URL: Source Code, https://gitlab.opengeosys.org/ogs/tools/ogstools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: h5py>=3.9.0
Requires-Dist: jupytext>=1.15.2
Requires-Dist: meshio==5.3.4
Requires-Dist: matplotlib>=3.7.1
Requires-Dist: nbconvert>=7.9.2
Requires-Dist: pyvista>=0.39.1
Requires-Dist: rich>=13.4.2
Requires-Dist: scipy>=1.10.1
Requires-Dist: Pint>=0.22
Requires-Dist: Pillow>=9.5.0
Requires-Dist: pandas>=2.0.3
Requires-Dist: papermill>=2.4.0
Requires-Dist: ogs>=6.5.0
Requires-Dist: ogs6py>=0.370
Provides-Extra: dev
Requires-Dist: pre-commit>=2.20; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: black; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: coverage; extra == "test"
Requires-Dist: gmsh; extra == "test"
Requires-Dist: ogs6py; extra == "test"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-argparse; extra == "docs"
Requires-Dist: sphinxcontrib-programoutput; extra == "docs"
Requires-Dist: sphinxcontrib-apidoc; extra == "docs"
Requires-Dist: livereload; extra == "docs"
Requires-Dist: pydata-sphinx-theme; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: myst_nb; extra == "docs"
Requires-Dist: sphinx-design; extra == "docs"
Requires-Dist: sphinx_gallery; extra == "docs"
Requires-Dist: ogs6py; extra == "docs"
Requires-Dist: VTUinterface; extra == "docs"
Provides-Extra: feflow
Requires-Dist: ifm_contrib==0.2.0; extra == "feflow"
Requires-Dist: matplotlib<3.8; extra == "feflow"

![OGS workflow overview](https://ogs.ogs.xyz/tools/ogstools/_static/ogstools.png "Supporting complex workflows - from preprocessing to simulation to postprocessing")

is a:

- Python library for streamlined usage of [OpenGeoSys](https://www.opengeosys.org) that aims to enable [OpenGeoSys](https://www.opengeosys.org) users to harness the full potential of Python's extensive ecosystem.
- set of interconnected modules for pre- and postprocessing of simulations with [OpenGeoSys](https://www.opengeosys.org),
- valuable resource that includes documentation, Jupyter notebooks, and workflows for guidance and reference.

# Overview

- **Website:** <https://www.opengeosys.org>
- **Documentation:** <https://ogs.ogs.xyz/tools/ogstools>
- **Source code:** <https://gitlab.opengeosys.org/ogs/tools/ogstools>
- **Contributing:** <https://ogs.ogs.xyz/tools/ogstools/development/index.html>
- **Bug reports:** <https://discourse.opengeosys.org>

# Installation

Install the latest version of ogstools:

```bash
pip install ogstools
```

For further details see the [User Guide](https://ogs.ogs.xyz/tools/ogstools/user-guide/index.html).

# Getting started

For first steps, please take a look at our [examples](https://ogs.ogs.xyz/tools/ogstools/auto_examples/index.html).

# Contribution

Please report bugs on [Discourse](https://discourse.opengeosys.org) or fork the repository on our [GitLab](https://gitlab.opengeosys.org/ogs/tools/ogstools) and create a merge request. We also welcome contributions in the form of merge requests and are here to assist in ensuring that the code passes all quality checks. We recommend starting with the [Developer Guide](https://ogs.ogs.xyz/tools/ogstools/development/index.html) as your initial point of reference.

You may also contribute by [donating](https://gitlab.opengeosys.org/ogs/tools/ogstools/-/blob/release-notes/donation.md) your existing code snippets.

# Motivation

To gain a deeper insight into the rationale behind the development of this Python library, find a comprehensive motivation section available [here](docs/user-guide/introduction/motivation.md).

# Related projects

- [ogs](https://pypi.org/project/ogs)
- [ogs6py](https://pypi.org/project/ogs6py)
- [VTUInterface](https://pypi.org/project/VTUinterface)

# License

`ogstools` is distributed under the Modified BSD License. See the `LICENSE`-file for the license text.
