Cumulus.ini (preserving history): Difference between revisions

m
Line 505: Line 505:
|style="background:lightgray;"|[Station]  
|style="background:lightgray;"|[Station]  
|style="background:lightgray;"|Section name - the following parameters relate to all weather stations.
|style="background:lightgray;"|Section name - the following parameters relate to all weather stations.
|-
|colspan="2" style="background:pink;"|Read-only parameters - enter directly into file with Cumulus stopped. Used in both C1 and MX unless indicated.
|-
|AvgBearingMinutes=N
|This line can be added in the [Station] section of the Cumulus.ini, with this parameter N is the number of minutes over which Cumulus calculates (by treating the wind as a vector and taking into account the speed as well as direction) its average bearing. Without it, the default sampling time = 10 minutes. Note the max number of wind samples stored by Cumulus is 720, so the maximum effective value for N for Fine Offset stations that are read every 10 seconds is 120 (2 hours) while for Davis stations that are sampled every 2 to 3 seconds the maximum effective value is only about 30 (minutes).
|-
|UseWindChillCutOff=1
|If you have not asked Cumulus to calculate wind chill, this parameter is irrelevant as it cannot affect how your weather station calculates wind chill.
If you have asked Cumulus to calculate wind chill ('''CalculatedWC=1'''), regardless of whether you have a weather station that can supply it, then Cumulus will by default only modify the outside temperature if both wind speed and temperature criteria are met. This parameter must be added to the file if you want to disable 'calculate Wind chill only if temperature less than 10°C rule'.
*  0 = Disabled, Cumulus will use any wind speed of 3 mph or more, to modify the temperature, and determine the wind chill, and Cumulus will ignore the temperature criterion
*    1 = Enabled (default), Cumulus will use both 10°C temperature and 3 mph wind speed criteria to determine if wind chill applies. Outside the criteria,the wind chill field will simply duplicate the outside temperature field.
|-
|ChillHourThreshold=45  '''Fahrenheit only i.e. USA'''
ChillHourThreshold=7 '''Celsius users'''
|The temperature threshold for the calculation of [[Heat/cold_degree_days_and_Chill_hours|Chill Hours]] is specified in the units that you use in Cumulus.
If the parameter is not included in the file, the default varies depending on the units you use.
*As shown the default is exactly 45 degrees Fahrenheit if Fahrenheit is used.
*The default is exactly 7 degrees Celsius, (note that is not exactly 45<sup>o</sup>F) if you have selected Celcius.
*You can put in any value you want, with a decimal place if required
*Some people have put in the freezing-point temperature (0<sup>o</sup>C and they relabel "chill hours" to "frost hours"
|-
|ChillHourSeasonStart=10
|The season start figure is the calendar month number (1=January to 12= December). The default if this parameter is not specified is October (month 10). On the first day of the month specified here, Cumulus resets the cumulative chill hours that it reports to zero.
|-
|SnowDepthHour=9
|If this parameter is not included in the file, then any snow entries in the [[Weather Diary]] for a particular date will continue to be used {{Version badge 1}} in output by Cumulus 1 until 9am the next morning, when entries for the current date will apply. [[File:Badge vMx.png]]The default for MX is not stated anywhere, but might be the standard rollover time (https://cumulus.hosiene.co.uk/viewtopic.php?f=37&t=17919).
*Allowed values are the integers 0 to 23
*The time is constant year round, in UK "a day of snow" could (before climate change) happen in April despite that being after swapping to summer (daylight saving) time.
#What you enter here is independent of any settings for rollover time
#For meteorological reporting, snow is reported on midnight to midnight days, although snow depth is measured and reported at 9am.
|-
|CreateWxnowTxt=0
|If the parameter is not included in the file, the default value is assumed.
    0= turn off creation of '''wxnow.tx'''t file (stored in main Cumulus folder)
    1= (default) create '''wxnow.txt''' file (an alternative way to get data to CWOP/APRS)
|-
|ListWebTags=0
|If the parameter is not included in the file, the default value is assumed.
    0= (default) turn off creation of WebTags.txt file (stored in main Cumulus folder)
    1= create WebTags.txt file when Cumulus is restarted (contains an unordered list of all the web tags your Cumulus build will recognise and process)
|-
|-
|colspan="2" style="background:lightblue;"| Both Cumulus flavours - in MX edit in Station Settings,  for Cumulus 1 edit in Station Configuration Screen
|colspan="2" style="background:lightblue;"| Both Cumulus flavours - in MX edit in Station Settings,  for Cumulus 1 edit in Station Configuration Screen
Line 608: Line 653:
*0 = Disabled (default), Cumulus will display the wind speed value to the precision used by the station.
*0 = Disabled (default), Cumulus will display the wind speed value to the precision used by the station.
*1 = Enabled, this setting causes wind speeds to be rounded to the nearest integer.
*1 = Enabled, this setting causes wind speeds to be rounded to the nearest integer.
|-
|AvgBearingMinutes=N
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. This line can be added in the [Station] section of the Cumulus.ini, with this parameter N is the number of minutes over which Cumulus calculates (by treating the wind as a vector and taking into account the speed as well as direction) its average bearing. Without it, the default sampling time = 10 minutes. Note the max number of wind samples stored by Cumulus is 720, so the maximum effective value for N for Fine Offset stations that are read every 10 seconds is 120 (2 hours) while for Davis stations that are sampled every 2 to 3 seconds the maximum effective value is only about 30 (minutes).
See next parameter for behaviour when calm.
|-
|-
|UseZeroBearing=0  
|UseZeroBearing=0  
Line 628: Line 669:
*1 = Enabled, Cumulus will calculate the wind chill instead of using the value supplied by the station. You should set this if you have specified any calibration values for wind and/or temperature, so that Cumulus can also apply those adjustments to the wind chill.
*1 = Enabled, Cumulus will calculate the wind chill instead of using the value supplied by the station. You should set this if you have specified any calibration values for wind and/or temperature, so that Cumulus can also apply those adjustments to the wind chill.
Note that some stations (Fine Offset, for example), do not make a wind chill value available to Cumulus. For these, Cumulus always calculates it.
Note that some stations (Fine Offset, for example), do not make a wind chill value available to Cumulus. For these, Cumulus always calculates it.
|-
|UseWindChillCutOff=1
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  If the parameter is not included in the file, the default value is assumed.  Purpose is to disable 'calculate [[Wind chill]] only if temperature less than 10&#176;C rule'.
*0 = Disabled, Cumulus will use any wind speed of 3 mph or more, to modify the temperature, and determine the wind chill ignoring the temperature criterion
*1 = Enabled (default), Cumulus will use both 10&#176;C temperature and  3  mph wind speed criterions to determine if wind chill applies.
Note if your station is a type that supplies wind chill to Cumulus; that ''CalculatedWC=1'' is needed for this setting to have any effect [i.e. you need to set Cumulus (see parameter directly above) to calculate the wind chill as this setting cannot change how your weather station calculates wind chill].
|-
|ChillHourThreshold=45
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. The temperature threshold is specified in the units that you use in Cumulus (see [[Heat/cold_degree_days_and_Chill_hours]]).  The default is exactly 45 degrees Fahrenheit (or exactly 7 degrees Celsius, note that is not exactly 45<sup>o</sup>F  depending on which units you use) if the parameter has not been included.
|-
|ChillHourSeasonStart=10
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen. The season start figure is the calendar month number (1=January to 12= December).  The default if this parameter is not specified is October (month 10).
|-
|-
|RolloverHour=0  
|RolloverHour=0  
Line 650: Line 679:
*0 = Use 9am in summer (use 10am not checked on Station Configuration Screen)
*0 = Use 9am in summer (use 10am not checked on Station Configuration Screen)
*1 = Use 10am in summer selected on Station Configuration Screen
*1 = Use 10am in summer selected on Station Configuration Screen
|-
|SnowDepthHour=9
|This parameter (attribute=value) is added directly to the file, it does not appear on a configuration screen.  If the parameter is not included in the file, the default value is assumed.  This line needs to be added in the [Station] section of the Cumulus.ini, it is the [[Weather_Diary|Snow lying/falling]] roll over time (time when yesterday's values in log.xml are forgotten) - Allowed values are 0 to 23 and represent the time to the nearest hour that snow depth measurements are taken.
*0 = midnight (default)
*9 = 9am,
*13 = 1pm etc.
Note this time is independent of your rollover time selections in the two preceding parameters.
|-
|-
|WarnMultiple=0  
|WarnMultiple=0  
Line 668: Line 690:
*0 = Disabled, application will close immediately
*0 = Disabled, application will close immediately
*1 = Enabled, application will prompt for confirmation that you wish to close it (do not use this if you might suspend/standby/hibernate your computer)
*1 = Enabled, application will prompt for confirmation that you wish to close it (do not use this if you might suspend/standby/hibernate your computer)
Ignored by MX.
[[File:Badge vMx.png]]Ignored by MX.
|-
|-
|CloseOnSuspend=1  
|CloseOnSuspend=1  
Line 731: Line 753:
|StartDate=13/08/2009  
|StartDate=13/08/2009  
|This parameter is automatically inserted into Cumulus.ini and given a value when Cumulus is first run. By default this will be set to the date of initial installation of the Cumulus application (whichever flavour). See [[FAQ#I_have_inserted_pre-Cumulus_data_making_.27Records_began_on.27_date_wrong]]
|This parameter is automatically inserted into Cumulus.ini and given a value when Cumulus is first run. By default this will be set to the date of initial installation of the Cumulus application (whichever flavour). See [[FAQ#I_have_inserted_pre-Cumulus_data_making_.27Records_began_on.27_date_wrong]]
|-
|CreateWxnowTxt=0
|This parameter (attribute=value) is added directly to the file in the [station] section, it does not appear on a configuration screen. If the parameter is not included in the file, the default value is assumed.
*0= turn off creation of wxnow.txt file (stored in main Cumulus folder)
*1= (default) create wxnow.txt file (an alternative way to get data to CWOP/APRS)
|-
|ListWebTags=0
|This parameter (attribute=value) is added directly to the file in the [station] section, it does not appear on a configuration screen. If the parameter is not included in the file, the default value is assumed.
*0= (default) turn off creation of WebTags.txt file (stored in main Cumulus folder)
*1= create WebTags.txt file when Cumulus is restarted (contains an unordered list of all the web tags your Cumulus build will recognise and process)
|-
|-
|LastLoggerDownload=13/08/2008 12:48:52  
|LastLoggerDownload=13/08/2008 12:48:52  
5,838

edits