Enode

Enode (Electric Node or Bus)

The Enode class is used by the NPSS Power System Library to connect multiple components to a single node or bus. It may alternatively be used for when a model requires two nodeless components (e.g. a cable to a breaker) to be connected which must have a nodal component placed in between to correctly propagate voltage information across its network (see Home).

Usage

The Enode component is primarily used as an electrical bus that connects multiple components to each other via Cables or Breakers (i.e. nodeless components). Used in this way, it propagates the voltage information to conform to the Power System Libary's solver configuration.

Bus Example

Consider the diagram below where two Source components , S1 & S2, are supplying power to a ConstantPowerLoad CPL:

 Branch 1
 Src (S1) -> Cbl (C1) ->|
                        |   Branch 3
              Node (E1) |-> Cbl (C3) -> CPL (L1)  
 Branch 2               |
 Src (S2) -> Cbl (C2) ->|

Because the model requires multiple source (nodal) components to be connected to the constant power load, the Enode E1 is used as a bus to connect all three branches together via cables (C1, C2, C3).

Defining an Enode component is similar to any other nodal component, however, requires the user to also define each ElectricInputPort and ElectricOutputPort manually as required by the model.

Enode E1 {
  ElectricInputPort EP_I1, EP_I2;
  ElectricInputPort EP_O;
  VrealRMS  = 100;  // [volts]
  VimagRMS  = 0;    // [volts]
  frequency = 400;  // [Hz]
}

Once this is done, the components must be linked via their ports to each Enode port to form a branch. User's are encouraged to use findSourcesAndPropagate() when using Enodes to avoid setting incorrect power types. An Enode's electric ports must all have the same power type.

// Branch 1
linkPortI("S1.EP_O", "C1.EP_I");
linkPortI("C1.EP_O", "E1.EP_I1");

// Branch 2
linkPortI("S2.EP_O", "C2.EP_I");
linkPortI("C2.EP_O", "E1.EP_I2");

// Branch 3
linkPortI("E1.EP_O", "C3.EP_I");
linkPortI("C3.EP_O", "CPL.EP_I");

findSourcesAndPropagate();

Functionality

TODO