FAQ: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
1,173 bytes added ,  11:48, 4 January 2021
(14 intermediate revisions by one other user not shown)
Line 63: Line 63:
{{Version badge 1}}Reminder, this FAQ answer is ONLY for Cumulus 1
{{Version badge 1}}Reminder, this FAQ answer is ONLY for Cumulus 1


As of 2017, development of both Cumulus 1 and Cumulus MX was abandoned by Steve Loft. Although there have been a couple of patches to change the years listed in drop downs with Cumulus 1, its code is frozen as the relevant development environment is no longer available.  
As of 2017, development of Cumulus 1 was stopped by Steve Loft and a new version called Cumulus MX replaced it. Although there have been a couple of patches to change the years listed in drop downs with Cumulus 1, its code is frozen as the relevant development environment is no longer available.  


Consequently, there is no possibility of any new features for Cumulus 1.
Consequently, there is no possibility of any new features for Cumulus 1.
Line 315: Line 315:
Cumulus 1 has the ability to input, log, and display Current Values/Outputs from the [[Rain_measurement#Optical_Rain_Gauges|Hydreon Optical Rain Sensor - Model RG-11]] and from either Oregon Scientific or Davis [[Extra_Sensor_Files|extra sensors]]. Only today's and yesterday's total rainfall from a Hydreon sensor are available in [[today.ini]] and [[yesterday.ini]] respectively.  
Cumulus 1 has the ability to input, log, and display Current Values/Outputs from the [[Rain_measurement#Optical_Rain_Gauges|Hydreon Optical Rain Sensor - Model RG-11]] and from either Oregon Scientific or Davis [[Extra_Sensor_Files|extra sensors]]. Only today's and yesterday's total rainfall from a Hydreon sensor are available in [[today.ini]] and [[yesterday.ini]] respectively.  


For some Oregon Scientific models, the temperature from an extra sensor can replace the temperature from the main sensor for processing by Cumulus 1, but all extra sensor values are stored in a series of [[Extra_Sensor_Files| monthly log]] files.  
For some Oregon Scientific models, the temperature from an extra sensor can replace the temperature from the main sensor for processing by Cumulus 1, but all extra sensor values are stored in a series of [[Extra_Sensor_Files| monthly log]] files for extra sensors.  


No other processing is performed for Davis extra sensors, but past values are retained in a series of [[Extra_Sensor_Files| monthly log]] files.  The file [[strings.ini]] is used to customise the description associated with extra sensors.
No other processing is performed for Davis extra sensors, but past values are retained in a series of [[Extra_Sensor_Files|extra sensor monthly log]] files.  The file [[strings.ini]] is used to customise the description associated with extra sensors.


== What is this "Solar Max" value which Cumulus is displaying? ==
== What is this "Solar Max" value which Cumulus is displaying? ==
Line 358: Line 358:
{{Version badge 1}}Reminder, this FAQ answer is ONLY for Cumulus 1
{{Version badge 1}}Reminder, this FAQ answer is ONLY for Cumulus 1


Cumulus was originally something Steve Loft 'knocked together' quickly when I got my first weather station, simply because I couldn't find any other software anywhere which I was prepared to use. No 'design' went into it, it was really just a prototype. Some of the things I did were just quick 'hacks' that I intended to fix when I did it 'properly'. But I never got around to going back and doing it 'properly', and it was never my intention that anyone else would use it. But I was persuaded to make it available for others, and then to add more and more enhancements.  
''This text is by the author, Steve Loft''
 
Cumulus was originally something I 'knocked together' quickly when I got my first weather station, simply because I couldn't find any other software anywhere which I was prepared to use.  
 
No 'design' went into it, it was really just a prototype. Some of the things I did were just quick 'hacks' that I intended to fix when I did it 'properly'. But I never got around to going back and doing it 'properly', and it was never my intention that anyone else would use it. But I was persuaded to make it available for others, and then to add more and more enhancements.  


The fact that it works with several different types of weather station means that much of it is a compromise; it doesn't use certain features of the weather station which it could use if it were dedicated to that type of weather station. For example, it typically does not use any high/low data that the station might store internally. Instead, it maintains its own high/low data from individual readings. There are a number of reasons for this; the fact that Cumulus supports an 0900-0900 day, and the weather station does not, and the fact that typically Cumulus maintains far more high/low values than the station does, and these need to be self-consistent.  
The fact that it works with several different types of weather station means that much of it is a compromise; it doesn't use certain features of the weather station which it could use if it were dedicated to that type of weather station. For example, it typically does not use any high/low data that the station might store internally. Instead, it maintains its own high/low data from individual readings. There are a number of reasons for this; the fact that Cumulus supports an 0900-0900 day, and the weather station does not, and the fact that typically Cumulus maintains far more high/low values than the station does, and these need to be self-consistent.  


So yes, I am aware that some of things that Cumulus does may seem strange, but it is simply not possible for me to start again from scratch, knowing what I know now. And it is not possible for me to effectively produce separate versions of Cumulus specifically for each type of weather station. If you don't like the way Cumulus does certain things, do what I did and write your own software!
So yes, I am aware that some of things that Cumulus does may seem strange, but it is simply not possible for me to start again from scratch, this is done in my spare time.
 
And it is not possible for me to effectively produce separate versions of Cumulus specifically for each type of weather station. If you don't like the way Cumulus does certain things, do what I did and write your own software!


== Can I run 2 copies of Cumulus 1? ==
== Can I run 2 copies of Cumulus 1? ==
Line 389: Line 395:
== I installed a new version and my web page templates got over-written  ==
== I installed a new version and my web page templates got over-written  ==


{{Version badge 1}}The supplied web page templates are part of Cumulus and will be over-written on upgrade. If you want to create your own web pages, don’t edit the supplied ones, place them in a different folder and use the ‘extra files’ facility. From version 1.8.9, the installer offers the option of not over-writing the web templates; it unconditionally also installs them to a sub-folder of the web folder called 'originals', so you can refer to them if required, even if you chose not to over-write those in the web folder.
{{Version badge 1}}The supplied web page templates are part of Cumulus and will be over-written on upgrade.  
*If you want to create your own web pages, don’t edit the supplied ones, place your templates in a different folder and use the ‘extra files’ facility.  
*From version 1.8.9, the installer offers the option of not over-writing the web templates; it unconditionally also installs them to a sub-folder of the web folder called 'originals', so you can refer to the originals if required, even if you chose the new option not to over-write whatever template files are already being processed in the web folder.


== I can’t find my data files!  ==
== I can’t find my data files!  ==


{{Version badge 1}}You’re probably running Windows Vista/Windows 7/Windows 8 (or one of the corresponding server versions of Windows). Look in C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Cumulus - note that this is a 'hidden' folder. Ideally, to avoid this situation, you would install to somewhere outside the Program Files hierarchy, as recommended in the readme.txt.
{{Version badge 1}}You’re probably running Windows Vista/Windows 7/Windows 8 (or one of the corresponding server versions of Windows). Look in C:\Users\[username]\AppData\Local\VirtualStore\Program Files\Cumulus - note that this is a 'hidden' folder. Ideally, to avoid this situation, you would install to somewhere outside the Program Files hierarchy, as recommended in the '''readme.txt'''.


== I can't save my NOAA reports! ==
== I can't save my NOAA reports! ==


{{Version badge 1}}You've probably corrupted your Cumulus.ini file in the default Cumulus folder. See [[Cumulus.ini#Section:_NOAA]]. It can only be edited either (if Cumulus is stopped) with an external text file editor or (with Cumulus running) using the ''NOAA Setup'' in the configuation menu.  Pay attention to where the quotes are required for the file names, and check that you have an allowed date format (see [[Webtags#Time.2FDate_.27format.27_Parameter]]).
{{Version badge 1}}You've probably corrupted your Cumulus.ini file in the default Cumulus folder. See [[Cumulus.ini#Section:_NOAA]]. It can only be edited either (if Cumulus is stopped) with an external text file editor or (with Cumulus running) using the ''NOAA Setup'' in the configuation menu.  Pay attention to where the quotes are required for the file names, and check that you have an allowed date format (see [[Webtags#The_format_used_for_naming]]).


== My sunrise and sunset times are wrong  ==
== My sunrise and sunset times are wrong  ==


You've almost certainly entered your co-ordinates incorrectly, or not entered them at all - on the station settings screen. You must enter DEGREES, MINUTES, and SECONDS, no other format will work. Make sure to use '''unsigned whole numbers''' for degrees, minutes, and seconds, with a 'W' for your longitude if you're West of the Greenwich meridian (e.g. if you are in the United States), and the appropriate letter for your latitude (N for northern hemisphere, S for southern hemisphere).  
You've almost certainly entered your co-ordinates incorrectly, or not entered them at all - on the station settings screen.  
*You must enter DEGREES, MINUTES, and SECONDS, no other format will work.  
*Make sure to use '''unsigned whole numbers''' for degrees, minutes, and seconds, with a 'W' for your longitude if you're West of the Greenwich meridian (e.g. if you are in the United States), and the appropriate letter for your latitude (N for northern hemisphere, S for southern hemisphere).  


If you are not familiar with the degrees/minutes/seconds standard format and have your co-ordinates in some other format, there are pages on the web which will convert for you. One such is here: http://transition.fcc.gov/mb/audio/bickel/DDDMMSS-decimal.html
If you are not familiar with the degrees/minutes/seconds standard format and have your co-ordinates in some other format, there are pages on the web which will convert for you. One such is here: http://transition.fcc.gov/mb/audio/bickel/DDDMMSS-decimal.html
Line 425: Line 435:
**You can try the same cure, but may not be able to recover the lost information in this case.
**You can try the same cure, but may not be able to recover the lost information in this case.


If you are viewing or editing log files at the time when rollover takes place, it is likely that some parts of the daily rollover will fail.  Although Cumulus 1 provides the functionality to view and (except for the data file) update the log files, make sure you have exited out of the built-in viewer or editor before rollover is due. If you inadvertently forget this, the cure of overwriting files mentioned above is applicable if your weather station has an internal log and it is around 2 logging intervals (see [[#Cumulus_takes_a_long_time_to_download_the_data_from_my_Davis_station_at_start_up]]) after rollover. When using an external editor, close Cumulus 1 or Cumulus MX before opening any Cumulus file.
If you are viewing or editing log files at the time when rollover takes place, it is likely that some parts of the daily rollover will fail.   
*Cumulus 1 provides the functionality to view any log file and you can update the log files that contain extreme records or the daily summary.
*Do make sure you have exited out of the built-in viewer or editor before rollover is due.  
**If you inadvertently forget this, the cure of overwriting files mentioned above is applicable if your weather station has an internal log and it is around 2 logging intervals (see [[#Cumulus_takes_a_long_time_to_download_the_data_from_my_Davis_station_at_start_up]]) after rollover.  
*When using an external editor, close Cumulus 1 or Cumulus MX before opening any Cumulus file.


== Why do I have some unexpected zero figures? ==
== Why do I have some unexpected zero figures? ==
Line 473: Line 487:


== Cumulus read some invalid figures from my station ==
== Cumulus read some invalid figures from my station ==
If you have:
If you have:
*just started using Cumulus,  
*just started using Cumulus,  
Line 479: Line 494:
... check you have the correct station type selected (see the Cumulus ''Help'' for the settings screen).
... check you have the correct station type selected (see the Cumulus ''Help'' for the settings screen).


Choosing the wrong station type means individual items of information are not correctly assigned to weather parameters.  Cumulus knows what is at what location for each station type.  
{{Version badge 1}}Choosing the wrong station type means individual items of information are not correctly assigned to weather parameters.  Cumulus knows what is at what location for each station type.  
*Is the information ''correct on the station console'' (i.e. not a fault with a sensor), but incorrectly displayed on Cumulus screen (i.e. transfer problem)?  
*Is the information ''correct on the station console'' (i.e. not a fault with a sensor), but incorrectly displayed on Cumulus screen (i.e. transfer problem)?  
Check all your settings on Cumulus, or see a [[#Cumulus_can.27t_read_a_data_update_from_my_station|previous question]].
Check all your settings on Cumulus, or see a [[#Cumulus_can.27t_read_a_data_update_from_my_station|previous question]].
Line 485: Line 500:
Over successive versions of Cumulus more and more code has been incorporated to deal with the way some stations are prone to reporting rogue readings.
Over successive versions of Cumulus more and more code has been incorporated to deal with the way some stations are prone to reporting rogue readings.
*Ensure you are using the latest Cumulus build, if you are using an old version you will not have any enhancements made since the earlier build that might improve the way Cumulus reads from your station type.
*Ensure you are using the latest Cumulus build, if you are using an old version you will not have any enhancements made since the earlier build that might improve the way Cumulus reads from your station type.
In general, if Cumulus 1.x.x identifies an odd value it will reuse the last good value instead, assuming that the problem will either right itself, or be spotted and dealt with quickly.
In general, if Cumulus 1.x.x identifies an odd value for up to 6 times, it will reuse the last good value instead. Depending on how frequently Cumulus is able to read from your station, that can represent
up to 5 minutes. That is designed to be long enough for you to spot the problem and deal with it. Sometimes the problem will right itself within that time. After that time, a problem with reading temperature, humidity, wind, or pressure, means Cumulus cannot calculate derived values, the last successful read is considered too stale to reuse, and by default Cumulus will stop any further processing.


'''Fine Offset stations''' are prone to reporting the odd non-sensical value, and Cumulus has the ability to compare successive readings:
'''Fine Offset stations''' are prone to reporting the odd nonsensical value, and Cumulus has the ability to compare successive readings:
*From the '''Configuration''' menu select [[Cumulus_Screenshots#Configuration_Menu_Screens|''Calibration'']] and in the '''Spike removal''' frame you can specify "the maximum '''differences''' between successive values" that Cumulus is to tolerate. See the '''Help''' for that screen, and note that spike removal applies while Cumulus is running, not to catch-up readings from the station's logger.  
*{{Version badge 1}}From the '''Configuration''' menu select [[Cumulus_Screenshots#Configuration_Menu_Screens|''Calibration'']] and in the '''Spike removal''' frame you can specify "the maximum '''differences''' between successive values" that Cumulus is to tolerate.  
*{{Version badge 1}}See the '''Help''' for that screen, and note that '''spike removal applies while Cumulus is running''', it is not applied to catch-up readings from the station's logger.  


'''Possible Cure:'''
'''Possible Cure:'''
The purpose of the backup files is to allow Cumulus to be 'rewound' to a particular point in time.  It simulates the situation where someone had closed Cumulus down at that point, and is only now starting it up again, and needs data to be downloaded from the station's logger to catch up to the present time. Obviously this cure will not work if your station type does not have a logger (one is needed for Cumulus to read old readings again).
The purpose of the backup files is to allow Cumulus to be 'rewound' to a particular point in time.  It simulates the situation where someone had closed Cumulus down at that point, and is only now starting it up again, and needs data to be downloaded from the station's logger to catch up to the present time. Obviously this cure will not work if your station type does not have a logger (one is needed for Cumulus to read old readings again).
*If you have only installed Cumulus a few days ago, or have just re-started Cumulus after it was stopped and encounter multiple ''rogue readings in the catch-up from the station logger''; '''one possibility''' is to stop Cumulus and find the [[#On_restarting_Cumulus.2C_it_did_not_successfully_read_all_data_from_when_it_last_ran|backup files]] that it took when you started it up (or just after the previous roll-over time), copy those files into the data folder, overwriting the ones that are there, then when you start it up again it will rewind back to the time in that back-up, and could sort itself out.
*If you have only installed Cumulus a few days ago, or have just re-started Cumulus after it was stopped and encounter multiple ''rogue readings in the catch-up from the station logger''; '''one possibility''' is to stop Cumulus and find the [[#On_restarting_Cumulus.2C_it_did_not_successfully_read_all_data_from_when_it_last_ran|backup files]] that it took when you started it up (or just after the previous roll-over time), copy those files into the data folder, overwriting the ones that are there, then when you start it up again it will rewind back to the time in that back-up, and could sort itself out.
The [[Diags]] log often contains useful information for sorting out what has been read, which values have been ignored, and which highs or lows may have been updated incorrectly. Note that automatic backups are made just after roll-over time because restarting Cumulus when there are no logger records to read before roll-over has been known to cause problems. Therefore, the backup to choose might be one with the date before when the problem occured, but remember that any calculations Cumulus makes are based on readings at least every minute when Cumulus is running, but for the catch up period such calculations can only use the readings available at your station's logging interval. Note if you choose a later backup and it does not work, you can always then repeat the 'rewind' with a earlier backup.
{{Version badge 1}}The Cumulus 1 [[Diags|Diagnostic]] log often contains useful information for sorting out what has been read, which values have been ignored, and which highs or lows may have been updated incorrectly. Note that automatic backups are made just after roll-over time because restarting Cumulus when there are no logger records to read before roll-over has been known to cause problems. Therefore, the backup to choose might be one with the date before when the problem occurred, but remember that any calculations Cumulus makes are based on readings at least every minute when Cumulus is running, but for the catch up period such calculations can only use the readings available at your station's logging interval. Note if you choose a later backup and it does not work, you can always then repeat the 'rewind' with a earlier backup.


== How to restore a corrupted log file ==
== How to restore a corrupted log file ==
Line 528: Line 545:
Because many positive values are realistic, Cumulus generally will accept those odd increases as a result of accidental knocking of a tipping bucket gauge, due to wind effects on the gauge, or even due to the station electronics generating a rogue reading. The sub-answers below explain how to correct such errors.
Because many positive values are realistic, Cumulus generally will accept those odd increases as a result of accidental knocking of a tipping bucket gauge, due to wind effects on the gauge, or even due to the station electronics generating a rogue reading. The sub-answers below explain how to correct such errors.
=== (Invented rain) Error in today's total ===
=== (Invented rain) Error in today's total ===
Easy - correct today's total using the [[Today.ini#Editing_rainfall_in_today.ini_within_Cumulus | 'today's rain']] editor on the edit menu (select from main screen in Cumulus 1, or find in the MX browser interface).
Easy - correct today's total using the [[Today.ini#Editing_rainfall_in_today.ini_within_Cumulus | 'today's rain']] editor on the edit menu (select from main screen in Cumulus 1, or find in the MX admin interface).


=== (Invented rain) Error in date/time of 'Last Tip' ===
=== (Invented rain) Error in date/time of 'Last Tip' ===
Line 612: Line 629:
If you do this, you will probably need to edit your log files in the '''data''' folder as you may have duplicate entries and/or entries out of order. Your rain totals will almost certainly also be wrong - the total for "today" in particular. See the [[FAQ#My_station_invented_some_rain_that_didn.27t_really_occur.2C_and_I_want_to_set_it_to_zero_.28or_some_other_figure.29 |FAQ]] entry about correcting rainfall data. If you have only just started using Cumulus, you could delete all of the files in the data folder, and just create a simple today.ini as below. Then when you start Cumulus, processing will start again with just the data from the station's logger.
If you do this, you will probably need to edit your log files in the '''data''' folder as you may have duplicate entries and/or entries out of order. Your rain totals will almost certainly also be wrong - the total for "today" in particular. See the [[FAQ#My_station_invented_some_rain_that_didn.27t_really_occur.2C_and_I_want_to_set_it_to_zero_.28or_some_other_figure.29 |FAQ]] entry about correcting rainfall data. If you have only just started using Cumulus, you could delete all of the files in the data folder, and just create a simple today.ini as below. Then when you start Cumulus, processing will start again with just the data from the station's logger.


Note that this method does not work for the Oregon WMR200 station. This station deletes logger entries when they are downloaded, and there is no mechanism for retrieving logger entries for a particular period - it just sends all the entries that it has. You may be able to circumvent this by creating a today.ini file in the data folder before you run Cumulus 1, with just this in it:
Note that this method does not work for the Oregon WMR200 station. This station deletes logger entries when they are downloaded, and there is no mechanism for retrieving logger entries for a particular period - it just sends all the entries that it has. {{Version badge 1}}You may be able to circumvent this by creating a today.ini file in the data folder before you run Cumulus 1, with just this in it:
<pre>
<pre>
[General]
[General]
Line 621: Line 638:
CurrentDay=10
CurrentDay=10
</pre>
</pre>
Note that Cumulus MX stores some time-stamps '''in ISO format''' (yyyy/MM/dd HH:mm:ss) within '[[today.ini]]', the format example above only works for Cumulus 1, see the article on the log file itself for specifics.
Note that Cumulus MX stores some time-stamps '''in ISO format''' (yyyy/MM/dd HH:mm:ss) within '[[today.ini]]', the format example above only works for {{Version badge 1}}Cumulus 1, see the article on the log file itself for specifics.
Change the dates and time to match the point from which you want Cumulus to start downloading data. If the station has already sent the data, this may not work, unfortunately.
Change the dates and time to match the point from which you want Cumulus to start downloading data. If the station has already sent the data, this may not work, unfortunately.


Line 636: Line 653:
{{Version badge 1}}'''Note''' ''StartDate=xxxx'' does ''not'' need to be updated for Cumulus 1 to recognise earlier data in log files in its ''data'' subfolder.   
{{Version badge 1}}'''Note''' ''StartDate=xxxx'' does ''not'' need to be updated for Cumulus 1 to recognise earlier data in log files in its ''data'' subfolder.   


[[File:Badge vMx.png]] However in calculating and updating extremes, Cumulus MX will ignore any monthly log file data prior to the start date set, so it is crucial to make sure the start date is right before you (re-)start MX.
[[File:Badge vMx.png]] However in calculating and updating extremes, '''CumulusMX.exe''' will ignore any standard log file for any month prior to the start date set, so it is crucial to make sure the start date is right before you (re-)start MX. However, if you use '''ExportMySQL.exe monthly''' this will start with January 2000 and process any standard log found for any month after that.


{{Version badge 1}}It really represents "Cumulus began on", so there is an alternative of leaving cumulus.ini unchanged, but editing default Cumulus ''recordsT.htm'' template twice:
{{Version badge 1}}and [[File:Badge vMx.png]]There is one web page template file ''recordT.htm'' that in two places uses this date. If you want to make one of those be the earliest date you  now have for your data and the other one to be when you started using Cumulus; there is an alternative of leaving '''Cumulus.ini''' unchanged, but editing the ''recordT.htm'' template twice:
*after the h2 heading is ''&lt;p&gt;Records began on <#recordsbegandate>. Here are the extremes recorded since then.&lt;/p&gt;'';  you can replace '<#recordsbegandate>' with the new earliest date typed in as text; and
*after the h2 heading is ''&lt;p&gt;Records began on <#recordsbegandate>. Here are the extremes recorded since then.&lt;/p&gt;'';  you can replace '<#recordsbegandate>' with the new earliest date typed in as text; and
*at the start of the table is the ''&lt;caption&gt;Records Since <#recordsbegandate>&lt;/caption&gt;''; replace the label "Records since" with "Cumulus began on" leaving the web tag unchanged.
*at the start of the table is the ''&lt;caption&gt;Records Since <#recordsbegandate>&lt;/caption&gt;''; replace the label "Records since" with "Cumulus began on" leaving the web tag unchanged.

Navigation menu