modelHowTo

How-To

Extends from Modelica.Icons.Information (Icon for general information packages).

Information

Data Sets Usage Guide

The following short guide is intended to provide a brief description on the use of the parameter data sets for generation units contained in this package.

The Example_1 of the OpenIPSL Library Tutorial explains the process required to create a simple network model along with a generation group sub-model. Although it is not necessary to create a model only for the generation group, it is highly recommended as it promotes modularity and flexibility. It should be noted that the network model can grow in size and complexity, as the IEEE14 and N44 examples demonstrate. For these last two cases, there is a generator group model for each generator connected to the network.

To be able to make use of the parameterized records containing the dynamic response related parameters of machines and their controls from this package, you must:

  • Go to the generation group model where you intend to use the records.
  • Drag and drop an instance of the GUDynamics record on the diagram layer of the model.
  • Propagate the record to the upper-level model (i.e., to the network model where the generation group model is instantiated).
  • Go to the network model (i.e., the upper-level model) and double click on the generator component.
  • Expand the drop-down list of the propagated GUnitDynamics parameter and choose the set of parameters that best suits your needs. Notice that the available parameters can be inspected later by first clicking on the button to the right of the drop-down list, and then on the button of the corresponding generator group component (e.g., machine, excitation system).
  • Go back to the generation group model and double-click each machine and machine control component, one at the time. Make sure you insert all required references to match the parameters with their corresponding values from the GUDynamics record. For example, after double-clicking on the machine component, its inertia parameter H can be assigned by reference using the expression gUDynamics.guDynamics.machine.H. The reference can be (a) typed, (b) copied and pasted or, (c) explored using the Insert Component Reference functionality.

A couple of examples have been created to illustrate the entire procedure: