Multinet

A MultiNet serves as ‘container’ for different pandapipes & pandapower nets and coupling controllers. More precisely, it is an dictionary with attribute properties (ADict).

Usually, a multinet is a multi energy net with one net per energy carrier.

Create Function

An empty multinet is created with this function:

create_empty_multinet(name='')

This function initializes the multinet datastructure.

Parameters:

name (string, default None) – Name for the multi net

Returns:

MultiNet with empty tables

Return type:

MultiNet

Example:
>>> mn = create_empty_multinet("my_first_multinet")

An existing pandapipes gas net or pandapower net can be added with this function:

add_net_to_multinet(multinet, net, net_name='power', overwrite=False)

Add a pandapipes or pandapower net to the multinet structure.

Parameters:

  • multinet (pandapipes.MultiNet) – multinet to which a pandapipes/pandapower net will be added

  • net (pandapowerNet or pandapipesNet) – pandapipes or pandapower net that will be added to the multinet

  • net_name (str) – unique name for the added net, e.g. ‘power’, ‘gas’, or ‘power_net1’

  • overwrite (bool) – whether a net should be overwritten if it has the same net_name

Returns:

net reference is added inplace to the multinet (in multinet[‘nets’])

Return type:

None

The nets are stored with a unique key in a dictionary in multinet[‘nets’]. It is also possible to add multiple nets in a single step to the multinet:

add_nets_to_multinet(multinet, overwrite=False, **networks)

Add multiple nets to a multinet. ‘networks’ is one or more keyword arguments with nets.

Parameters:

  • multinet (pandapipes.MultiNet) – multinet to which several pandapipes/pandapower nets are added

  • overwrite (bool) – whether a net should be overwritten if it has the same net_name

  • networks (kwarg (name=net)) – one or more keyword arguments with pandapipes/pandapower nets as values. The keyword of each net will be set in multinet.nets as the name for the network in the respective argument.

Returns:

nets are added to multinet

Return type:

None

Example:
>>> mn = create_empty_multinet()
>>> add_net_to_multinet(mn, net, "first_net_in_multinet")
>>> add_nets_to_multinet(mn, ("power_net1", net1), ("power_net2", net2), ("gas_net", net3)