Cumulus.ini (preserving history): Difference between revisions

Clarifying how to edit the different parameters, adding NOAAUseUTF8=0 and proxies (Someone please check), explaining parameters that nobody had explained after Shamrockspider had set them as '???' in 2009!
m (→‎Section: Station: Minor clarification following forum discussion)
(Clarifying how to edit the different parameters, adding NOAAUseUTF8=0 and proxies (Someone please check), explaining parameters that nobody had explained after Shamrockspider had set them as '???' in 2009!)
Line 1: Line 1:
The cumulus.ini [[:Category:Configuration Files| configuration file]] is a text file containing initialization parameters used by the Cumulus application, and is read only when Cumulus starts up.
The cumulus.ini [[:Category:Configuration Files| configuration file]] is located in the directory in which you installed Cumulus. It is a text file containing initialization parameters used by the Cumulus application, and is read only when Cumulus starts up. Parameters are in the form 'attribute=value' and grouped into sections. Cumulus re-writes the contents of the application configuration screens to the file when it shuts down.
It is located in the directory in which you installed Cumulus and is updated whenever you change any configuration parameters from the application configuration pages. Cumulus also re-writes the contents of the application configuration pages to the file when it shuts down, so if you want to edit the file yourself, make sure Cumulus is stopped.
Note that some configuration settings can only be applied by editing this file to insert them; they do not appear anywhere in the configuration screens. Cumulus does not write these values back out to the file on shut down, so they do not appear with default values - in other words, you need to ''add'' them if you want to set them.
Note also that if your system is configured to use a comma for a decimal separator, then you should use a comma in any decimal values that you set in this file.


== Section: Station ==
== Editing the file ==
Many configuration parameters are changed from the various application configuration pages, you should never edit these directly in the file while Cumulus is running, as Cumulus will replace these parameters with the contents of the relevant application Edit/View/Configuration screens to the file when it shuts down.  You can edit them in the file with Cumulus stopped, it will read the new values when it restarts, but beware of selecting invalid values for these parameters, generally it is safer to use the application to edit them (unless you are importing values from another setup).
 
Note that some configuration settings can only be applied by editing this file to insert them; they do not appear anywhere in the configuration screens. Cumulus does not write these values back out to the file on shut down, so they do not appear with default values - in other words, you need to ''add'' them if you want to set them. Make sure you place these additional parameters in the correct section as listed below.
 
'''Note''' also that if your system is configured to use a comma for a decimal separator, then you should use a comma in any decimal values that you set in this file.
 
== File Contents ==
All installations (using the current version of Cumulus) will contain all the following sections (although the order of sections is inmaterial and probably reflects when you started using Cumulus as new sections have been added at the end by various versions), some relate to the external websites that Cumulus can optionally supply with updates, if you do not use those services those parameters will be set to the defaults.  Within a section, newer versions of cumulus may add additional parameters set by revised configuration screens, and permit additional parameters to be added manually.
 
If you are not using the current version, or you are using a beta build, then checking the release information may be advisable before you make changes.  I also strongly advise taking a backup of Cumulus.ini at regular intervals, to ensure you have a version to return to if an edit (within cumulus or externally) causes a problem.
=== Section: Station ===
See individual parameters for specific instructions on setting them. In many cases this is by using Station Configuration Screen, but if the parameter does not exist in your file, then insert it using a file editor.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 80: Line 89:
*0 = Disabled (default)
*0 = Disabled (default)
*1 = Enabled, this line needs to be added in the [Station] section of the Cumulus.ini
*1 = Enabled, this line needs to be added in the [Station] section of the Cumulus.ini
Note that you need to set Cumulus to calculate the wind chill (if your station is a type that supplies one itself) for this setting to have any effect.
Note that ''CalculatedWC=1'' is needed for this setting to have any effect (if your station is a type that supplies wind chill itself); i.e. you need to set Cumulus (see directly above) to calculate the wind chill if it is to apply a rule based on temperature.
|-
|ChillHourThreshold=45
|The temperature threshold is specified in the units that you use in Cumulus (see [[Heat/cold_degree_days_and_Chill_hours]])
|-
|-
|ChillHourSeasonStart=10
|ChillHourSeasonStart=10
|The season start figure is the calendar month number (1 to 12)
|The season start figure is the calendar month number (1 to 12)
|-
|ChillHourThreshold=45
|The temperature threshold is specified in the units that you use in Cumulus (see [[Heat/cold_degree_days_and_Chill_hours]])
|-
|-
|RolloverHour=0  
|RolloverHour=0  
|Log roll over time as selected on the Station Configuration Screen
|Log roll over time as selected on the Station Configuration Screen
*0 = midnight
*0 = midnight
*9 = 9am
*9 = 9am/10am
|-
|-
|Use10amInSummer=1  
|Use10amInSummer=1  
|Daylight saving correction for 9am roll over
|Daylight saving correction for 9am roll over
*0 = Use 10am in summer 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
|-
|-
Line 101: Line 110:
SnowDepthHour=9
SnowDepthHour=9
|[[Weather_Diary|Snow lying/falling]] roll over time (time when yesterday's values in log.xml are forgotten)
|[[Weather_Diary|Snow lying/falling]] roll over time (time when yesterday's values in log.xml are forgotten)
*0 = midnight
Note this time is independent of your rollover time selections in the two preceding parameters.
*9 = 9am
*0 = midnight (default)
*9 = 9am, this line needs to be added in the [Station] section of the Cumulus.ini
|-
|-
|ConfirmClose=0  
|ConfirmClose=0  
|Confirm you wish to close Cumulus application after telling it to close
|Confirm you wish to close Cumulus application after telling it to close
*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
*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)
|-
|-
|CloseOnSuspend=1  
|CloseOnSuspend=1  
|If this is selected, Cumulus will close if you suspend/standby/hibernate your computer.  You should not select 'Confirm shutdown' if you use this option.
|If this is selected, on the Station Configuration Screen, Cumulus will close if you suspend/standby/hibernate your computer.  You should not select 'Confirm shutdown' if you use this option.
*0 = Disabled, application will not close if you suspend/standby/hibernate your computer   
*0 = Disabled, application will not close if you suspend/standby/hibernate your computer (it is highly recommended you close Cumulus manually before your computer is put into suspend/standby/hibernate state)  
*1 = Enabled, application will close on suspend/standby/hibernate of your computer
*1 = Enabled, application will close on suspend/standby/hibernate of your computer (recommended if your computer can go into any of these states when left alone)
|-
|-
|RestartIfUnplugged=0  
|RestartIfUnplugged=0  
|Cumulus will restart if it detects that a Fine Offset station is unplugged.
|Cumulus will restart if it detects that a Fine Offset station is unplugged.
*0 = Disabled
*0 = Disabled, default as deselected on the Station Configuration Screen
*1 = Enabled
*1 = Enabled as selected on the Station Configuration Screen
|-
|-
|SyncDavisClock=0  
|SyncDavisClock=0  
|When set, at start-up, Cumulus will set the Davis VP/VP2 clock to the same time as the PC  
|When set, at start-up, Cumulus will set the Davis VP/VP2 clock to the same time as the PC  
*0 = Disabled
*0 = Disabled, default as deselected on the Station Configuration Screen
*1 = Enabled
*1 = Enabled
|-
|-
Line 396: Line 406:
|}
|}


== Section: Web Site ==
=== Section: Offsets ===
Set these parameters using the '''Configuration''' menu and ''Calibration'' screen, nothing else can be added to this section.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 402: Line 413:
!style="width:600px" | Function  
!style="width:600px" | Function  
|-
|-
|style="background:lightgray;"|[Web Site]  
|style="background:lightgray;"|[Offsets]  
|style="background:lightgray;"|Section Name - the following parameters relate to your website
|style="background:lightgray;"|Section Name - the following parameters are the correction factors for your specific sensors
|-
|PressOffset=0
|Value by which Measured Pressure to be corrected (Add/Subtract)
|-
|-
|ForumURL=<nowiki>http://sandaysoft.com/forum/</nowiki>
|TempOffset=0
|A website forum URL
|Value by which Measured Outdoor Temperature to be corrected (Add/Subtract)
|-
|-
|WebcamURL=<nowiki>http://www.sanday.org.uk/webcam/webcam.php </nowiki>
|HumOffset=0
|URL for your Webcam
|Value by which Measured Humidity to be corrected (Add/Subtract)
|}
 
== Section: FTP Site ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|WindDirOffset=0
!style="width:600px" | Function
|Value by which Measured Wind Direction to be corrected (Add/Subtract)
|-
|-
|style="background:lightgray;"|[FTP site]
|InTempOffset=0
|style="background:lightgray;"|Section Name - the following parameters relate to your website FTP parameters
|Value by which Measured Indoor Temperature to be corrected (Add/Subtract)
|-
|-
|Host=  
|WindSpeedMult=1
|This is the name (or the IP address) of the ftp server which you connect to when you upload pages to your web site. Leave blank if you are not using ftf, but simply creating the output files on your pc.
|Multiplier by which measured Average [[Wind_measurement|Wind Speed]] to be corrected.  Officially wind speed is measured with sensors at 10m above ground level.  If your sensor is not at 10m AGL then a correction multiplier should be applied using the following formula ''V10/Vh = 1/(0.233 + 0.656*log10(h+4.75))'' where "h" is your sensor height in meters.
e.g. if your anemometer is 5m off the ground, V10/Vh comes out at 1.134
|-
|-
|Port=21
|WindGustMult=1
|Port used for FTP upload, default =21
|Multiplier by which measured Wind Gust Speed to be corrected.
|-
|-
|Username=  
|TempMult=1
|your web site FTP login Username as entered in the Internet Configuration Screen
|Multiplier by which measured Temperature to be corrected.
|-
|-
|Password=  
|HumMult=1
|your web site FTP login password as entered in the Internet Configuration Screen (note: this is not encrypted)
|Multiplier by which measured Humidity to be corrected.
|-
|-
|Directory=  
|RainMult=1
|Directory (including path) on your server to which FTP will upload the files. Starting point is the position specified by ftp server (see Host above)
|Multiplier by which measured Rainfall to be corrected.
|-
|-
|AutoUpdate=0  
|UVOffset=0
|Set in the Internet Configuration Screen Web Settings block.
|Value by which measured UV to be corrected (add/subtract).
*0 = Disabled
*1 = Enabled, Cumulus will automatically upload your processed web pages to your web site at regular intervals (as specified by the 'Update Interval') using FTP to the directory as specified in 'Directory'.
|-
|-
|UpdateInterval=15
|UVMult=1
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block in '''Interval''' box.  The interval in minutes at which you wish auto updates (either FTP to your website or output to a directory on your pc) to occur.  Default 15 minutes.
|Multiplier by which measured UV to be corrected
|}
 
