Especificación Json Eléctrico (v.4.0)

La versión 4.0 especifica un formato de datos de red híbrido en el que se guardan de manera indistinta datos en formato bus-branch como en formato node-breaker.

Raíz de documento

La estructura raíz hospeda un diccionario con las siguientes entradas:

  • type: Describe el tipo de archivo JSON, sirve para indicar que este json no es un archivo común y que su uso es para intercambio de red. El texto que debe contener es: Grid Exchange Json File
  • version: Versión del la especificación del archivo.
  • review: Versión del la revisión de la especificación del archivo.
  • software: Nombre del programa que creó el archivo.
  • devices: Diccionario de dispositivos. Sólo los datos de diseño.
  • data: Datos operacionales con perfil de tiempo; misma estructura que devices. Opcional.
  • topology: Datos sobre el procesado topológico. Contiene las correspondencias de los nudos de conectividad a los nudos de cálculo. Opcional.
  • results: Diccionario de resultados. Opcional.

Con el contenido colapsado, debe tener el siguiente aspecto:

{
    "type": "Grid Exchange Json File",
    "version": 4.0,
    "software": "GridCal",
    "units": {...},
    "devices": {...},
    "data": {...},
    "topology": {...},
    "results": {...}
}

Devices

Circuit

diccionario con los parámetros del circuito.

  • id: Id única, prefentemente generada con UUIDv4
  • id_parent: Id única del modelo padre. Puede estar vacío.
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre
  • sbase: potencia base (MVA)
  • fbase: Frecuencia (Hz)
  • model_version: Versión del modelo
  • user_name: Nombre del usuario que guardó el circuito
  • comments: Comentario

Ejemplo

"id": "efb91a32cbd84dd495001ead8acd857d",
"phases": "ps",
"fbase": 50,
"model_version": "1.3.0",
"name": "MyGrid",
"sbase": 100,
"user_name": "User",
"comments": "This is a test grid"

Country

Entrada de los países disponibles.

  • id: Id única, prefentemente generada con UUIDv4
  • code: Código del país, por ejemplo ES, FR, PT, MA, …
  • name: Nombre del país

Ejemplo:

"id": "63c0ba21be834fbda5c997b29bc4793a",
"code": "default",
"name": "default"

Area

Entrada de las áreas disponibles.

  • id: Id única, prefentemente generada con UUIDv4
  • code: Código del área
  • name: Nombre del área

Ejemplo:

"id": "2d75268c55784799b69d8bf6a871df5c",
"name": "default",
"code": "0"

Zone

Entrada de las zonas disponibles.

  • id: Id única, prefentemente generada con UUIDv4
  • code: Código de la zona
  • name: Nombre de la zona

Ejemplo:

"id": "2d75268c55784799b69d8bf6a871df5c",
"name": "default",
"code": "0"
  • technology_group: id de la tecnología para denominar al grupo de tenologías p.ej: «Ciclo Combinado» (referencia a la tabla de tecnologías)
  • technology_category: id de la tecnología genérica, p.ej «Gas» (referencia a la tabla de tecnologías)

Technology Category

La asociación mayor de grupos de tecnologías.

  • id: Id única, prefentemente generada con UUIDv4
  • name: Nombre de la categoría de tecnología

Ejemplo:

"id": "299d71fd90e145f68e3cdc9ff03895d7",
"name": "Gas"

Technology Group

Grupos de tecnologías.

  • id: Id única, prefentemente generada con UUIDv4
  • name: Nombre de la categoría de tecnología
  • id_technology_category: Id de la categoría a la que pertenece

Ejemplo:

"id": "299d71fd90e145f68e3cdc9ff03895456",
"name": "Ciclo combinado",
"id_technology_category": "299d71fd90e145f68e3cdc9ff03895d7"

Technology

Entrada de las tecnologías disponibles.

  • id: Id única, prefentemente generada con UUIDv4
  • name: Nombre de la tecnología
  • id_technology_group: Id del grupo de tecnologías al que pertenece

Ejemplo:

"id": "8aff71fd90e145f68e3cdc9ff03895d7",
"name": "default",
"id_technology_group": "299d71fd90e145f68e3cdc9ff03895456"

Substation

Representa una subestación.

  • id: Id única, prefentemente generada con UUIDv4
  • name: Nombre

VoltageLevel

Representa el nivel de tensión (parque) de una subestación.

  • id: Id única, prefentemente generada con UUIDv4
  • id_voltage_level: Id de la subestación a la que pertenece.
  • vnom: Tensión nominal (kV)
  • name: Nombre

