📘 Referencia Completa del Lenguaje DPL

Activa un proyecto por su nombre. Acepta nombre simple, nombre calificado (Project.IntPrj) o ruta completa (\User\Project.IntPrj).

Retorna: 0 en éxito, 1 si no se encuentra o no se puede activar.

Retorna el proyecto actualmente activo (objeto IntPrj) o NULL si no hay proyecto activo.

object project;
project = GetActiveProject();
printf('Proyecto activo: %o', project);

Retorna el caso de estudio activo (objeto IntCase). NULL si no hay caso activo.

Crea un nuevo proyecto copiando el proyecto por defecto. Retorna el nuevo objeto de proyecto.

Retorna el escenario actualmente activo o NULL.

Retorna la carpeta de proyecto del tipo dado. Tipos comunes: 'study', 'netdat', 'netmod', 'scen', 'script'.

Retorna (o crea) el primer objeto de la clase dada en el caso de estudio activo. Muy usado para obtener comandos de cálculo.

object ldf;
ldf = GetFromStudyCase('ComLdf');  ! Obtener comando de load flow
ldf.Execute();

Retorna la red resumen del caso de estudio activo (combinación de todas las redes activas). NULL si no hay redes activas.

Retorna todas las variaciones activas de la carpeta 'Network Data' (objetos IntScheme activos).

Retorna todas las etapas activas para una carpeta dada (objetos IntSstage activos).

Retorna todos los objetos relevantes para el cálculo actual. Es la función más utilizada en DPL para obtener elementos de la red.

set loads;
object load;
loads = GetCalcRelevantObjects('*.ElmLod');
for (load = loads.First(); load; load = loads.Next()) {
  printf('%o: P=%f MW', load, load:plini);
}

Retorna la carpeta donde se almacenan datos de red para la clase dada. Clases: ElmArea, ElmZone, ElmFeeder, ElmBoundary, etc.

Retorna la carpeta de la biblioteca global para tipos de objetos de la clase dada.

Retorna la carpeta de la biblioteca local del proyecto para tipos de objetos.

Mueve el objeto o conjunto de objetos a la papelera de reciclaje (no destruye permanentemente).

Crea casos de falla a partir de los elementos dados. Modos: 0=caso único con todos los elementos, 1=N-1, 2=N-2, 3=acoplamientos de línea.

Divide una línea en el punto especificado por una barra existente o porcentaje de longitud.

Retorna todos los objetos marcados en el gestor de datos activo (Browser) o diagrama.

GetBrowserSelection(): objetos marcados en el panel derecho del Data Manager.
GetDiagramSelection(): objetos marcados en el diagrama activo.

Retorna el objeto del diagrama actualmente activo.

Retorna el objeto del tablero gráfico activo (Graphics Board).

Marca/selecciona objetos en todos los diagramas gráficos abiertos.

Retorna la orientación de flujo del proyecto activo: -1=sin proyecto, 0=MIXED MODE, 1=LOAD ORIENTED, 2=GENERATOR ORIENTED.

Retorna el idioma del programa: 'en' (inglés), 'de' (alemán), 'es' (español), 'fr' (francés), 'ru' (ruso), 'cn' (chino), 'tr' (turco).

Retorna el número de versión de PowerFactory en formato ##.#.#.# (e.g. '20.0.3.1').

Acceso de solo lectura a configuraciones de PowerFactory.

Retorna el identificador del cálculo actualmente válido. Valores posibles: 'ldf', 'shc', 'rms', 'emt', 'harm', 'opf', 'est', 'modal', etc.

Fuerza la escritura de cambios pendientes en la base de datos. Durante la ejecución del script los cambios no se persisten hasta que el script termina o se llama esta función.

Guarda el estado de red actual como un nuevo escenario.

Realiza una petición HTTP/HTTPS y retorna la respuesta. El acceso a la URL debe estar permitido en la configuración de seguridad global (IntExtaccess).

Termina el script DPL inmediatamente. Si se llama desde un sub-script, solo termina ese sub-script y el código es retornado al script principal.

Pausa la ejecución del script durante el número de milisegundos indicado.

Las funciones GetResData, GetResDesc, GetResObj, GetResUnit, GetResVar están deprecadas. Usar los métodos de ElmRes y IntComtrade en su lugar.

BinaryAnd(a, b): AND binario. Retorna 1 solo si ambos son 1.
BinaryOr(a, b): OR binario. Retorna 1 si al menos uno es 1.

Invierte una matriz (real o compleja) usando el método de Gauss-Jordan con pivoteo parcial escalado. Trabaja con objetos IntMat.

Retorna: 0=éxito, 1=fallo (matriz singular).

Crea un nuevo objeto de la clase dada dentro del objeto receptor. Los nameParts se concatenan para formar el nombre.

object folder;
folder.CreateObject('ElmLod', 'Carga', 1);  ! Crea 'Carga1.ElmLod'

Agrega una copia de un objeto o conjunto al objeto receptor (destino). Respeta referencias internas entre objetos. Para copiar entre proyectos diferentes, usar PasteCopy().

Similar a AddCopy, pero adapta automáticamente todas las referencias. Necesario cuando el objeto destino está en un proyecto diferente.

Mueve el objeto a la carpeta destino especificada.

Copia todos los parámetros (excepto loc_name y contenedores) del objeto fuente al objeto receptor.

Retorna los objetos almacenados dentro del objeto. Name puede contener wildcards (*, ?). recursive=1 incluye sub-carpetas.

