5,838
edits
Cumulus.ini (preserving history): Difference between revisions
Cumulus.ini (preserving history) (view source)
Revision as of 13:03, 15 September 2014
, 13:03, 15 September 2014→Introduced for problems with Fine Offset family:: spike removal - added text from forum/viewtopic.php?f=13&t=12451
m (→Section: Station: add 'FCPressureThreshold=0.1') |
m (→Introduced for problems with Fine Offset family:: spike removal - added text from forum/viewtopic.php?f=13&t=12451) |
||
| Line 390: | Line 390: | ||
====Introduced for problems with Fine Offset family:==== | ====Introduced for problems with Fine Offset family:==== | ||
*These parameters | *These parameters were introduced for Cumulus to cope with Fine Offset stations and their clones, but a few of the parameters below may be found to be useful more widely. | ||
*Some parameters are set on screens, other attributes do not appear in the file unless they are added using an external editor, but the values still have a recommended default value as explained below. | *Some parameters are set on screens, other attributes do not appear in the '''cumulus.ini''' file unless they are added using an external editor, but the values still have a recommended default value as explained below. | ||
{| class="wikitable" border="1" | {| class="wikitable" border="1" | ||
|- | |- | ||
| Line 402: | Line 400: | ||
|style="background:lightgray;"|[Station] | |style="background:lightgray;"|[Station] | ||
|style="background:lightgray;"|Section name - the following parameters relate to the station configuration. | |style="background:lightgray;"|Section name - the following parameters relate to the station configuration. | ||
|- | |- | ||
|RestartIfUnplugged=0 | |RestartIfUnplugged=0 | ||
|This is set in the settings frame on the Station settings screen off the configuration menu. | |This is set in the settings frame on the Station settings screen off the configuration menu. | ||
*0 = Disabled, default i.e. deselected on the Station Configuration Screen | *0 = Disabled, default i.e. deselected on the Station Configuration Screen | ||
*1 = Enabled, Cumulus will restart if it detects that a Fine Offset station is unplugged. | *1 = Enabled, Cumulus will restart if it detects that a Fine Offset station is unplugged. '''Note:''' Unless the station has been manually plugged in again, a Cumulus restart has no benefit; normally the station should be checked to be plugged in before Cumulus is ever started and the station then left plugged in. | ||
|- | |- | ||
|EWdisablecheckinit=0 | |EWdisablecheckinit=0 | ||
| Line 437: | Line 419: | ||
|SyncFOReads=0 | |SyncFOReads=0 | ||
|This is set in the settings frame on the Station settings screen off the configuration menu. | |This is set in the settings frame on the Station settings screen off the configuration menu. | ||
A Fine Offset station will be writing to its memory every 48 or 60 seconds (depending on model); Cumulus can attempt once a day to identify when this update of memory occurs, and thereafter try not to read the memory at update time, by using what is called a synchronisation mode of operation. | A Fine Offset station will be writing to its memory every 48 or 60 seconds (depending on model); Cumulus can attempt once a day to identify when this update of memory occurs, and thereafter try not to read the memory at update time, by using what is called a synchronisation mode of operation. See next parameter. | ||
*0 = Synchronisation disabled, default (Cumulus reads the memory without taking into account when | *0 = Synchronisation disabled, default (Cumulus reads the memory without taking into account when memory is being updated) | ||
*1 = Re-synchronizes once each day, to avoid reading memory at time of memory update | *1 = Re-synchronizes once each day, to avoid reading memory at time of memory update | ||
|- | |- | ||
|FOReadAvoidPeriod=3 | |FOReadAvoidPeriod=3 | ||
|Sets the interval (in seconds) during each 48 second station logging period when Cumulus will avoid reading the station data to try and minimise lock ups. If the clock drifts more than this value in 24 hours, then Cumulus may cause the station to lock up when reading the data. The actual station clock drift gets logged to the diags file when the re-synchronise takes place, this will give an idea of whether it would be useful to adjust this setting. | |Add this line to cumulus.ini [Station] section if you wish to change the default, this parameter used to fine-tune the previous parameter. | ||
Sets the interval (in seconds) during each 48 (or 60 for some models) second of station logging period when Cumulus will avoid reading the station data to try and minimise lock ups. If the clock drifts more than this value in 24 hours, then Cumulus may cause the station to lock up when reading the data. The actual station clock drift gets logged to the diags file when the re-synchronise (see last parameter) takes place, this will give an idea of whether it would be useful to adjust this setting. | |||
*3 = default value | *3 = default value | ||
|- | |- | ||
|ReportLostSensorContact=0 | |ReportLostSensorContact=0 | ||
| Line 465: | Line 446: | ||
|Add this line to cumulus.ini [Station] section | |Add this line to cumulus.ini [Station] section | ||
Cumulus will ignore all pressure readings from the station that are greater than this value (units are always hPa/millibars) | Cumulus will ignore all pressure readings from the station that are greater than this value (units are always hPa/millibars) | ||
|} | |||
'''Spike Removal''' | |||
*The 7 spike removal parameters listed below are adjusted in the frame at the bottom of the ''Calibration'' screen, off '''Configuration''' menu, they have a prefix of EW because they were introduced for dealing with problems seen in the Fine Offset family; the corrections are only applied when Cumulus is reading directly from the station at a very frequent interval, spike removal does not apply when Cumulus is re-started and is transferring observations from the station logger to the Cumulus monthly log. | |||
*As Cumulus does not check station type before applying any of these settings, ensure for Davis stations (these do not have spike problems) the spike removal filters are set to the defaults shown below. | |||
*However, spike removal correction may be implemented for La Crosse stations, they do have problems with their PC interface, using the same EW filter settings listed below. | |||
{| class="wikitable" border="1" | |||
|- | |||
!style="width:150px" | Parameter Line Entry | |||
!style="width:600px" | Function | |||
|- | |||
|style="background:lightgray;"|[Station] | |||
|style="background:lightgray;"|Section name - the following parameters relate to the station configuration. | |||
|- | |- | ||
|EWmaxHourlyRain=999 | |EWmaxHourlyRain=999 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. An hourly rain | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. | ||
An hourly rain count 'spike removal' filter for weather stations that do not supply this figure so Cumulus has to calculate it. | |||
Any ''changes in calculated value'', between one calculation and the next, greater than the value specified here will be ignored by Cumulus when it calculates the hourly rain total. | |||
Cumulus ignores this parameter if the weather station directly supplies this figure to Cumulus. '''999''' is the default indicating no spike removal required. | |||
|- | |- | ||
|EWmaxRainRate=999 | |EWmaxRainRate=999 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A rain rate 'spike removal' filter, ''changes in calculated value'' between one calculation and the next greater than the value specified here (set in calibration screen of configuration menu) will be ignored by Cumulus when it calculates the rain rate. | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. | ||
A rain rate 'spike removal' filter, ''changes in calculated value'', between one calculation and the next, greater than the value specified here (set in calibration screen of configuration menu) will be ignored by Cumulus when it calculates the rain rate. | |||
Cumulus ignores this parameter for other makes of weather station (they supply a rain rate to Cumulus). The default value of '''999''' also effectively makes Cumulus ignore spike removal. | |||
|- | |- | ||
|EWgustdiff=999.0 | |EWgustdiff=999.0 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A wind gust 'spike removal' filter, ''changes in calculated value'' between one calculation and the next greater than the value specified here ( | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A wind gust 'spike removal' filter, ''changes in calculated value'' between one calculation and the next, greater than the value (always metres per second) specified here (with a default of '''999.0''') will be ignored by Cumulus. | ||
|- | |- | ||
|EWwinddiff=999.0 | |EWwinddiff=999.0 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu.. A wind speed 'spike removal' filter, ''changes in calculated value'' between one calculation and the next greater than the value specified here ( | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu.. A wind speed 'spike removal' filter, ''changes in calculated value'' between one calculation and the next greater than the value (always metres per second) specified here (with a default of '''999.0''') will be ignored by Cumulus | ||
|- | |- | ||
|EWpressurediff=999.0 | |EWpressurediff=999.0 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A pressure change 'spike removal' filter, ''changes in read value'' from any station greater than the value specified here ( | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A pressure change 'spike removal' filter, ''changes in read value'', from one reading to the next, off any station greater than the value (always mb) specified here (with a default of '''999.0''') will be ignored by Cumulus | ||
|- | |- | ||
|EWTempdiff=999.0 | |EWTempdiff=999.0 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A temperature change 'spike removal' filter | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A temperature change 'spike removal' filter. | ||
Replace default of 999.0 with the maximum difference in degrees Celsius (the units Cumulus uses for all calculations regardless of what you select for display) you are prepared to accept between successive data readings | |||
|- | |- | ||
|EWhumiditydiff=999.0 | |EWhumiditydiff=999.0 | ||
|This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A humidity change 'spike removal' filter, ''changes in read value''from any station greater than the value specified here (set in | |This is set in the spike removal frame on the Calibration settings screen off the configuration menu. A humidity change 'spike removal' filter, ''changes in read value'' from any station greater than the value (as %) specified here (with a default of '''999.0''') will be ignored by Cumulus | ||
|} | |||
'''Requiring Cumulus to read Easyweather.dat instead of a station directly perhaps for Stations not recognised by Cumulus''' | |||
*Stations not recognised by Cumulus ''may'' be set to create an [[EasyWeather_Format#Usage_of_easyweather.dat_fields_for_Cumulus_input_of_latest_record: |EasyWeather_Format]] file. For these the first two (or three) parameters below are mandatory. | |||
{| class="wikitable" border="1" | |||
|- | |||
!style="width:150px" | Parameter Line Entry | |||
!style="width:600px" | Function | |||
|- | |||
|style="background:lightgray;"|[Station] | |||
|style="background:lightgray;"|Section name - the following parameters relate to the station configuration. | |||
|- | |||
|EWInterval=0 | |||
|This parameter is entered in the Station Configuration Screen Settings block. | |||
*0= Default, meaning not applicable | |||
*n= any integer representing Easyweather logging interval in minutes (used for reading single latest observations from [[EasyWeather_Format#Usage_of_easyweather.dat_fields_for_Cumulus_input_of_latest_record: |Easyweather]] software output). | |||
'''Note:''' If you have not set Station '''Type''' to 4, then Cumulus ignores this parameter, i.e. it only applies if Cumulus needs to know how often to read a new record from the easyweather.dat file. | |||
|- | |||
|EWFile= | |||
|This is set in the settings frame on the Station settings screen off the configuration menu. | |||
*[[EasyWeather_Format#Usage_of_easyweather.dat_fields_for_Cumulus_input_of_latest_record: |Easyweather.dat or EasyWeatherPlus.dat]] file path/name as entered in the Station Configuration Screen Settings block (Station '''Type''' is set to 4). '''Note:''' This approach is viewed as outdated, used if EasyWeather software is running at same time as Cumulus software, both run all the time, and Cumulus is required to simply process the latest record on the database, at the interval set in previous parameter, without all the additional processing Cumulus is able to do if it is reading directly from the console very frequently. | |||
*(attribute and equals sign, but no value)= Default (Station '''Type''' ''not'' set to 4). '''Note:''' This is the default when Cumulus is operating normally. | |||
*(attribute and equals sign, but no value)= Default (Station '''Type''' is set to 4). '''Note:''' If you want to run Cumulus without an attached weather station (because your station has a fault or because you have a second PC), it is possible to run Cumulus with station '''Type=4''' but with the default of no file specified in this parameter. The full Cumulus directory structure and its files including those in the ''data'' sub-directory are needed (kept from when your station was working or copied from the PC with the station). Although only the old observations can be accessed, (no new ones are being added), this does allow analysis of the old observations via all Cumulus features such as '''View''' ''This period'' and '''View''' ''Select-A-Graph''. | |||
|- | |||
|LogExtraSensors=0 | |||
|This is set in the settings frame on the Station settings screen off the configuration menu. | |||
*0 = Disabled (default) | |||
*1 = Enabled; Use if you a) have Fine Offset models (generally those [[EasyWeather_Format#Note_on_Models|models 3xyz]]) with Solar/UV sensors, and b) '''Type=4''' set in that parameter (see top of [station] section), and c) '''EWFile='''''path'''''/EasyWeatherPlus.dat''' set in previous parameter. Only relevant if '''all these''' conditions met. | |||
'''Note:''' Cumulus uses this parameter to determine where to find each observation (e.g. outside temperature, wind speed, humidity etc.) in the console memory. If you set this parameter wrong, Cumulus will assign what it finds in various memory locations wrongly and therefore it is highly likely that temperatures, wind speeds and everything else will appear to have many rogue values in Cumulus but look okay on the weather station console display. | |||
This parameter is also used for other makes of weather station, see the relevant section for your make as the parameter is used differently. | |||
|} | |} | ||