GridCal file format

General

The GridCal file is a simple excel file (.xls or .xlsx) Different tabs contain the diferent types of information

• Conf: Configuration variables
• Bus: Buses information
• Gen: Generators information
• Branch: Branches information
• Lprof: Load active power profile
• LprofQ: Load reactive power profile
• Gprof: Generators active power profile

The ordering of the tabs is not essential, neither is the casing of the tab names.

Overall the format of the tabs Bus, Gen and Branch is the same as the one you encounter in MatPower.

Another thing to note is that the bus numbering starts in zero as Python is Zero-based. When a MatPower file is imported into GridCal the indexing is correctly converted from one base to zero base.

Configuration variables

Buses information

• bus_i
• type
• Pd
• Qd
• Gs
• Bs
• area
• Vm
• Va
• baseKV
• zone
• Vmax
• Vmin
• LaM_P
• LaM_Q
• Mu_Vmax
• Mu_Vmin
• Bus_X
• Bus_Y
• Collapsed

Generators information

• bus
• Pg
• Qg
• Qmax
• Qmin
• Vg
• mBase
• status
• Pmax
• Pmin
• Pc1
• Pc2
• Qc1min
• Qc1max
• Qc2min
• Qc2max
• ramp_agc
• ramp_10
• ramp_30
• ramp_q
• apf
• MU_PMAX
• MU_PMIN
• MU_QMAX
• MU_QMIN

Branches Information

• fbus
• tbus
• r
• x
• b
• rateA
• rateB
• rateC
• ratio
• angle
• status
• angmin
• angmax
• Pf
• Qf
• Pt
• Qt
• Mu_Sf
• Mu_St
• Mu_AngMin
• Mu_AngMax
• Current
• Loading
• Losses
• Original_index

Load profiles: Active power

Loads profiles: Reactive power

Generators profiles: Active power