.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
:alt: License: MIT
:target: LICENSE
.. image:: https://img.shields.io/pypi/pyversions/sir3stoolkit.svg
:alt: Supported Python versions
:target: https://pypi.org/project/sir3stoolkit
.. image:: https://img.shields.io/pypi/v/sir3stoolkit.svg
:alt: PyPI Package latest release
:target: https://pypi.org/project/sir3stoolkit/
.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?logo=readthedocs&logoColor=white
:target: https://3sconsult.github.io/sir3stoolkit/
:alt: docs
----
SIR 3S Toolkit
==============
**SIR 3S Toolkit** is a Python package developed by 3S Consult that provides a programming interface for SIR 3S -
a software for the simulation, analysis and optimization of flow processes in gas/water/heat supply networks,
plants, pipelines and caverns.
At its core, the package wraps basic functionality of SIR 3S, offering a low-level access to the creation, modification and simulation of SIR 3S models.
On top of this core, higher-level functionality is provided, enabling more powerful and intuitive interactions with SIR 3S models.
This layered architecture of the SIR 3S Toolkit ensures both flexibility and extensibility for advanced applications.
.. image:: https://raw.githubusercontent.com/3SConsult/PT3S/master/sphinx_docs/_static/Sir3S_Splash.jpg
:target: https://www.3sconsult.de/software/sir-3s/
:width: 20%
:alt: Sir3S Splash
Note: This package is a client toolkit for the proprietary SIR 3S software. A valid license for SIR 3S is required to use this package in production.
Features
--------
- **Create** new SIR 3S models
- **Modify** existing SIR 3S models
- **Simulate** SIR 3S models
- **Read** data and simulation results from SIR 3S models
Documentation
-------------
For detailed documentation, visit `SIR 3S Toolkit Documentation <https://3sconsult.github.io/sir3stoolkit/>`_.
PyPI
----
You can find the SIR 3S Toolkit package on `PyPI <https://pypi.org/project/sir3stoolkit/>`_.
Installation
------------
To install the SIR 3S Toolkit, use pip:
.. code-block:: bash
pip install sir3stoolkit
Quick Start
-----------
.. code-block:: python
from sir3stoolkit.core import wrapper
SIR3S_SIRGRAF_DIR = r"C:\SIR3S\SirGraf-90-15-00-12_Quebec_x64"
wrapper.Initialize_Toolkit(SIR3S_SIRGRAF_DIR)
model = wrapper.SIR3S_Model()
model.OpenModel(dbName=r"example_model.db3",
providerType=model.ProviderTypes.SQLite,
Mid="M-1-0-1",
saveCurrentlyOpenModel=False,
namedInstance="",
userID="",
password="")
model.ExecCalculation(True)
Contact
-------
If you'd like to report a bug or suggest an improvement for the SIR 3S Toolkit, please `open a new issue on GitHub <https://github.com/3SConsult/sir3stoolkit/issues>`_. Describe the situation in detail — whether it's a bug you encountered or a feature you'd like to see improved. Feel free to attach images or other relevant materials to help us better understand your request.
For other requests, please contact us at `sir3stoolkit@3sconsult.de <mailto:sir3stoolkit@3sconsult.de>`_.
License
-------
MIT License. See `LICENSE <https://github.com/3SConsult/sir3stoolkit/blob/master/LICENSE>`_ for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "sir3stoolkit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "Python, 3S, SIR 3S, SirGraf, SirCalc, 3S Consult, network, pipeline, analysis, automation, engineering, simulation, hydraulics, gas, water, district heating, oil",
"author": null,
"author_email": "3S Consult GmbH <sir3stoolkit@3sconsult.de>",
"download_url": "https://files.pythonhosted.org/packages/12/f7/04ac161806377ac50be3bfb2edd8bbb2b6a4e3366c84f9213ef60e3acf99/sir3stoolkit-90.15.2.tar.gz",
"platform": null,
"description": ".. image:: https://img.shields.io/badge/License-MIT-yellow.svg\r\n :alt: License: MIT\r\n :target: LICENSE\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/sir3stoolkit.svg\r\n :alt: Supported Python versions\r\n :target: https://pypi.org/project/sir3stoolkit\r\n\r\n.. image:: https://img.shields.io/pypi/v/sir3stoolkit.svg\r\n :alt: PyPI Package latest release\r\n :target: https://pypi.org/project/sir3stoolkit/\r\n\r\n.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?logo=readthedocs&logoColor=white\r\n :target: https://3sconsult.github.io/sir3stoolkit/\r\n :alt: docs\r\n\r\n----\r\n\r\nSIR 3S Toolkit\r\n==============\r\n\r\n**SIR 3S Toolkit** is a Python package developed by 3S Consult that provides a programming interface for SIR 3S - \r\na software for the simulation, analysis and optimization of flow processes in gas/water/heat supply networks, \r\nplants, pipelines and caverns. \r\n\r\nAt its core, the package wraps basic functionality of SIR 3S, offering a low-level access to the creation, modification and simulation of SIR 3S models.\r\n\r\nOn top of this core, higher-level functionality is provided, enabling more powerful and intuitive interactions with SIR 3S models. \r\n\r\nThis layered architecture of the SIR 3S Toolkit ensures both flexibility and extensibility for advanced applications.\r\n\r\n.. image:: https://raw.githubusercontent.com/3SConsult/PT3S/master/sphinx_docs/_static/Sir3S_Splash.jpg\r\n :target: https://www.3sconsult.de/software/sir-3s/\r\n :width: 20%\r\n :alt: Sir3S Splash\r\n\r\nNote: This package is a client toolkit for the proprietary SIR 3S software. A valid license for SIR 3S is required to use this package in production.\r\n\r\nFeatures\r\n--------\r\n\r\n- **Create** new SIR 3S models\r\n- **Modify** existing SIR 3S models\r\n- **Simulate** SIR 3S models\r\n- **Read** data and simulation results from SIR 3S models\r\n\r\nDocumentation\r\n-------------\r\nFor detailed documentation, visit `SIR 3S Toolkit Documentation <https://3sconsult.github.io/sir3stoolkit/>`_.\r\n\r\nPyPI\r\n----\r\nYou can find the SIR 3S Toolkit package on `PyPI <https://pypi.org/project/sir3stoolkit/>`_.\r\n\r\nInstallation\r\n------------\r\n\r\nTo install the SIR 3S Toolkit, use pip:\r\n\r\n .. code-block:: bash\r\n\r\n pip install sir3stoolkit\r\n\r\nQuick Start\r\n-----------\r\n\r\n.. code-block:: python\r\n\r\n from sir3stoolkit.core import wrapper\r\n\r\n SIR3S_SIRGRAF_DIR = r\"C:\\SIR3S\\SirGraf-90-15-00-12_Quebec_x64\"\r\n wrapper.Initialize_Toolkit(SIR3S_SIRGRAF_DIR)\r\n\r\n model = wrapper.SIR3S_Model()\r\n model.OpenModel(dbName=r\"example_model.db3\", \r\n providerType=model.ProviderTypes.SQLite, \r\n Mid=\"M-1-0-1\", \r\n saveCurrentlyOpenModel=False, \r\n namedInstance=\"\", \r\n userID=\"\", \r\n password=\"\")\r\n\r\n model.ExecCalculation(True)\r\n\r\nContact\r\n-------\r\nIf you'd like to report a bug or suggest an improvement for the SIR 3S Toolkit, please `open a new issue on GitHub <https://github.com/3SConsult/sir3stoolkit/issues>`_. Describe the situation in detail \u2014 whether it's a bug you encountered or a feature you'd like to see improved. Feel free to attach images or other relevant materials to help us better understand your request.\r\n\r\nFor other requests, please contact us at `sir3stoolkit@3sconsult.de <mailto:sir3stoolkit@3sconsult.de>`_.\r\n\r\nLicense\r\n-------\r\nMIT License. See `LICENSE <https://github.com/3SConsult/sir3stoolkit/blob/master/LICENSE>`_ for details.\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "SIR3S Toolkit",
"version": "90.15.2",
"project_urls": {
"Documentation": "https://3sconsult.github.io/sir3stoolkit",
"Download": "https://pypi.org/project/sir3stoolkit/#files",
"Issues": "https://github.com/3SConsult/sir3stoolkit/issues",
"Repository": "https://github.com/3SConsult/sir3stoolkit.git",
"Source": "https://github.com/3SConsult/sir3stoolkit"
},
"split_keywords": [
"python",
" 3s",
" sir 3s",
" sirgraf",
" sircalc",
" 3s consult",
" network",
" pipeline",
" analysis",
" automation",
" engineering",
" simulation",
" hydraulics",
" gas",
" water",
" district heating",
" oil"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6696aeeb9e04a7e7caeebd6e846aecf54231d9988af73caa9bc4f309ac98d5d4",
"md5": "0fcc0debc45b3142aa74806a92e0be7b",
"sha256": "fc6de8846e314688d048a4f86ee3d98bf95440a8a80be95dfa047c459eac87ad"
},
"downloads": -1,
"filename": "sir3stoolkit-90.15.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0fcc0debc45b3142aa74806a92e0be7b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 25272,
"upload_time": "2025-08-06T08:38:27",
"upload_time_iso_8601": "2025-08-06T08:38:27.234028Z",
"url": "https://files.pythonhosted.org/packages/66/96/aeeb9e04a7e7caeebd6e846aecf54231d9988af73caa9bc4f309ac98d5d4/sir3stoolkit-90.15.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "12f704ac161806377ac50be3bfb2edd8bbb2b6a4e3366c84f9213ef60e3acf99",
"md5": "51c96e95360a2ec120ae29ef6afd7c8c",
"sha256": "b3d1c585c5c0b21ac0aab700a14a3e5fbd37ff46348309b36691e69739ed42db"
},
"downloads": -1,
"filename": "sir3stoolkit-90.15.2.tar.gz",
"has_sig": false,
"md5_digest": "51c96e95360a2ec120ae29ef6afd7c8c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 26528,
"upload_time": "2025-08-06T08:38:28",
"upload_time_iso_8601": "2025-08-06T08:38:28.505512Z",
"url": "https://files.pythonhosted.org/packages/12/f7/04ac161806377ac50be3bfb2edd8bbb2b6a4e3366c84f9213ef60e3acf99/sir3stoolkit-90.15.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 08:38:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "3SConsult",
"github_project": "sir3stoolkit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sir3stoolkit"
}
JSON