=== Section: Web Site ===
All parameters edited in the Internet Configuration screen ''Sites/Options tab'' Web Site block.
{| class="wikitable" border="1"
|-
|-
|IncludeSTD=1
!style="width:150px" | INI Line Entry
|Selected in the Internet Configuration Files Tab screen
!style="width:600px" | Function
*0 = Disabled
*1 = Enabled, (default) the standard web files provided with Cumulus will be processed and uploaded at each web update.
|-
|-
|IncludeSTDImages=1
|style="background:lightgray;"|[Web Site]
|Selected in the Internet Configuration Files Tab screen
|style="background:lightgray;"|Section Name - the following parameters relate to your website
*0 = Disabled
*1 = Enabled,(default) the standard image files generated by Cumulus (graphs, etc) will be uploaded at each web update to a subfolder of the 'Directory' you specified called 'images'.
|-
|-
|EnableRealtime=0
|ForumURL=<nowiki>http://sandaysoft.com/forum/</nowiki>
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block.
|A website forum URL
The [[realtime.txt]] file contains various weather parameters and is used by the CumulusRealtime.swf (shock wave flash) real time wind gauges (as on the supplied 'gauges' web page).
*0 = Disabled (default) If you have the 'auto update' option set (and a suitable interval configured), Cumulus will  create the realtime.txt file at the specified normal update Interval (not the Realtime Interval) so that you can specify it as an extra file to upload during the 'normal' upload, or use it for any other purpose on your PC.
*1 = Enabled, Cumulus will create the realtime.txt file,  and upload it to your web site, at the interval specified by Realtime Interval (see below).
|-
|-
|RealtimeInterval=3000
|WebcamURL=<nowiki>http://www.sanday.org.uk/webcam/webcam.php </nowiki>
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block. The time in seconds between uploads of the realtime.txt file.
|URL for your Webcam
|}
 
=== Section: FTP Site ===
See individual entries for how to edit these parameters.
{| class="wikitable" border="1"
|-
|-
|RealtimeFTPEnabled=0
!style="width:150px" | INI Line Entry
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
!style="width:600px" | Function
*0 = Disabled (default)
*1 = Enabled, Cumulus will establish an FTP connection to your web site, so that the realtime.txt file, and any other files you specify, can be uploaded when realtime processing takes place. The 'EnableRealtime' setting must be set to 1 for this setting to have any effect.
|-
|-
|RealtimeTxtFTP=0
|style="background:lightgray;"|[FTP site]
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
|style="background:lightgray;"|Section Name - the following parameters relate to your website FTP parameters
When set to 1 Cumulus will upload the [[realtime.txt]] to your web site during realtime processing. The 'EnableRealtime' and 'RealtimeFTPEnabled' settings must both be set to 1 for this setting to have any effect.
|-
|-
|ActiveFTP=0
|Host=  
|Set in the Internet Configuration Screen ''Sites/Options tab'' Web Settings block
|Selected in the Internet Configuration screen ''Sites/Options tab''.  This is either the name or the IP address of the ftp server to which you connect when you upload pages to your web site. You probably used it with an external FTP program when you followed the instructions in the Cumulus help, Readme.txt or [[Simple_Website_setup]].
*0 = Disabled (default)
''Leave blank if you are not using ftp, but simply creating the output files on your pc.''
*1 = Enabled, Cumulus will use 'active' FTP mode instead of the default 'passive' mode. You should only select active mode if you are having problems with FTP uploads.
|-
|-
|FTPRename=0
|Port=21
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
|Selected in the Internet Configuration screen ''Sites/Options tab''. Port used for FTP upload, default =21
*0 = Disabled default,
*1 = Enabled,  the new update is loaded using temporary names, files are renamed on the sever afterwards
|-
|-
|DeleteBeforeUpload=0
|Username=  
|Selected in Internet Configuration Screen ''Sites/Options tab'' Web Settings block
|Select in the Internet Configuration screen ''Sites/Options tab'' your web site FTP login Username
*0 = Disabled default
*1 = Enabled, files are deleted from sever before the new update is loaded
|-
|-
|ResizeGraphs=0
|Password=  
|Selected in the Internet Congfiuration Screen Web graphs block.
|Shows your web site FTP login password as entered in the Internet Configuration Screen (note: this is not encrypted)
*0 = Disabled (default) Cumulus uploads the default 750 x 300 pixel graphs.
*1 = Cumulus resizes the large graph images when creating them for upload to your web site. Specify the required height and width in the corresponding boxes. Note that the images are simply scaled to the new size; there will be some loss of quality
|-
|-
|GraphHeight=300
|Directory=  
|Graph height, default is 300 (pixels)
|Selected in the Internet Configuration screen ''Sites/Options tab''.  Directory (including path) on your server to which FTP will upload the files. Starting point is the position specified by ftp server (see Host above)
|-
|-
|GraphWidth=750
|AutoUpdate=0
|Graph width, default is 750 (pixels)
|Set in the Internet Configuration Screen Web Settings block.
*0 = Disabled
*1 = Enabled, Cumulus will automatically upload your processed web pages to your web site at regular intervals (as specified by the 'Update Interval') using FTP to the directory as specified in 'Directory'.
|-
|-
|ImageFolder=  
|UpdateInterval=15
|Set in Internet Configuration Screen Files tab.  Path and file name in LOCAL folder to which the generated image files are also copied at each web update interval, either the 'normal' interval, or the 'realtime' interval, depending on next parameterUsed if you want backups of generated images. See Cumulus Help.
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block in '''Interval''' boxThe interval in minutes at which you wish auto updates (either FTP to your website or output to a directory on your pc) to occurDefault 15 minutes.
|-
|-
|ImageCopyRealtime=0
|IncludeSTD=1
|Set in Internet Configuration Screen Files tab.
|Selected in the Internet Configuration Files Tab screen
*0 = files copied in 'normal' interval each web update (default)
*0 = Disabled
*1 = files copied in 'real time' interval.  
*1 = Enabled, (default) the standard web files provided with Cumulus will be processed and uploaded at each web update.
|-
|-
|ExtraLocal[0-9]=  
|IncludeSTDImages=1
| Set in Internet Configuration Screen Files tab. Path and file name on local computer for alternate files #0 through #9. See cumulus Help for details of how to specify reading current monthly log here.
|Selected in the Internet Configuration Files Tab screen
*0 = Disabled
*1 = Enabled,(default) the standard image files generated by Cumulus (graphs, etc) will be uploaded at each web update to a subfolder of the 'Directory' you specified called 'images'.  
|-
|-
|ExtraLocal[10-99]=  
|EnableRealtime=0
|Path and file name on local computer for alternate file #10 through #19. These additional files can only be set via the configuration file, they are not visible in the Internet Configuration screen Files tab.
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block.
The [[realtime.txt]] file contains various weather parameters and is used by the CumulusRealtime.swf (shock wave flash) real time wind gauges (as on the supplied 'gauges' web page).
*0 = Disabled (default) If you have the 'auto update' option set (and a suitable interval configured), Cumulus will  create the realtime.txt file at the specified normal update Interval (not the Realtime Interval) so that you can specify it as an extra file to upload during the 'normal' upload, or use it for any other purpose on your PC.
*1 = Enabled, Cumulus will create the realtime.txt file, and upload it to your web site, at the interval specified by Realtime Interval (see below).  
|-
|-
|ExtraRemote[0-9]=  
|RealtimeInterval=3000
|Path and file name on web server for alternate files #0 through #9. Set in Internet Configuration Screen Files tab. See cumulus Help for details of how to specify creating current monthly log here.
|Set in the Internet Configuration screen ''Sites/Options tab'' Web Settings block. The time in seconds between uploads of the realtime.txt file.
|-
|-
|ExtraRemote[10-99]=  
|RealtimeFTPEnabled=0
|Path and file name on web server for alternate file #10 through #19. These additional files can only be set via the configuration file, they are not visible in the Internet Configuration screen Files tab.
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
*0 = Disabled (default)
*1 = Enabled, Cumulus will establish an FTP connection to your web site, so that the realtime.txt file, and any other files you specify, can be uploaded when realtime processing takes place. The 'EnableRealtime' setting must be set to 1 for this setting to have any effect.
|-
|-
|ExtraProcess[0-9]=0  
|RealtimeTxtFTP=0
|Set in Internet Configuration Screen Files tab.
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
*0 = Disabled, (default) file will not pass through the cumulus 'tag processor'.
When set to 1 Cumulus will upload the [[realtime.txt]] to your web site during realtime processing. The 'EnableRealtime' and 'RealtimeFTPEnabled' settings must both be set to 1 for this setting to have any effect.
*1 = Enabled, file will be passed through the 'tag processor' in Cumulus, in the same way that the standard Cumulus web pages are. This allows to you to create your own web pages into which Cumulus will insert the various weather parameters. See the "Web tags" section of the help file for a list of the tags which you can use. Cumulus will create a temporary file to hold the processed version of your file and then upload that.  
|-
|-
|ExtraProcess[10-99]=0  
|ActiveFTP=0  
|Set in this config file only.
|Set in the Internet Configuration Screen ''Sites/Options tab'' Web Settings block
*0 = Disabled, file will not pass through the cumulus 'tag processor'.
*0 = Disabled (default)
*1 = Enabled, file will be passed through the 'tag processor' in Cumulus, in the same way that the standard Cumulus web pages are. This allows to you to create your own web pages into which Cumulus will insert the various weather parameters. See the "Web tags" section of the help file for a list of the tags which you can use. Cumulus will create a temporary file to hold the processed version of your file and then upload that
*1 = Enabled, Cumulus will use 'active' FTP mode instead of the default 'passive' mode. You should only select active mode if you are having problems with FTP uploads.
|-
|-
|ExtraBinary[0-9]=0  
|FTPRename=0  
|Set in Internet Configuration Screen Files tab.
|Selected in the Internet Configuration screen ''Sites/Options tab'' Web Settings block
*0 = not binary (e.g. HTML file)
*0 = Disabled default,
*1 = Binary (e.g. images)
*1 = Enabled,  the new update is loaded using temporary names, files are renamed on the sever afterwards
|-
|-
|ExtraBinary[10-99]=0  
|DeleteBeforeUpload=0  
|Set in this config file only.
|Selected in Internet Configuration Screen ''Sites/Options tab'' Web Settings block
*0 = not binary (e.g. HTML file)
*0 = Disabled default
*1 = Binary (e.g. images)
*1 = Enabled, files are deleted from sever before the new update is loaded
|-
|-
|ExtraRealtime[0-9]=0  
|ResizeGraphs=0  
|Set in Internet Configuration Screen Files tab. If you select this for any files, you will also need to select the Realtime option.
|Selected in the Internet Congfiguration Screen Web graphs block.  
*0 = Disabled, (default) file uploaded as part of normal upload
*0 = Disabled (default) Cumulus uploads the default 750 x 300 pixel graphs.
*1 = Enabled, file uploaded during Realtime upload
*1 = Cumulus resizes the large graph images when creating them for upload to your web site. Specify the required height and width in the corresponding boxes. Note that the images are simply scaled to the new size; there will be some loss of quality
|-
|-
|ExtraRealtime[10-99]=0
|GraphHeight=300
|Set in this config file only. If you select this for any files, you will also need to select the Realtime option.
|Graph height, default is 300 (pixels)
*0 = Disabled, file uploaded as part of normal upload
*1 = Enabled, file uploaded during Realtime upload
|-
|-
|ExtraFTP[0-9]=1
|GraphWidth=750
|Graph width, default is 750 (pixels)
|-
|ImageFolder=
|Set in Internet Configuration Screen Files tab.  Path and file name in LOCAL folder to which the generated image files are also copied at each web update interval, either the 'normal' interval, or the 'realtime' interval, depending on next parameter.  Used if you want backups of generated images. See Cumulus Help.
|-
|ImageCopyRealtime=0
|Set in Internet Configuration Screen Files tab.
|Set in Internet Configuration Screen Files tab.
*0 = Disabled, File copied to the location specified in the Remote Filename box.
*0 = files copied in 'normal' interval each web update (default)
*1 = Enabled, (default) File uploaded  by FTP
*1 = files copied in 'real time' interval.  
Not intended for standard Cumulus web pages (tick box at top of screen, missing files will be ignored), nor for NOAA reports (FTF for them set up in '''NOAA Setup''' within Configuration menu).
|-
|-
|ExtraFTP[10-99]=1
|ExtraLocal[0-9]=  
|Set in this config file only.
| Set in Internet Configuration Screen Files tab. Path and file name on local computer for alternate files #0 through #9. See cumulus Help for details of how to specify reading current monthly log here.
*0 = Disabled, File copied to the location specified in the Remote Filename box.
*1 = Enabled, File uploaded  by FTP
|-
|-
|ExternalProgram=
|ExtraLocal[10-99]=  
|The name (including path) of a command-line program to be run at the 'normal' web update interval, after all of the processing has been performed.
|Path and file name on local computer for alternate file #10 through #19. These additional files can only be set via the configuration file, they are not visible in the Internet Configuration screen Files tab.
|-
|-
|ExternalParams=
|ExtraRemote[0-9]=  
|The corresponding 'paramaters' for 'ExternalProgram' used to specify any parameters to be passed to the command.
|Path and file name on web server for alternate files #0 through #9. Set in Internet Configuration Screen Files tab. See cumulus Help for details of how to specify creating current monthly log here.
|-
|-
|RealtimeProgram=
|ExtraRemote[10-99]=  
|The name (including path) of a command-line program to be run at the 'realtime' web update interval, after all of the processing has been performed.
|Path and file name on web server for alternate file #10 through #19. These additional files can only be set via the configuration file, they are not visible in the Internet Configuration screen Files tab.
|-
|RealtimeParams=
|The corresponding 'paramaters' for 'RealtimeProgram' used to specify any parameters to be passed to the command.
|-
|-
|DailyProgram=
|ExtraProcess[0-9]=0
|The name (including path) of a command-line program to be run once a day, after the daily 'rollover' has been performed.
|Set in Internet Configuration Screen Files tab.
*0 = Disabled, (default) file will not pass through the cumulus 'tag processor'.
*1 = Enabled, file will be passed through the 'tag processor' in Cumulus, in the same way that the standard Cumulus web pages are. This allows to you to create your own web pages into which Cumulus will insert the various weather parameters. See the "Web tags" section of the help file for a list of the tags which you can use. Cumulus will create a temporary file to hold the processed version of your file and then upload that.  
|-
|-
|DailyParams=
|ExtraProcess[10-99]=0
|The corresponding 'paramaters' for 'DailyProgram' used to specify any parameters to be passed to the command.
|Set in this config file only.
|}
*0 = Disabled, file will not pass through the cumulus 'tag processor'.
 
