Attributes

This page will give you an overview of all the attributes, that are currently available. Each attribute specifies a unit, e.g. [MW], that is considered during translation.

Universal attributes

These attribute can be used for input and output models.

Type	Attributes	Value	Additional information
Active power	P[MW]	float	Active power in MW
Reactive power	Q[MVAr]	float	Reactive power in MVAr
Thermal power	P_th[MW]	float	Thermal power in MW
Energy	E[MWh]	float	Energy in MWh.

Result attributes

These attribute can be only be used for output models.

Type	Attributes	Value	Additional information
Voltage magnitude	u[pu]	float	The magnitude of the voltage in per-unit.
Voltage angle	u[RAD]	float	The angle of the voltage in radians.
Current magnitude	I[A]	float	The magnitude of the current in ampere.
Current angle	I[RAD]	float	The angle of the current in radians.
State-of-charge	SOC[%]	float	The state-of-charge in percent.

Energy management attributes

These attributes can be only be used for energy management models. Some of the attributes use dictionaries as values. The structure of these can be found here.

Type	Attribute	Value	Additional information
Flexibility requests	Flex[request]	flex request dict	The sender is needed, the other keys can be dropped.
Flexibility options	Flex[options]	flex option dict	The sender is needed, the other keys can be dropped.
Energy management set points	EM[setPoint]	set point dict	Currently, SIMONA only supportes active power for set points. The reactive power value is currently ingnored.
Energy management communication message	Flex[com]	em com dict	Only the content can be dropped.

Energy management flex dictionaries

Below are the structures of all types of dictionaries used for the energy management attributes. For each dictionary the keys with their corresponding value type is given.

Flex request dict:
There are multiple options for the values of the flex request dictionary.

Option 1: { sender: str }
Option 2: { sender: str, disaggregated: bool }

Flex option dict:
There are multiple options for the values of the flex option dictionary.

Option 1: { 
    sender: str, 
    PMin[MW]: float, 
    PRef[MW]: float, 
    PMax[MW]: float
}

Option 2: {
    sender: str,
    flexType: str,
    PMin[MW]: float,
    PMax[MW]: float, 
    EtaCharge[%]: float,
    EtaDischarge[%]: float,
    tickToEnergyLimits: {
        tick: long,
        {
            LowerEnergyLimit[MWh]: float,
            UpperEnergyLimit[MWh]: float
        }
    }

Option 3: {
    receiver: str,
    disaggregated (dict): { receiver: flex option dict }
}

Set point dict:
There are multiple options for the values of the set point dictionary.

Option 1: {
    P[MW]: float,
    Q[MVAr]: float
}
    
Option 2: {
    P[MW]: float
}

Option 3: {
    Q[MVAr]: float
}

Option 4: {
    P[MW]: float,
    disaggregated: {
        receiver: str,
        set point dict
    }
}

Option 5: {
    receiver: str,
    disaggregated (dict): { receiver: P[MW] }
}

Em com dict:
There is only one option for the values of the em com dictionary.

Option 1: {
    receiver: str,
    sender: str,
    msg_id: str,
    type: str,
    content: any em dict exept em com dict
}