Metadata-Version: 2.5
Name: talsimpy
Version: 3.0.0
Summary: Python interface for Talsim datasets, databases, scenarios, simulation runs and time series processing.
Project-URL: Homepage, https://github.com/sydroconsult/talsimpy
Project-URL: Documentation, https://sydroconsult.github.io/talsimpy/
Project-URL: Changelog, https://github.com/sydroconsult/talsimpy/blob/main/CHANGELOG.md
Author-email: SYDRO Consult GmbH <mail@sydro.de>
License: Copyright (c) 2026 SYDRO Consult GmbH
        
        Permission is hereby granted, free of charge, to any person obtaining a
        copy of this software (the "Software"), to use the Software for any
        purpose, including commercial purposes, in particular for preparing,
        transforming, or manipulating data intended for use with the
        proprietary Talsim software, subject to the following conditions:
        
        1. Modification. The Software may not be modified, and no derivative
           works may be created based on the Software, in whole or in part.
        
        2. No incorporation into other products. The Software's source code,
           in whole or in part, may not be extracted, embedded, repackaged, or
           otherwise incorporated into any other software product or service
           that you distribute, sell, or otherwise make available to third
           parties, whether offered commercially or free of charge. For the
           avoidance of doubt, this condition does not restrict using the
           Software as an unmodified dependency of your own scripts,
           applications, or internal tools (for example, via a Python `import`
           statement) for your own purposes, including preparing data for use
           with the Talsim software; such use is expressly permitted under
           these terms.
        
        3. Redistribution. The Software may not be redistributed, sublicensed,
           or otherwise made available to third parties, except in unmodified
           form via the official distribution channel
           (https://pypi.org/project/talsimpy/).
        
        4. Notice. The above copyright notice and this permission notice shall
           be included, unmodified, in all copies of the Software.
        
        5. Termination. This license terminates automatically if you breach
           any of the conditions above. Upon termination, you must cease all
           use of the Software and destroy all copies in your possession.
        
        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.
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: numpy
Requires-Dist: pandas
Provides-Extra: plot
Requires-Dist: matplotlib; extra == 'plot'
Provides-Extra: raster
Requires-Dist: rioxarray; extra == 'raster'
Requires-Dist: xarray; extra == 'raster'
Description-Content-Type: text/markdown

# talsimpy

Python interface for Talsim datasets, databases, scenarios, simulation runs and time series processing.

[Documentation](https://sydroconsult.github.io/talsimpy/)

## Installation

```bash
pip install talsimpy
```

Optional extras: `pip install talsimpy[plot]` (plotting) or `talsimpy[raster]` (xarray/rioxarray).

## Features

* `TalsimDataset` – read and edit Talsim ASCII datasets
* `TalsimDatabase` – interact with a Talsim 5 database
* `TalsimScenario` – manage a scenario within a database
* `TalsimEngine` – run simulations
* `Timeseries` – process time series

## Example

```python
from talsimpy import TalsimDatabase

db = TalsimDatabase("path/to/database.db")
```
