Python API Reference

import sys
sys.path.append(r"C:\Program Files\DIgSILENT\PowerFactory 2021\Python\3.8")
import powerfactory

try:
    app = powerfactory.GetApplicationExt()
    # ... cálculos ...
except powerfactory.ExitError as error:
    print(f"Error código: {error.code}")

ow = app.GetOutputWindow()
ow.Print(powerfactory.OutputWindow.MessageType.Info, "Hello World!")
# Guardar log
ow.Save(r"C:\logs\output.html")

import sys
sys.path.append(r"C:\Program Files\DIgSILENT\PowerFactory 2021\Python\3.8")
import powerfactory

app = powerfactory.GetApplication()
app.EchoOff()

app.ActivateProject("Mi_Proyecto")

# Obtener todos los terminales relevantes
terms = app.GetCalcRelevantObjects("*.ElmTerm")
for t in terms:
    uknom = t.GetAttribute("uknom")
    app.PrintInfo(f"{t.GetFullName()} → {uknom} kV")

app.EchoOn()

ldf = app.GetFromStudyCase("ComLdf")
ldf.iopt_net = 0   # 0=AC, 1=DC
ierr = ldf.Execute()
if ierr == 0:
    app.PrintInfo("✓ Flujo de potencia exitoso")
else:
    app.PrintError("✗ Error en flujo de potencia")

res = app.GetFromStudyCase("ElmRes")
res.Load()

gen = app.GetCalcRelevantObjects("Gen1.ElmSym")[0]
col_p = res.FindColumn(gen, "s:P1")  # columna de potencia activa
col_t = res.FindColumn(res, "b:tnow")  # columna de tiempo

nrows = res.GetNumberOfRows()
for row in range(nrows):
    t = res.GetObjectValue(row, col_t)
    p = res.GetObjectValue(row, col_p)
    print(f"t={t:.3f}s  P={p:.4f}MW")

res.Release()

# Aumentar carga 10% con caché habilitada (más rápido)
app.SetWriteCacheEnabled(1)

for load in app.GetCalcRelevantObjects("*.ElmLod"):
    p_actual = load.GetAttribute("plini")
    load.SetAttribute("plini", p_actual * 1.10)

app.WriteChangesToDb()
app.SetWriteCacheEnabled(0)

shc = app.GetFromStudyCase("ComShc")
shc.iopt_mde = 0   # VDE 0102
shc.iopt_shc = 0   # 3-fase
shc.Execute()

if app.IsShcValid():
    for bus in app.GetCalcRelevantObjects("*.ElmTerm"):
        ikss = bus.GetAttribute("m:Ikss")  # corriente de cc en kA
        app.PrintInfo(f"{bus.loc_name}: Ikss = {ikss:.3f} kA")

# 1. Flujo de potencia inicial
ldf = app.GetFromStudyCase("ComLdf")
ldf.Execute()

# 2. Condiciones iniciales
inc = app.GetFromStudyCase("ComInc")
inc.Execute()

# 3. Simulación
sim = app.GetFromStudyCase("ComSim")
sim.tstop  = 10.0   # [s]
sim.dtgrd  = 0.01   # paso de integración [s]
sim.iopt_sim = 0   # 0=RMS, 1=EMT
sim.Execute()

app.PrintInfo("Simulación completada.")

folder = app.GetProjectFolder("netdat")
mat = folder.CreateObject("IntMat", "MiMatriz")
mat.SetAttributeShape("val", 3, 3)
mat.SetAttribute("val", [[1,0,0],[0,2,0],[0,0,3]])
val = mat.GetAttribute("val")  # retorna lista 2D