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:
- 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
EnergyModelsHeatand should be reported. - If the problem occurs in model construction, it is most likely a bug in either
EnergyModelsBaseorEnergyModelsHeatand 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 inEnergyModelsBaseorEnergyModelsHeat. It can occur, that the last shown failing function is withinJuMPorMathOptInterface. In this case, it is best to trace the error to the last calledEnergyModelsBaseorEnergyModelsHeatfunction. - 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 forMathOptInterface. In this case, please contact the developers of the corresponding solver wrapper.
- 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
- Label the issue as bug, and
- 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.
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.