*1 = Enabled, file will be passed through the 'tag processor' in Cumulus, in the same way that the standard Cumulus web pages are. This allows to you to create your own web pages into which Cumulus will insert the various weather parameters. See the "Web tags" section of the help file for a list of the tags which you can use. Cumulus will create a temporary file to hold the processed version of your file and then upload that
== Section: Display ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|ExtraBinary[0-9]=0
!style="width:600px" | Function
|Set in Internet Configuration Screen Files tab.
*0 = not binary (e.g. HTML file)
*1 = Binary (e.g. images)
|-
|-
|style="background:lightgray;"|[Display]  
|ExtraBinary[10-99]=0
|style="background:lightgray;"|Section heading - the following parameters affect the way things are displayed.
|Set in this config file only.
*0 = not binary (e.g. HTML file)
*1 = Binary (e.g. images)
|-
|-
|Heading=My Weather
|ExtraRealtime[0-9]=0
|Title Heading on the Main Screen. Set in the Display Configuration Screen General block
|Set in Internet Configuration Screen Files tab. If you select this for any files, you will also need to select the Realtime option.
*0 = Disabled, (default) file uploaded as part of normal upload
*1 = Enabled, file uploaded during Realtime upload
|-
|-
|MinimizeToTray=0  
|ExtraRealtime[10-99]=0  
|Set in the Display Configuration Screen General block
|Set in this config file only. If you select this for any files, you will also need to select the Realtime option.
*0 = Disabled (default)
*0 = Disabled, file uploaded as part of normal upload
*1 = Enabled, causes Cumulus to appear as an icon in the system tray when it is minimized. The icon will flash if a record is broken or an error occurs. Double click on the icon to restore the main window (or right click on the icon and use the pop-up menu).
*1 = Enabled, file uploaded during Realtime upload
|-
|-
|ForecastCentred=0
|ExtraFTP[0-9]=1
|Set in the Display Configuration Screen General block.
|Set in Internet Configuration Screen Files tab.
*0 = Disabled, (default) Forecast appears left justified on main screen
*0 = Disabled, File copied to the location specified in the Remote Filename box.
*1 = Enabled, Forecast appears centred on main screen
*1 = Enabled, (default) File uploaded  by FTP
Not intended for standard Cumulus web pages (tick box at top of screen, missing files will be ignored), nor for NOAA reports (FTF for them set up in '''NOAA Setup''' within Configuration menu).
|-
|-
|FontColour=4227327
|ExtraFTP[10-99]=1
|Decimal code for the screen font color
|Set in this config file only.
*0 = Disabled, File copied to the location specified in the Remote Filename box.
*1 = Enabled, File uploaded  by FTP
|-
|-
|BackColour=12632256
|ExternalProgram=
|Decimal code for the application background color
|The name (including path) of a command-line program to be run at the 'normal' web update interval, after all of the processing has been performed.
|-
|-
|HeadingColour=10485760
|ExternalParams=
|Decimal code for the screen heading color
|The corresponding 'paramaters' for 'ExternalProgram' used to specify any parameters to be passed to the command.
|-
|-
|ClockColour=-16777201
|RealtimeProgram=
|Decimal code for the main screen clock background color (
|The name (including path) of a command-line program to be run at the 'realtime' web update interval, after all of the processing has been performed.
|-
|-
|DisplaySolarData=0
|RealtimeParams=
|Set in the Display Configuration Screen General block.
|The corresponding 'paramaters' for 'RealtimeProgram' used to specify any parameters to be passed to the command.
*0 = Disabled (default)
*1 = causes Vantage Pro solar data (ET, UV and Solar radiation) to be displayed on the main screen (if supported by the station), or extra sensor data in the case of Oregon WMR-928 stations.
|-
|-
|DisplayCloudBase=0
|DailyProgram=
|Set in the Display Configuration Screen General block.
|The name (including path) of a command-line program to be run once a day, after the daily 'rollover' has been performed.
*0 = Disabled, (default)
*1 = Enabled, the calculated cloud base is displayed on the main screen. The calculation is a simple one; 1000 feet for every 4.5 degrees Fahrenheit difference between the temperature and the dew point.
|-
|-
|TwelveHourClock=0
|DailyParams=
|Set by left click on clock on main screen
|The corresponding 'paramaters' for 'DailyProgram' used to specify any parameters to be passed to the command.
*0 = 24Hr clock mode
|}
*1 - 12 Hr am/pm clock mode
 
