modelProsumer
Extends from TransiEnt.Basics.Icons.Household (Icon Households).
Information
1. Purpose of model
The purpose of this model is to combine different technological features of modern residential households into one Prosumer model. The model main components are:
TransiEnt.Components.Sensors.SmartMeter : A model for generating realistic measurements/information outputs of Smart Meters.
TransiEnt.Storage.Electrical.BatterySimple: A model for household battery electric storage systems.
TransiEnt.Consumer.Electrical.ElectricVehicle.BatteryElectricVehicle: A model for a Battery Electric Vehicle and its behaviour when charging with non-public charging infrastructure (wallboxes)
TransiEnt.Consumer.Heat.SpaceHeating.Heating: A model for the building heating combining a dynamic heat loss model dependent on the households dimensions, an electric heatpump and an electrical heater rod.
TransiEnt.Producer.Electrical.Photovoltaics.Advanced_PV.DNIDHI_Input.PVPlantControllable: A photovoltaic power plant with controllable reactive behaviour.
TransiEnt.Components.Boundaries.Electrical.ComplexPower.PQBoundary_new: A PQ boundary to represent inflexible load profiles within a complex RMS grid simulation.
2. Level of detail, physical effects considered, and physical insight
Please have a further look in the subcomponents.
3. Limits of validity
Please have a further look in the subcomponents.
4. Interfaces
controlBus for input and output parameters regarding power setpoints, limitations and measurements.
5. Nomenclature
See parameter and variable descriptions in the code.
6. Governing Equations
Please have a further look in the subcomponents.
7. Remarks for Usage
Choose the configuration of the subcomponents for your purpose.
8. Validation
Please have a further look in the subcomponents.
9. References
[1] T. Steffen, B. Wiegel, D. Babazadeh, A. Youssfi, C. Becker and V. Turau, "Generation of realistic Smart Meter Data from Prosumers for future energy system scenarios," NEIS 2022; Conference on Sustainable Energy Supply and Energy Storage Systems, Hamburg, Germany, 2022, pp. 1-6.
[2] B. Wiegel, T. Steffen, D. Babazadeh and C. Becker, "Towards a more comprehensive open-source model for interdisciplinary smart integrated energy systems," 2023 11th Workshop on Modelling and Simulation of Cyber-Physical Energy Systems (MSCPES), San Antonio, TX, USA, 2023, pp. 1-7, doi: 10.1109/MSCPES58582.2023.10123432.
10. Version History
Added by Tom Steffen and Béla Wiegel, Techische Universität Hamburg, Institut für Elektrische Energietechnik, 2025
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Electrical | |||
| Modelica.Units.SI.ActivePower | loadProfileScaleP | ||
| Modelica.Units.SI.ReactivePower | loadProfileScaleQ | ||
| Generation | |||
| Boolean | usePV | true | |
| Modelica.Units.SI.Power | PV_peakPower | 10000 | peak power of PV plant |
| Modelica.Units.SI.Angle | PV_slope | 10/180*Modelica.Constants.pi | slope of the tilted surface |
| Modelica.Units.SI.Angle | PV_azimuth | 0/180*Modelica.Constants.pi | surface azimuth angle |
| Modelica.Units.SI.Power | ApparentPowerMax | PV_peakPower/0.9 | maximum apparent power of pv inverter |
| Boolean | usePVSwitch | false | |
| ControlType | photovoltaicControlType | TransiEnt.Basics.Types.ControlType.Internal | Type of control for PV |
| Battery | |||
| Boolean | useBattery | true | |
| Modelica.Units.SI.Energy | Bat_Capacity | 20e3*3600 | Battery Capacity |
| Modelica.Units.SI.Power | Bat_PowerLimit | PV_peakPower | Charge and discharge power |
| Real | Bat_SOCStart | 0.5 | SOC at simulation start |
| ControlType | batteryControlType | TransiEnt.Basics.Types.ControlType.Internal | Type of control for BES |
| Heating System | |||
| Boolean | useEHP | true | |
| Modelica.Units.SI.HeatFlowRate | Q_HP_nom | 5e3 | nominal heat flow rate of heat pump |
| Modelica.Units.SI.Volume | V_BST | 800 | volume of buffer storage tank |
| Modelica.Units.SI.Area | A_living | 240 | living area |
| Modelica.Units.SI.Area | A_wall | 100 | area of exterior walls |
| Modelica.Units.SI.Area | A_window | 40 | area of windows |
| Modelica.Units.SI.Area | A_roof | 240 | area of rooftop |
| Modelica.Units.SI.Area | A_ground | 240 | area of ground of house |
| Modelica.Units.SI.Volume | V_air | 600 | Volume of air inside the house |
| Modelica.Units.SI.CoefficientOfHeatTransfer | U_wall | 0.28 | heat transfer coefficient of walls |
| Modelica.Units.SI.CoefficientOfHeatTransfer | U_window | 1.30 | heat transfer coefficient of windows |
| Modelica.Units.SI.CoefficientOfHeatTransfer | U_roof | 0.20 | heat transfer coefficient of rooftop |
| Modelica.Units.SI.CoefficientOfHeatTransfer | U_ground | 0.35 | heat transfer coefficient of ground of house |
| Modelica.Units.SI.HeatCapacity | thermalMass | 19e6 | total thermal mass of building |
| ControlType | heatingControlType | TransiEnt.Basics.Types.ControlType.Internal | Type of control for heating system |
| Boolean | heatingBusActive | true | Activate heat pump control bus |
| Electric Vehicle | |||
| Integer | num_BEVs | 1 | number of BEVs |
| ControlType | bevControlType | TransiEnt.Basics.Types.ControlType.Internal | Type of control for BEVs |
| Controller | |||
| Boolean | useControlBus | true | |
| Data | |||
| String | data_local | "" | path to simulation data |
| String | loadProfileName | "" | name of load profile |
| String | tappingProfileName | "" | name of tapping profile |
| Modelica.Units.SI.Time | data_timeOffset | 0 | |
| String | data_weatherLocation | "" | name of load profile |
| String | data_weatherYear | "" | year of weather data in yyyy |
| Metering | |||
| Boolean | manualConfiguration | false | |
| String | configuration | "Ideal" | choose the basic configuration |
| Boolean | useNoise | false | Activates Noise Generator |
| Boolean | useDelay | false | Activates Delay Generator |
| Modelica.Units.SI.PerUnit | sigma_I | 0.01 | Standard Deviation of the Current Sensor |
| Modelica.Units.SI.PerUnit | sigma_V | 0.01 | Standard Deviation of the Voltage Sensor |
| Modelica.Units.SI.PerUnit | sigma_Delay | 10 | Standard Deviation of the Voltage Sensor |
| Integer | samplePeriod | 60 | Sample Period for the noise generator of the Smart Meter |
| Integer | maxDelay | 60 | Maximum Delay Time |
| Initialization | |||
| Init | initType | Init.NoInit | Type of initialization (1: no init, 2: steady state, others do not apply) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Basics.Interfaces.General.ControlBus | controlBus | ||
| TransiEnt.Basics.Interfaces.Electrical.ComplexPowerPort | epp |