Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DNMY] Add conventions to README #72

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,28 @@ The outputs are used in
[PyPSA-Eur](https://github.com/PyPSA/pypsa-eur) and
[PyPSA-Eur-Sec](https://github.com/PyPSA/pypsa-eur-sec).

## Contributions welcome!

We are happy to receive contributions, either as feedback, corrections, modifications or addition of new technology entries.
You can either open an *Issue* on GitHub for reporting potentials problems, providing feedback or suggesting additional entries.
Alternatively you can also directly open a *Pull Request* already containing suggested modifications.

All sizes and qualities of contributions are welcome. After an the *Issue* or *Pull Request* we'll assist with comments and leads to get your contribution included into the repository.

## Unit conventions

The following conventions are recommended for new additions to the repository.
Care must be taken with legacy entries, of which not all follow these conventions.

* Energy units: Use MWh and MW or kWh and kW

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggestion:

  • Investment costs in EUR/kW (or EUR/kWh for stores) -> increase readability
  • Energy and VOM in EUR/MWh

Thermal energy content: When referring to the thermal energy content of a mass or volume, use the Lower Heating Value (LHV)
* Currency-values are specified in EUR
* Ambigiuous units are avoided by specifying whether the unit applies to the input or the output of a process, e.g. the capacity of hydrogen electrolysis "MW_e" refers to "MW" of electricity input capacity whilst "MW_H2" refers to "MW" of output hydrogen

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The convention seems that capacity is mainly expressed in the output capacity. When there are multiple outputs, the one with the highest exergy is used. Exceptions are electrolysis and solar thermal.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Yes, for some processes like electrolysis and solar thermal it makes sense to specify them based on their input, increasing also the comparability between different electrolysis technologies (and in the future potentially allowing for load-dependent efficiencies).

  • I'd say it is less about the exergy content and more about the purpose of the process, i.e. what's the desired output. It should usually overlap, with the "output" definition being easier understood and better applicable to processes like desalination or DAC.

* Specification is always done using a subscript, e.g. "MWh_e" (MWh of electricity), "MWh_th" (MWh of thermal energy), "t_CO2" (t of CO2)
* Multiple units are concatenated using an asterisk an space before and after the asterisk " * ", e.g. "m^3 * h"
* Combined units are written as a single unit, e.g. "MWh" (instead of "MW*h")
* Multiple units in the demoninator are encapsulated in brackets, e.g. "EUR/(m^3_water * h)" instead of "EUR/m^3_water/h


## Licence

Expand Down