Today.ini: Difference between revisions
m (→Example yesterday.ini: adding cross-reference for RG-11 sensor) |
m (→Introduction: Add writing on closedown) |
||
Line 2: | Line 2: | ||
The files '''today.ini''' and '''yesterday.ini''' are used by Cumulus to store the Highs and Lows (and their timestamps) for key parameters as reached on each of the two days. These files are normally located in the Data sub-folder of the path where your Cumulus.exe is installed. See [[FAQ#I_can.E2.80.99t_find_my_data_files.21| FAQ on location of data log files]] for where else to look. |
The files '''today.ini''' and '''yesterday.ini''' are used by Cumulus to store the Highs and Lows (and their timestamps) for key parameters as reached on each of the two days. These files are normally located in the Data sub-folder of the path where your Cumulus.exe is installed. See [[FAQ#I_can.E2.80.99t_find_my_data_files.21| FAQ on location of data log files]] for where else to look. |
||
At the end of a day [either midnight, or 9am (or 10am) depending on your configuration and season], the today.ini file |
The highs and lows are held in memory while Cumulus is running. At the end of a day [either midnight, or 9am (or 10am) depending on your configuration and season], the final values and timestamps written to today.ini file are rolled-over to become values and timestamps in yesterday.ini; and a new today.ini is created. From the examples below you can see that the two files have a few differences in content, so rolling-over does involve a little editing work. |
||
If you close down and restart Cumulus during the day it will read these files at startup, so it can resume tracking extremes of the key parameters. |
|||
If you restart Cumulus during the day it will read both these files at startup, so it can resume tracking extremes of the key parameters starting from latest stored values in today.ini. Equally, if you close Cumulus during the day it will write the final values for highs and lows and their timestamps to today.ini as part of the close down process. |
|||
== Dealing with rogue values == |
== Dealing with rogue values == |
Revision as of 08:00, 27 August 2013
Introduction
The files today.ini and yesterday.ini are used by Cumulus to store the Highs and Lows (and their timestamps) for key parameters as reached on each of the two days. These files are normally located in the Data sub-folder of the path where your Cumulus.exe is installed. See FAQ on location of data log files for where else to look.
The highs and lows are held in memory while Cumulus is running. At the end of a day [either midnight, or 9am (or 10am) depending on your configuration and season], the final values and timestamps written to today.ini file are rolled-over to become values and timestamps in yesterday.ini; and a new today.ini is created. From the examples below you can see that the two files have a few differences in content, so rolling-over does involve a little editing work.
If you restart Cumulus during the day it will read both these files at startup, so it can resume tracking extremes of the key parameters starting from latest stored values in today.ini. Equally, if you close Cumulus during the day it will write the final values for highs and lows and their timestamps to today.ini as part of the close down process.
Dealing with rogue values
The today file is written to throughout the current day as any new High or Low for the day at reached. If your weather station reports a rogue value, an incorrect update to the High or Low may result, but details of that update should be in the Diags, so look there to see what correction will be required to eliminate the rogue value. Normally you would not need to edit today.ini, however rarely you may wish to edit the rain data if there has been a quirk in your weather station reporting during the day and the figure is abnormally inflated. The stored rainfall today value in today.ini may be edited within Cumulus via Today's rain screen on the Edit menu. This does not affect any false derived rainfall values for the month or year. Note: If you do decide to edit today.ini outside Cumulus, you must close Cumulus down first!
If the rogue value is not rainfall, then you might need to edit today.ini or yesterday.ini using an external editor. Note: If you do edit either of these files, you must close Cumulus down first! The files are text files, so edit using any plain text editor. The format consists of a number of sections (section title is delimited by []), and a number of properties (consisting of attrbute name, an equals sign and a value). Blank lines can be included for readability, they are ignored in these .ini type log files. All values have to be specified in the correct format, see example below.
Example today.ini file
[General] Date=29/04/2011 Timestamp=29/04/2011 11:50:00 [Wind] Speed=10.7008972167969 SpTime=10:09 Gust=22.0114517211914 Time=08:42 Bearing=90 Direction=E Windrun=63.1526298522949 DominantWindBearing=317 DominantWindBearingMinutes=1041 DominantWindBearingX=-3914.11743164063 DominantWindBearingY=4215.82763671875 [Temp] Low=8.30000019073486 LTime=01:16 High=16.8999996185303 HTime=11:41 Total=7500.697265625 Samples=714 ChillHours=1.64999914169312 HeatingDegreeDays=5.34738397598267 CoolingDegreeDays=0 [Pressure] Low=1014.89996337891 LTime=11:13 High=1018.79998779297 HTime=00:06 [Rain] High=0 HTime=00:00 Start=1923.59997558594 Yesterday=0 LastTip=2011-04-22 22:08 HourlyHigh=0 HHourlyTime=00:00 ConsecutiveRainDays=2 ConsecutiveDryDays=0 [ET] Annual=0 Startofday=0 [Humidity] Low=65 High=88 LTime=11:45 HTime=06:06 [Solar] SunshineHours=0 SunshineHoursToMidnight=0 [HeatIndex] High=16.8999996185303 HTime=11:41 [AppTemp] Low=5.0417857170105 LTime=01:30 High=15.0359125137329 HTime=11:52 [WindChill] Low=6.39816427230835 LTime=01:30 [Dewpoint] Low=5.30104923248291 LTime=00:52 High=10.7219848632813 HTime=11:38 [NOAA] LatestMonthlyReport= LatestYearlyReport=
Example yesterday.ini
See Average_temperature for one key transformation between today.ini and yesterday.ini, no ET parameters are retained, plus there are some wind and some rain parameters not copied from today.ini to yesterday.ini.
NOTE: Yesterday's total rainfall from weather station is stored in today.ini, but yesterday's total rainfall from RG-11 sensor is stored in yesterday.ini.
[General] Date=28/04/2011 [Wind] Speed=7.2 SpTime=09:00 Gust=15.9 Time=12:15 Bearing=315 Direction=NW Windrun=35.3391151428223 DominantWindBearing=230 [Temp] Low=5.6 LTime=05:34 High=21.0 HTime=14:46 HeatingDegreeDays=3.76118206977844 CoolingDegreeDays=0.702986478805542 AvgTemp=12.4447975158691 [Pressure] Low=29.72 LTime=09:00 High=29.85 HTime=22:12 [Rain] High=1.2 HTime=00:34 HourlyHigh=0.899999976158142 HHourlyTime=02:04 RG11Yesterday=0 [Humidity] Low=49 High=99 LTime=14:34 HTime=00:34 [Solar] SunshineHours=0 HighSolarRad=0 HighSolarRadTime=09:00 HighUV=0 HighUVTime=09:00 [HeatIndex] High=21 HTime=14:46 [AppTemp] Low=3.98110413551331 LTime=05:34 High=21.0052318572998 HTime=15:50 [WindChill] Low=5.59999990463257 LTime=05:34 [Dewpoint] Low=5.4555492401123 LTime=05:34 High=11.6547174453735 HTime=09:03
Cross-references for explanations of key parameters
Bearing and Direction, Windrun;
Temp, Total and Samples, Humidity, Heating degree days, Cooling degree days, AppTemp, Heat index, wind chill, Chill hours, Dewpoint;
Rain, ConsecutiveRainDays, ConsecutiveDryDays;
NOAA.