Simulation Inputs

The power simulation is based on four main inputs: * Time * Irradiance (either commanded or played from csv file that's internal to the software) * Grid voltage and frequency (either commanded or played from csv file) * Nameplate data (either from a json file or the internal operations for a PV system or BESS)

Time

The time is set in the simulator is configured with the following parameters: 

  -wc, --wall_clock WALL_CLOCK
                        Use real world time as simulation time
  -wc_tz, --wall_clock_timezone WALL_CLOCK_TIMEZONE
                        A ZoneInfo string for the timezone
  -start_clock_time, --start-clock-time START_CLOCK_TIME
                        Specify the start time for the simulation clock in HH:MM:SS format (e.g., 14:30:00).

The time can also be manipulated in the 30004 SunSpec Modbus model.

Irradiance

The irradiance can be set in the simulator with the 30004 SunSpec Modbus model or with the internal csv file.

Grid Voltage and Frequency

The grid voltage and frequency are either set statically using the 30004 SunSpec Modbus model or dynamically using the internal csv file.

Nameplate Data

The nameplate data is configured using a json file or using one of the default DER types:

  • PV, which is the same as PV-3Phase
  • PV-2Phase
  • PV-1Phase
  • Batt, which is the same as Batt-3Phase
  • Batt-2Phase
  • Batt-1Phase

The following parameters from the json file are used to dynamically configure the simulation:

  • 1.DA - Sets the device address for the simulator
  • 701.ACType - Sets the AC type for the simulator
  • 701.TotWhInjL1 - Sets the total initial energy injected into the grid for phase 1
  • 701.TotWhInjL2 - Sets the total initial energy injected into the grid for phase 2
  • 701.TotWhInjL3 - Sets the total initial energy injected into the grid for phase 3
  • 701.TotWhAbsL1 - Sets the total initial energy absorbed from the grid for phase 1
  • 701.TotWhAbsL2 - Sets the total initial energy absorbed from the grid for phase 2
  • 701.TotWhAbsL3 - Sets the total initial energy absorbed from the grid for phase 3
  • 701.TotVarhInjL1 - Sets the total initial reactive energy injected into the grid for phase 1
  • 701.TotVarhInjL2 - Sets the total initial reactive energy injected into the grid for phase 2
  • 701.TotVarhInjL3 - Sets the total initial reactive energy injected into the grid for phase 3
  • 701.TotVarhAbsL1 - Sets the total initial reactive energy absorbed from the grid for phase 1
  • 701.TotVarhAbsL2 - Sets the total initial reactive energy absorbed from the grid for phase 2
  • 701.TotVarhAbsL3 - Sets the total initial reactive energy absorbed from the grid for phase 3
  • 701.W - Initial simulation power measurement
  • 701.VA - Initial simulation apparent power measurement
  • 701.Var - Initial simulation reactive power measurement
  • 701.PF - Initial simulation power factor measurement
  • 701.A - Initial simulation current measurement
  • 701.LLV - Initial simulation low line voltage measurement
  • 701.LNV - Initial simulation nominal line voltage measurement
  • 701.Hz - Initial simulation frequency measurement
  • 701.TmpAmb - Initial simulation ambient temperature measurement
  • 701.TmpCab - Initial simulation cabinet temperature measurement
  • 701.TmpSnk - Initial simulation heat sink temperature measurement
  • 701.TmpTrns - Initial simulation transformer temperature measurement
  • 701.TmpSw - Initial simulation IGBT/MOSFET temperature measurement
  • 701.TmpOt - Initial simulation other temperature measurement
  • 701.ThrotPct - Initial simulation throttle percentage measurement
  • 701.ThrotSrc - Initial simulation throttle source measurement
  • 702.WMaxRtg - Sets the maximum power rating for the simulator
  • 702.WOvrExtRtg - Sets the maximum power rating for the simulator when over-excited
  • 702.WOvrExtRtgPF - Sets the power factor for the simulator when over-excited
  • 702.WUndExtRtg - Sets the maximum power rating for the simulator when under-excited
  • 702.WUndExtRtgPF - Sets the power factor for the simulator when under-excited
  • 702.VAMaxRtg - Sets the maximum apparent power rating for the simulator
  • 702.VarMaxInjRtg - Sets the maximum reactive power rating for the simulator
  • 702.VarMaxAbsRtg - Sets the maximum reactive power rating for the simulator
  • 702.WChaRteMaxRtg - Sets the maximum charging power rating for the simulator
  • 702.WDisChaRteMaxRtg - Sets the maximum discharging power rating for the simulator
  • 702.VAChaRteMaxRtg - Sets the maximum charging apparent power rating for the simulator
  • 702.VADisChaRteMaxRtg - Sets the maximum discharging apparent power rating for the simulator
  • 702.VNomRtg - Sets the nominal voltage rating for the simulator
  • 702.VMaxRtg - Sets the maximum voltage rating for the simulator
  • 702.VMinRtg - Sets the minimum voltage rating for the simulator
  • 702.AMaxRtg - Sets the maximum current rating for the simulator
  • 702.PFOvrExtRtg - Sets the power factor rating for the simulator when over-excited
  • 702.PFUndExtRtg - Sets the power factor rating for the simulator when under-excited
  • 702.ReactSusceptRtg - Sets the reactive power rating for the simulator
  • 702.NorOpCatRtg - Sets the normal operating category rating for the simulator
  • 702.AbnOpCatRtg - Sets the abnormal operating category rating for the simulator
  • 702.WMax - Sets the maximum power setting for the simulator
  • 702.WMaxOvrExt - Sets the maximum power setting for the simulator when over-excited
  • 702.WOvrExtPF - Sets the power factor limit setting for the simulator when over-excited
  • 702.WMaxUndExt - Sets the maximum power limit rating for the simulator when under-excited
  • 702.WUndExtPF - Sets the power factor setting for the simulator when under-excited
  • 702.VAMax - Sets the maximum apparent power setting for the simulator
  • 702.VarMaxInj - Sets the maximum reactive power setting for the simulator
  • 702.VarMaxAbs - Sets the maximum reactive power setting for the simulator
  • 702.WChaRteMax - Sets the maximum charging power setting for the simulator
  • 702.WDisChaRteMax - Sets the maximum discharging power setting for the simulator
  • 702.VAChaRteMax - Sets the maximum charging apparent power setting for the simulator
  • 702.VADisChaRteMax - Sets the maximum discharging apparent power setting for the simulator
  • 702.VNom - Sets the nominal voltage setting for the simulator
  • 702.VMax - Sets the maximum voltage setting for the simulator
  • 702.VMin - Sets the minimum voltage setting for the simulator
  • 702.AMax - Sets the maximum current setting for the simulator
  • 702.PFOvrExt - Sets the power factor setting for the simulator when over-excited
  • 702.PFUndExt - Sets the power factor setting for the simulator when under-excited
  • 702.IntIslandCat - Sets the internal islanding category for the simulator
  • 714.Prt[0].DCW
    • If 714.Prt[0].PrtTyp == 0, DCW is used to create the I-V curves, this is the Pmp for the EN50530 curve
    • If 714.Prt[0].PrtTyp == 1, DCW sets the battery power capacity
  • 714.Prt[0].DCV
    • If 714.Prt[0].PrtTyp == 0, DCV is used to create the I-V curves, this is the Vmp for the EN50530 curve
    • If 714.Prt[0].PrtTyp == 1, DCV is the battery voltage
  • 713.WHRtg - Sets the battery energy capacity
  • 713.SoC - Sets the State of Charge for the battery
  • 802.SoC - Sets the State of Charge for the battery (priority over 713)
  • 802.VMax - Sets the maximum voltage for the battery where bulk is 95% and float is 90%