Cumulus.ini (preserving history): Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
m
→‎Section: Solar: Merged the two separate table into a single table, instead of separate table for MX only parameters
m (→‎Section: Solar: Merged the two separate table into a single table, instead of separate table for MX only parameters)
(8 intermediate revisions by the same user not shown)
Line 2,039: Line 2,039:
=== Section: Solar ===
=== Section: Solar ===


Not applicable to Cumulus 1.
{{Version badge 1}}Set mostly in '''solar block''' at foot of ''Station Settings'' screen in Configuration menu.


[[File:Badge vMx.png]] Available from version 3.0.0 only.
[[File:Badge vMx.png]]Set in '''Solar''' section quite a long way down on ''Station settings'' page in Settings menu


{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
!style="width:150px" | Parameter Line Entry
!style="width:150px" | Parameter Line Entry
!style="width:800px" | Function  
!style="width:600px" | Function  
|-
|style="background:lightgray;"|[Solar]
|style="background:lightgray;"|Section Name - the following parameters are set as described above
|-
|colspan="2" style="background:lightblue;"| Both Cumulus flavours
|-
|SunThreshold=75
|If you have a solar sensor: Cumulus tries to determine whether the sun is shining by determining whether the current solar radiation value is above a certain percentage of the current theoretical maximum. The value you supply here is used as that percentage. The default value is 75%.
|-
|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.80.
|-
|SolarMinimum=0
|This setting allows you to specify a minimum solar radiation value which needs to be reached before it can be considered to be sunny. Note that this setting does not replace the calculation using the current theoretical maximum, it specifies an additional condition which has to be met. This setting therefore allows you to cater for the periods at the beginning and end of the day when the theoretical maximum is very low.
|-
|LuxToWM2=0.0079
|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. You can add this parameter if you want to use a value other than the default of 0.0079, which is the generally accepted standard conversion factor for sunlight.
|-
|-
|style="background:lightgray;"|[Solar]
|UseBlakeLarsen=0
|style="background:lightgray;"|Section name - the following parameters relate to the solar configuration.
| 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.
|-
|-
|colspan="2" style="background:lightblue;"| Cumulus MX only
|colspan="2" style="background:lightblue;"| [[File:Badge vMx.png]] Available from MX version 3.0.0 only
|-
|-
|SolarCalc=1
|SolarCalc=1
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when the solar calculation method is set.
The value is set in the MX user interface when the solar calculation method is set.
*0 (default) = Ryan-Stolzenbach calculation, which uses the RStransfactor entry to tune the output.
*0 (default) = Ryan-Stolzenbach calculation, which uses the RStransfactor entry to tune the output.
*1 = Bras calculation, which uses the BrasTurbidity entry below to tune the output.
*1 = Bras calculation, which uses the BrasTurbidity entry below to tune the output.
|-
|-
|BrasTurbidity=2.0
|BrasTurbidity=2.0
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when the solar calculation method is set.
*2.0 (default) = Perfect clear sky
*2.0 (default) = Perfect clear sky
*decimal value = The normal range is 2 (Clear sky) to 5 (Smoggy)
*decimal value = The normal range is 2 (Clear sky) to 5 (Smoggy)
Line 2,855: Line 2,871:
==== Section: xAP ====
==== Section: xAP ====


{{Version badge 1}Set in the Internet Configuration Screen sites/Options tab
{{Version badge 1}}Set in the Internet Configuration Screen sites/Options tab


[[File:Badge vMx.png]]It is in Cumulus.ini for MX, but nobody has told me whether it can be edited within the Admin interface.
[[File:Badge vMx.png]]It is in Cumulus.ini for MX, but nobody has told me whether it can be edited within the Admin interface.
Line 2,880: Line 2,896:


==== Section: WeatherCloud ====
==== Section: WeatherCloud ====
Not available in Cumulus 1


[[File:Badge vMx.png]] Only available from version 3.0.0
[[File:Badge vMx.png]] Only available from version 3.0.0
Line 2,894: Line 2,912:
|-
|-
|Wid=
|Wid=
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when the Weathercloud ID value is set.
The value is set in the MX user interface when the Weathercloud ID value is set.
|-
|-
|Key=
|Key=
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when your Weathercloud API Key value is set.
The value is set in the MX user interface when your Weathercloud API Key value is set.
|-
|-
|Enabled=0
|Enabled=0
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|This parameter controls whether data is sent to WeatherCloud
*0 = Disable sending of data (default)
*0 (default) = Disable sending of data
*1 = Enable sending of data
*1 = Enable sending of data
|-
|-
|SendUV=0
|SendUV=0
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when the Include UV value is set.
The value is set in the MX user interface when the Include UV value is set.
*0 = Do not send UV data (default)
*0 = Do not send UV data (default)
*1 = Send UV data
*1 = Send UV data
|-
|-
|SendSR=0
|SendSR=0
|This parameter (attribute=value) can be added directly to the file, it does also appear on the user interface screen.
|The value is set in the MX user interface when the Include Solar Radiation value is set.
The value is set in the MX user interface when the Include Solar Radiation value is set.
*0 = Do not send Solar data (default)
*0 = Do not send Solar data (default)
*1 = Send Solar data
*1 = Send Solar data
|}
|}


