Skip to content

Energysystem

EnEnergysystem

Bases: EnBaseModel

Represents an energy system consisting of various components including busses, sinks, sources, converters, generic storages, and constraints.

This class serves as a model for energy systems where components can be added and managed. It provides methods to organize these components and convert them into a format suitable for oemof energy systems, enabling seamless integration with oemof's modeling and analysis tools.

Attributes:

Name Type Description
busses list[EnBus]

List of all busses in the energy system.
sinks list[EnSink]

List of all sinks in the energy system.
sources list[EnSource]

List of all sources in the energy system.
converters list[EnConverter]

List of all converters in the energy system.
generic_storages list[EnGenericStorage]

List of all generic storages in the energy system.
constraints list[EnConstraints]

List of all constraints associated with the energy system.
Source code in ensys/components/energysystem.py 
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
class EnEnergysystem(EnBaseModel):
    """
    Represents an energy system consisting of various components including busses,
    sinks, sources, converters, generic storages, and constraints.

    This class serves as a model for energy systems where components can be added
    and managed. It provides methods to organize these components and convert them
    into a format suitable for oemof energy systems, enabling seamless integration
    with oemof's modeling and analysis tools.

    :ivar busses: List of all busses in the energy system.
    :type busses: list[EnBus]
    :ivar sinks: List of all sinks in the energy system.
    :type sinks: list[EnSink]
    :ivar sources: List of all sources in the energy system.
    :type sources: list[EnSource]
    :ivar converters: List of all converters in the energy system.
    :type converters: list[EnConverter]
    :ivar generic_storages: List of all generic storages in the energy system.
    :type generic_storages: list[EnGenericStorage]
    :ivar constraints: List of all constraints associated with the energy system.
    :type constraints: list[EnConstraints]
    """
    busses: list[EnBus] = Field(
        default=[],
        title='Busses',
        description='List of all busses.'
    )

    sinks: list[EnSink] = Field(
        default=[],
        title='Sinks',
        description='List of all sinks.'
    )

    sources: list[EnSource] = Field(
        default=[],
        title='Sources',
        description='List of all sources.'
    )

    converters: list[EnConverter] = Field(
        default=[],
        title='Converters',
        description='List of all converters.'
    )

    generic_storages: list[EnGenericStorage] = Field(
        default=[],
        title='Generic Storages',
        description='List of all generic storages.'
    )

    constraints: list[EnConstraints] = Field(
        default=[],
        title='Constraints',
        description='List of all constraints.'
    )

    def add(self, elem: EnSink | EnSource | EnBus | EnGenericStorage | EnConverter | EnConstraints):
        """
        Adds an element to the corresponding list based on its type. Determines
        the type of the given element and appends it to its respective
        container (e.g., sinks, sources, busses, etc.). Raises an exception
        if the type of the element is not recognized.

        :param elem: The element to be added. It should be one of the following
                     types: EnSink, EnSource, EnBus, EnGenericStorage,
                     EnConverter, or EnConstraints.
        :type elem: EnSink | EnSource | EnBus | EnGenericStorage | EnConverter | EnConstraints
        :return: None
        """
        if type(elem) is EnSink:
            self.sinks.append(elem)
        elif type(elem) is EnSource:
            self.sources.append(elem)
        elif type(elem) is EnBus:
            self.busses.append(elem)
        elif type(elem) in [EnGenericStorage]:
            self.generic_storages.append(elem)
        elif type(elem) is EnConverter:
            self.converters.append(elem)
        elif type(elem) is EnConstraints:
            self.constraints.append(elem)
        else:
            raise Exception("Unknown Type given!")

    def to_oemof(self, energysystem: solph.EnergySystem) -> solph.EnergySystem:
        """
        Converts the internal energy system components to an oemof energy system and adds
        them to the provided oemof energy system instance. Each component in the internal
        energy system is iterated through, converted to its corresponding oemof object,
        and subsequently added to the provided energy system. This includes busses, sinks,
        sources, converters, and generic storages.

        :param energysystem: The oemof energy system instance to which the converted components
            of the internal energy system are added.
        :return: An updated oemof energy system instance containing all converted components.
        :rtype: solph.EnergySystem
        """
        for bus in self.busses:
            energysystem.add(bus.to_oemof(energysystem))

        for sink in self.sinks:
            energysystem.add(sink.to_oemof(energysystem))

        for source in self.sources:
            energysystem.add(source.to_oemof(energysystem))

        for converter in self.converters:
            energysystem.add(converter.to_oemof(energysystem))

        for generic_storage in self.generic_storages:
            energysystem.add(generic_storage.to_oemof(energysystem))

        # TODO: Adding Constraints

        return energysystem

