Component Library

Reusable parameters for different electrical components can be defined in the Component Library.

The specified models can be used to update electrical components in the grid by means of Grid Upgrades or directly in the Grid Editor.

If Component library matching is set up in the Data Integration, electrical parameters will be automatically applied to the electrical components during the Grid Data Updates.

INFO

All projects within one team share the same component library.

Lines

By default, a library of LEONI cables with the associated electrical parameters is provided.

A new row can be added to the default library by clicking .

Delete one or multiple rows, by selecting them and clicking .

Columns that are marked with an * are mandatory and need to be filled with values.

Uploading a csv-file will append the rows to the existing library. The uploaded file is expected to be UTF-8 encoded and needs to follow the following format: lines.csv.

The complete library can be downloaded by clicking .

TIP

The Name column is used to automatically match the parameters from the library to the lines using the LibraryComponentName attribute of lines. For more info check Electrical Components and Data Integration.

Transformers

A default library with transformers from the following manufacturers is provided:

• Rauscher & Stoecklin
• Siemens
• Merlin Gerin
• ABB
• Schneider Electric

A new row can be added to the default library by clicking .

Delete one or multiple rows, by selecting them and clicking .

Columns that are marked with an * are mandatory and need to be filled with values.

Uploading a csv-file will append the rows to the existing library. The uploaded file is expected to be UTF-8 encoded and needs to follow the following format: transformers.csv.

The complete library can be downloaded by clicking .

TIP

The Name column is used to automatically match the parameters from the library to the transformers in the grid using the LibraryComponentName attribute of transformers. For more info check Electrical Components and Data Integration.

Fuses

A selection of fuse characteristics is provided by default.

A new row can be added to the default library by clicking .

Delete one or multiple rows, by selecting them and clicking .

Columns that are marked with an * are mandatory and need to be filled with values.

Uploading a csv-file will append the rows to the existing library. The uploaded file is expected to be UTF-8 encoded and needs to follow the following format: fuses.csv.

Characteristic curve

Click on in the Characteristic curve column to edit the characteristic curve of the selected fuse.

Each fuse requires a minimum and a maximum switch-off time curve. If only one set of data is available, simply paste the same data into both columns. After adding some support points for the characteristic curve, click on to see the resulting curve in the chart. The characteristic curve is the result of interpolating the defined support points using a natural cubic spline interpolation as described in ^[1]. If the plotted curve is not similar to the source curve, simply add more support points.

The complete library can be downloaded by clicking .

INFO

• The characteristic curve of a fuse is used to determine the fault-switch-off-time in the Protection Calculation
• The Current Rating [A] is used to determine the fuse loading when running a Power Flow

TIP

The Name column is used to automatically match the parameters from the library to the fuses in the grid using the LibraryFuseName attribute of fuses. For more info check Electrical Components and Data Integration.

Reliability

A reliability model defines the reliability of a specific grid element. It is used for the Reliability Calculation. There are different outage reasons, each of which can be assigned the following properties:

• H: Number of outage occurrences per year
• T: Outage duration per occurrence

A reliability model can be assigned to elements in the grid model. For elements without a defined reliability model, a default can be set in the reliability calculation options.

There are predefined models for lines and transformers based on the VDE FNN outage statistics 2011.

TIP

The Reliability Model Name is used to automatically match the parameters from the library to the grid element using the LibraryReliabilityName attribute of grid elements. For more info check Electrical Components and Data Integration.

Active Power

Defines the active power controller for storage devices (such as batteries). Two types of controller can be defined:

• Voltage controller: voltage dependant power output $P(U)$
• Overloading avoidance controller: loading depandant power output $P(\text{Loading})$

For $P(U)$ the voltage dependant power is defined in a tabular format.

For $P(\text{Loading})$ the maximum loading of lines and transformers need to be defined.

Furthermore, the average state of charge $SoC$ of the storage needs to be defined.

INFO

• The voltage controller reduces high/low voltages in the grid by charging/discharging the battery depending on the measured voltage.
• The overloading avoidance controller prevents the overloading of lines and transformers by charging/discharging the battery depending on the measured loading.
• The controller can be assigned to storage components in the Grid Editor or as Grid Upgrade.

TIP

The Name is used to automatically match the controller from the library to the storage in the grid using the LibraryStorageControllerName attribute of storage. For more info check Electrical Components and Data Integration.

Reactive Power

Defines the voltage-dependant reactive power characteristic of loads and generators. The reactive power can either be defined as $Q(U)$ or through the power factor $cos\varphi (U)$, where $U$ is the voltage.

INFO

• Values are defined in the consumer reference frame. See Signing Convention for more details.
• The purpose of the voltage-dependant reactive power characteristic is to correct the voltage change caused by the addition of loads/generators.
• The reactive power characteristic can be assigned to loads/generators in the Grid Editor or as Grid Upgrade.

TIP

The Name is used to automatically match the function from the library to the loads/generators in the grid using the LibraryCharacteristicName attribute of loads/generators. For more info check Electrical Components and Data Integration.

Reference Profiles

Reference Profiles are time series profiles that can be used with loads and generators.

Profiles can be uploaded as csv or txt files. The expected file format is:

• One value per line
• UTF-8 encoded
• Example: reference-profile.txt

The start time, sampling time and the length of the data in the uploaded file define the length of the time series. A sampling time of 900 seconds (15 minutes) means that 4 lines in the file cover 1 hour.

INFO

• Reference profiles can be used as time series behavior of loads and generators or as fallback behavior for unmetered loads/generators in the Simulation settings.

TIP

The Name is used to automatically match the profile from the library to the loads/generators in the grid using the TimeSeriesBehavior attribute of loads/generators. For more info check Electrical Components and Data Integration.

---

1. R.L. Burden, J.D. Faires, Numerical Analysis, 4th Ed., 1989, PWS-Kent, ISBN 0-53491-585-X, pp 126-131 ↩︎