MANUAL DSL

Se proceder a la instalacin de un AVR (control de tensin) en el generador PP1_G1

del tutorial 7 haciendo uso del lenguaje DSL del software Digsilent Power Factory.
Una vez abierto el DIgSILENT, nos dirigimos a abrir el tutorial 7 terminado, como se
muestra en la imagen:

Nos mostrara entonces el siguiente grfico, notar que el GRID est conformado
por 2 partes, a lo cual usaremos la parte 2 del tutorial 7:
NOTA:
En el tutorial 7, simplemente lo que se hizo fue jalar estos AVR, PCU y VCO ya
preestablecidos, en este manual nosotros crearemos nuestro propio modelo.
Si habis hecho el tutorial 7 notaras que ya se agregaron un AVR, PCU y VCO para
fines de este manual tendremos que eliminar el Composite Model de estos
generadores.
Puedes tanto eliminar el Composite Model como tambin podemos editarlos en
ellos mismos.
Como se puede apreciar en el grafico el generador PP1_G1 ya tiene
implementado el AVR como el PCU y VCO. Presione la flechita y podr notarlo.

Para eliminar nos dirigimos al DATA MANAGER

Buscamos Plant_PP1_G1
Hacemos Antilclick---DELETE
Vuelva a ingresar al generador y notara vacio, ahora si podemos proceder con
nuestra gua.
1.- Macros
La implementacin requiere contar con la disponibilidad inmediata de los macros que se
van a utilizar, el software ya incluye una librera propia denominada GLOBAL, la cual
contiene muchos modelos y macros ya elaborados, sin embargo debido a la utilidad y
exigencias particulares de cada simulacin, se requiere de una librera con macros
flexibles, a lo que la librera GLOBAL no satisface.

Nota: La librera GLOBAL, contiene macros y modelos que no permiten la modificacin

por escritura, estn en modo SOLO LECTURA.
Para superar este inconveniente creamos una librera propia de la siguiente manera:
Abrimos el Administrador de Datos
Desplegamos el contenido de nuestro proyecto hacindole click izquierdo
Library
User Defined Models
Click derecho en User Defined Models
Nuevo
Carpeta
Aparece un cuadro de dilogo de edicin e ingresamos:
o Nombre: A1_Libreria_DSL
o Tipo de Carpeta: Biblioteca

Quedar de la siguiente manera:

Para crear nuevos macros en nuestra librera se contar con los siguientes 3 pasos
repetitivos para cada macro que deseamos aadir:
Clic derecho en la librera creada
Nuevo
Diagrama de Bloques/Macros

A continuacin aparece un cuadro de dilogo de edicin denominado Definicin de

Bloque (.BlkDef), los datos que ingresaremos dependen del tipo de macro que se
especifica.
1.1.- Macro: Parmetro K
Datos bsicos
Nombre: cteK
Variables
Seales de salida: yo
Seales de entrada: yi
Parmetros: K

Equations
Ecuaciones Adicionales:

yo=K*yi
1.2.- Macro: 1/(1+sT)
Datos bsicos
Nombre: 1/(1+sT)_m
Variables
Seales de salida: yo
Seales de entrada: yi
Variables de Estado: x
Parmetros: T

Equations
Ecuaciones Adicionales:
limits(T)=(0,]
x.=(yi-x)/T
yo=x
1.3.- Macro: 1/(K+sT)
Datos bsicos
Nombre: 1/(K+sT)_m
Variables
Seales de salida: yo
Seales de entrada: yi
Variables de Estado: x
Parmetros: K,T
 Equations
Ecuaciones Adicionales:
limits(T)=(0,]
x.=(yi-K*x)/T
yo=x

1.4.- Macro: K/(1+sT)

Datos bsicos
Nombre: K/(1+sT)_m
Variables
Seales de salida: yo
Seales de entrada: yi
Variables de Estado: x
Parmetros: K,T
 Equations
