Skip to content

Bus

EnBus

Bases: EnBaseModel

Represents a bus in an energy system model.

This class is used to define a bus element, which is a central node in an energy system. The bus connects different components such as sources, demands, and transformers and facilitates the movement of energy between them. It also checks for balance in energy inflows and outflows at every timestep.

Attributes:

Name Type Description
label str

String holding the label of the Bus object. The label of each object must be unique.
balanced bool

Indicates if the bus is balanced, i.e., if the sum of inflows equals the sum of outflows for each timestep; defaults to True.
Source code in ensys/components/bus.py 
 7
 8
 9
10
11
12
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
class EnBus(EnBaseModel):
    """
    Represents a bus in an energy system model.

    This class is used to define a bus element, which is a central node in an energy
    system. The bus connects different components such as sources, demands, and
    transformers and facilitates the movement of energy between them. It also checks for
    balance in energy inflows and outflows at every timestep.

    :ivar label: String holding the label of the Bus object. The label of each object must
        be unique.
    :type label: str
    :ivar balanced: Indicates if the bus is balanced, i.e., if the sum of inflows equals
        the sum of outflows for each timestep; defaults to True.
    :type balanced: bool
    """
    label: str = Field(
        ...,
        title='Label',
        description='String holding the label of the Bus object. The label of each object must be unique.'
    )

    balanced: bool = Field(
        default=True,
        title='Balanced',
        description=' Indicates if bus is balanced, i.e. if the sum of inflows equals to the sum of outflows for each timestep; defaults to True'
    )

    def to_oemof(self, energysystem: solph.EnergySystem) -> solph.Bus:
        """
        Converts the current instance into an oemof.solph.Bus object using the
        provided energy system. This method prepares necessary keyword arguments
        from the energy system to initialize and return a solph.Bus instance.

        :param energysystem: An instance of solph.EnergySystem used to build
            keyword arguments for the solph.Bus.
        :type energysystem: solph.EnergySystem
        :return: A solph.Bus object initialized with the built keyword arguments.
        :rtype: solph.Bus
        """
        kwargs = self.build_kwargs(energysystem)

        return solph.Bus(**kwargs)

to_oemof(energysystem)

Converts the current instance into an oemof.solph.Bus object using the provided energy system. This method prepares necessary keyword arguments from the energy system to initialize and return a solph.Bus instance.

Parameters:

Name Type Description Default
energysystem EnergySystem

An instance of solph.EnergySystem used to build keyword arguments for the solph.Bus.

 required

Returns:

Type Description
solph.Bus

A solph.Bus object initialized with the built keyword arguments.
Source code in ensys/components/bus.py 
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
def to_oemof(self, energysystem: solph.EnergySystem) -> solph.Bus:
    """
    Converts the current instance into an oemof.solph.Bus object using the
    provided energy system. This method prepares necessary keyword arguments
    from the energy system to initialize and return a solph.Bus instance.

    :param energysystem: An instance of solph.EnergySystem used to build
        keyword arguments for the solph.Bus.
    :type energysystem: solph.EnergySystem
    :return: A solph.Bus object initialized with the built keyword arguments.
    :rtype: solph.Bus
    """
    kwargs = self.build_kwargs(energysystem)

    return solph.Bus(**kwargs)