ConnectivityNode

Representa un nudo de conectividad.

  • id: Id única, prefentemente generada con UUIDv4
  • id_voltage_level Id del nivel de tensión al que pertenece. Puede estar vacío.
  • name: Nombre
  • x: Posición x para su representación dentro del nivel de tensión (pixels)
  • y: Posición y para su representación dentro del nivel de tensión (pixels)

CalcNode

Representa un nudo de cálculo. Puede no existir en el modelo si no se ha realizado el procesamiento topológico.

  • id: Id única, prefentemente generada con UUIDv4
  • secondary_id: Id secundario y posiblemente no único, es para concoordancia con otros formatos.(i.e. número PSSe etc.)
  • name: Nombre
  • active: Estado de actividad del nudo (true / false). Si procede del procesado topológico, por definición estará activo, pero si procede de la conversión de un modelo bus-branch es posible que no.
  • is_slack: Es slack? (true / false)
  • is_dc: Es de corriente contínua? (true / false)
  • vnom: Tensión nominal en kV
  • vmin: Tensión mínima en p.u.
  • vmax: Tensión máxima en p.u.
  • rf: Resistencia de cortocircuito en p.u.
  • xf: Reactancia de cortocircuito en p.u.
  • x: Posición x para su representación (pixels)
  • y: Posición y para su representación (pixels)
  • h: Alto su representación (pixels)
  • w: Ancho para su representación (pixels)
  • rot: Rotación para su representación (radianes)
  • lat: Latitud en grados decimales
  • lon: Longitud en grados decimales
  • alt: Altitud en metros
  • area: ID del área
  • zone: ID de la zona
  • country: ID del país de pertenencia
  • substation: ID de la subestación

Ejemplo

"id": "596d19e0639f42e0be5d0887585b9a4e",
"secondary_id": 1000,
"name": "Bus 1000",
"active": true,
"is_slack": false,
"is_dc": false,
"vnom": 132.0,
"vmin": 0.8999999761581421,
"vmax": 1.100000023841858,
"rf": 0,
"xf": 0,
"x": 0,
"y": 0,
"h": 0,
"w": 0,
"rot": 0,
"lat": 0,
"lon": 0,
"alt": 0,
"area": "42fe8cc3a9764556b93d3d27dbbca396",
"zone": "51e1f18908294b4facc762d20f1efbec",
"country": "ef30e70ed16646479fb548bc2a6bc972",
"substation": ""

Line

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre de la línea
  • name_code: Código alternativo de la línea
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea en MW
  • r: Resistencia de la línea (p.u. del sistema)
  • x: Reactancia de la línea (p.u. del sistema)
  • b: susceptancia shunt total de la línea (p.u. del sistema)
  • length: Longitud de la línea en km
  • base_temperature: Termperatura base de la línea (ºC)
  • operational_temperature: Temperatura operacional de la línea (ºC)
  • alpha: Coeficiente térmico de la línea
  • locations: Lista de longitudes y latitudes de los apoyos de la línea

Ejemplo:

"id": "096162cf5ade4ce4894baaff1a291fe7",
"type": "line",
"phases": "ps",
"name": "L-132\\132 kV ALBARES-JBP1-S.MARIN-JBP1 1",
"name_code": "1000_1147_1",
"bus_from": "596d19e0639f42e0be5d0887585b9a4e",
"bus_to": "054768f9518e465a9ecac721aa8c73de",
"active": 1,
"rate": 82.0,
"r": 0.020090000703930855,
"x": 0.03386000171303749,
"b": 0.006670000031590462,
"length": 0.0,
"base_temperature": 20,
"operational_temperature": 20,
"alpha": 0.0033,
"locations": [(-8.054827817,41.94040418),
              (-8.055221703,41.93964657),
              (-8.05670121,41.93781459),
              (-8.05746899,41.936873),
              (-8.060648726,41.93295244)]

DC Line

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre de la línea
  • name_code: Código alternativo de la línea
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea en MW
  • r: Resistencia de la línea (p.u. del sistema)
  • length: Longitud de la línea en km
  • base_temperature: Termperatura base de la línea (ºC)
  • operational_temperature: Temperatura operacional de la línea (ºC)
  • alpha: Coeficiente térmico de la línea
  • locations: Lista de longitudes y latitudes de los apoyos de la línea

Ejemplo:

