0.8.0: Allow pip installation

Allow pip installation

Previously, dhnx_addons was published to conda. But dhnx_addons has several key dependencies not published there, most notably dhnx, oemof.demand, oemof.solph and pandapipes, which made the installation difficult and error-prone.

In an effort to get rid of conda, this project has now been moved to "proper" pyproject.toml build definitions and is tested as a regular pip install. It is not yet published on pypi, but you can easily install it directly from GitHub with e.g.:

pip install "dhnx_addons @ https://github.com/jnettels/dhnx_addons/archive/main.tar.gz"

A word of caution: The dependencies geopandas, fiona, tobler, etc. that do the GIS-related work rely on GDAL which sometimes causes problems on Windows machines. You may see errors about some `dll`` files missing. This needs to be investigated further.

Updated dependencies

• Updates and deprecations in many dependencies since the last release were fixed
• New use cases in dhnx_addons required updates to dhnx
• A pandas 3 - compatible fork of pandapipes was created to allow stable installation of all dependencies

Actual changes in functionality

See the full changelog below, just a few notes:

• Existing pipes (in dhnx) are now supported throughout the workflows
• The simultaneity approach has been updated for dhnx and pandapipes
  • As a bonus, the resulting network lines saved to a gpkg are now ordered by flow direction, so in e.g. QGIS you can add arrows to lines to visualize flow direction
• For pandapipes, a circular flow direction has been implemented, which creates a network that allows to simulate both supply and return in a closed loop. This yields information about the total pressure drop of the network
• An experimental downloader for public alkis data has been added
• Functions for reading roof area (or complete geometries) from LoD2 CityGML files have been added (e.g. for solar yield estimations)
• There are some intentional breaking changes

Full Changelog: 0.7.1...0.8.0

Update package publishing

Full Changelog: 0.7.0...0.7.1

Update for compatibility with dhnx, pandapipes, lpagg

Update for compatibility with dependencies

• dhnx>0.0.4 (current dev branch, specifically because of Expose setting 'allow_nonoptimal' to the user)
• pandapipes 0.12
• lpagg 0.19

Most important additions:

• Allow setting district heating temperatures in dhnx_run()
  • Forward, return flow and ground temperatures (T_FF, T_RF, T_ground) as well as maximium allowed pressure drop (dP_max) were previously read from the pipe_data file.
  • They can now be set in dhnx_run(), which will override values from the pipe_data file.
• Add elevation data download functionality
  • Elevation for polygons, lines and points can now easily be downloaded.
  • This can be used automatically in pandapipes_run(), to account for height differences in pressure calculations
    • pandapipes_run(elevation_col='height_m', download_missing_elevation=True)
• Implement KWW Technikkatalog as new data source
  • Can be used to apply values for specific heat demand to a set of buildings

(Known) breaking changes

• Make lpagg_run return the lpagg cfg (b9f5f88)
  • lpagg_run() now returns a tuple of size 3: (gdf_houses, df_load_ts_slice, lpagg_cfg)
  • lpagg_cfg can be used to e.g. retrieve the actual simultaneity factor resulting from the time shift in lpagg

Full Changelog

0.6.3...0.7.0

Add deterministic method for simultaneity factors in network

The main new feature of this release is the option to use a deterministic method for simultaneity factors in the district heating network. The simultaneity factor at each fork is calculated as a fixed function of the number of downstream consumers. The required thermal capacity of the connected pipe is reduced accordingly.

Full Changelog: 0.6.2...0.6.3

Update references to correct DHNx branch

Previous releases had to point to a specific feature branch of the dependency DHNx. Now all updates required by dhnx_addons are merged into the dev branch. It can now be used for automatic installation with an environment.yaml, as described in the readme.

Full Changelog: 0.6.1...0.6.2

Adapt to pandapipes 0.11

Adapt to pandapipes 0.11 and update installation instructions.

Full Changelog: 0.6.0...0.6.1

Adapt to DHNx and lpagg updates

6e09ebc Update for compatibility with lpagg>=0.18

• Naming convention for building types changed in lpagg 0.18
• A new workflow calculating only the unique profiles yields speed improvements for large datasets

For further notes see
https://github.com/jnettels/lpagg/releases/tag/0.18.0

f3dca4b Update for compatibility with DHNx

dhnx_addons now requires the following branch of dhnx
https://github.com/oemof/DHNx/tree/features/multiple_building_connections

This enables supports for multiple connection lines per building

This commit also allows dhnx_addons to run without an 'invest_data' folder. The default settings for consumers, producers and network required by DHNx (and oemof, internally) are now hardcoded and used without reading a folder structur. If the folder is defined, it is still used. For the definition of the pipe data (network), default settings derived from Logstor steel pipes are used. A csv/Excel input can still be used to overwrite this data.

c075c98 Update project dependencies

numpy<2.0 is currently restricted by pandapower, a dependency of pandapipes. This restriction can be lifted when pandapower 3.0 releases

Other noteworthy changes:

• 4b4169a Make workflow_example_openstreetmap() more robust
• b0e8892 Allow usage of elevation in pandapipes_run()
• 4cda054 Update types in building_type_from_osm()
• 4a5783d Add new function snap_line_network()
• 1468719 Add new function join_area_interpolate()

Full Changelog

0.5.2...0.6.0

Fix missing gdf.to_file() output

Fixes the error Passing 'crs' is not supported with the 'pyogrio' engine.

Full Changelog: 0.5.1...0.5.2

Fix pandas error and update dependencies

Full Changelog: 0.5.0...0.5.1

First release to anaconda.org

dhnx_addons is still far from stable, but a conda package is created for easier deployment.

Full Changelog: 0.4.0...0.5.0