Ecuaciones Adicionales:
limits(T)=(0,]
x.=select(T>0,(K*yi-x)/T,0)
yo=select(T>0,x,K*yi)
1.5.- Macro: sK/(1+sT)
Datos bsicos
Nombre: sK/(1+sT)_m
Variables
Seales de salida: yo
Seales de entrada: yi
Variables de Estado: x
Parmetros: K,T
Variables Internas: dx

Equations
Ecuaciones Adicionales:
limits(T)=(0,]
dx=(yi-x)/T
x.=dx
yo=K*dx
1.6.- Macro: limiter
Limitacin Superior
Parmetro Limitante: y_max
Limitacin Inferior
Parmetro Limitante: y_min
Datos bsicos
Nombre: limiter
Variables
Seales de salida: yo
Seales de entrada: yi
 Equations
Ecuaciones Adicionales:
yo=lim(yi,y_min,y_max)

Entonces la librera queda implementada para nuestra simulacin:

NOTA: Como se ve en el grafico siguiente se crearon tambin varias ventanas las cuales
son de nuestros bloques creados, eliminarlos ya que no las utilizaremos:
CTRL+CLICK (Seleccionamos los bloques).
Una vez seleccionados (Eliminamos las ventanas) ver grfico.
2.- Diagrama de bloques
El siguiente paso es armar el diagrama de bloque que corresponde al AVR:

Icono Insertar Nueva Grfica ( )

Nombre: AVR
Nuevo
Diagrama de Bloques/Ensambles

Ejecutar
 Hay que tener en cuenta que a partir de esta ltima ventana se puede armar un
DIAGRAMA DE BLOQUES como tambin se podra armar un FRAME, lo que se ver
ms adelante.
El cono Referencia de Bloque se usa para armar los DIAGRAMAS DE BLOQUE.
El cono Slot se usa para armar los FRAMEs.
Arrastrando el cono Referencia de Bloque armamos una disposicin de los
bloques, luego adicionamos los puntos sumas, cono Punto de Suma:
Ahora enlazaremos cada referencia de bloque con su respectivo macro:
2.1.- Bloque: Filtro de entrada
Click derecho sobre el primer bloque y seleccionar Editar Datos
Editar Datos

Aparece el cuadro de dilogo de edicin Referencia de Bloque (.BlkRef) en el cual

modificamos:
Nombre: Filtro_entrada
Tipo
Icono
Seleccionar Tipo del Proyecto
Aparece una ventana parecida al Administrador de Datos en el que buscamos la
ubicacin del macro 1/(1+sT)_m ya creado en A1_Libreria_DSL, lo seleccionamos y
pulsamos OK

Variables
Parmetros: TR
Variables de Estado: xf1

Quedando de la siguiente manera:

 OK

De la misma manera se procede para los dems bloques

2.2.- Bloque: Regulador
Nombre: Regulador
Tipo
Icono
Seleccionar Tipo del Proyecto

Buscamos la ubicacin del macro K/(1+sT)_m ya creado en A1_Libreria_DSL, lo

seleccionamos y pulsamos OK
Variables
Parmetros: KA,TA
Variables de Estado: xr

Quedando de la siguiente manera:

 OK

2.3.- Bloque: Limitador

Nombre: Limitador
Tipo
Icono
Seleccionar Tipo del Proyecto

Buscamos la ubicacin del macro limiter ya creado en A1_Libreria_DSL, lo

seleccionamos y pulsamos OK
Parmetro Limitante
Limitacin Superior: VRMAX
Limitacin Inferior: VRMIN

Quedando de la siguiente manera:

2.4.- Bloque: Sistema de Excitacin
Nombre: Sist_excitacion
Tipo
Icono
Seleccionar Tipo del Proyecto

Buscamos la ubicacin del macro 1/(K+sT)_m ya creado en A1_Libreria_DSL, lo

seleccionamos y pulsamos OK
Variables
Parmetros: KE,TE
Variables de Estado: xe

Quedando de la siguiente manera:

2.5.- Bloque: Saturacin
Nombre: Saturacin
Tipo
Icono
Seleccionar Tipo del Proyecto

Buscamos la ubicacin del macro cteK ya creado en A1_Libreria_DSL, lo