=== Section: Display ===
Set these parameters using Configuration menu and either ''Display'' or ''Colours'' screens.
{| class="wikitable" border="1"
|-
|-
|WMR928Channel1Caption=Extra channel 1
!style="width:150px" | INI Line Entry
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
!style="width:600px" | Function
|-
|-
|WMR928Channel2Caption=Extra channel 2
|style="background:lightgray;"|[Display]
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
|style="background:lightgray;"|Section heading - the following parameters affect the way things are displayed.
|-
|-
|WMR928Channel3Caption=Extra channel 3
|Heading=My Weather
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
|Title Heading on the Main Screen. Set in the Display Configuration Screen General block
|-
|-
|WindGaugeRange=50
|MinimizeToTray=0
|Sets the default full scale deflection of the wind speed gauge
|Set in the Display Configuration Screen General block
*0 = Disabled (default)
*1 = Enabled, causes Cumulus to appear as an icon in the system tray when it is minimized. The icon will flash if a record is broken or an error occurs. Double click on the icon to restore the main window (or right click on the icon and use the pop-up menu).
|-
|-
|SnowUnitText=cm
|ForecastCentred=0
|Snow measurement unit. Default is cm.  Can be any unit you like, but all values must be an integer (without any decimal part)!
|Set in the Display Configuration Screen General block.
*0 = Disabled, (default) Forecast appears left justified on main screen
*1 = Enabled, Forecast appears centred on main screen
|-
|-
|DisplayHumidex=0
|FontColour=4227327
|Set in the Display Configuration Screen General block
|Decimal code for the screen font color
*0 = Disabled (default) [[Heat_index]] displayed on main screen. The heat index is calculated only if the actual temperature in the shade (not in direct sunlight) is above 27 °C (80 °F), so normal temperature shown here for cooler temperatures.
*1 = Enabled, calculated [[Humidex]] value to be displayed on the main screen instead of Heat Index. Note that Cumulus displays degrees C or F for Humidex, whereas strictly speaking it is unitless. This is for the convenience of those who use Fahrenheit but would still prefer to see Humidex displayed, where it might be confusing to show the unconverted value.
|-
|-
|LegendSymbolWidth=3
|BackColour=12632256
|The width of the plot lines in graph ledgends
|Decimal code for the application background color
|-
|-
|WindRoseColour=8388608
|HeadingColour=10485760
|
|Decimal code for the screen heading color
|-
|-
|ShowCurrentConditions=0
|ClockColour=-16777201
|*0 = Disabled, (default)
|Decimal code for the main screen clock background color (
*1 = Enabled, a box labelled 'Current:' appears at bottom of Cumulus main screen. See [[Webtags_as_boolean_operators_in_HTML#Current_Weather_Conditions]] for possible use of this information, and [[Currentconditions.txt]] for the effect when its value changes
|-
|-
|NumWindRosePoints=16
|DisplaySolarData=0
|The number of points to plot on the Wind Rose diagram (suggest 8 for FO stations)
|Set in the Display Configuration Screen General block.
*0 = Disabled (default)
*1 = causes Vantage Pro solar data (ET, UV and Solar radiation) to be displayed on the main screen (if supported by the station), or extra sensor data in the case of Oregon WMR-928 stations.
|-
|-
|ChartLineWidth=2
|DisplayCloudBase=0
|The width of the plot lines in the graph body
|Set in the Display Configuration Screen General block.
*0 = Disabled, (default)
*1 = Enabled, the calculated cloud base is displayed on the main screen. The calculation is a simple one; 1000 feet for every 4.5 degrees Fahrenheit difference between the temperature and the dew point.
|-
|-
|ClockDigitColour=4227327
|TwelveHourClock=0
|
|Set by left click on clock on main screen
*0 = 24Hr clock mode
*1 - 12 Hr am/pm clock mode
|-
|-
|WindRoseTransparency=50
|WMR928Channel1Caption=Extra channel 1
|
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
|-
|-
|WindGaugeAnimated=1
|WMR928Channel2Caption=Extra channel 2
|Animate the Wind Gauge pointer movement
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
*0 = Disabled,
*1 = Enabled (default)
|-
|-
|WindGaugeAnimationFactor=2
|WMR928Channel3Caption=Extra channel 3
|This sets the speed of the wind gauge animation. Lower values correspond to a faster animation speed. Be careful not to set the animation too slow, particularly with stations which update frequently (e.g. Davis) as the animation will never catch up, and will use significant CPU time.
|Set the captions on the main screen which are displayed along with the extra channel data for WMR928 stations.
|-
|-
|CompassColour=12632256
|WindGaugeRange=50
|
|Sets the default full scale deflection of the wind speed gauge
|-
|-
|CompassTickColour=16711680
|SnowUnitText=cm
|
|Snow measurement unit. Default is cm.  Can be any unit you like, but all values must be an integer (without any decimal part)!
|-
|-
|CompassLabelColour=16777215
|DisplayHumidex=0
|
|Set in the Display Configuration Screen General block
*0 = Disabled (default) [[Heat_index]] displayed on main screen. The heat index is calculated only if the actual temperature in the shade (not in direct sunlight) is above 27 °C (80 °F), so normal temperature shown here for cooler temperatures.
*1 = Enabled, calculated [[Humidex]] value to be displayed on the main screen instead of Heat Index. Note that Cumulus displays degrees C or F for Humidex, whereas strictly speaking it is unitless. This is for the convenience of those who use Fahrenheit but would still prefer to see Humidex displayed, where it might be confusing to show the unconverted value.
|-
|-
|CompassBearingColour=0
|LegendSymbolWidth=3
|
|The width of the plot lines in graph legends
|-
|-
|CompassCurrentPointerColour=255
|WindRoseColour=8388608
|
|
|-
|-
|CompassAveragePointerColour=16711680
|ShowCurrentConditions=0
|
|Set in the Display Configuration Screen General block
*0 = Disabled, (default)
*1 = Enabled, a box labelled 'Current:' appears at bottom of Cumulus main screen. See [[Webtags_as_boolean_operators_in_HTML#Current_Weather_Conditions]] for possible use of this information, and [[Currentconditions.txt]] for the effect when the contents of the box on main screen changes.
|-
|-
|WindRoseLabelColour=0
|NumWindRosePoints=16
|Set in the Display Configuration Screen Graphs block
The number of points to plot on the Wind Rose diagram (suggest 8 for FO stations)
|-
|ChartLineWidth=2
|The width of the plot lines in the graph body
|-
|ClockDigitColour=4227327
|
|
|-
|-
|TransparentGauges=0
|WindRoseTransparency=50
|The square backgrounds of the three wind gauges on the Cumulus main screen can be the same colour as the main window background, or, with this option selected, the images will be processed to make the background colour transparent.
|
|-
|-
|LogFTPErrors=1
|WindGaugeAnimated=1
|Controls logging of FTP errors to the Cumulus Error Dialog display, set to 0 to suppress the logging of FTP errors.
|Animate the Wind Gauge pointer movement
*0 = Disabled,
*1 = Enabled (default)
|-
|-
|SavePosition=0
|WindGaugeAnimationFactor=2
|If set to 1, the current position of the main window will be saved to cumulus.ini when Cumulus closes, and the window will open again at that position the next time Cumulus starts.
|This sets the speed of the wind gauge animation. Lower values correspond to a faster animation speed. Be careful not to set the animation too slow, particularly with stations which update frequently (e.g. Davis) as the animation will never catch up, and will use significant CPU time.
|-
|-
|StartMinimised=0
|CompassColour=12632256
|If set to 1, Cumulus will start with the main window minimised, either to the system tray or the task bar, depending on the 'Minimise to tray' setting.
|
|-
|-
|LabelColour=0
|CompassTickColour=16711680
|Parameter labels on main screen - default black. Note alarm conditions can change label colour (see next 2 parameters).
|-
|AlarmColour=255
|Parameter labels on main screen - default red - when an alarm is set for that parameter
|-
|PastAlarmColour=16711680
|Parameter labels on main screen - default blue - when an alarm is cleared for that parameter
|-
|PanelHeadingFontColour=0
|
|
|-
|-
|PanelLineColour=0
|CompassLabelColour=16777215
|
|
|-
|-
|PanelBorderColour=8421504
|CompassBearingColour=0
|
|
|-
|-
|PanelGradientColourFrom=16777215
|CompassCurrentPointerColour=255
|
|
|-
|-
|PanelGradientColourTo=13226453
|CompassAveragePointerColour=16711680
|
|
|-
|-
|WindGaugeArcColour=16773091
|WindRoseLabelColour=0
|
|
|-
|-
|WindGaugeTickColour=9841920
|TransparentGauges=0
|
|The square backgrounds of the three wind gauges on the Cumulus main screen can be the same colour as the main window background, or, with this option selected, the images will be processed to make the background colour transparent.
|-
|-
|WindGaugeFontColour=9841920
|LogFTPErrors=1
|
|Controls logging of FTP errors to the Cumulus Error Dialog display, set to 0 to suppress the logging of FTP errors.
|-
|-
|WindGaugeInnerCircleColour=16765615
|SavePosition=0
|
|If set to 1, the current position of the main window will be saved to cumulus.ini when Cumulus closes, and the window will open again at that position the next time Cumulus starts.
|-
|StartMinimised=0
|If set to 1, Cumulus will start with the main window minimised, either to the system tray or the task bar, depending on the 'Minimise to tray' setting.
|-
|LabelColour=0
|Parameter labels on main screen - default black. Note alarm conditions can change label colour (see next 2 parameters).
|-
|-
|WindGaugeNeedleColour=128
|AlarmColour=255
|
|Parameter labels on main screen - default red - when an alarm is set for that parameter
|-
|-
|WindGaugeInnerCentreColourFrom=16765615
|PastAlarmColour=16711680
|
|Parameter labels on main screen - default blue - when an alarm is cleared for that parameter
|-
|-
|WindGaugeInnerCentreColourTo=16765615
|PanelHeadingFontColour=0
|
|
|-
|-
|WindGaugeOuterCentreColourFrom=16765357
|PanelLineColour=0
|
|
|-
|-
|WindGaugeOuterCentreColourTo=16711680
|PanelBorderColour=8421504
|
|
|-
|-
|WindGaugeOuterCircleColour=16765615
|PanelGradientColourFrom=16777215
|
|
|-
|-
|WindGaugeOuterRimColour=9470064
|PanelGradientColourTo=13226453
|
|
|-
|-
|WindGaugeAverageSectorColour=32768
|WindGaugeArcColour=16773091
|
|
|-
|-
|WindGaugePeakSectorColour=33023
|WindGaugeTickColour=9841920
|
|
|-
|-
|WindRoseAxesColour=8388608
|WindGaugeFontColour=9841920
|
|
|-
|-
|WindGaugeNeedleShineColourFrom=1049273
|WindGaugeInnerCircleColour=16765615
|
|
|-
|-
|WindGaugeNeedleShineColourTo=328090
|WindGaugeNeedleColour=128
|
|
|-
|-
|DisplayBeaufortDesc=1
|WindGaugeInnerCentreColourFrom=16765615
|If set to 1, the Beaufort description of the current average wind speed will appear in the header of the wind panel on the main screen. If set to 0, it will instead appear as a 'tool tip' for the wind panel.
|
|-
|-
|DisplayBarometerTrendText=1
|WindGaugeInnerCentreColourTo=16765615
|If set to 1, the description of the current barometer trend will appear in the header of the barometer panel on the main screen. If set to 0, it will instead appear as a 'tool tip' for the barometer panel.
|
|-
|-
|UpdateAtStartup=1
|WindGaugeOuterCentreColourFrom=16765357
|If set to 1, the the display will be updated as data is downloaded and processed from the station's logger. This increases the time taken to process the data. If set to 0, it makes the download faster; this may be significant if there is a lot of data to download.
|
|-
|-
|IndependentGraphsWindow=0
|WindGaugeOuterCentreColourTo=16711680
|
|
|-
|-
|DigitBackground=0
|WindGaugeOuterCircleColour=16765615
|
|-
|WindGaugeOuterRimColour=9470064
|
|
|}
== Section: WUnderground ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|WindGaugeAverageSectorColour=32768
!style="width:600px" | Function
|
|-
|-
|style="background:lightgray;"|[Wunderground]
|WindGaugePeakSectorColour=33023
|style="background:lightgray;"|Section Name - Parameters for your [http://www.wunderground.com/ Weather Underground] site
|
|-
|-
|ID=  
|WindRoseAxesColour=8388608
|Your Weather Underground station identifier (note: not your user name).
|
|-
|-
|Password=  
|WindGaugeNeedleShineColourFrom=1049273
|Your Weather Underground password. (note: not encrypted)
|
|-
|-
|Enabled=0
|WindGaugeNeedleShineColourTo=328090
|Set if you wish to upload to your Weather Underground site
|
*0 = Disabled, (default) no Weather underground site
*1 = Enabled, data sent at the interval specified below
|-
|-
|RapidFire=0
|DisplayBeaufortDesc=1
|'rapid fire' mode.
|Set in the Display Configuration Screen General block
*0 = Disabled (default)
If set to 1, the Beaufort description of the current average wind speed will appear in the header of the wind panel on the main screen. If set to 0, it will instead appear as a 'tool tip' for the wind panel.
*1 = Enabled, You should also tick 'Enabled'. Rapid fire updates occur every 5 seconds.
|-
|-
|Interval=15
|DisplayBarometerTrendText=1
|Time in minutes between uploads to Weather Underground. (default = 15)
|If set to 1, the description of the current barometer trend will appear in the header of the barometer panel on the main screen. If set to 0, it will instead appear as a 'tool tip' for the barometer panel.
|-
|-
|SendUV=0
|UpdateAtStartup=1
|Current UV value
|If set to 1, the the display will be updated as data is downloaded and processed from the station's logger. This increases the time taken to process the data. If set to 0, it makes the download faster; this may be significant if there is a lot of data to download.
*0 = Disabled (default) no UV info sent
*1 = Enabled, UV value sent with the data  
|-
|-
|SendSR=0  
|IndependentGraphsWindow=0
|Solar Radiation
|
*0 = Disabled (default) no solar data sent
*1 = Enabled, Solar Radiation value sent with data
|-
|-
|SendAverage=0  
|DigitBackground=0
|Causes average wind speed and directon to be sent rather than instantaneous/gust speed and direction.
|
*0 = Disabled (default) instantaneous/gust speed data sent
|}
*1 = Enabled, average wind speed sent with data
|-
|CatchUp=1
|If possible send missing historic data to the server on startup
*0 = Disabled
*1 = Enabled (default)
|}


== Section: [[Twitter.txt|Twitter]] ==
=== Section: Graphs ===
Set many of these parameters using '''Configuration''' menu and either ''Display'' (Graphs block) or ''Colours'' screens.
Set the colours of the data lines on graphs/charts and Select whether to plot particular data by using '''View''' menu and ''Graphs'' option, then right click over the relevant graph.
Set the SAG colours and axis position by using '''View''' menu and ''Select-A-Graph'' option, the settings for different observations are at the foot of the screen.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 853: Line 872:
!style="width:600px" | Function  
!style="width:600px" | Function  
|-
|-
|style="background:lightgray;"|[Twitter]  
|style="background:lightgray;"|[Graphs]  
|style="background:lightgray;"|Section Name - the following parameters relate to your [[Twitter]] site parameters
|style="background:lightgray;"|Section Name - the following parameters relate to your graph settings
|-
|-
|User=  
|GraphHours=12
|your Twitter login username
|The number of hours data to be displayed in temperature (outdoor, heat index, wind chill, dewpoint and apparent temperature), humidity, rainfall rate, rainfall, pressure, solar radiation, UV index, wind speed and wind direction graphs.
You can enter any multiple of 12 from the Display Settings Screen, and you can also edit cumulus.ini and set this item to any other value. But note that setting it to a non-standard value is unsupported (i.e. if it causes problems, I probably won't fix them) and if you change any display settings, the value will get reset to a supported value (so you'll need to edit cumulus.ini again).
|-
|-
|Password=  
|ChartMaxDays=7
|your Twitter login password ('''note:''' this is not encrypted)
|How many days of values to plot on the daily min/average/max temperature, daily sunshine, and daily rain charts (default=7)
|-
|-
|Enabled=0
|Background=12632256
|Set in Internet Configuration Screen Twitter block
|Decimal value for the Graph and Chart background colour.  
*0 = Disabled (default)
*1 = Enabled, tweats sent at the specified interval.
|-
|-
|Interval=60
|WindColour=65535
|interval in minutes that Tweats will be sent.
|Decimal value for the 10 minute average wind speed plot colour
|-
|-
|OauthToken=
|GustColour=8421376
|??
|Decimal value for the Wind Gust plot colour
|-
|-
|OauthTokenSecret=
|RainColour=9527753
|??
|Decimal value for the Rain plot colour
|}
 
==Section: PWSweather ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|RainTodayColour=9527753
!style="width:600px" | Function
|Decimal value for the Rain Today plot colour
|-
|-
|style="background:lightgray;"|[PWSweather]
|TempColour=9527753
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://www.pwsweather.com/ PWS] weather site parameters
|Decimal value for the Outside Temperature plot colour
|-
|-
|ID=  
|HeatIndexColour=16711680
|Your PWS Weather station identifier (note: not your user name)
|Decimal value for the Heat Index plot colour
|-
|-
|Password=  
|AppTempColour=8388736
|your PWS weather site login password ('''note:''' this is not encrypted)
|Decimal value for the Apparent Temperature plot colour
|-
|-
|Enabled=0
|PressColour=9527753
|Select in Internet Configuration Screen PWS Weather block
|Decimal value for the Pressure plot colour
*0 = Disabled (default) no data sent to PWS
|-
*1 = Enabled, data sent to PWS at the specified interval
|WindDirColour=255
|Decimal value for the Wind Direction plot colour
|-
|DewPointColour=255
|Decimal value for the Dew Point plot colour
|-
|-
|Interval=15
|WindChillColour=32768
|Interval in minutes that updates will be sent to your PWS weather site
|Decimal value for the Wind Chill plot colour
|-
|-
|SendUV=0
|MinTempColour=16711680
|Current Ultra Violet level
|Decimal value for the Minimum Temperature chart plot colour
*0 = Disabled (default)
*1 = Enabled, UV level sent with normal data
|-
|-
|SendSR=0
|MaxTempColour=255
|Solar Radiation level
|Decimal value for the Maximum Temperature chart plot colour
*0 = Disabled (default)
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|CatchUp=1
|AvgTempColour=32768
|If possible send missing historic data to the server on startup
|Decimal value for the Average Temperature chart plot colour
*0 = Disabled
*1 = Enabled (default)
|}
 
== Section: APRS ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|DailyRainColour=32768
!style="width:600px" | Function
|Decimal value for the Daily Rain chart plot colour
|-
|-
|style="background:lightgray;"|[APRS]
|InsideTempColour=0
|style="background:lightgray;"|Section Name - the following parameters relate to your [[APRS]] weather site parameters
|Decimal value for the Inside Temperature plot colour
|-
|-
|ID=  
|InsideHumColour=255
|Your APRS identifier
|Decimal value for the Inside Humidity plot colour
|-
|-
|pass=-1
|OutsideHumColour=16711680
|your APRS password (Note: not encrypted)
|Decimal value for the Outside Humidity plot colour
|-
|-
|server=cwop.aprs.net
|Graph3D=0
|The APRS server to use
|3D or normal graph selection as selected in the Display Configuration Graphs block
*0 = normal graph selected
*1 = 3D graph selected
|-
|-
|port=14580
|PlotLatestGust=0
|The port number to use on the APRS server.
|Plot Latest Gust selection as selected in the Display Configuration Graphs block
*0 = Disabled
*1 = Enabled
|-
|OriginIsSouth=0
|Wind Direction Graph Y Axis origin
*0 = North as Origin (default)
*1 = South as Origin
|-
|-
|Enabled=0  
|ShowFreezingLine=0
|Select in Internet Configuration Screen APRS Settings block
|Draw a horizontal line on the temperature graph at 0°C/32°F
|-
|-
|Interval=9
|TempVisible=1
|Time in minutes between uploads to the APRS server
|Select whether to plot the outside air temperature on the temperature graph
*0 = Disabled
*1 = Enabled
|-
|-
|APRSHumidityCutoff=1
|HIVisible=0
|For Oregon Scientific, so it doesn't report humidity to [[APRS]] when the temperature is below -10&#176;C
|Select whether to plot the heat index on the temperature graph
*0 = Disabled
*1 = Enabled
|-
|-
|SendSR=0
|DPVisible=1
|Solar Radiation level
|Select whether to plot the dewpoint values on the temperature graph
*0 = Disabled (default)
*0 = Disabled
*1 = Enabled, Solar radiation reading sent with normal data
*1 = Enabled
|}
 
== Section: WOW ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|WCVisible=1
!style="width:600px" | Function
|Select whether to plot the wind chill values on the temperature graph
*0 = Disabled
*1 = Enabled
|-
|-
|style="background:lightgray;"|[WOW]
|AppTempVisible=1
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://wow.metoffice.gov.uk/WOW| WOW] weather site parameters
|Select whether to plot the apparent temperature values on the temperature graph
*0 = Disabled
*1 = Enabled
|-
|-
|ID=
|InHumVisible=1
|Your WOW station ID
|Select whether to plot the indoor humidity values on the humidity graph
*0 = Disabled
*1 = Enabled
|-
|-
|Password=
|OutHumVisible=1
|your WOW password (Note: not encrypted)
|Select whether to plot the outdoor humidity values on the humidity graph
*0 = Disabled
*1 = Enabled
|-
|-
|Enabled=1
|GraphGradientEnabled=0
|Updates enabled/disabled
|Use gradient shading on the graph background
*0 = Disabled
*1 = Enabled
|-
|GradientStart=12632256
|
|-
|-
|Interval=15
|GradientMiddle=16777215
|Time in mimutes between uploads to the WOW server
|
|-
|-
|SendUV=0
|GradientEnd=8421504
|Current Ultra Violet level
|
*0 = Disabled (default)
*1 = Enabled, UV level sent with normal data
|-
|-
|SendSR=0
|SAGintempcolour=32768
|Solar Radiation level
|(Select-A-Graph)
*0 = Disabled (default)
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|CatchUp=1
|SAGouttempcolour=255
|If possible send missing historic data to the WOW server on startup
|
*0 = Disabled
*1 = Enabled (default)
|}
 
