OpenREiD - QGIS Plugin

OpenREiD es un complemento para QGIS orientado al modelado, edición, importación, exportación y simulación de redes eléctricas de distribución.

Integra OpenDSS mediante AltDSS-Python (DSS-Extensions), manteniendo el modelo eléctrico persistido en capas QGIS y generando archivos .dss para los cálculos.

Instituto de Energía Eléctrica (UNSJ-CONICET): https://iee-unsjconicet.org/reid/

---

Estado

Experimental. OpenREiD está en evolución activa; el esquema de capas, la API interna y algunas funciones pueden cambiar entre versiones.

---

Funcionalidades

• Barra de herramientas en QGIS para crear y editar redes de distribución.
• Gestión de redes en formato OpenREiD (.reid).
• Edición georreferenciada de nodos, líneas, transformadores, cargas, capacitores, generadores, sistemas fotovoltaicos y estación transformadora.
• Modelado de aparatos de maniobra y protección: seccionadores, fusibles, reconectadores y relés.
• Importación y exportación de modelos OpenDSS (.dss).
• Gestión de librerías DSS: LineCode, LineGeometry, LineSpacing, WireData, CNData, TSData, LoadShape, TShape, XYCurve, TCC_Curve y XfmrCode.
• Cálculo de flujo de potencia instantáneo y de 24 hs.
• Resultados de flujo como capas QGIS: v_en_nodos, flujo_en_lineas, flujo_en_cargas y sumario.
• Selector horario para visualizar resultados de flujo de potencia de 24 hs.
• Estilos QML y visualización de resultados directamente sobre el mapa.
• Compatibilidad Windows/Linux mediante AltDSS-Python.

---

Requisitos

• QGIS 3.40 o superior.
• AltDSS-Python instalado en el Python utilizado por QGIS.

Instalación de AltDSS-Python:

Windows, desde OSGeo4W Shell:

python -m pip install "altdss==0.2.4"

Linux:

1. En QGIS, abrir la consola Python y ejecutar:

python import sys print(sys.executable)

1. Cerrar QGIS y, en una terminal, ejecutar la ruta mostrada:

bash "/ruta/mostrada/por/qgis/python3" -m pip install --user --break-system-packages "altdss==0.2.4"

En Debian/Ubuntu recientes, --break-system-packages evita el error externally-managed-environment. No usar python3 genérico salvo que coincida con la ruta mostrada por QGIS.

Después de instalar, cerrar y volver a abrir QGIS.

Verificación, desde la consola Python de QGIS:

from altdss import altdss
print(altdss.NewContext().Version())

AltDSS-Python es el motor requerido para ejecutar los cálculos eléctricos desde QGIS.

---

Instalación Desde ZIP

1. Descargar la release openreid.zip desde la carpeta releases/.
2. En QGIS: Complementos -> Administrar e instalar complementos... -> Instalar desde ZIP.
3. Seleccionar el ZIP, instalar y habilitar OpenREiD.
4. Instalar altdss si aún no está disponible en el Python de QGIS.
5. Reiniciar QGIS.

Actualización: instalar la nueva release repitiendo los pasos anteriores. Si QGIS no reemplaza correctamente la versión anterior, desinstalar el complemento y volver a instalarlo desde ZIP.

---

Uso Rápido

1. Activar el complemento desde QGIS.
2. Crear o abrir una red .reid.
3. Editar los elementos de la red en el grupo RED.
4. Editar o importar librerías en el grupo LIB.
5. Importar o exportar modelos OpenDSS si corresponde.
6. Ejecutar flujo de potencia instantáneo o de 24 hs.
7. Revisar resultados en CALC/FLUJO DE POTENCIA.
8. Usar el selector horario si el cálculo fue de 24 hs.
9. Guardar la red.

La ayuda integrada del plugin incluye una descripción más detallada de capas, atributos y reglas de modelado.

---

Ejemplos

El repositorio público incluye ejemplos en:

examples/
├─ openreid/      # Redes nativas OpenREiD (.reid)
└─ dss/           # Modelos OpenDSS compatibles con importación

Los ejemplos .reid pueden abrirse directamente desde OpenREiD.

Los ejemplos DSS incluyen un Master.dss y archivos separados de elementos y librerías. Si se importa un modelo propio, se recomienda mantener una estructura similar. Si el Master.dss contiene instrucciones Redirect, los archivos referenciados deben existir.

---

Notas De Modelado

• Mantener coherencia entre cantidad de fases (phases) y fases de conexión (start_ph, end_ph, etc.).
• Para sistemas fotovoltaicos trifásicos, conectar a nodos y tramos trifásicos compatibles.
• Para cálculo de 24 hs, usar curvas horarias coherentes:
• LoadShape para daily.
• TShape para Tdaily.
• XYCurve para EffCurve.
• Los aparatos de protección pueden operar durante el flujo si el modo de control de OpenDSS lo permite; revisar ajustes de reconectadores, relés y fusibles.
• Los fusibles se guardan en QGIS como open/closed, y OpenREiD exporta Normal/State como arreglos por fase requeridos por OpenDSS.

---

Estructura Del Repositorio Público

├─ releases/        # Paquetes ZIP instalables del plugin
├─ examples/        # Redes .reid y modelos DSS de ejemplo
├─ CHANGELOG.md     # Historial de cambios
├─ LICENSE.md       # Licencia
└─ README.md        # Este archivo

---

Licencia

CC BY-NC-SA 4.0. Ver LICENSE.md.

---

Créditos

• Desarrollador: Dario R. Carestia.
• Director del proyecto OpenREiD: Mauricio E. Samper.
• Co-Director: Gustavo D. Baron.