Add helper function ``area`` and ``layout_from_area_density`` & allow auto chunks

PyPSA / atlite

Atlite: A Lightweight Python Package for Calculating Renewable Power Potentials and Time Series

254 stars 86 forks source link

add functions area & layout_from_area_density
allow for auto chunks when loading cutout

Motivation and Context

The area function is helpful for custom workflows, the same with the new layout function.

The auto chunking can help to accelerate the computation of the conversion functions.

Type of change

[ ] Bug fix (non-breaking change which fixes an issue)
[x] New feature (non-breaking change which adds functionality)
[ ] Breaking change (fix or feature that would cause existing functionality to change)

Checklist

[x] I tested my contribution locally and it seems to work fine.
[x] I locally ran pytest inside the repository and no unexpected problems came up.
[x] I have adjusted the docstrings in the code appropriately.
[x] I have documented the effects of my code changes in the documentation doc/.
[x] I have added newly introduced dependencies to environment.yaml file.
[x] I have added a note to release notes doc/release_notes.rst.
[x] I have used pre-commit run --all to lint/format/check my contribution

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Comparison is base (5a1f00f) 72.34% compared to head (d5d2316) 72.49%.

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #328 +/- ## ========================================== + Coverage 72.34% 72.49% +0.14% ========================================== Files 19 19 Lines 1696 1705 +9 Branches 294 296 +2 ========================================== + Hits 1227 1236 +9 Misses 387 387 Partials 82 82 ``` | [Files](https://app.codecov.io/gh/PyPSA/atlite/pull/328?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=PyPSA) | Coverage Δ | | |---|---|---| | [atlite/cutout.py](https://app.codecov.io/gh/PyPSA/atlite/pull/328?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=PyPSA#diff-YXRsaXRlL2N1dG91dC5weQ==) | `76.26% <100.00%> (+1.13%)` | :arrow_up: |

PyPSA / atlite