RainMachine Watering Simulation Log Format Explained

From RainMachine wiki page
Jump to: navigation, search

RainMachine watering simulation log format explained

Watering simulation calculates the expected watering time for each zone in all the programs for 7 days in the future.
Simulation starts when new weather data is received but can be forced by multiple methods:
- Changing Wind/Rain Sensitivity
- Changing a program frequency or enable/disabling program Weather Data
- Running REFRESH ALL from Weather Services in Web Interface

The simulation log, which is available from web application interface -> About -> View Log is always at the bottom of the log file.
It contains multiple blocks of logs like the one below (for each day and program a new block will be logged)

2016-05-26 16:42:06,352 - INFO  - rmSimulator:480 - 
* Program Coefficients (pid=1, fake=False, ignoreInternetWeather=0, day=2016-05-27 00:00:00)
	- pastStart=2016-05-26 00:00:00, futureEnd=2016-05-28 00:00:00, pastMultiplier=1, futureMultiplier=1
	- qpfReal=0.00, qpfUsed=None, qpfEst=0.00, historyQpf=0.00, et0Real=5.02, et0Used=None, et0Est=6.40, historyEt0=6.40
	- et0Avg=6.00, et0Delta=0.00, qpfDelta=0.00, No rain information
	- detailsReal=[et0(m)=5.02, qpf(m)=0.00], detailsHistory=[et0(m)=6.40, qpf(m)=None]
	 zone  lastAW  newAW  chEt0  waterFF  corrPast  water%  newAvWater  waterNeeded  fielCap  cropCoef  zoneType
	    2    0.00   0.00   6.40     5.12      0.00  106.70        0.00         5.12    12.00      0.80      1.00

Log elements

  • pid=1
    Program id that this simulation is for (this value can be obtained from API GET /program call)
  • fake=False
    If this is a user defined program of a fake RainMachine program used for Daily Watering estimations graphs
  • ignoreInternetWeather=0
    If program ignores internet weather 0 means it doesn't ignore it
  • day=2016-05-27 00:00:00
    For what day this simulation is
  • pastStart=2016-05-26 00:00:00
    The last date this program started, for a every 2 days program this will be 2 days in the past
  • futureEnd=2016-05-28 00:00:00
    The end date for program weather data.
    Each program will sum QPF (precipitation) and ET (evapotranspiration) from pastStart to futureEnd
  • pastMultiplier=1
    How many days from pastStart
  • futureMultiplier=1
    How many days till next start. Example: a program that runs: Tuesday Friday Sunday and simulated day is Friday past multiplier is 3 and future multiplier is 2
  • qpfUsed
    The sum of QPF calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start
  • qpfReal
    The sum of QPF calculated for the same interval as above but using the newest available weather data from mixer.
    There might be other weather updates for same day *after* the program has run
  • qpfEst
    The estimated future QPF sum for the interval future start (this simulation day) till futureEnd.
  • historyQpf
    The estimated future QPF sum but missing QPF data is filled from historical data if zone Use historical data is checked. Same interval as above
  • et0Used
    The sum of ET calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start
  • et0Real
    The sum of ET calculated for the same interval as above but using the newest available weather data from mixer.
    There might be other weather updates for same day *after* the program has run
  • et0Est
    The estimated future ET sum for the interval future start (this simulation day) till futureEnd.
  • historyEt0
    The estimated future ET sum but missing ET data is filled from historical data if zone Use historical data is checked. Same interval as above
  • et0Avg
    ET0 Summer 30 days moving Average for a period of 30 years
  • et0Delta
    The difference between et0Used and et0Real only used if Correction for Past is enabled can reduce or increase watering depending if delta < or > 0.
  • qpfDelta
    The difference between qpfUsed and qpfReal only used if Correction for Past is enabled can reduce or increase watering depending if delta < or > 0.
  • No rain information
    Means that no observed/measured Rain was found. If a weather service with personal weather station is enabled the observed amount of rain will appear here.
    This value it's only used when Correction for Past is enabled
  • detailsReal
    QPF and ET detailed for each day that made up the sums for qpfReal and et0Real above.
    If the program is for example every 7 days there will be 7 values here.
  • detailsHistory
    Same as above but missing ET and QPF data replaced with historical data
  • zone
    The zone id for the next values
  • lastAW
    Last Available Water (in soil) for this zone
  • newAW
    New Available Water after this simulation
  • chEt0
    chosen ET0 from the above (historical or real) depending on zone Use Historical or Weather data settings enabled or not
  • waterFF
    Water for Future value in mm from: cropCoef * et0Est - rainSensitivity * qpfEst
  • corrPast
    Correction for Past value in mm
  • water%
    Water for future percentage
  • newAvWater
    Same as newAW
  • waterNeeded
    Determined from waterForFuture + correctionForPast - availableWater
  • fielCap
    The maximum field capacity (depending on zone settings). The available water is restricted to this value if above.
  • cropCoef
    The crop coefficient from zone settings.
  • zoneType
    The zone type from settings for now this determines the value of crop coefficient