Difference between revisions of "RainMachine Watering Simulation Log Format Explained"

From RainMachine wiki page
Jump to: navigation, search
(Created page with "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 c...")
 
m
 
Line 1: Line 1:
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  
+
<h1>RainMachine watering simulation log format explained</h1>
be forced by multiple methods:<br>
+
 
 +
Watering simulation calculates the expected watering time for each zone in all the programs for 7 days in the future.<br>
 +
Simulation starts when new weather data is received but can be forced by multiple methods:<br>
 
- Changing Wind/Rain Sensitivity<br>
 
- Changing Wind/Rain Sensitivity<br>
 
- Changing a program frequency or enable/disabling program Weather Data<br>
 
- Changing a program frequency or enable/disabling program Weather Data<br>
 
- Running REFRESH ALL from Weather Services in Web Interface<br>
 
- Running REFRESH ALL from Weather Services in Web Interface<br>
  
The simulation log, which is available from Web Interface -> About->View Logs is always at the bottom of the log file. It contains
+
The simulation log, which is available from web application interface -> '''About''' -> '''View Log''' is always at the bottom of the log file.<br>
multiple blocks of logs like the one below, for each days and programs a new block will be logged)
+
It contains multiple blocks of logs like the one below (for each day and program a new block will be logged)
  
 
<pre>
 
<pre>
Line 19: Line 21:
 
</pre>
 
</pre>
  
- pid=1 - Program id that this simulation is for (this value can be obtained from API GET /program call) <br>
+
<h2>Log elements</h2>
- fake=False - If this is a user defined program of a fake RainMachine program used for Daily Watering estimations graphs<br>
+
<div style="color:#555;">
- ignoreInternetWeather=0 - If program ignores internet weather 0 means it doesn't ignore it<br>
+
*<code>pid=1</code><br>Program id that this simulation is for (this value can be obtained from API GET /program call) <br>
- day=2016-05-27 00:00:00 - For what day this simulation is <br>
+
*<code>fake=False</code><br>If this is a user defined program of a fake RainMachine program used for Daily Watering estimations graphs<br>
- 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<br>
+
*<code>ignoreInternetWeather=0</code><br>If program ignores internet weather 0 means it doesn't ignore it<br>
- 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<br>
+
*<code>day=2016-05-27 00:00:00</code><br>For what day this simulation is <br>
- pastMultiplier=1 - How many days from pastStart <br>
+
*<code>pastStart=2016-05-26 00:00:00</code><br>The last date this program started, for a every 2 days program this will be 2 days in the past<br>
- 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<br>
+
*<code>futureEnd=2016-05-28 00:00:00</code><br>The end date for program weather data.<br>Each program will sum QPF (precipitation) and ET (evapotranspiration) from pastStart to futureEnd<br>
- qpfUsed - The sum of QPF calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start <br>
+
*<code>pastMultiplier=1</code><br>How many days from pastStart <br>
- 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  <br>
+
*<code>futureMultiplier=1</code><br>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<br>
- qpfEst - The estimated future QPF sum for the interval future start (this simulation day) till futureEnd.<br>
+
*<code>qpfUsed</code><br>The sum of QPF calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start <br>
- 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<br>
+
*<code>qpfReal</code><br>The sum of QPF calculated for the same interval as above but using the newest available weather data from mixer.<br>There might be other weather updates for same day *after* the program has run  <br>
 +
*<code>qpfEst</code><br>The estimated future QPF sum for the interval future start (this simulation day) till futureEnd.<br>
 +
*<code>historyQpf</code><br>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<br>
  
- et0Used - The sum of ET calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start <br>
+
*<code>et0Used</code><br>The sum of ET calculated and *used* last time this program has ran the interval is Past Start - Day Before Future Start <br>
- 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  <br>
+
*<code>et0Real</code><br>The sum of ET calculated for the same interval as above but using the newest available weather data from mixer.<br>There might be other weather updates for same day *after* the program has run  <br>
- et0Est - The estimated future ET sum for the interval future start (this simulation day) till futureEnd.<br>
+
*<code>et0Est</code><br>The estimated future ET sum for the interval future start (this simulation day) till futureEnd.<br>
- 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<br>
+
*<code>historyEt0</code><br>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<br>
- et0Avg - ET0 Summer 30 days moving Average for a period of 30 years<br>
+
*<code>et0Avg</code><br>ET0 Summer 30 days moving Average for a period of 30 years<br>
- 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.<br>
+
*<code>et0Delta</code><br>The difference between et0Used and et0Real only used if Correction for Past is enabled can reduce or increase watering depending if delta < or > 0.<br>
- 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.<br>
+
*<code>qpfDelta</code><br>The difference between qpfUsed and qpfReal only used if Correction for Past is enabled can reduce or increase watering depending if delta < or > 0.<br>
- 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
+
*<code>No rain information</code><br>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.<br>This value it's only used when '''Correction for Past''' is enabled<br>
it's only used when Correction for Past is enabled<br>
+
*<code>detailsReal</code><br>QPF and ET detailed for each day that made up the sums for qpfReal and et0Real above.<br>If the program is for example every 7 days there will be 7 values here.<br>
- 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.<br>
+
*<code>detailsHistory</code><br>Same as above but missing ET and QPF data replaced with historical data<br>
- detailsHistory - Same as above but missing ET and QPF data replaced with historical data<br>
+
*<code>zone</code><br>The zone id for the next values<br>
- zone - The zone id for the next values<br>
+
*<code>lastAW</code><br>Last Available Water (in soil) for this zone <br>
- lastAW - Last Available Water (in soil) for this zone <br>
+
*<code>newAW</code><br>New Available Water after this simulation<br>
- newAW - New Available Water after this simulation<br>
+
*<code>chEt0</code><br>chosen ET0 from the above (historical or real) depending on zone Use Historical or Weather data settings enabled or not<br>
- chEt0 - chosen ET0 from the above (historical or real) depending on zone Use Historical or Weather data settings enabled or not<br>
+
*<code>waterFF</code><br>Water for Future value in mm from: cropCoef * et0Est - rainSensitivity * qpfEst<br>
- waterFF - Water for Future value in mm from: cropCoef * et0Est - rainSensitivity * qpfEst<br>
+
*<code>corrPast</code><br>Correction for Past value in mm<br>
- corrPast - Correction for Past value in mm<br>
+
*<code>water%</code><br>Water for future percentage<br>
- water% - Water for future percentage<br>
+
*<code>newAvWater</code><br>Same as newAW<br>
- newAvWater - Same as newAW<br>
+
*<code>waterNeeded</code><br>Determined from waterForFuture + correctionForPast - availableWater <br>
- waterNeeded - Determined from waterForFuture + correctionForPast - availableWater <br>
+
*<code>fielCap</code><br>The maximum field capacity (depending on zone settings). The available water is restricted to this value if above.<br>
- fielCap - The maximum field capacity (depending on zone settings). The available water is restricted to this value if above.<br>
+
*<code>cropCoef</code><br>The crop coefficient from zone settings.<br>
- cropCoef - The crop coefficient from zone settings.<br>
+
*<code>zoneType</code><br>The zone type from settings for now this determines the value of crop coefficient<br>
- zoneType - The zone type from settings for now this determines the value of crop coefficient<br>
+
</div>

Latest revision as of 00:27, 27 May 2016

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