set lines;
lines = grid.GetContents('*.ElmLne', 1);  ! Todas las líneas recursivamente

Como GetContents, pero también da acceso a objetos ocultos por la gestión de esquemas. hiddenMode: 0=solo visibles, 1=todos, 2=solo ocultos.

Retorna la carpeta padre del objeto (mismo que el parámetro 'fold_id').

Busca un objeto por nombre dentro del objeto receptor. Soporta wildcards y filtros de clase.

Retorna todos los objetos que tienen referencias al objeto receptor.

Retorna la red eléctrica en la que está almacenado el objeto.

GetClassName(): retorna el nombre de clase del objeto (ej: 'ElmLne').
GetFullName([type]): retorna la ruta completa del objeto como cadena. type=0 genera un enlace clickeable en la ventana de salida.

object line;
printf('Clase: %s', line.GetClassName());    ! ElmLne
printf('Ruta: %s', line.GetFullName(0));      ! 'Grid\Red\Linea1.ElmLne'

ShowFullName(): imprime la ruta completa del objeto en la ventana de salida.
ShowEditDialog(): abre el diálogo de edición del objeto.

Retornan descripciones de atributos: lnm()=nombre largo, snm()=nombre corto, unm()=unidad.

Retorna 1 si el objeto es de la clase especificada (o hereda de ella), 0 en caso contrario.

Retorna 1 si el atributo/variable especificado existe en el objeto.

Retorna 0 si la variable existe y escribe su tipo en el parámetro de salida type.

Obtiene el valor de un atributo en la unidad actualmente configurada. Para parámetros complejos, key puede ser: 'r'=parte real, 'i'=imaginaria, 'mag'=magnitud, 'phi'=ángulo(°), 'phirad'=ángulo(rad). Para vectores: 'min', 'max', 'avg', 'sum', 'std'.

Retorna: 0=éxito, 1=error (variable no existe o índice fuera de rango).

Establece el valor de un atributo. Funciona en la unidad interna del objeto (no la unidad de visualización).

Obtiene el tamaño de una variable de tipo vector o matriz.

Establece el tamaño de una variable de tipo vector o matriz.

Retorna 1 si el objeto tiene resultados de cálculo disponibles.

GetUnom(busIndex=0): tensión nominal del objeto en kV en el nodo indicado.
GetInom(busIndex=0): corriente nominal en el nodo indicado.

Retorna la impedancia de secuencia positiva del elemento referida a la tensión dada. Para transformadores de 3 devanados, i3Trf selecciona el par (HV-MV=0, HV-LV=1, MV-LV=2).

Retorna el nodo conectado al objeto en el índice de barra especificado.

Retorna la cubícula del objeto en la conexión con índice side.

Retorna el conjunto de elementos conectados eléctricamente. Los parámetros opcionales determinan si se consideran interruptores (rBrk), desconectadores (rDis) y estado en servicio (rOut).

Retorna el número de conexiones eléctricas del objeto.

Retorna el índice de la región a la que pertenece el objeto. Dos elementos comparten región si están topológicamente conectados. -1=desconocido.

Retorna el tipo de puesta a tierra: -1=no determinado, 0=sólidamente a tierra, 1=compensado, 2=aislado.

Retorna el nodo controlado y la tensión objetivo para generadores y unidades reguladoras de tensión.

Retorna las subestaciones, transformadores o estaciones de transformación de suministro más cercanas al componente.

Flags de estado del objeto: IsCalcRelevant()=es relevante para el cálculo actual, IsOutOfService()=fuera de servicio, IsEnergized()=energizado.

Flags adicionales: aterrado, es un nodo, reducible en la red, en cortocircuito.

Acciones de conmutación: SwitchOn()=conectar, SwitchOff()=desconectar, Isolate()=aislar, Energize()=energizar (quitar aterramientos + conectar).

Retorna el operador (ElmOperator) o propietario (ElmOwner) del elemento, heredado recursivamente de los padres si no está definido.

! Crear/usar un mapa DPL (definido como variable interna del script)
object myMap;  ! IntDplmap en contenido del script
myMap.Add('clave1', 100.0);
myMap.Add('clave2', 'valor texto');

double val;
myMap.Get('clave1', val);  ! val = 100.0
printf('Contiene clave1: %d', myMap.Contains('clave1'));  ! 1
myMap.Remove('clave1');
printf('Cantidad de entradas: %d', myMap.Count());

object A;  ! IntMat en contenido del script
A.Resize(3, 3);          ! Redimensionar a 3x3
A.Set(1, 1, 1.0);        ! Asignar valor (fila, col, valor)
A.Set(1, 2, 0.5);
double val;
val = A.Get(1, 1);       ! Leer valor
int rows, cols;
A.GetSize(rows, cols);   ! Obtener dimensiones
InvertMatrix(A);          ! Invertir la matriz in-place

! Iteración básica
set transformers;
object tr;
transformers = GetCalcRelevantObjects('*.ElmTr2');
for (tr = transformers.First(); tr; tr = transformers.Next()) {
  printf('Transformador: %o', tr);
}

! Iteración con filtro de clase/nombre
object tr3;
tr3 = transformers.FirstFilt('T*.ElmTr?');  ! Nombre empieza con T, clase Tr2 o Tr3
while (tr3) {
  tr3.ShowFullName();
  tr3 = transformers.NextFilt();
}