seleccionamos y pulsamos OK
Variables
Parmetros: SE

Quedando de la siguiente manera:

2.6.- Bloque: Estabilizador del regulador
Nombre: Est_reg
Tipo
Icono
Seleccionar Tipo del Proyecto

Buscamos la ubicacin del macro sK/(1+sT)_m ya creado en A1_Libreria_DSL, lo

seleccionamos y pulsamos OK
Variables
Parmetros: KF,TF
Variables de Estado: xf
Variables internas: dxf

Quedando de la siguiente manera:

La esquela del AVR tiene ahora la siguiente apariencia:

Los puntos de color verde muestran la entrada de cada bloque y los puntos rojos
muestran las salidas de las mismas.
Debido a la disposicin de las seales se hace una rotacin a los bloques de
Saturacin y Estabilizador del regulador.
Para cada uno de estos dos bloques:
Click derecho
Lazo de entrada
 Derecha

Repitiendo para el otro bloque, queda el conjunto de la siguiente manera:

El siguiente paso ser hacer las conexiones haciendo uso del cono Seal, el sentido de
conexin es partiendo de un punto de salida hacia un punto de entrada o en sus
variantes.
Damos nombre apropiado a cada seal
Click derecho sobre la seal
Editar Datos
Ingresamos el nombre de las seales de acuerdo al modelo

Para terminar esta parte damos el signo menos en algunos puntos suma:
Click derecho sobre el punto suma
Seleccionar con Check la entrada adecuada que lo volver negativo
Una vez terminado esto resulta:

3.- Condiciones Iniciales

Una parte muy importante es el clculo de las condiciones iniciales de las variables de
estado que contenga el diagrama de bloques elaborado.
Haciendo doble click en el marco de nuestro diagrama de bloques tenemos:
Que debe ser inicializado?
Todas la variables de estado
 Todas las seales de entrada que se desconocen desde el flujo de carga.

Resolver las condiciones iniciales partiendo de las entradas y salidas conocidas.

Estado estable (flat start) significa:
- x =0
Equivalente a la entrada de todos los integradores debe ser igual a cero.
Evaluacin de funciones de transferencia en estado estable: set s=0
Ajuste de condiciones iniciales:
inc(varnm)=expr
inc0(varnm)=expr

Notamos que contamos con cuatro variables de estado para este diagrama:
xf1
xr
xe
xf

Nota: Al no inicializar las variables de estado, simplemente el modelo manda error y no

corre la simulacin.
INSERTAR LAS CONDICIONES INICIALES:
Las condiciones iniciales de las variables de estado y las entradas/salidas (input/output)
pueden ser definidas.
inc(vref)=u
inc(upss)=0
inc(xf1)=0
inc(xe)=ve
inc(xf)=ve
inc(xr)=xe*KE+o15

inc0(u)=1
inc0(ve)=1

DEFINIR NOMBRE DE VARIABLES:

Use eL siguiente comando:

vardef(TR) ='s';'Constante de tiempo del filtro de entrada de regulacin'

vardef(KE) ='s';'Constante del excitador relacionada al campo autoexcitado '
vardef(KF) ='pu';'Ganancia del circuito estabilizador del regulador'
vardef(KA) ='pu';'Ganancia del regulador'
vardef(TE) ='s';'Constante de tiempo de la excitacin'
vardef(TF) ='s';'Constante de tiempo del circuito estabilizador del regulador'
vardef(TA) ='s';'Constante de tiempo del regulador'
vardef(SE) ='pu';'Funcin de saturacin del regulador'
vardef(VRMIN) ='pu';'Valor mnimo de salida del bloque regulador'
vardef(VRMAX) ='pu';'Valor maximo de salida del bloque regulador'
La forma de verificar que todo lo anterior hecho es:

1
2

Lo cual debe de salir este mensaje: (Indica que todo esta OK)

4.- Modelo General (.ElmDsl)

