Contribute to EnergyModelsHeat

Contributing to EnergyModelsHeat can be achieved in several different ways.

File a bug report

Another approach to contributing to EnergyModelsHeat is through filing a bug report as an issue when unexpected behaviour is occuring.

When filing a bug report, please follow the following guidelines:

  1. Be certain that the bug is a bug and originating in EnergyModelsHeat:
    • If the problem is within the results of the optimization problem, please check first that the nodes are correctly linked with each other. Frequently, missing links (or wrongly defined links) restrict the transport of energy/mass. If you are certain that all links are set correctly, it is most likely a bug in EnergyModelsHeat and should be reported.
    • If the problem occurs in model construction, it is most likely a bug in either EnergyModelsBase or EnergyModelsHeat and should be reported in the respective package. The error message of Julia should provide you with the failing function and whether the failing function is located in EnergyModelsBase or EnergyModelsHeat. It can occur, that the last shown failing function is within JuMP or MathOptInterface. In this case, it is best to trace the error to the last called EnergyModelsBase or EnergyModelsHeat function.
    • If the problem is only appearing for specific solvers, it is most likely not a bug in EnergyModelsHeat, but instead a problem of the solver wrapper for MathOptInterface. In this case, please contact the developers of the corresponding solver wrapper.
  2. Label the issue as bug, and
  3. Provide a minimum working example of a case in which the bug occurs.

Feature requests

EnergyModelsHeat includes several new nodal descriptions for heat technologies. However, there can be a demand for additional requirements for the existing nodes or for new descriptions which fall below the umbrella of heat technologies. In this case, you can contribute through a feature request.

Feature requests for EnergyModelsHeat should follow the guidelines developed for EnergyModelsBase.

Note

EnergyModelsHeat is slightly different than EnergyModelsBase.

Contrary to the other package, we consider that it is beneficial to have all potential features of heat technologies within EnergyModelsHeat. Hence, if you have a requirement for a new nodal description, do not hesitate to create an issue.