PowerConsumption
Symbol | ![]() |
|---|
Use
This component can be used to integrate electrical loads or generators, represented by existing power time series, into a model. The time series can be read from a text file and imported into the simulation.
Parameters and Connectors
Basic
For the load or power data import the path to the text file must be specified by the parameter File and the table name (name of the values column within the text file) by the parameter Table. The table values are interpreted as effective power in [W]. Positive values are interpreted as power demand, negative values generate a power supply.

The timebase of the load table can either be supplied in hours of year (useDayTime=false) or in hours of a day (useDayTime=true). Using the latter format, simulations longer than a day will repeat the given load curve accordingly.
As the model imitates an electrical device, the power factor must be considered which is the ratio between the real power to the apparent power and can be defined using power factor parameter cosPhi.
The Connector â–¶EnvironmentConditions has to be connected to an Environment block to provide the current time of year and time of day for reading the text file. The connector â–¶LVGrid must be connected to a grid element to draw or feed in electrical power.
The output variables of the model are electrical power and cumulative electrical energy. The consumer arrow system applies here, with energy consumption represented by a positive sign and energy generation by a negative sign.
Model Background
From the parameterised text file, the value corresponding to the current timestamp is read into the model. The values are interpreted as effective power in watts. Linear interpolation is applied between the individual table points, and extrapolation is performed outside the given time series. Reactive power is calculated from active power, taking into account the cosPhi parameter. The electrical power from the table is distributed equally across all three phases of the three-phase electrical connection.
