5,838
edits
Monthly log files: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
Expanding 'Correcting any data problems' based on experience with importing from EasyWeather
(Expanding 'Correcting any data problems' based on experience with importing from EasyWeather) |
|||
|
Files are automatically created with names in the form <Month><Year>log.txt (for example, the file for August 2009 is called <tt>Aug09log.txt</tt>); an entry is made to the current month's file every ''ten'' minutes (default value; you can change this on the station settings screen), recording the current sensor values. The file is in comma-separated format with one line per entry.
For more information on these files see in the Cumulus help file, in the section “Data log file format”.
==Correcting any data problems==
See [[FAQ#I.E2.80.99ve_just_installed_Cumulus.2C_and_it_didn.E2.80.99t_download_all_the_old_data_from_my_weather_station]], [[FAQ#How_do_I_correct_my_all-time_.28or_monthly.29_records.3F]] and [[FAQ#I_can.E2.80.99t_find_my_data_files.21]].
After you have edited any Monthly log files, you can:
* update the [[Alltime.ini]] by choosing ''all time records'' from the '''Edit''' menu. This is a text editor, and works best when at full screen. Click the ''Help'' button for detailed instructions.
* (if the monthly log relates to the current year) update the [[year.ini]] by choosing ''This year's records'' from the '''Edit''' menu. This is a text editor, and works best when at full screen. Click the ''Help'' button for detailed instructions.
* (from version 1.9.3) update the [[monthlyalltime.ini]] by choosing ''all time records'' from the '''Edit''' menu. This is a text editor, and works best when at full screen. Click the ''Help'' button for detailed instructions.
* create the relevant monthly and/or annual NOAA style report by choosing ''NOAA Monthly Report'' or ''NOAA Annual Report'' from the '''View''' menu, then select the required period using the selectors, click the ''Update Display'' button to see various statistics calculated from processing the monthly log files, and finally press ''Save'' button to store the new or amended report.
===Editing in Cumulus===
Only the current month's file can be edited from within Cumulus, choose ''This month's records'' from the '''Edit''' menu. This is a text editor, and works best when at full screen. Click the ''Help'' button for detailed instructions.
In the Cumulus '''View''' menu, choose ''This month'' or choose ''This period'' and then select the required period using the selectors to see various statistics calculated from processing the monthly log files.
===Manipulation outside Cumulus===
Any log files for previous months can be edited with Cumulus running, unless you are trying to view them!
Tip -- take a copy of the file before you work on it outside Cumulus (perhaps call it <Month><Year>log.csv).
Edit the file using an editor that treats all fields as text (a text editor or a spreadsheet program that can be instructed ''not'' to recognise special field (like date) types). See
Each line must contain the fields in correct sequence (i.e. nulls ',,' are not allowed in the line, but since new builds add to number of fields, Cumulus can accept lines without the more recent fields at the end).
'''Important''': The date format uses two digits for the year. Do not edit this file using Excel or similar, as it is likely to change the dates to have four figure years, and then Cumulus will no longer be able to use the file.
Times in these files are in the form hh:mm using the 24 hour clock and local time (system time). Note that the fields related to solar data will only contain valid data if your station has the appropriate sensor(s).▼
Apart from bearings (stored as integers), most value fields are in format x.y using your system decimal notation. See [[Monthly_log_files#Example_lines_from_the_file]].
===Importing pre-Cumulus data===
Given that monthly log files are used as input for updating the all-time, monthly (from version 1.9.3), and this year record extremes, and for creating NOAA style reports, you may have some information for a period before you fist starting using Cumulus.
There are some postings in the support Forum about importing past data, and it is too wide a subject to cover here.
Essentially match the fields listed in [[Monthly_log_files#List_of_fields_in_the_file]] below with the fields you have available in your source.
There are some issues to consider. For example, wind directions might be reported as cardinal points (north, south etc) and need converting to bearings in degrees (spreadsheet packages provide ''look up'' functionality to do such conversions), and dates and times might need some pre-processing (spreadsheet packages usually have ability to select part of a text string and to cocatenate a number of strings) to convert them to text in the formats mentioned above. Cumulus has various wind speed, temperature, and rainfall related fields, not directly available from for example ''EasyWeather'' outputs. See [[FAQ#What_do_the_various_wind_speeds_in_Cumulus_correspond_to.2C_with_Fine_Offset_stations.3F]] and other answers in the FAQ to pursue this.
==Format of the file==▼
The date that Cumulus first started operating, does ''not'' need to be updated, for Cumulus to recognise earlier monthly log files in its ''data'' subfolder. However, the web tag associated with that date is on the default Cumulus ''recordsT.htm'' template, and you might want to amend the associated label wording to indicate it is the date that full Cumulus parameter logging/calculation began, rather than the date the station began operating. If you do want to edit the start date, you can edit the ''StartDate='' line in cumulus.ini with Cumulus stopped.
* 00: Date in the form dd/mm/yy
* 13: Inside humidity
* 14: Current gust (i.e. 'Latest')
* 15:
* 16: [[Heat
* 17: UV Index
* 18: Solar Radiation
Added in 1.9.1:
* 19: Evapotranspiration
* 20: Annual Evapotranspiration
* 21: [[Apparent temperature]]
* 22: Current theoretical max solar radiation
* 23: Hours of sunshine so far today
Added in 1.9.2:
* 24: Current Wind bearing
Added in 1.9.3 beta:
* 25: RG-11 rain today
▲Times in these files are in the form hh:mm using the 24 hour clock and local time (system time). Note that the fields related to solar data will only contain valid data if your station has the appropriate sensor(s).
==Example
An extract of a few lines of the file (v.1.9.0)
Here the field delimiter is a semicolon ,the decimal separator is a comma, and the date separator a dash.
30-09-10;19:00;16,4;94;15,4;5,2;13,3;17;3,6;21,0;995,3;47,7;25,6;62;6,1;16,4;16,4;0,0;0
30-09-10;19:15;16,4;94;15,4;5,6;11,2;12;18,0;24,0;995,0;50,7;25,6;62;7,2;16,4;16,4;0,0;0
30-09-10;22:30;14,9;94;13,9;17,6;31,7;3;3,6;63,3;990,6;90,0;25,8;59;19,4;13,7;14,9;0,0;0
this is an example of a file from 1.9.1
Here using UK settings the field delimiter is a comma, the decimal separator is a full stop, and the date separator a slash.
22/04/11,10:25,8.1,96,7.5,13,20,138,0.0,0.0,1013.24,215.2,20.3,53,17,4.8,8.1,0.0,197,0.08,171.88,3.4,663,0.0
| |||
