ADVANCED DIGSILENT TRAINING

DYNAMIC MODELLING WORKSHOP

INTRODUCTION TO DSL PROGRAMMING

Reference: Chapter 11
 Overview

DIgSILENT Simulation Language(DSL)

DSL can define:

- Linear or non-linear system of differential equations
- Arithmetic/logic expressions(e.g. digital controllers)
- Action upon grid elements(e.g. open breakers)

DSL routines/programs can be implemented by:

- Directly writing DSL code
- Using graphical macros(Graphical interface)
 Introduction

 Mathematical description of (time) continuous linear

& non linear systems.
 Simulation tool is based upon control & logic diagrams
and is mainly intended to represent dynamic systems.
 PF provides the user an interface to build a DSL model
graphically.
 Others
Dynamic Systems
Writing DSL code
 Writing DSL code

Reference: Chapter 11 pp 169-185

- DSL General syntax

- DSL expressions
- DSL variables
- Etc.
 DYNAMIC MODELS IN POWER FACTORY

1. DSL block definition/model – structure of dynamic function and

corresponds to type. To include a dynamic model in the calculation, an
active element must be created in the grid making reference to this “type”

2. Common model
- connections to the grid elements upon which it will act and to which it
will respond must be defined. (an AVR connected to a
generator)
- active network element representing a dynamic model.
Examples are AVR, Governor (Hygov, IEEGO, etc.).
In the common model, specific
parameters have to be specified.
3. Composite Model. The connection of a common model to other
network elements which is done via input & output signal names of the
common model and the element to which it is connected.
The method to establish such connections or relationships is via the
connection structure called Composite Frame.
Composite Frame is a layout of the intended correlation between dynamic
models and elements.
 COMPOSITE FRAME

Composite Frame:

• shows the correlation between dynamic models &

elements. Of built “type”.

• model or network element is represented via slot.

• a composite frame is also a layout of inter

connections between slots. Signal matching is done
via local signal names
COMPOSITE FRAME
 MODELLING APPROACH
pp 199-200

Type Element

Composite Frame Composite Model

Model Definition Common Model
 CREATING A DSL PROGRAM
1. Equations in time domain describing the dynamic system must
be written as code using DSL syntax rules & function
(refer to Digsilent technical manual).
2. Parameters and types of variables must be defined.
3. A variable cannot be an output or input and a state variable at
the same time.
4. When using the graphical interface, again a Block Definition
object hast to be created. DSL code must be implemented in a
Block Definition Object. User created Block Definition are
stored in the “User Defined Models” Library.
5. A Block Definition object can either be a complete DSL model
(program) or a DSL macro to be used to build graphically a
complete model.
Note: Macros can be dragged from their original locations and
dropped in the graphical page.
Refer to Digsilent Advance Training Manual pages 179-185 for
additional references about Block Definition.
DSL COMMON MODEL
 SAMPLE EXERCISE
(SIMPLE EXCITATION SYSTEM)

Reference: Chapter 11.4 pp 186-189

FRAME DIAGRAM
 Procedure
Creating the Block Diagram of Figure 1

1. Create a new block diagram and name it “Simple AVR”.

2. Insert different functions blocks/macros using Drag &

Drop functionality.

3. Connect the blocks to the corresponding input &

output signals.

4. Formulate source code in “Equations” tab for model

initialization and variable definition.
CREATE A FRAME DIAGRAM
STEP RESPONSE TEST
STEP RESPONSE TEST
AVR STEP RESPONSE TEST
 MODEL VALIDATION: STEP RESPONSE TEST

No Load(Open Circuit )

1. Open unit circuit breaker, and set the “Spinning if Circuit breaker is
open”
2. Calculate load-flow & initial conditions to check for project errors.
3. Run simulation without events and monitor usetp, uerrs & u. Make
sure that the system is in steady state and does not “move” from
beginning on.

(Closed-Loop) step response test on voltage set point

3. Make a test response to reference voltage usetp. Record the

results.
 ACTUAL APPLICATIONS
Excitation system of HEDCOR
 EXERCISE
HYDRO- TURBINE & GOVERNOR

Reference:

Page 206-214
FRAME DIAGRAM
LOAD RESPONSE TEST
 ACTUAL APPLICATIONS
Governor system of HEDCOR