Metadata-Version: 2.4
Name: dave_core
Version: 1.3.4
Summary: DAVE is a tool for automatic energy grid generation
Maintainer-email: DAVE_core Developers <tobias.banze@iee.fraunhofer.de>
Project-URL: Homepage, http://databutler.energy/
Project-URL: Documentation, https://dave-core.readthedocs.io
Project-URL: Source, https://github.com/DaveFoss/DAVE_core
Project-URL: Repository, https://github.com/DaveFoss/DAVE_core.git
Project-URL: Issues, https://github.com/DaveFoss/DAVE_core/issues
Project-URL: Download, https://pypi.org/project/dave-core/#files
Project-URL: Changelog, https://dave-core.readthedocs.io/en/latest/about/changelog.html
Keywords: power system,gas system,network,modeling,automation,grid,energy,DAVE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: pandas>=2.3
Requires-Dist: Shapely>=2.1
Requires-Dist: geopandas>=1.1
Requires-Dist: matplotlib>=3.10
Requires-Dist: geopy>=2.4
Requires-Dist: fiona>=1.10
Requires-Dist: networkx>=3.5
Requires-Dist: contextily>=1.6
Requires-Dist: pytest>=8.4
Requires-Dist: pytest-cov>=6.2
Requires-Dist: pytest-xdist>=3.8
Requires-Dist: xmlschema>=4.1
Requires-Dist: lxml>=6.0
Requires-Dist: tables>=3.10
Requires-Dist: tqdm>=4.67
Requires-Dist: pandapower>=3.1
Requires-Dist: pandapipes>=0.12
Requires-Dist: defusedxml>=0.7
Requires-Dist: dask_geopandas>=0.5
Requires-Dist: scipy>=1.16
Requires-Dist: openpyxl>=3.1
Provides-Extra: docs
Requires-Dist: sphinx>=5.3.0; extra == "docs"
Requires-Dist: sphinx_rtd_theme>=1.1.1; extra == "docs"
Requires-Dist: sphinx-pyproject; extra == "docs"
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: isort>=6.0; extra == "dev"
Requires-Dist: pre-commit>=4.3; extra == "dev"
Provides-Extra: all
Requires-Dist: dave_core[dev,docs]; extra == "all"
Dynamic: license-file

=========
DAVE_core
=========

.. start-badges

.. list-table::
    :stub-columns: 1

    * - package
      - |version| |commits-since| |download| |licence| |wheel| |supported-versions|
    * - docs
      - |docs|
    * - tests
      - |github-actions| |coveralls| |codecov|
    * - code
      - |black| |isort| |ruff|

.. |download| image:: https://pepy.tech/badge/dave-core
    :alt: pepy
    :target: https://pepy.tech/project/dave-core

.. |version| image:: https://img.shields.io/pypi/v/dave_core.svg
    :alt: PyPI Package latest release
    :target: https://pypi.org/project/dave_core

.. |wheel| image:: https://img.shields.io/pypi/wheel/dave_core.svg
    :alt: PyPI Wheel
    :target: https://pypi.org/project/dave_core

.. |supported-versions| image:: https://img.shields.io/pypi/pyversions/dave_core.svg
    :alt: Supported versions
    :target: https://pypi.org/project/dave_core


.. |docs| image:: https://readthedocs.org/projects/dave-core/badge/?version=latest
    :target: https://dave-core.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. |github-actions| image:: https://github.com/DaveFoss/DAVE_core/actions/workflows/github-actions.yml/badge.svg
    :alt: GitHub Actions Build Status
    :target: https://github.com/DaveFoss/DAVE_core/actions


.. |coveralls| image:: https://coveralls.io/repos/github/DaveFoss/DAVE_core/badge.svg?branch=main
    :alt: Coverage Status
    :target: https://coveralls.io/github/DaveFoss/DAVE_core?branch=main

.. |codecov| image:: https://codecov.io/gh/DaveFoss/DAVE_core/branch/main/graphs/badge.svg?branch=main
    :alt: Coverage Status
    :target: https://app.codecov.io/github/DaveFoss/DAVE_core

.. |commits-since| image:: https://img.shields.io/github/commits-since/DaveFoss/DAVE_core/v1.3.4.svg
    :alt: Commits since latest release
    :target: https://github.com/DaveFoss/DAVE_core/compare/v1.3.4...develop

.. |licence| image:: https://img.shields.io/badge/License-BSD%203--Clause-blue.svg
   :target: https://github.com/DaveFoss/DAVE_core/blob/main/LICENSE
   :alt: BSD

.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. |isort| image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
    :target: https://pycqa.github.io/isort/

.. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
    :target: https://github.com/astral-sh/ruff
    :alt: Ruff

.. end-badges


DAVE is an softwaretool for a automatic generation of region-specific energy grid models. The resulting grid models are based on open data from different sources.


This code ist based on and explained in the following publicationat :

- `Banze, T., Kneiske, T.M. Open data for energy networks: introducing DAVE—a data fusion tool for automated network generation. Sci Rep 14, 1938 (2024). <https://doi.org/10.1038/s41598-024-52199-w>`_

More on DAVE is published on the webside http://databutler.energy


Installation
============

::

    pip install dave-core

You can also install the in-development version with::

    pip install https://github.com/DaveFoss/DAVE_core/archive/develop.zip


Documentation
=============


https://dave-core.readthedocs.io


Development
===========

To run all the tests run::

    tox

Note, to combine the coverage data from all the tox environments run:

.. list-table::
    :widths: 10 90
    :stub-columns: 1

    - - Windows
      - ::

            set PYTEST_ADDOPTS=--cov-append
            tox

    - - Other
      - ::

            PYTEST_ADDOPTS=--cov-append tox