==== Section: WLL ====


 
Not available in Cumulus 1
 
==== Section: WLL ====


[[File:Badge vMx.png]] Only available from version 3.0.0
[[File:Badge vMx.png]] Only available from version 3.0.0
Line 2,983: Line 2,996:


==== Section: Windy ====
==== Section: Windy ====
Not available in Cumulus 1


[[File:Badge vMx.png]] Only available from version 3.0.0 build 3049 onwards. Edit all parameters in the '''Internet settings''' screen, ''Windy.com'' section.
[[File:Badge vMx.png]] Only available from version 3.0.0 build 3049 onwards. Edit all parameters in the '''Internet settings''' screen, ''Windy.com'' section.
Line 3,016: Line 3,031:


=== 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 'NOAATempNorm[Jan-Dec]' and 'NOAARainNorm[Jan-Dec]' 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).


'''Please note:''' because this section of Cumulus.ini uses [[Webtags#Time.2FDate_.27format.27_Parameter|date format]] parameters, it is not directly exchangeable between Cumulus 1 and Cumulus MX. You will need to update this section using the NOAA Setup Screen in Configuration menu.
{{Version badge 1}}All these can be set in the '''NOAA Setup Screen''' in Configuration menu. 
 
[[File:Badge vMx.png]]Set these setting on the '''NOAA Settings''' page within Settings menu.
 
You might select to close Cumulus, and edit the 'NOAATempNorm[Jan-Dec]' and 'NOAARainNorm[Jan-Dec]' 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).
 
'''Please note:''' because this section of Cumulus.ini uses [[Webtags#Time.2FDate_.27format.27_Parameter|date format]] parameters, you are advised to read [[Webtags#The_format_used_for_naming_reports]].
 
The settings that you use for Cumulus 1 may not be the same as settings you use for MX.  If for Cumulus 1, you used capital "M" to represent month it will work for MX too. If for Cumulus 1 you used "NOAAMO'mmyy'.txt" and you then move to MX at any version from version 3.3.0 onwards, it will automatically change your setting to "NOAAMO'MMyy'.txt" (which works on both Cumulus MX and, if you then revert, also on Cumulus 1).
 
 
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
Line 3,096: Line 3,120:
|NOAARainNorm[Jan-Dec]=-1000
|NOAARainNorm[Jan-Dec]=-1000
|Long term rainfall averages for each month, used for 'departure from the norm' calculations. '-1000' is used to represent Null, a parameter that has not yet been set
|Long term rainfall averages for each month, used for 'departure from the norm' calculations. '-1000' is used to represent Null, a parameter that has not yet been set
|}
=== Section: Solar ===
Set mostly in solar block at foot of Station Settings screen.
{| class="wikitable" border="1"
|-
!style="width:150px" | Parameter Line Entry
!style="width:600px" | Function
|-
|style="background:lightgray;"|[Solar]
|style="background:lightgray;"|Section Name - the following parameters are set from the Solar Setup dialog in Cumulus
|-
|SunThreshold=75
|If you have a solar sensor: Cumulus tries to determine whether the sun is shining by determining whether the current solar radiation value is above a certain percentage of the current theoretical maximum. The value you supply here is used as that percentage. The default value is 75%.
|-
|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.80.
|-
|SolarMinimum=0
|This setting allows you to specify a minimum solar radiation value which needs to be reached before it can be considered to be sunny. Note that this setting does not replace the calculation using the current theoretical maximum, it specifies an additional condition which has to be met. This setting therefore allows you to cater for the periods at the beginning and end of the day when the theoretical maximum is very low.
|-
|LuxToWM2=0.0079
|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. You can add this parameter if you want to use a value other than the default of 0.0079, which is the generally accepted standard conversion factor for sunlight.
|-
|UseBlakeLarsen=0
| 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.
|}
|}


5,838

edits

Navigation menu