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

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.

units: Diccionario de unidades de las magnitudes, debe seguir la misma estructura que devices, pero de manera que hay una entrada de unidades por cada tipo de dispositivo. De esa forma se declaran las unidades de cada parámatro de cada dispositivo.

Por ejemplo:

"units": {
  "Circuit": {
   "time": "Milliseconds since 1/1/1970 (Unix time in ms)"
  },
  "Bus": {
   "vnom": "kV",
   "vmin": "p.u.",
   "vmax": "p.u.",
   "rf": "p.u.",
   "xf": "p.u.",
   "x": "px",
   "y": "px",
   "h": "px",
   "w": "px",
   "lat": "degrees",
   "lon": "degrees",
   "alt": "meters"
  },
  "Generator": {
   "p": "MW",
   "vset": "p.u.",
   "pf": "p.u.",
   "snom": "MVA",
   "enom": "MWh",
   "qmin": "MVAr",
   "qmax": "MVAr",
   "pmin": "MW",
   "pmax": "MW",
   "cost": "\u20ac/MWh"
  },
  "Load": {
   "g": "MVAr at V=1 p.u.",
   "b": "MVAr at V=1 p.u.",
   "ir": "MVAr at V=1 p.u.",
   "ii": "MVAr at V=1 p.u.",
   "p": "MW",
   "q": "MVAr"
  },
  "Shunt": {
   "g": "MVAr at V=1 p.u.",
   "b": "MVAr at V=1 p.u."
  },
  "Line": {
   "rate": "MW",
   "r": "p.u.",
   "x": "p.u.",
   "b": "p.u.",
   "length": "km",
   "base_temperature": "\u00baC",
   "operational_temperature": "\u00baC",
   "alpha": "1/\u00baC"
  },
  "Transformer": {
   "rate": "MW",
   "r": "p.u.",
   "x": "p.u.",
   "b": "p.u.",
   "g": "p.u.",
   "base_temperature": "\u00baC",
   "operational_temperature": "\u00baC",
   "alpha": "1/\u00baC"
  }
}

devices: Diccionario de dispositivos.

profiles: Diccionario de perfiles; misma estructura que devices.

results: Diccionario de resultados.

Con el contenido colapsado, debe tener el siguiente aspecto:

{
    "type": "Grid Exchange Json File",
    "version":   3.0,
    "software": "GridCal",
    "units": {...},
    "devices": {...},
    "profiles": {...},
    "results": {...}
}

Devices

Circuit

diccionario con los parámetros del circuito.

  • id: Id única, prefentemente generada con UUIDv4
  • 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

"fbase": 50,
"phases": "ps",
"model_version": "1.3.0",
"name": "MyGrid",
"sbase": 100,
"user_name": "User",
"id": "efb91a32cbd84dd495001ead8acd857d",
"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"