== Section: Weatherbug ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|SAGpressurecolour=16711680
!style="width:600px" | Function
|
|-
|-
|style="background:lightgray;"|[Weatherbug]
|SAGraintotalcolour=8388608
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://weather.weatherbug.com| Weatherbug] weather site parameters
|
|-
|-
|ID=
|SAGrainratecolour=16776960
|Your Weatherbug station ID
|
|-
|-
|Password=
|SAGgustcolour=16711935
|your Weatherbug password (Note: not encrypted)
|
|-
|-
|Enabled=1
|SAGpeakgustcolour=65280
|Updates enabled/disabled
|
|-
|-
|Interval=15
|SAGspeedcolour=8388736
|Time in mimutes between uploads to the Weatherbug server
|
|-
|-
|SendUV=0
|SAGinhumcolour=32896
|Current Ultra Violet level
|
*0 = Disabled (default)
*1 = Enabled, UV level sent with normal data
|-
|-
|SendSR=0
|SAGouthumcolour=8388608
|Solar Radiation level
|
*0 = Disabled (default)
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|CatchUp=1
|SAGheatindexcolour=128
|If possible send missing historic data to the server on startup
|
*0 = Disabled
*1 = Enabled (default)
|}
 
== Section: Graphs ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|SAGwindchillcolour=8421504
!style="width:600px" | Function
|
|-
|-
|style="background:lightgray;"|[Graphs]
|SAGwinddircolour=0
|style="background:lightgray;"|Section Name - the following parameters relate to your graph settings
|
|-
|-
|GraphHours=12
|SAGdewpointcolour=8421376
|The number of hours data to be displayed in each graph. You can select 12, 24 or 48 from the Display Settings, and you can also edit cumulus.ini and set this item to any other value. But note that setting it to a non-standard value is unsupported (i.e. if it causes problems, I probably won't fix them) and if you change any display settings, the value will get reset to a supported value (so you'll need to edit cumulus.ini again).
|
|-
|-
|Background=12632256
|SAGsolarradcolour=65535
|Decimal value for the Graph background colour.
|
|-
|-
|WindColour=65535
|SAGmaxsolarradcolour=16711935
|Decimal value for the 10 minute average wind speed plot colour
|
|-
|-
|GustColour=8421376
|SAGapptempcolour=0
|Decimal value for the Wind Gust plot colour
|
|-
|-
|RainColour=9527753
|SAGuvindexcolour=65280
|Decimal value for the Rain plot colour
|
|-
|-
|RainTodayColour=9527753
|SAGintempaxis=L
|Decimal value for the Rain Today plot colour
|(Select-A-Graph)
|-
|-
|TempColour=9527753
|SAGouttempaxis=L
|Decimal value for the Temperature plot colour
|
|-
|-
|HeatIndexColour=16711680
|SAGpressureaxis=L
|Decimal value for the Heat Index plot colour
|
|-
|-
|PressColour=9527753
|SAGraintotalaxis=L
|Decimal value for the Pressure plot colour
|
|-
|-
|WindDirColour=255
|SAGrainrateaxis=L
|Decimal value for the Wind Direction plot colour
|
|-
|-
|DewPointColour=255
|SAGgustaxis=L
|Decimal value for the Dew Point plot colour
|
|-
|-
|WindChillColour=32768
|SAGpeakgustaxis=L
|Decimal value for the Wind Chill plot colour
|
|-
|-
|MinTempColour=16711680
|SAGspeedaxis=L
|Decimal value for the Minimum Temperature plot colour
|
|-
|-
|MaxTempColour=255
|SAGinhumaxis=L
|Decimal value for the Maximum Temperature plot colour
|
|-
|-
|AvgTempColour=32768
|SAGouthumaxis=L
|Decimal value for the Average Temperature plot colour
|
|-
|-
|DailyRainColour=32768
|SAGheatindexaxis=L
|Decimal value for the Daily Rain plot colour
|
|-
|-
|InsideTempColour=0
|SAGwindchillaxis=L
|Decimal value for the Inside Temperature plot colour
|
|-
|-
|InsideHumColour=255
|SAGwinddiraxis=L
|Decimal value for the Inside Humidity plot colour
|
|-
|-
|OutsideHumColour=16711680
|SAGdewpointaxis=L
|Decimal value for the Outside Humidity plot colour
|
|-
|-
|Graph3D=0
|SAGsolarradaxis=L
|3D or normal graph selection as selected in the Display Configuration Graphs block
|
*0 = normal graph selected
*1 = 3D graph selected
|-
|-
|PlotLatestGust=0
|SAGmaxsolarradaxis=L
|Plot Latest Gust selection as selected in the Display Configuration Graphs block
|
*0 = Disabled
*1 = Enabled
|-
|-
|OriginIsSouth=0
|SAGapptempaxis=L
|Wind Direction Graph Y Axis origin
|
*0 = North as Origin (default)
*1 = South as Origin
|-
|-
|ShowFreezingLine=0
|SAGuvindexaxis=L
|Draw a horizontal line on the temperature graph at 0°C/32°F
|
|-
|-
|AppTempColour=8388736
|SAG3D=0
|Decimal value for the Apparent Temperature plot colour
|
|-
|-
|TempVisible=1
|SAGgradientback=0
|???
|
*0 = Disabled
*1 = Enabled
|-
|-
|HIVisible=0
|SAGleftgrid=1
|???
|
*0 = Disabled
*1 = Enabled
|-
|-
|DPVisible=1
|SAGrightgrid=1
|Plot the dewpoint values on the temperature graph
|
*0 = Disabled
|}
*1 = Enabled
 