El modelo general invoca el modelo que ha sido desarrollado en diagrama de bloque y
por medio de este modelo general se puede editar los valores de los parmetros.
Para crear este objeto abrimos el Administrador de Datos y seguimos los siguientes pasos:
Ubicamos nuestro diagrama de bloques y lo seleccionamos con un click
Click en el cono Nuevo Objeto
 Seleccionar casilla Common Model

OK

Aparece una nueva ventana en la que editamos:

Nombre: AVR_dsl

Definicin de modelo:
Click cono
Seleccionar Tipo del Proyecto
Buscamos la ubicacin del diagrama de bloques AVR ya creado, lo seleccionamos y
pulsamos OK

Nos aparece una ventana en la cual se muestran los parmetros creados en nuestro
modelo y le asignamos valores de acuerdo a la siguiente tabla:
Parmetro Descripcin Valor
TR Constante de tiempo del filtro de entrada de regulacin (s) 0.015
KE Constante del excitador relacionada al campo autoexcitado (s) 1
KF Ganancia del circuito estabilizador del regulador (p.u.) 0.4
KA Ganancia del regulador (p.u.) 250
TE Constante de tiempo de la excitacin (s) 0.98
TF Constante de tiempo del circuito estabilizador del regulador (s) 0.25
TA Constante de tiempo del regulador (s) 0.1
SE Funcin de saturacin del regulador (p.u.) 0.5
VRMIN Valor mnimo de salida del bloque regulador (p.u.) -7.6
VRMAX Valor mximo de salida del bloque regulador (p.u.) 7.6
vref Voltaje de referencia del regulador (p.u.) Consigna

OK
5.- Frame
* El frame es la plantilla o estructura basada en slots y lneas de seal.
* Define la interfaz o vas de comunicacin de las distintas seales entre los bloques o
modelos dentro de un Modelo Compuesto.
Se inicia el procedimiento de creacin de la misma forma como en los Diagramas de
Bloques, slo que esta vez usaremos en la estructura solamente slots y lneas de
seal.
El frame que usaremos ser el siguiente:

DIgSILENT
frame_GS:

ii
0
ir
1 VCo Lim Slot
ElmLim*,ElmDsl* curgn
2
ui
3
ur
u
u_lim

0 0
0 1 1
df edt 1 2 2
2 3 3
3 4 4
PSS Slot ve
4 5 VCo Slot 0 5
ElmPss*,ElmDsl*
5 6 ElmVco*,ElmDsl* 6
upss
6 7 7
7 8
Sym Slot 8
ElmSym*
8 9 9
10 10
Wf
11 11
12
pt
0 0 1 13
1 PCU Slot 14
2 ElmPcu*,ElmDsl* 1 15
3

curex
cosn
sgnn
xmt
xme
pgt
w
qg
pg
fe

5.1. Sym Slot

Name: Sym Slot
Sequence: 0.
Class Name: ElmSym*
Output Signals: ut,utr,uti,cur1,cur1r,cur1i,fe,P1,Q1,xspeed,pgt,xme,xmt,sgnn,cosn,ie
Input Signals: ve,pt
5.2. VCo Slot
Name: VCo Slot
Sequence: 1.
Class Name: ElmVco*,ElmDsl*
Output Signals: uerrs
Input Signals: u,ur,ui,curgn,ir,ii,u_lim,upss,sgnn,pg,qg,curex

5.3. VCo Lim Slot

Name: VCo Lim Slot
Sequence: 2.
Class Name: ElmLim*,ElmDsl*
Output Signals: u_lim
Input Signals: curgn,curex,qg,sgnn
5.4. PSS Slot
Name: PSS Slot
Sequence: 3.
Class Name: ElmPss*,ElmDsl*
Output Signals: upss
Input Signals: u,dfedt,fe,xspeed,pgt,xme,xmt,Wf,sgnn

5.5. PCU Slot