"id": "096162cf5ade4ce4894baaff1a291fe7",
"type": "line",
"phases": "ps",
"name": "L-132\\132 kV ALBARES-JBP1-S.MARIN-JBP1 1",
"name_code": "1000_1147_1",
"bus_from": "596d19e0639f42e0be5d0887585b9a4e",
"bus_to": "054768f9518e465a9ecac721aa8c73de",
"active": 1,
"rate": 82.0,
"r": 0.020090000703930855,
"length": 0.0,
"base_temperature": 20,
"operational_temperature": 20,
"alpha": 0.0033,
"locations": [(-8.054827817,41.94040418),
              (-8.055221703,41.93964657),
              (-8.05670121,41.93781459),
              (-8.05746899,41.936873),
              (-8.060648726,41.93295244)]

Table

Tablas de valores, por ejemplo valores de taps, ángulos etc.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • name: Nombre de la tabla
  • index: Índice de la tabla (números enteros)
  • values: valores (números)

Ejemplo:

{
"id": "068362caafde4ce4894baaff1a291fe7",
"type": "table",
"name": "Tap values 1",
"index": [-4,       -3,     -2,     -1,     0,       1,      2,      3,      4],
"values": [0.96,    0.97,   0.98,   0.99,  1.0,     1.01,    1.02,  1.03,  1.04]
}

Transformer (2-windings)

Transformador de dos devanados.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del transformador
  • name_code: Código alternativo del transformador
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea
  • Vnomf: Tensión nominal del lado «from» en kV
  • Vnomt: Tensión nominal del lado «to» en kV
  • r: Resistencia ( en p.u.)
  • x: Reactancia ( en p.u.)
  • g: Conductancia shunt total ( en p.u.)
  • b: Susceptancia shunt total ( en p.u.)
  • tap_module: Valor del tap ( por defecto 1.0)
  • min_tap_module: Valor mínimo del tap ( por defecto 0.5)
  • max_tap_module: Valor máximo del tap ( por defecto 1.5)
  • id_tap_module_table: ID de la tabla de módulos de taps.
  • tap_angle: Valor del ángulo ( por defecto 0.0 radianes)
  • min_tap_angle: Valor mínimo del ángulo ( por defecto 0.0)
  • max_tap_angle: Valor máximo del ángulo ( por defecto \(2\pi\))
  • id_tap_angle_table: ID de la tabla de ángulos de taps.
  • control_mode: Modo de conrol. Ver tabla de modos de control.
  • vset: Tensión de regulación (en p.u.).
  • pset: Nivel de potencia a regular (MW)
  • base_temperature: Termperatura base del transformador
  • operational_temperature: Temperatura operacional del transformador
  • alpha: Coeficiente térmico del transformador

Modos de control

Modo Función Control 1 Control 2
0 Libre
1 Control de módulo de tensión «to» Vac
2 Control de potencia alterna Pac
3 Control de potencia activa y módulo de tensión alterna Pac Vac

Ejemplo:

"id": "ec04b8678a324672acb5b7c95bf25aad",
"type": "transformer",
"phases": "ps",
"name": "T-132/11 kV 11 ARBON  -PB-G-ARBON  -JBP2",
"bus_from": "16b003d418df4b97b9453f8b3291aec1",
"bus_to": "53a300acd0714636a54a97a8aa71a41a",
"active": 0,
"rate": 35.0,
"r": 0.0,
"x": 0.35143,
"g": 0.0,
"b": 0.0,

"tap_module": 0.982,
"min_tap_module": 0.96,
"max_tap_module": 1.04,
"id_tap_module_table": ""

"tap_angle": 0.0,
"min_tap_angle": -6.28,
"max_tap_angle": 6.28,
"id_tap_angle_table": "068362caafde4ce4894baaff1a291fe7"

"control_mode": 0,
"vset": 1.0,
"pset": 0.0,

"base_temperature": 20,
"operational_temperature": 20,
"alpha": 0.0033

Transformer (N-windings)

Transformador de «N» devanados. Típicamente de tres devanados pero no restringido a eso. Se modela como el equivalente en delta del modelo en estrella.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del transformador
  • windings: Lista de dispositivos de bobinado «delta» equivalente

Winding

Representa un devanado de transformador

  • id: ID del bobinado
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus1: ID del bus 1
  • bus2: ID del bus 2
  • r: Resistencia en p.u. del sistema
  • x: Reactancia en p.u. del sistema
  • g: Conductancia en p.u. del sistema
  • b: Susceptancia en p.u. del sistema

