How can we help?

  1. RainMachine
  2. Developers

Sections

Developers

Follow

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

Related articles

Comments

0 comments

Please sign in to leave a comment.