Name: PCU Slot
Sequence: 4.
Class Name: ElmPcu*,ElmDsl*
Output Signals: pt,Wf
Input Signals: w,pgt,sgnn,cosn
6.- Modelo Compuesto (.ElmComp)
El Composite Model o Modelo Compuesto es una filosofa para administrar los modelos
asociados a una mquina o sistema de control, la cual ejemplifica la visin de objetos
que emplea el administrador de datos del programa.
El modelo general invoca el modelo que ha sido desarrollado en diagrama de bloque y
por medio de este modelo general se puede editar los valores de los parmetros.
Para crear este objeto abrimos el Administrador de Datos y seguimos los siguientes pasos:
Ubicamos nuestro red donde se encuentra dibujado el sistema de potencia y lo
seleccionamos con un click
Click en el cono Nuevo Objeto
Seleccionar casilla Modelo Compuesto

OK

Aparece una nueva ventana en la que editamos:

Nombre: Gen1 Composite Model
Marco:
o Click cono
o Seleccionar Tipo del Proyecto

Buscamos la ubicacin del frame frame_GS, lo seleccionamos y pulsamos OK

Nos aparece la siguiente ventana
La imagen muestra los nombres de los slots del frame y a su derecha se tendrn que
vincular con su respectivo Modelo General en la columna que titula Elementos de
Red.
Para esta simulacin acoplaremos a este Modelo Compuesto el generador en el slot
Sym Slot y el modelo del AVR en el slot VCo Slot.
Para esto hacemos doble click en la casilla respectiva y ubicamos el generador y el
Modelo General del AVR, quedando de la siguiente manera:
 OK

El Modelo entonces ya est incorporado al generador PP1_G1.

Para la visualizacin de resultados es necesaria una herramienta llamada Instrumentos
Virtuales

NOTA:
Para poder visualizar resultados necesitamos crear evento transitorios
(cortocircuitos, rechazos de cargas, etc)
En este tutorial ya se implementaron este tipo de eventos, por lo tanto ya no ser
necesario crear algn otro evento.
El evento transitorio de este tutorial es la ocurrencia de una falla monofsica a
tierra, donde se ocurren las aperturas y cierres de los seccionadores de la lnea de
transmisin.
Revisar el tutorial 7 Anlisis de Transitorio para una mayor comprensin.
7.- Definicin de variables
Elegiremos las variables que calcular el software durante la simulacin para despus
sean graficadas y evaluadas.
Podemos elegir entre variables del flujo de potencia como de las seales internas del
diagrama de bloques.
7.1.- Definicin de variables del Generador Sncrono
Nos desplazamos a la red del sistema de potencia
Click derecho sobre el generador
Definir
Conjunto de Variables (Sim) o Results for RMS/EMT Simulation (depende de la versin)

Aparece la siguiente ventana en la cual hacemos doble click sobre el generador

Otra ventana se muestra y buscamos las variables que queremos en la pestaa

Simulacin RMS
Filtro para
Conjunto de variables: Seales
Se tienen dos columnas ms abajo: Variables Disponibles y Variables Seleccionadas.
Ubicamos y seleccionamos las variables deseadas en Variables Disponibles luego las

desplazamos a la columna Variables Seleccionadas mediante el botn .

Las variables seleccionadas sern para este caso:
ve : Tensin de exitacin
ut : Tensin en el terminal
P1 : Potencia activa de secuencia positiva
Q1 : Potencia reactiva de secuencia positiva

OK
Cerrar

7.2.- Definicin de variables del diagrama de bloques

Para la definicin de las variables de nuestro diagrama de bloques, realizamos pasos
parecidos como con el generador con la nica diferencia que esta vez no
seleccionamos al diagrama de bloques sino a su Modelo General AVR_dsl.
Entonces ubicamos al Modelo General AVR_dsl en el Administrador de Datos:
Click derecho sobre el Modelo General
Definir
Conjunto de Variables (Sim) o Results for RMS/EMT Simulation (depende de la versin)
Aparece la siguiente ventana en la cual hacemos doble click sobre el Modelo General
AVR_dsl

Otra ventana se muestra y buscamos las variables que queremos en la pestaa

Simulacin RMS
Filtro para
Conjunto de variables: Seales

Se tienen dos columnas ms abajo: Variables Disponibles y Variables Seleccionadas.

Ubicamos y seleccionamos las variables deseadas en Variables Disponibles luego las

