Metadata-Version: 2.1
Name: dave_core
Version: 1.3.0
Summary: DAVE is a tool for automatic energy grid generation
Home-page: https://github.com/DaveFoss/DAVE_core
Author: DAVE_core Developers
Author-email: EMAIL@IS.MISSING.DE
License: BSD 3-cluase
Project-URL: Documentation, https://dave-core.readthedocs.io
Project-URL: Changelog, https://dave-core.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/DaveFoss/DAVE_core/issues
Project-URL: Homepage, http://databutler.energy/
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: Shapely
Requires-Dist: geopandas
Requires-Dist: matplotlib
Requires-Dist: geopy
Requires-Dist: fiona
Requires-Dist: contextily
Requires-Dist: pytest
Requires-Dist: pytest-cov
Requires-Dist: pytest-xdist
Requires-Dist: openpyxl
Requires-Dist: xmlschema
Requires-Dist: lxml
Requires-Dist: authlib
Requires-Dist: tables
Requires-Dist: pyopenssl
Requires-Dist: rasterio
Requires-Dist: tqdm
Requires-Dist: pandapower
Requires-Dist: pandapipes
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"

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




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/main.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

=======================
What's new in DAVE_core
=======================

These are new features and improvements of note in each release.

1.3.0 (August 23, 2024)
=======================

Added
-----

* Consider case sensitivity at geodata parameter
* Return plotting and converting functions from DAVE_client
* Tutorial for creating a grid model with DAVE_core main function

Changed
-------

* Changelog style
* Authors list to DAVE_core constributers

Removed
-------

* building hight, heat demand and census popolation

Fixed
-----

* Problem with multilinestrings at medium voltage topology

Event
-----

* Switched name from DAVE to DAVE_core as part of the open source publication and restructuring
* This release represents the state from the paper (https://doi.org/10.1038/s41598-024-52199-w)

1.2.0 (November 20, 2023)
=========================

Added
-----

* Building height based on raster data
* Extend api with functions for database managment
* Environment files for the possibility to install DAVE via mamba
* Converter for the multiphysical network simulator MYNTS
* Population data from census and the possibility to request the raster data
* Importer for data from the gassimulation softwaretool SIMONE
* Api restriction by user role
* Option to choose year for nuts regions (2013, 2016, 2021)
* Geopackage as possible output format
* Extend geographical data with more landuse information and data for waterways

Changed
-------

* Archiv i/o function in seperated file
* Input parameters for geographical objects reduced to one parameter "geodata"

Removed
-------

* Moved dave structure functions to DAVE client
* Moved read simone function to DAVE client
* Moved read gaslib function to DAVE client
* Moved io module to DAVE client
* Moved plotting module to DAVE client

1.1.0 (November 03, 2022)
=========================

Added
-----

* Algorithm for automated deployment
* Geography module and separated geographical data from grid model generation
* Restructured target area functions
* Different years as option for nuts regions
* Function for intersection with considering mixed geometries
* Topology cleanup for power and gas models
* Gaslib converter
* Gas component: source, sink, compressor
* Pandapipes converter
* Function to transform address into coordinates

Changed
-------

* Renamed building category from "for_living" to "residential"
* Power components script splitted to separate scripts according to the components
* Bus naming in ehv and hv models from "bus0/bus1" to "from/to_bus"
* Channel for required packages to only "conda forge" because of anaconda terms changes

Fixed
-----

* Osm gateway timeout
* Stack overflow error
* Duplicate naming

Event
-----

* First open accessible "software as a service" platform version
* DAVE licensed under a three clause bsd license

1.0.6 (October 20, 2021)
========================

Added
-----

* Option for output folder path
* Functions for serialization
* Basic test structure
* setup file
* Uniform code style (with black) via pre-commit hooks
* Uniform import order (with isort) via pre-commit hooks

Changed
-------

* Build seperated io modul, changed structure and moved existing io functions to that
* Rebuild from/to hdf functions and merged with from/to archiv
* Moved dave dir paths to settings file

Fixed
-----

* Wrong/missing types at pandapower converter
* Missing crs definitions

1.0.5 (March 21, 2021)
======================

Added
-----

* Substations for other voltage levels

Changed
-------

* Move ehv substations to components power

Fixed
-----

* Missing line and trafo data within pandapower converting

1.0.4 (March 18, 2021)
======================

Changed
-------

* Pandapower converter function restructured
* Condition deleted that more than one bus must exist for transformers

1.0.3 (March 04, 2021)
======================

Added
-----

* Description in install tutorial for using DaVe in PyCharm
* Runtime count

1.0.2 (February 10, 2021)
=========================

Added
-----

* Progress bars

Fixed
-----

* Overwriting points in voronoi calculation

1.0.1 (January 26, 2021)
========================

Added
-----

* Json to pp converting function with considering geometries
* pp to json converting function with considering geometries
* Nuts regions as input option for grid area
* Possibility to choose components individually

Changed
-------

* Voronoi function expanded with dynamic corner points
* Use scigridgas igginl dataset instead of lkd_eu dataset for high pressure gas level

Fixed
-----

* Replaced deprecated shapely "cascaded union" function with "unary_union" function

1.0.0 (December 21, 2020)
=========================

Event
-----

* First usable DaVe version

0.0.0 (February 05, 2020)
=========================

Event
-----

* Started DaVe development
