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’ has to be a dictionary.

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 (dict) – a dictionary with different pandapipes/pandapower nets as values. The keys will be set in multinet.nets as net names for the different networks.

Returns

net is 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)