Bus

  • 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 bus
  • name_code: Código secundario del bus (i.e. número PSSe etc.)
  • active: Estado del bus (true / false)
  • is_slack: Es slack? (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 en pixels
  • y: posición y para su representación en pixels
  • h: alto su representación en pixels
  • w: ancho para su representación en pixels
  • 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",
"type": 2,
"phases": "ps",
"name": "My bus 1",
"name_code": "1001",
"active": 1,
"is_slack": false,
"vnom": 132.0,
"vmin": 0.899,
"vmax": 1.100,
"rf": 0,
"xf": 0,
"x": 0,
"y": 0,
"h": 0,
"w": 0,
"lat": 0,
"lon": 0,
"alt": 0,
"area": "42fe8cc3a9764556b93d3d27dbbca396",
"zone": "51e1f18908294b4facc762d20f1efbec",
"country": "ef30e70ed16646479fb548bc2a6bc972",
"substation": ""

Line

Línea AC normal.

  • 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
  • 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
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • 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": "my line 1",
"name_code": "my code 001",
"bus_from": "596d19e0639f42e0be5d0887585b9a4e",
"bus_to": "054768f9518e465a9ecac721aa8c73de",
"active": 1,
"rate": 82.0,
"r": 0.020,
"x": 0.033,
"b": 0.006,
"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

Línea DC.

  • 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
  • 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
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • 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": "my dc line 1",
"name_code": "my code 002",
"bus_from": "596d19e0639f42e0be5d0887585b9a4e",
"bus_to": "054768f9518e465a9ecac721aa8c73de",
"active": 1,
"rate": 80.0,
"r": 0.020,
"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
  • 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
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • 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": "my transformer",
"name_code": "my name code 003",
"bus_from": "16b003d418df4b97b9453f8b3291aec1",
"bus_to": "53a300acd0714636a54a97a8aa71a41a",
"active": 0,
"rate": 60.0,
"r": 0.0,
"x": 0.35,
"g": 0.0,
"b": 0.0,

"tap_module": 0.98,
"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

  • id: ID del bobinado
  • 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
  • rate: Rating de potencia de la bobina
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3

HVDC Line

Este es el modelo HVDC simple. Se modela internamente con dos generadores de tensión controlada y la línea en sí no se introduce. Si la línea de este modelo es la única ligazón entre dos sistemas, entonces en la propia simulación esos sistemas están aislados.

  • 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
  • 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
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • 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 de set point en en lado «from» (p.u. del sistema)
  • vset_to: Tensión de 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 (Universal Power Flow Controller)

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 («upfc»)
  • name: Nombre del dispositivo
  • name_code: Código alternativo del dispositivo
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado del dispositivo (1: activo, 0: inactivo)
  • rate: Rating de potencia del dispositivo (MW)
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • rl: Resistencia del dispositivo (p.u. del sistema)
  • xl: Reactancia del dispositivo (p.u. del sistema)
  • bl: Susceptancia del dispositivo (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 de set point en en lado «from» (p.u. del sistema)
  • Pset: Potencia activa establecida de «envío» en el lado «from» (MW)
  • Qset: Potencia reactiva establecida de «envío» en el lado «from» (MW)

SSSC (Static Synchronous Series Compensator)

Static Synchronous Series Compensator (SSSC).

  • id: Id única, prefentemente generada con UUIDv4
  • type: Nombre de la clase («sssc»)
  • name: Nombre del SSSC
  • name_code: Código alternativo
  • bus_from: id del bus «from»
  • bus_to: id del bus «to»
  • active: Estado del dispositivo (1: activo, 0: inactivo)
  • rate: Rating del dispositivo (MW)
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • rs: Resistencia serie del dispositivo (p.u. del sistema)
  • xs: Reactancia serie del dispositivo (p.u. del sistema)
  • control_mode: Modo de conrol. Ver tabla de modos de control.
  • vset: Tensión de consigna establecida de «envío» en el lado «from» (p.u.)
  • Pset: Potencia activa establecida de «envío» en el lado «from» (MW)
  • Qset: Potencia reactiva establecida de «envío» en el lado «from» (MW)

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 activa P
3 Control de potencia reactiva Q

VSC (Voltage Source Converter)

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 («vsc»)
  • name: Nombre del dispositivo
  • name_code: Código alternativo del convertidor
  • bus_from: id del bus «from», es el lado DC siempre.
  • bus_to: id del bus «to», es el lado AC siempre.
  • active: Estado del dispositivo (1: activo, 0: inactivo)
  • rate: Rating de potencia del dispositivo en MW
  • contingency_factor1: Multiplicador del rate para contingencias tipo 1
  • contingency_factor2: Multiplicador del rate para contingencias tipo 2
  • contingency_factor3: Multiplicador del rate para contingencias tipo 3
  • 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.)
  • control_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
  • 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 ",
"name_code": "Gen2345"
"bus": "596d19e0639f42e0be5d0887585b9a4e",
"active": 1,
"is_controlled": true,
"p": 24.0,
"pf": 0.94,
"vset": 1.02,
"snom": 43.0,
"qmin": -12.0,
"qmax": 12.0,
"pmin": 0.0,
"pmax": 41.0,
"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
  • 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": "Battery",
"name_code": "Bat345"
"bus": "596d19e0639f42e0be5d0887585b9a4e",
"active": 1,
"is_controlled": true,
"p": 24.0,
"pf": 0.95,
"vset": 1.01,
"snom": 43.0,
"qmin": -12.0,
"qmax": 12.0,
"pmin": 0.0,
"pmax": 41.0,
"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
  • 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.5,
"q": 2.2

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
  • 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": "Load 1",
"name_code": "my name code 004",
"bus": "16b003d418df4b97b9453f8b3291aec1",
"active": 1,
"g": 0.0,
"b": 0.0,
"ir": 0.0,
"ii": 0.0,
"p": 6.2,
"q": 2.3

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
  • 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": "Shunt",
"bus": "68adb547e8ca4218925cf7c400422eab",
"active": 1,
"controlled": 1,
"g": 0.0,
"b": 0.0
"bmax": 5.0,
"bmin": 0.0,
"id_impedance_table": "deb2195e03cf4070859b2059a3d17b1b"

Profiles

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.

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": {
                "bus": {
                            "596d19e0639f42e0be5d0887585b9a4e": {
                                                                 "va": 0.16,
                                                                 "vm": 1.02
                                                                }, ...
                       },
                "branch": {
                            "096162cf5ade4ce4894baaff1a291fe7": {
                                                                 "q": 8.6,
                                                                 "p": 24.4,
                                                                 "losses": 0.0
                                                                 }, ...
                          }
                }