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]
}, ...
]
}