Fórmulas MiroxQL (referencia de la API)

Una fórmula MiroxQL combina métricas diarias de la exportación heredada en una columna calculada, por ejemplo un performance ratio a partir de una energía y un objetivo.

¿MiroxQL o Métricas?

Rutas de fórmulas

Todas las rutas siguen a https://service.mirox.io/api/v1/export/metric/formula. Las rutas necesitan un inicio de sesión o un token de API del grupo Acceso completo; un token Metric Export no llega a ellas. La lectura está abierta a los miembros de la organización; la escritura, a los roles de organización Administrador, Moderador, Gestor de activos (técnico) y Gestor de activos (comercial).

Las fórmulas que entrega Mirox no se pueden modificar ni eliminar.

Campos de una fórmula

{
  "metric_id": "energy_total_incl_losses",
  "name": "Total Energy Including Losses",
  "description": "Sum of grid energy and all shutdown losses",
  "unit": "kWh",
  "scale": 0.001,
  "digits": 2,
  "formula": "@energy_grid_daily + @energy_shutdown_grid_daily + @energy_shutdown_external_daily",
  "calculation_level": "daily",
  "aggregation_method": "sum"
}

Ids

Un id debe estar libre. 409 metric_id_taken significa que una fórmula o una métrica de tu organización, o una métrica de Mirox, ya tiene ese id. Esto se aplica también cuando modificas una fórmula existente cuyo id se ha ocupado entretanto; desactivarla con active=false sigue siendo posible.

Escala y decimales

Calcula en unidades base y convierte con scale. Las métricas diarias se evalúan en unidades base (Wh, W, Wh/m²), así que una suma de energías con scale=0.001 se exporta en kWh. scale y digits se aplican solo al valor exportado. Una fórmula que lee otra fórmula recibe su resultado sin escalar y sin redondear.

Nivel de cálculo

Sintaxis

Referencias

Una métrica se lee con @ y su id. Los ids son los ids de métricas heredadas y los ids de otras fórmulas.

@energy_grid_daily
@gti_sensor_daily

Un valor de la configuración de la planta se lee con $ y su ruta:

GET /config-fields responde la lista actual.

Operadores

Una comparación responde 1 o 0. Una división por cero responde 0. Una métrica sin datos cuenta como 0.

Las operaciones se evalúan en este orden, de mayor a menor prioridad: paréntesis, funciones, * / %, + -, < <= > >=, == !=, &&, ||.

Ejemplos

Producción específica:

@energy_grid_daily / $park.peak_production_w

Irradiación del sensor, o del modelo meteorológico cuando el sensor no tiene valor:

@gti_sensor_daily > 0 ? @gti_sensor_daily : @gti_weather_daily

Proporción de las pérdidas por limitación:

(@energy_shutdown_grid_daily + @energy_shutdown_external_daily) / (@energy_grid_daily + @energy_shutdown_grid_daily + @energy_shutdown_external_daily) * 100

Reglas

• Una fórmula lee al menos una métrica.
• Los paréntesis están equilibrados, y dos operadores no van seguidos, salvo !.
• Una fórmula no debe depender de sí misma, ni directamente ni a través de otras fórmulas.
• Una fórmula trabaja sobre valores diarios. No puede leer valores dentro de un día, y no puede mirar hacia atrás a filas anteriores.

Pasar una fórmula a Métricas

Una fórmula y una métrica se escriben en lenguajes distintos, así que una fórmula se reescribe, no se convierte. En la mayoría de los casos la métrica es más corta, porque expresa lo que ocurre en un intervalo de 15 minutos y deja el resto a su Agregación.

1. Abre Exportación de datos ▸ Glosario y haz clic en Nueva métrica.
2. Describe la cifra al asistente del editor, o escribe tú la expresión. El panel lateral enumera las series con las que puedes construir.
3. Elige la Agregación que corresponde a la fórmula:

4. Comprueba la vista previa en una planta, y después usa la métrica en un informe o expórtala.

El performance ratio, la producción esperada y la producción específica no necesitan una métrica propia. La colección los tiene: plant.pr_weather, plant.pr_pyranometer, plant.expected_weather, plant.expected_pyranometer, plant.specific_yield.

Funciones relacionadas

• Métricas: el sucesor: cifras que tu organización define por sí misma
• Metric Export: exporta métricas con cualquier paso
• API de exportación heredada: las plantillas y los enlaces que evalúan fórmulas
• Migrar a Metric Export: las columnas calculadas y sus equivalentes
• Tokens de API: un token Acceso completo para las rutas de fórmulas