add(elem)

Adds an element to the corresponding list based on its type. Determines the type of the given element and appends it to its respective container (e.g., sinks, sources, busses, etc.). Raises an exception if the type of the element is not recognized.

Parameters:

Name Type Description Default
elem EnSink | EnSource | EnBus | EnGenericStorage | EnConverter | EnConstraints

The element to be added. It should be one of the following types: EnSink, EnSource, EnBus, EnGenericStorage, EnConverter, or EnConstraints.

 required

Returns:

Type Description

None
Source code in ensys/components/energysystem.py 
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
def add(self, elem: EnSink | EnSource | EnBus | EnGenericStorage | EnConverter | EnConstraints):
    """
    Adds an element to the corresponding list based on its type. Determines
    the type of the given element and appends it to its respective
    container (e.g., sinks, sources, busses, etc.). Raises an exception
    if the type of the element is not recognized.

    :param elem: The element to be added. It should be one of the following
                 types: EnSink, EnSource, EnBus, EnGenericStorage,
                 EnConverter, or EnConstraints.
    :type elem: EnSink | EnSource | EnBus | EnGenericStorage | EnConverter | EnConstraints
    :return: None
    """
    if type(elem) is EnSink:
        self.sinks.append(elem)
    elif type(elem) is EnSource:
        self.sources.append(elem)
    elif type(elem) is EnBus:
        self.busses.append(elem)
    elif type(elem) in [EnGenericStorage]:
        self.generic_storages.append(elem)
    elif type(elem) is EnConverter:
        self.converters.append(elem)
    elif type(elem) is EnConstraints:
        self.constraints.append(elem)
    else:
        raise Exception("Unknown Type given!")

to_oemof(energysystem)

Converts the internal energy system components to an oemof energy system and adds them to the provided oemof energy system instance. Each component in the internal energy system is iterated through, converted to its corresponding oemof object, and subsequently added to the provided energy system. This includes busses, sinks, sources, converters, and generic storages.

Parameters:

Name Type Description Default
energysystem EnergySystem

The oemof energy system instance to which the converted components of the internal energy system are added.

 required

Returns:

Type Description
solph.EnergySystem

An updated oemof energy system instance containing all converted components.
Source code in ensys/components/energysystem.py 
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
def to_oemof(self, energysystem: solph.EnergySystem) -> solph.EnergySystem:
    """
    Converts the internal energy system components to an oemof energy system and adds
    them to the provided oemof energy system instance. Each component in the internal
    energy system is iterated through, converted to its corresponding oemof object,
    and subsequently added to the provided energy system. This includes busses, sinks,
    sources, converters, and generic storages.

    :param energysystem: The oemof energy system instance to which the converted components
        of the internal energy system are added.
    :return: An updated oemof energy system instance containing all converted components.
    :rtype: solph.EnergySystem
    """
    for bus in self.busses:
        energysystem.add(bus.to_oemof(energysystem))

    for sink in self.sinks:
        energysystem.add(sink.to_oemof(energysystem))

    for source in self.sources:
        energysystem.add(source.to_oemof(energysystem))

    for converter in self.converters:
        energysystem.add(converter.to_oemof(energysystem))

    for generic_storage in self.generic_storages:
        energysystem.add(generic_storage.to_oemof(energysystem))

    # TODO: Adding Constraints

    return energysystem