HVDC Line

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • name: Nombre de la línea
  • name_code: Código alternativo de la línea
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea en MW
  • r: Resistencia de la línea (p.u. del sistema)
  • Pset: Potencia establecida de «from» a «to» (MW)
  • loss_factor: factor de pérdidas (p.u.)
  • vset_from: Tensión se set point en en lado «from» (p.u. del sistema)
  • vset_to: Tensión se set point en en lado «to» (p.u. del sistema)
  • min_firing_angle_f: Mínimo ángulo de disparo del convertidor «from» (radianes)
  • min_firing_angle_t: Mínimo ángulo de disparo del convertidor «to» (radianes)
  • max_firing_angle_f: Máximo ángulo de disparo del convertidor «from» (radianes)
  • max_firing_angle_t: Máximo ángulo de disparo del convertidor «to» (radianes)
  • length: Longitud de la línea en km
  • base_temperature: Termperatura base de la línea (ºC)
  • operational_temperature: Temperatura operacional de la línea (ºC)
  • alpha: Coeficiente térmico de la línea
  • locations: Lista de longitudes y latitudes de los apoyos de la línea

UPFC

Unified Power Flow Controller (UPFC). este modelo se utiliza habitualmente para representar dispositivos «FACTS» de forma genérica.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • name: Nombre de la línea
  • name_code: Código alternativo de la línea
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea en MW
  • rl: Resistencia de la línea (p.u. del sistema)
  • xl: Reactancia de la línea (p.u. del sistema)
  • bl: Susceptancia de la línea (p.u. del sistema)
  • rs: Resistencia serie del dispositivo (p.u. del sistema)
  • xs: Reactancia serie del dispositivo (p.u. del sistema)
  • rsh: Resistencia shunt del dispositivo (p.u. del sistema)
  • xsh: Reactancia shunt del dispositivo (p.u. del sistema)
  • vsh: Tensión se set point en en lado «from» (p.u. del sistema)
  • Pfset: Potencia activa establecida de «envío» en el lado «from» (MW)
  • Qfset: Potencia reactiva establecida de «envío» en el lado «from» (MW)

VSC

Voltage Source Converter. Este dispositivo de utiliza para convertir corriente alterna a continua. Puede utilizarse para componer otros dispositivos de electrónica de potencia aprovechando la posibilidad de transformar AC->DC->AC con varios convertidores.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • name: Nombre de la línea
  • name_code: Código alternativo del convertidor
  • cn_from: id del nudo de conectividad «from»
  • cn_to: id del nudo de conectividad «to»
  • bus_from: id del bus «from», es el lado DC siempre.
  • bus_to: id del bus «to», es el lado AC siempre.
  • active: Estado de la línea (1: activo, 0: inactivo)
  • rate: Rating de potencia de la línea en MW
  • r: Resistencia que modela las pérdidas resistivas (p.u. del sistema)
  • x: Reactancia que modela las pérdidas magnéticas (p.u. del sistema)
  • g: Conductancia que modela las pérdidas del inversor (p.u. del sistema)
  • m: Valor del control de tensión (equivale a los taps del transformador) (p.u.)
  • m_max: Valor máximo del control de tensión (p.u.)
  • m_min: Valor mínimo del control de tensión (p.u.)
  • theta: Ángulo de disparo del convertidor (radianes)
  • theta_max: Ángulo de disparo máximo del convertidor (radianes)
  • theta_min: Ángulo de disparo mínimo del convertidor (radianes)
  • Beq: Susceptancia que absorve la reaciva de la parte DC convertidor (radianes)
  • Beq_max: Ángulo de disparo máximo del convertidor (radianes)
  • Beq_min: Ángulo de disparo mínimo del convertidor (radianes)
  • alpha1: Parámetro 1 de la curva de pérdidas IEC 62751-2
  • alpha2: Parámetro 2 de la curva de pérdidas IEC 62751-2
  • alpha3: Parámetro 3 de la curva de pérdidas IEC 62751-2
  • k: Factor del convertidor. (Habitualmente sqrt(3) / 2 = 0.866666)
  • kdp: Pendiente del control droop potencia / Tensión. (p.u. / p.u.)
  • Pfset: Potencia establecida en el control de potencia activa (MW)
  • Qfset: Potencia establecida en el control de potencia reactiva (MW)
  • vac_set: Tensión establecida en el control de tensión AC. (p.u.)
  • vdc_set: Tensión establecida en el control de tensión DC. (p.u.)
  • mode: Modo de control. Ver la tabla adjunta.