desplazamos a la columna Variables Seleccionadas mediante el botn .

Las variables seleccionadas para este caso sern todas las seales:
u
upps
ve
vref
xe
xf
xf1
xr

OK
Cerrar
8.- Instrumentos Virtuales
Para la creacin de estos elementos seguimos los siguientes pasos
Click cono Insertar Nueva Grfica

Nombre: graficas_AVR
Panel de Instrumentos Virtuales (VI)

Ejecutar
 Icono Agregar Nuevo VI(s)

Aparece una ventanita en la que editamos:

Objeto: Subplot (VisPlot)
Nmero de VI(s): 4
OK
Una vez esto indicamos a cada grafica la variable que va a mostrar de la siguiente
forma:
El procedimiento se repite para cada grfica
Doble click en la grafica

Aparece una ventana en la que editamos:

Nombre: Grafica_1
Curvas
Doble click en la casilla: Fila 1, Columna Elemento
Aparece una ventanita en la que seleccionamos el objeto respectivo.
En este caso seleccionamos AVR_dsl y le damos OK.
Doble click en la casilla: Fila 1, Columna Variable

Nos muestra una lista de variables de las que podemos seleccionar a nuestra
preferencia.
En este caso seleccionamos la variable ve.
De la misma manera podemos personalizar el color, estilo de lnea, ancho de la lnea
entre otros.
 OK

De esta manera podemos disponer de cada grfica enlazando las variables ya

definidas de los objetos de inters.
Para este caso personalizamos las grficas del siguiente modo:

GRAFICA/Nombre Objeto Variable

Grafica_1 AVR_dsl ve
PP1_G1
Grafica_2 ve
(Generador)
PP1_G1
Grafica_3 P1
(Generador)
PP1_G1
Grafica_4 Q1
(Generador)

NOTA:
Antes de mostrar las grficas tenemos que cortar el elemento creado AVR_dsl
(este se encuentra ubicado en Library >> Userdefined Models >> AVR >>
AVR_dsl y pegarlo en el Composite Model Gen1 Composite Model.

De esta manera aseguraremos nos muestre la grfica de nuestro AVR.

Ahora buscaremos el siguiente icono, donde daremos inicio a la simulacin transitoria:

No mostrara la siguiente ventana: Ingrese el tiempo que uste crea por conveniente,

adems asegurarse de seleccionar .

Quedando de la siguiente manera:

Tambin podemos agregar todas las variables de AVR_ds:
 ANEXO

DEMOSTRACIN DE LA CONDICIONES INICIALES

Dibujaremos el siguiente circuito, los bloques los sacaremos de la misma biblioteca

general:
Database >> V13.2 Models (old) >> Global Macros
Siguiendo los pasos anteriores encontraremos los elementos para poder crear nuestro
AVR.
Nos quedara de la siguiente manera.

En las siguientes imgenes podemos ver los datos que tendremos que modificar
(Variables).
Ahora veremos como obtener las ecuaciones, que harn que funcione nuestro
controlador:
 Este bloque representa una
contante llamada KeSe

1.-
Definimos uset, u y upss
inc(usetp)=u;

inc(upss)=0 ;el estabilizador de potencia es cero

inc(xr)=u
 El bloque tiene una variable de estado xr

inc(xe)=uerrs

El bloque tiene una variable de estado xe

inc(xf)=uerrs

El bloque tiene una variable de estado xf

Ahora definimos la variable de estado xa

= DESPEJANDO xa tenemos
= +
Inc(xa)= +

ahora definimos Vs
las condiciones iniciales s tiende cero

Sale xa
Yi1*Ka=xa
Usetp=u entonces es igual a 1

S tiende a cero queda u=Vc=1

Vs+Verr-Vf=yi1 reemplazando queda

Vs+0+0=yi1 entonces Vs=yi1 y sabemos
que
Yi1*Ka=xa reemplazando Vs*ka=xa
Vs=xa/ka

Inc(Vs)=xa/ka

2.-
Una vez terminado lo anterior, estos sern los cdigos insertado en las ecuaciones de
inicializacin.