Skip to content

Finding and Eliminating Error Causes

Navigation:

Troubleshooting

If errors occur in the simulation, this can have various causes. The most important hints for troubleshooting are the error messages and warnings that are displayed in the Simulator message window during simulation and in the Simulation form under the tab Metrics and the subtab Messages after simulation.

In addition to general error messages and warnings, model-specific error messages, so-called PML messages, such as the following, can also occur:

LIMITS CHP: The heat generated by the CHP exceeds its thermal rating.

The first error message or warning should always be considered. For this activate stop at errors under the tab Settings. If the information is not sufficient, the Log level should be increased to 4 (Debugging).

If a large number of messages is displayed, use the Prioritätsansicht priority view for better clarity to limit the display to the most important messages sorted by causes and subsequent errors.

The documentation explains the error messages sorted by category and ID on the linked page and shows possible solutions.

The article on calculation time explains how you can accelerate simulation and how errors affect simulation duration.

Depending on the individual steps in the simulation, there are four different types of errors, which are presented in the following.

Syntax Errors in the Model

The components are written in the modeling language PML. If the simple syntax of the PML is not adhered to, an error occurs which generally leads to the termination of the simulation. For example, it may be a misspelled unit or a variable used in an equation that has not been declared.

The error message displayed includes a link to the component, the model section, and the number of the line in which the error occurred (see following figure).

Error in the Calculation of the Simulation Period

A typical error is that the periods of the stored time series do not overlap so that the simulation period is empty. The simulation is then not carried out. The problem can easily be solved by editing the corresponding time series.

Incorrect Block Decomposition

When large under-determined systems of equations occur, often input data have been forgotten. When searching for such inputs you should check the result variables with identifiers in the Simulator window under the tab Unsolvable.

The simulation is also carried out with underdetermined blocks, but all result variables in underdetermined equation systems cannot be calculated. Usually, such an incomplete result is useless.

Error in the Calculation of the Results

It can happen that errors occur during the calculation of individual blocks, possibly only in some time steps. Because the systems of equations depend on the results of blocks already calculated, the cause of the error may lie in a previous block. For this the navigation over already calculated variables under the tab Solvable equations is useful. Some typical errors are listed below:

  • The linear optimization problem could not be solved. The error can occur if components are incorrectly dimensioned so that a CHP unit, for example, cannot cover the energy demand.
  • A system of equations has not converged. The error occurs only in systems that are solved numerically. If many time steps and variables are affected, you can activate Advanced solution search in the menu under Extras → Options → Simulation → General Settings.
  • The solution of a system of equations violates an operational limit. If an operating limit is violated (if the nominal capacity is exceeded or the generation power is negative), different error messages may occur depending on the block decomposition. A PML message can be generated that specifies which operating limit was exceeded in which component. It is also possible to evaluate a characteristic curve for a point that does not exist in the characteristic curve. If a temperature is very low, it is possible that the logarithm for calculating the specific entropy cannot be evaluated. Another possibility is the violation of a value range. All these errors indicate an undersizing of the energy system.
  • If physically implausible results occur (e.g., efficiencies above 100 % or unrealistically designed temperatures), it shall be checked whether numerical errors are present.
Back To Top