=== Section: Alarms ===
Set these using the '''Edit''' menu, ''Alarms'' screen.
{| class="wikitable" border="1"
|-
|-
|WCVisible=1
!style="width:150px" | INI Line Entry
|Plot the wind chill values on the temperature graph
!style="width:600px" | Function
*0 = Disabled
*1 = Enabled
|-
|-
|AppTempVisible=1
|style="background:lightgray;"|[Alarms]
|Plot the apparent temperature values on the temperature graph
|style="background:lightgray;"|Section Name - the following parameters relate to your alarm settings
*0 = Disabled
*1 = Enabled
|-
|-
|InHumVisible=1
|alarmlowtemp=0
|Plot the indoor humidity values on the humidity graph
|Select in Edit Alarms Screen
*0 = Disabled
*0 = Disable low temperature alarm (default)
*1 = Enabled
*1 = Enable Low temperature alarm
|-
|-
|OutHumVisible=1
|LowTempAlarmSet=0
|Plot the outdoor humidity values on the humidity graph
|Setting for low temperature alarm point (degrees)
*0 = Disabled
*1 = Enabled
|-
|-
|ChartMaxDays=7
|LowTempAlarmSound=0
|How many days of data to plot on the graphs (default=7)
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|GraphGradientEnabled=0
|LowTempAlarmSoundFile=C:\Cumulus\alert.wav
|Use gradient shading on the graph background
|Path and file name of sound file for Low Temperature alarm
*0 = Disabled
*1 = Enabled
|-
|-
|GradientStart=12632256
|alarmhightemp=0
|
|Select in Edit Alarms Screen
*0 = Disable high temperature alarm (default)
*1 = Enable High temperature alarm
|-
|-
|GradientMiddle=16777215
|HighTempAlarmSet=0
|
|Degrees above which alarm will occur.
|-
|-
|GradientEnd=8421504
|HighTempAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGintempcolour=32768
|HighTempAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name of sound file for High Temperature alarm
|-
|-
|SAGouttempcolour=255
|alarmlowpress=0
|
|Select in Edit Alarms Screen
|-
|-
|SAGpressurecolour=16711680
|LowPressAlarmSet=0
|
|Pressure below which you wish Low Pressure alarm to occur
|-
|-
|SAGraintotalcolour=8388608
|LowPressAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGrainratecolour=16776960
|LowPressAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for sound file to play for Low Pressure Alarm
|-
|-
|SAGgustcolour=16711935
|alarmhighpress=0
|
|Select in Edit Alarms Screen
*0 = Disable low High Pressure alarm (default)
*1 = Enable High Pressure alarm
|-
|-
|SAGpeakgustcolour=65280
|HighPressAlarmSet=0
|
|Pressure above which you wish High Pressure alarm to occur
|-
|-
|SAGspeedcolour=8388736
|HighPressAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGinhumcolour=32896
|HighPressAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for the sound file used for the High Pressure Alarm
|-
|-
|SAGouthumcolour=8388608
|alarmhighraintoday=0
|
|Select in Edit Alarms Screen
*0 = Disable High Rain today alarm (default)
*1 = Enable High Rain today alarm
|-
|-
|SAGheatindexcolour=128
|HighRainTodayAlarmSet=0
|
|Rain level above which alarm to occur
|-
|-
|SAGwindchillcolour=8421504
|HighRainTodayAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGwinddircolour=0
|HighRainTodayAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for the sound file used for the High Rain Today Alarm
|-
|-
|SAGdewpointcolour=8421376
|alarmhighrainrate=0
|
|Select in Edit Alarms Screen
*0 = Disable High Rain Rate alarm (default)
*1 = Enable High Rain Rate alarm
|-
|-
|SAGsolarradcolour=65535
|HighRainRateAlarmSet=0
|
|Rain rate above which you wish alarm to occur
|-
|-
|SAGmaxsolarradcolour=16711935
|HighRainRateAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGapptempcolour=0
|HighRainRateAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for the sound file used for the High Rain Rate Alarm
|-
|-
|SAGuvindexcolour=65280
|alarmhighgust=0
|
|Select in Edit Alarms Screen
*0 = Disable High Gust alarm (default)
*1 = Enable High Gust alarm
|-
|-
|SAGintempaxis=L
|HighGustAlarmSet=0
|
|Gust speed above which you wish alarm to occur
|-
|-
|SAGouttempaxis=L
|HighGustAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGpressureaxis=L
|HighGustAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for the sound file used for the High Gust Alarm
|-
|-
|SAGraintotalaxis=L
|alarmhighwind=0
|
|Select in Edit Alarms Screen
*0 = Disable High Average Wind alarm (default)
*1 = Enable High Average Wind alarm
|-
|-
|SAGrainrateaxis=L
|HighWindAlarmSet=0
|
|Average Wind speed above which alarm to occur
|-
|-
|SAGgustaxis=L
|HighWindAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGpeakgustaxis=L
|HighWindAlarmSoundFile=C:\Cumulus\alert.wav
|
|Path and file name for the sound file used for the High Wind Alarm
|-
|-
|SAGspeedaxis=L
|SensorAlarmSet=0
|
|Select in Edit Alarms Screen
*0 = Disable sensor contact lost alarm (default)
*1 = Enable sensor contact lost alarm
|-
|-
|SAGinhumaxis=L
|SensorAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGouthumaxis=L
|SensorAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|
|Path and file name for the sound file used for the Sensor Contact lost Alarm
|-
|-
|SAGheatindexaxis=L
|alarmtempchange=0
|
|Select in Edit Alarms Screen
*0 = Disable Temperature Change alarm (default)
*1 = Enable Temperature Change alarm
|-
|-
|SAGwindchillaxis=L
|TempChangeAlarmSet=0
|
|Temperature change value to trigger the alarm
|-
|-
|SAGwinddiraxis=L
|TempChangeAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGdewpointaxis=L
|TempChangeAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|
|Path and file name for the sound file used for the Temperature Change Alarm
|-
|-
|SAGsolarradaxis=L
|alarmpresschange=0
|
|Select in Edit Alarms Screen
*0 = Disable Pressure Change alarm (default)
*1 = Enable Pressure Change alarm
|-
|-
|SAGmaxsolarradaxis=L
|PressChangeAlarmSet=0
|
|Pressure change value to trigger the alarm
|-
|-
|SAGapptempaxis=L
|PressChangeAlarmSound=0
|
|Alarm Action
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SAGuvindexaxis=L
|PressChangeAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|
|Path and file name for the sound file used for the Pressure Change Alarm
|}
 