Modos de control

Modo Función Control 1 Control 2
0 Libre
1 Control de ángulo de fase y módulo de tensión alterna Ɵ Vac
2 Control de potencia alterna Pac Qac
3 Control de potencia activa y módulo de tensión alterna Pac Vac
4 Control de módulo de tensión y reactiva alternas Vdc Qac
5 Control de tensión alterna y continua Vdc Vac
6 Control droop P/Vdc y reactiva Vdc_droop Qac
7 Control droop P/Vdc y módulo de tensión alterna Vdc_droop Vac

Generator

Generador del sistema.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del generador
  • name_code: Código alternativo del generador
  • cn: id del nudo de conectividad
  • bus: Identificador del bus
  • active: Estado del generador (true / false)
  • is_controlled: Estado de control (true / false)
  • p: Potencia activa
  • pf: Factor de potencia a utilizar si el generador no es controlado
  • vset: Tensión de consigna en p.u.
  • snom: Potencia nominal (MVA)
  • qmin: Potencia reactiva mínima (MVAr)
  • qmax: Potencia reactiva máxima (MVAr)
  • pmin: Potencia activa mínima (MW)
  • pmax: Potencia activa máxima (MW)
  • cost: Coste por unidad de potencia (€/MWh)
  • technology: id de la tecnología utilizada por el generador p.ej: «Mi Cico Combinado increíblemente específico» (referencia a la tabla de tecnologías)

Ejemplo:

"id": "c86d942555cb46bd9a8710442bddbfed",
"type": "generator",
"phases": "ps",
"name": "Generador 1T",
"name_code": "Gen2345"
"bus": "596d19e0639f42e0be5d0887585b9a4e",
"active": 1,
"is_controlled": true,
"p": 24.446718215942383,
"pf": 0.9434666954838484,
"vset": 1.0251911878585815,
"snom": 43.06626510620117,
"qmin": -12.375,
"qmax": 12.375,
"pmin": 0.0,
"pmax": 41.25,
"cost": 0,
"technology": "38d4fa12ebff4e4a910f08397fa5ae06"

Battery

Batería del sistema.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del generador
  • name_code: Código alternativo de la batería
  • cn: id del nudo de conectividad
  • bus: Identificador del bus
  • active: Estado del generador (true / false)
  • is_controlled: Estado de control (true / false)
  • p: Potencia activa
  • pf: Factor de potencia a utilizar si el generador no es controlado
  • vset: Tensión de consigna (p.u.)
  • snom: Potencia nominal (MVA)
  • enom: Energía nominal (MWh)
  • qmin: Potencia reactiva mínima (MVAr)
  • qmax: Potencia reactiva máxima (MVAr)
  • pmin: Potencia activa mínima (MW)
  • pmax: Potencia activa máxima (MW)
  • cost: Coste por unidad de potencia (€/MWh)
  • charge_efficiency: Eficiencia de recarga (p.u.)
  • discharge_efficiency: Eficiencia de descarga (p.u.)
  • min_soc: Mínimo estado de carga (p.u.)
  • max_soc: Máximo estado de carga (p.u.)
  • soc_0: Estado de carga (p.u.)
  • min_soc_charge: Mínimo estado de carga para volver a cargar (p.u.)
  • charge_per_cycle: Potencia por unidad que admitir cargar en cada ciclo (p.u.)
  • discharge_per_cycle: Potencia por unidad que admitir descargar en cada ciclo (p.u.)
  • technology: id de la tecnología utilizada p.ej: «Mi Batería increíblemente específica» (referencia a la tabla de tecnologías)

Ejemplo:

"id": "c86d942555cb46bd9a8710442bddbfed",
"type": "battery",
"phases": "ps",
"name": "Generador 1T",
"name_code": "Gen2345"
"bus": "596d19e0639f42e0be5d0887585b9a4e",
"active": 1,
"is_controlled": true,
"p": 24.446718215942383,
"pf": 0.9434666954838484,
"vset": 1.0251911878585815,
"snom": 43.06626510620117,
"qmin": -12.375,
"qmax": 12.375,
"pmin": 0.0,
"pmax": 41.25,
"cost": 0,
"technology": "38d4fa12ebff4e4a910f08397fa5ae06"

StaticGenerator