=== Section: WUnderground ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
|-
|-
|SAG3D=0
!style="width:150px" | INI Line Entry
|
!style="width:600px" | Function
|-
|-
|SAGgradientback=0
|style="background:lightgray;"|[Wunderground]
|
|style="background:lightgray;"|Section Name - Parameters for your [http://www.wunderground.com/ Weather Underground] site
|-
|-
|SAGleftgrid=1
|ID=  
|
|Your Weather Underground station identifier (note: not your user name).
|-
|-
|SAGrightgrid=1
|Password=  
|
|Your Weather Underground password. (note: not encrypted)
|}
 
== Section: Alarms ==
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | INI Line Entry
|Enabled=0
!style="width:600px" | Function
|Set if you wish to upload to your Weather Underground site
*0 = Disabled, (default) no Weather underground site
*1 = Enabled, data sent at the interval specified below
|-
|-
|style="background:lightgray;"|[Alarms]
|RapidFire=0
|style="background:lightgray;"|Section Name - the following parameters relate to your alarm settings
|'rapid fire' mode.
*0 = Disabled (default)
*1 = Enabled, You should also tick 'Enabled'. Rapid fire updates occur every 5 seconds.
|-
|-
|alarmlowtemp=0
|Interval=15
|Select in Edit Alarms Screen
|Time in minutes between uploads to Weather Underground. (default = 15)
*0 = Disable low temperature alarm (default)
*1 = Enable Low temperature alarm
|-
|-
|LowTempAlarmSet=0  
|SendUV=0  
|Setting for low temperature alarm point (degrees)
|Current UV value
*0 = Disabled (default) no UV info sent
*1 = Enabled, UV value sent with the data
|-
|-
|LowTempAlarmSound=0  
|SendSR=0  
|Alarm Action
|Solar Radiation
*0 = Disable, (default) no sound on alarm
*0 = Disabled (default) no solar data sent
*1 = Enable sound on alarm
*1 = Enabled, Solar Radiation value sent with data
|-
|-
|LowTempAlarmSoundFile=C:\Cumulus\alert.wav
|SendAverage=0
|Path and file name of sound file for Low Temperature alarm
|Causes average wind speed and directon to be sent rather than instantaneous/gust speed and direction.
*0 = Disabled (default) instantaneous/gust speed data sent
*1 = Enabled, average wind speed sent with data
|-
|-
|alarmhightemp=0
|CatchUp=1
|Select in Edit Alarms Screen
|If possible send missing historic data to the server on startup
*0 = Disable high temperature alarm (default)
*0 = Disabled
*1 = Enable High temperature alarm
*1 = Enabled (default)
|}
 
=== Section: [[Twitter.txt|Twitter]] ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
|-
|-
|HighTempAlarmSet=0
!style="width:150px" | INI Line Entry
|Degrees above which alarm will occur.
!style="width:600px" | Function
|-
|-
|HighTempAlarmSound=0
|style="background:lightgray;"|[Twitter]
|Alarm Action
|style="background:lightgray;"|Section Name - the following parameters relate to your [[Twitter]] site parameters
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighTempAlarmSoundFile=C:\Cumulus\alert.wav
|User=  
|Path and file name of sound file for High Temperature alarm
|your Twitter login username
|-
|-
|alarmlowpress=0
|Password=  
|Select in Edit Alarms Screen
|your Twitter login password ('''note:''' this is not encrypted)
|-
|-
|LowPressAlarmSet=0  
|Enabled=0  
|Pressure below which you wish Low Pressure alarm to occur
|Set in Internet Configuration Screen Twitter block
*0 = Disabled (default)
*1 = Enabled, tweats sent at the specified interval.
|-
|-
|LowPressAlarmSound=0
|Interval=60
|Alarm Action
|interval in minutes that Tweats will be sent.
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|LowPressAlarmSoundFile=C:\Cumulus\alert.wav
|OauthToken=
|Path and file name for sound file to play for Low Pressure Alarm
|??
|-
|-
|alarmhighpress=0
|OauthTokenSecret=
|Select in Edit Alarms Screen
|??
*0 = Disable low High Pressure alarm (default)
|}
*1 = Enable High Pressure alarm
 
===Section: PWSweather ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
|-
|-
|HighPressAlarmSet=0
!style="width:150px" | INI Line Entry
|Pressure above which you wish High Pressure alarm to occur
!style="width:600px" | Function
|-
|-
|HighPressAlarmSound=0
|style="background:lightgray;"|[PWSweather]
|Alarm Action
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://www.pwsweather.com/ PWS] weather site parameters
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighPressAlarmSoundFile=C:\Cumulus\alert.wav
|ID=  
|Path and file name for the sound file used for the High Pressure Alarm
|Your PWS Weather station identifier (note: not your user name)
|-
|-
|alarmhighraintoday=0
|Password=  
|Select in Edit Alarms Screen
|your PWS weather site login password ('''note:''' this is not encrypted)
*0 = Disable High Rain today alarm (default)
*1 = Enable High Rain today alarm
|-
|-
|HighRainTodayAlarmSet=0  
|Enabled=0  
|Rain level above which alarm to occur
|Select in Internet Configuration Screen PWS Weather block
*0 = Disabled (default) no data sent to PWS
*1 = Enabled, data sent to PWS at the specified interval
|-
|-
|HighRainTodayAlarmSound=0
|Interval=15
|Alarm Action
|Interval in minutes that updates will be sent to your PWS weather site
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighRainTodayAlarmSoundFile=C:\Cumulus\alert.wav
|SendUV=0
|Path and file name for the sound file used for the High Rain Today Alarm
|Current Ultra Violet level
*0 = Disabled (default)
*1 = Enabled, UV level sent with normal data
|-
|-
|alarmhighrainrate=0  
|SendSR=0  
|Select in Edit Alarms Screen
|Solar Radiation level
*0 = Disable High Rain Rate alarm (default)
*0 = Disabled (default)
*1 = Enable High Rain Rate alarm
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|HighRainRateAlarmSet=0  
|CatchUp=1
|Rain rate above which you wish alarm to occur
|If possible send missing historic data to the server on startup
*0 = Disabled
*1 = Enabled (default)
|}
 
=== Section: APRS ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
|-
|-
|HighRainRateAlarmSound=0
!style="width:150px" | INI Line Entry
|Alarm Action
!style="width:600px" | Function
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighRainRateAlarmSoundFile=C:\Cumulus\alert.wav
|style="background:lightgray;"|[APRS]
|Path and file name for the sound file used for the High Rain Rate Alarm
|style="background:lightgray;"|Section Name - the following parameters relate to your [[APRS]] weather site parameters
|-
|-
|alarmhighgust=0
|ID=  
|Select in Edit Alarms Screen
|Your APRS identifier
*0 = Disable High Gust alarm (default)
*1 = Enable High Gust alarm
|-
|-
|HighGustAlarmSet=0
|pass=-1
|Gust speed above which you wish alarm to occur
|your APRS password (Note: not encrypted)
|-
|-
|HighGustAlarmSound=0
|server=cwop.aprs.net
|Alarm Action
|The APRS server to use
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighGustAlarmSoundFile=C:\Cumulus\alert.wav
|port=14580
|Path and file name for the sound file used for the High Gust Alarm
|The port number to use on the APRS server.
|-
|-
|alarmhighwind=0  
|Enabled=0  
|Select in Edit Alarms Screen
|Select in Internet Configuration Screen APRS Settings block
*0 = Disable High Average Wind alarm (default)
*1 = Enable High Average Wind alarm
|-
|-
|HighWindAlarmSet=0
|Interval=9
|Average Wind speed above which alarm to occur
|Time in minutes between uploads to the APRS server
|-
|-
|HighWindAlarmSound=0
|APRSHumidityCutoff=1
|Alarm Action
|For Oregon Scientific, so it doesn't report humidity to [[APRS]] when the temperature is below -10&#176;C
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|HighWindAlarmSoundFile=C:\Cumulus\alert.wav
|SendSR=0
|Path and file name for the sound file used for the High Wind Alarm
|Solar Radiation level
|-
*0 = Disabled (default)
|SensorAlarmSet=0
*1 = Enabled, Solar radiation reading sent with normal data
|Select in Edit Alarms Screen
|}
*0 = Disable sensor contact lost alarm (default)
 