Generador «estático» del sistema. Funciona opuestamente a una carga.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del generador
  • name_code: Código del generador
  • cn: id del nudo de conectividad
  • bus: Identificador del bus
  • active: Estado de la carga (true / false)
  • p: Potencia activa
  • q: Potencia reactiva
  • technology: id de la tecnología utilizada p.ej: «Mi generador increíblemente específico» (referencia a la tabla de tecnologías)

Ejemplo:

"id": "63f751f752d9429bb8780b9cbf3270cc",
"type": "static_generator",
"phases": "ps",
"name": "StaGen 2 ",
"name_code": "2000",
"bus": "16b003d418df4b97b9453f8b3291aec1",
"active": 1,
"p": 6.590253829956055,
"q": 2.257225275039673

Load

Carga del sistema.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre de la carga
  • name_code: Código de la carga
  • cn: id del nudo de conectividad
  • bus: Identificador del bus
  • active: Estado de la carga (true / false)
  • g: Conductancia, expresada como potencia equivalente a v=1.0 p.u.
  • b: Susceptancia, expresada como potencia equivalente a v=1.0 p.u.
  • ir: Corriente real, expresada como potencia equivalente a v=1.0 p.u.
  • ii: Corriente imaginaria, expresada como potencia equivalente a v=1.0 p.u.
  • p: Potencia activa
  • q: Potencia reactiva

Ejemplo:

"id": "63f751f752d9429bb8780b9cbf3270cc",
"type": "load",
"phases": "ps",
"name": "Lo-132 kV ARBON  -JBP2 1 ",
"bus": "16b003d418df4b97b9453f8b3291aec1",
"active": 1,
"g": 0.0,
"b": 0.0,
"ir": 0.0,
"ii": 0.0,
"p": 6.590253829956055,
"q": 2.257225275039673

Shunt

Dispositivo en derivación como condensadores o reactancias.

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase
  • phases: Tipo de modelos de fases («ps»: positive sequence, «3p»: three phase)
  • name: Nombre del shunt
  • name_code: Código del shunt
  • cn: id del nudo de conectividad
  • bus: Identificador del bus
  • active: Estado de la carga (true / false, o 1 / 0)
  • controlled Si es controlable o no (true / false, o 1 / 0)
  • g: Conductancia, expresada como potencia equivalente a v=1.0 p.u.
  • b: Susceptancia, expresada como potencia equivalente a v=1.0 p.u.
  • bmax: Susceptancia máxima, expresada como potencia equivalente a v=1.0 p.u.
  • bmin: Susceptancia mínima, expresada como potencia equivalente a v=1.0 p.u.
  • id_impedance_table: ID de la tabla de impedancia.

Ejemplo:

"id": "deb2195e03cf4070859b2059a3d17b1a",
"type": "shunt",
"phases": "ps",
"name": "SWSHT-132 kV ATIOS  -JBP2",
"bus": "68adb547e8ca4218925cf7c400422eab",
"active": 1,
"controlled": 1,
"g": 0.0,
"b": 0.0
"bmax": 5.0,
"bmin": 0.0,
"id_impedance_table": "deb2195e03cf4070859b2059a3d17b1b"

Data

Tiene la misma estructura que «Devices» pero los objetos contienen sólo aquellas propiedades con perfiles. Además, los valores de cada propiedad es una lista de valores.

Ejemplo:

Results (Opcional)

Esta sección incluye resultados que se quieran enviar junto con el archivo JSON.

Power Flow

Resultados de flujo de potencia.

Bus

  • va: Angulo de tensión en radianes
  • vm: Módulo de tensión en p.u.

Branch

  • p: Flujo de potencia activa desde el nudo «from» (MW)
  • q: Flujo de potencia reactiva desde el nudo «from» (MVAr)
  • losses: Pérdidas en MW
"power_flow": {
                "time": [1, 2, 3, 4, 5]  # list of time steps in unix time
                "bus": [
                          { "id": "596d19e0639f42e0be5d0887585b9a4e",
                            "va": [0.1696, 0.1823, 0.1425, 0.2365, 0.1147],
                            "vm": [1.0252, 1.0301, 1.0199, 1.0201, 1.0114],
                          }, ...
                       ],
                "branch": [
                            {
                             "id": "096162cf5ade4ce4894baaff1a291fe7",
                             "q": [8.6019, 8.7562, 8.6352, 8.9863, 8.6547]
                             "p": [24.4467, 23.6541, 25.3654, 24.8963, 24.5637]
                             "losses": [0.0, 0.0, 0.0, 0.0, 0.0]
                            }, ...
                          ]
                }