*1 = Enable sensor contact lost alarm
=== Section: WOW ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
|-
|-
|SensorAlarmSound=0
!style="width:150px" | INI Line Entry
|Alarm Action
!style="width:600px" | Function
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|SensorAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|style="background:lightgray;"|[WOW]
|Path and file name for the sound file used for the Sensor Contact lost Alarm
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://wow.metoffice.gov.uk/WOW| WOW] weather site parameters
|-
|-
|alarmtempchange=0
|ID=
|Select in Edit Alarms Screen
|Your WOW station ID
*0 = Disable Temperature Change alarm (default)
*1 = Enable Temperature Change alarm
|-
|-
|TempChangeAlarmSet=0
|Password=
|Temperature change value to trigger the alarm
|your WOW password (Note: not encrypted)
|-
|-
|TempChangeAlarmSound=0
|Enabled=1
|Alarm Action
|Updates enabled/disabled
*0 = Disable, (default) no sound on alarm
*1 = Enable sound on alarm
|-
|-
|TempChangeAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|Interval=15
|Path and file name for the sound file used for the Temperature Change Alarm
|Time in mimutes between uploads to the WOW server
|-
|-
|alarmpresschange=0
|SendUV=0
|Select in Edit Alarms Screen
|Current Ultra Violet level
*0 = Disable Pressure Change alarm (default)
*0 = Disabled (default)
*1 = Enable Pressure Change alarm
*1 = Enabled, UV level sent with normal data
|-
|-
|PressChangeAlarmSet=0
|SendSR=0
|Pressure change value to trigger the alarm
|Solar Radiation level
*0 = Disabled (default)
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|PressChangeAlarmSound=0
|CatchUp=1
|Alarm Action
|If possible send missing historic data to the WOW server on startup
*0 = Disable, (default) no sound on alarm
*0 = Disabled
*1 = Enable sound on alarm
*1 = Enabled (default)
|-
|PressChangeAlarmSoundFile=C:\Program Files\Cumulus\alert.wav
|Path and file name for the sound file used for the Pressure Change Alarm
|}
|}


== Section: Offsets ==
=== Section: Weatherbug ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 1,473: Line 1,512:
!style="width:600px" | Function  
!style="width:600px" | Function  
|-
|-
|style="background:lightgray;"|[Offsets]  
|style="background:lightgray;"|[Weatherbug]
|style="background:lightgray;"|Section Name - the following parameters are the correction factors for your specific sensors
|style="background:lightgray;"|Section Name - the following parameters relate to your [http://weather.weatherbug.com| Weatherbug] weather site parameters
|-
|-
|PressOffset=0
|ID=
|Value by which Measured Pressure to be corrected (Add/Subtract)
|Your Weatherbug station ID
|-
|-
|TempOffset=0
|Password=
|Value by which Measured Outdoor Temperature to be corrected (Add/Subtract)
|your Weatherbug password (Note: not encrypted)
|-
|-
|HumOffset=0
|Enabled=1
|Value by which Measured Humidity to be corrected (Add/Subtract)
|Updates enabled/disabled
|-
|-
|WindDirOffset=0
|Interval=15
|Value by which Measured Wind Direction to be corrected (Add/Subtract)
|Time in mimutes between uploads to the Weatherbug server
|-
|-
|InTempOffset=0  
|SendUV=0
|Value by which Measured Indoor Temperature to be corrected (Add/Subtract)
|Current Ultra Violet level
*0 = Disabled (default)
*1 = Enabled, UV level sent with normal data
|-
|-
|WindSpeedMult=1
|SendSR=0
|Multiplier by which measured Average [[Wind_measurement|Wind Speed]] to be corrected.  Officially wind speed is measured with sensors at 10m above ground level.  If your sensor is not at 10m AGL then a correction multiplier should be applied using the following formula ''V10/Vh = 1/(0.233 + 0.656*log10(h+4.75))'' where "h" is your sensor height in meters.
|Solar Radiation level
e.g. if your anemometer is 5m off the ground, V10/Vh comes out at 1.134
*0 = Disabled (default)
*1 = Enabled, Solar radiation reading sent with normal data
|-
|-
|WindGustMult=1  
|CatchUp=1
|Multiplier by which measured Wind Gust Speed to be corrected.
|If possible send missing historic data to the server on startup
|-
*0 = Disabled
|TempMult=1
*1 = Enabled (default)
|Multiplier by which measured Temperature to be corrected.
|-
|HumMult=1  
|Multiplier by which measured Humidity to be corrected.
|-
|RainMult=1
|Multiplier by which measured Rainfall to be corrected.
|-
|UVOffset=0
|Value by which measured UV to be corrected (add/subtract).
|-
|UVMult=1
|Multiplier by which measured UV to be corrected
|}
|}


== Section: xAP ==
=== Section: xAP ===
Set in the Internet Configuration Screen sites/Options tab
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 1,535: Line 1,565:
|}
|}


== Section: NOAA ==
=== Section: NOAA ===
All these can be set in the NOAA Setup Screen in Configuration menu.  You might select to close Cumulus, and edit the 'Norm' parameters by using a external editor to manipulate into required format, copy, and paste, the values from another source (as there are a lot of figures to type in).
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 1,551: Line 1,582:
|-
|-
|State=
|State=
|NOAA location state/county/province
|NOAA location state/county/province or the equivalent in your nation
|-
|-
|12hourformat=0
|12hourformat=0
Line 1,587: Line 1,618:
|AutoSave=0
|AutoSave=0
|If set, when Cumulus does the end of day reset, it will auto create NOAA-style reports for the month and year corresponding to the day which has just ended.
|If set, when Cumulus does the end of day reset, it will auto create NOAA-style reports for the month and year corresponding to the day which has just ended.
|-
|NOAAUseUTF8=0
|(Added in version 1.9.4) Specifies the 'Character set' in which NOAA reports are generated whether automatically (by Cumulus just after rollover) or manually (by selecting '''Save''' in NOAA Monthly/Annual Reports screen within Edit menu).
*0 = Usual Cumulus format (default)  ?? iso-8859-1 ??
*1 = UTF8 ((UCS Transformation Format—8-bit) format - the dominant character encoding for the World-Wide Web as using one to three bytes it represents most characters in common use covering most languages.
|-
|-
|NOAATempNorm[Jan-Dec]=
|NOAATempNorm[Jan-Dec]=
Line 1,598: Line 1,634:
|-
|-
|MonthFileFormat="NOAAMO"mmyy".txt"
|MonthFileFormat="NOAAMO"mmyy".txt"
|Defines the format of the filename used for the monthly reports, using date formatting characters (see [[Webtags#Time.2FDate_.27format.27_Parameter]]). Note that any characters which are not date formatting characters should be in double quotes.
|Defines the format of the filename used for the monthly reports, using date formatting characters (see [[Webtags#Time.2FDate_.27format.27_Parameter]]). The default uses a 2 digit number for the month, but you may prefer the full month name or an abbreviation in your language. Note that any characters which are not date formatting characters should be in double quotes.
|-
|-
|YearFileFormat="NOAAYR"yyyy".txt"
|YearFileFormat="NOAAYR"yyyy".txt"
Line 1,607: Line 1,643:
|}
|}


== Section: Solar ==
=== Section: Solar ===
Set mostly in solar block at foot of Station Settings screen of Configuration menu.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 1,620: Line 1,657:
|-
|-
|RStransfactor=0.8
|RStransfactor=0.8
|Cumulus uses the Ryan-Stolzenbach formula to determine the current theoretical maximum solar radiation at your location at the current moment in time. This formula has a factor to allow for the transmission of the radiation through the atmosphere; the default is 0.8.
|Cumulus uses the Ryan-Stolzenbach formula to determine the current theoretical maximum solar radiation at your location at the current moment in time. This formula has a factor to allow for the transmission of the radiation through the atmosphere; the default is 0.80.
|-
|-
|SolarMinimum=0
|SolarMinimum=0
Line 1,626: Line 1,663:
|-
|-
|LuxToWM2=0.0079
|LuxToWM2=0.0079
|For Fine Offset stations. These supply 'Lux' values rather than 'W/m2' values that Davis stations supply. Cumulus attempts to convert from Lux to W/m2 using the supplied multiplication factor.
|Edit cumulus.ini to add this parameter if you have a Fine Offset station with a solar detector. These supply 'Lux' values rather than 'W/m2' values that Davis stations supply. Cumulus attempts to convert from Lux to W/m2 using the supplied multiplication factor.
|-
|-
|UseBlakeLarsen=0
|UseBlakeLarsen=0
|Set this to 1 if you have a Blake-Larsen Sun Recorder, and you want Cumulus to get today's sunshine hours from it. You need to configure the Blake-Larsen software to put the SRsunshine.dat file into the Cumulus data folder so that Cumulus can read it.
| Called B/l on screen. Set this to 1 if you have a Blake-Larsen Sun Recorder, and you want Cumulus to get today's sunshine hours from it. You need to configure the Blake-Larsen software to put the SRsunshine.dat file into the Cumulus data folder so that Cumulus can read it.
|}
|}


== Section: MainForm ==
=== Section: MainForm ===
This section also appears in a shorter cumulus.ini stored in the reports sub-directory where it stores the position of your last saved NOAA form.
This section also appears in a shorter cumulus.ini stored in the reports sub-directory where it stores the position of your last saved NOAA form.  Cumulus updates this section of the main cumulus.ini on closing, after you move the screen around on your monitor, if you have set 'Save main window position' on Display settings screen.
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 1,649: Line 1,686:
|}
|}


[[Category: Configuration Files]]
=== Section: Proxies ===
HTTPProxyName=
HTTPProxyPort=
HTTPProxyUser=
HTTPProxyPassword=
5,838

edits