Cumulusutils.ini

Revision as of 08:23, 25 September 2022 by HansR (talk | contribs) (→‎[ExtraSensors])

Introduction

CumulusUtils is a configurable application and its parameters are stored in the file CumulusUtils.ini.

This page will list most parameters and if deemed necessary, a short explanation will be given. Most parameters will be discussed on the page of the module.

The phrase most parameters is used, because parameters - if non-existent - are created with their default values when used during a run of CumulusUtils. As not all parameters are needed, those not needed will not be seen by the user. Although through testing I assume my inifile has all parameters, I cannot guarantee that: the complexity has increased quickly and I may have missed some. You are invited to notify me or update this file yourself. (I and me being HansR)

The order of the parameters can be changed by the user and will be maintained. This can be handy in grouping parameters within sections, especially for the larger sections like Website and Graphs

Lines starting with a semicolon (';') are treated as comment and ignored.

Each parameter can be reset to its default by simply deleting it from the file. A new entry will be created with its default value on the next run, adding it to the end of the already existing section. A total reset of all parameters is accomplished by deleting this file, the user has to start from scratch.

Listing of the Parameters per section

[General]

LoggingOn=true
NormalMessageToConsole=true
TraceInfoLevel=Info
IgnoreDataErrors=true
GeneratejQueryInclude=false
DoLibraryIncludes=false
;Language=nl-NL
Language=en-GB
MonthsOfMiracleAndWonder=jan,feb,mrt,apr,mei,jun,jul,aug,sep,okt,nov,dec
ChartContainerHeight=700
ChartBackgroundImage=
UseScrollableTables=true NOTE: Used for Day Records and pwsFWI. The thin scrollbar does work with FireFox but not with Chrome

The parameters GeneratejQueryInclude and DoLibraryIncludes require special attention. Please read the chapter on the modules for modular use of javascript libraries.

[pwsFWI]

Analyse=90
WarningLevel=5
ResultFormat=beteljuice
FireImage=true
predictionURL=http://api.yourweather.co.uk/index.php?api_lang=en&localidad=185686&affiliate_id=52wzikfato88&v=2.0
PredictionBackground=Moccasin
CurrentIndexFormat=Standard
;CurrentIndexFormat=Betel-Kocher
CurrentIndexDay=Today
CurrentPwsFWI=<span id='CurrentPwsFWI' style="border: 1px solid black;text-align:center;background:green;color: white">  26.4 pwsFWI</span>

NOTE: CurrentPwsFWI is not configurable but is set/read by the application. Any value you put here will be modified.

[Top10]

BackgroundColorHeader=#d0d0d0
BackgroundColorTable=#f0f0f0
TextColorAccentTable=DarkOrange
TextColorHeader=Green
NumberOfColumns=3

[NOAA]

FTPDirectory=./reports/
ColorNOAAText=Black
ColorNOAABackground=#f9f8EB
StartInCurrentMonth=true

NOTE: the report directory MUST be the directory you configure in Cumulus.ini

[Graphs]

UseHighchartsBoostModule=true
UseNormalTempReference=both
UseNormalRainReference=both
MaxNrOfSeriesVisibileInGraph=3
PeriodMovingAverage=365
WindRoseNrOfWindforceClasses=6
WindRoseMaxWindSpeed=60
WindRoseInversed=false
WindrunClassWidth=75
DailyRain=true
MonthlyRain=true
YearRainstats=true
YearMonthRainstats=true
MonthlyTemp=true
YearTempstats=true
YearMonthTempstats=true
WarmerDays=true
HeatMap=true
WindRose=true
Windrun=true
SolarHours=true
SolarEnergy=true
SolarHoursYearMonth=true
SolarEnergyYearMonth=true
TempSum=true
GrowingDegreeDays=true
Seasons=true
DailyEVT=true
MonthlyEVT=true
AverageClash=true
GraphColors=
;GraphColors=['#058DC7', '#50B432', '#ED561B', '#DDDF00', '#24CBE5', '#64E572', '#FF9655', '#FFF263', '#6AF9C4']
WindRoseColors=
;WindRoseColors=['lightgrey', 'green', 'blue', 'yellow', 'orange', 'red', 'deeppink', 'purple', 'black']
HeatmapNumberOfYearsPerPage=10
GrowingDegreeDaysReferenceTemp=5
WinterToSpringTemperatureLimit=5
SpringToSummerTemperatureLimit=15

[FTP site]

DoUploadFTP=true
UploadDir=
FtpLog=on

[Maps]

Website=https://meteo-wagenborgen.nl/
Participant=true
DoneToday=15-05-21

[Website]

GoogleStatsId=
CumulusRealTimeLocation=
ShowInsideMeasurements=true
CumulusRealTimeInterval=30
ShowUV=true
ShowSolar=true
HeaderLeftText=
HeaderRightText=<a href='http://cumulussites.net/'><img src='http://cumulussites.net/button.php?u=HansR' style='border-width:0' alt='Cumulus Top Weather Sites'/></a>
PermitGoogleOptout=true
SiteTitleAddition=
ColorMenuBackground=Lightgrey
ColorMenuText=Black
ColorDropdownMenuBackground=Lightgrey
ColorDropdownMenuText=Black
ColorDropdownMenuHoverBackground=Silver
ColorDropdownMenuHoverText=Black
ColorTitleBar=#E87510
ColorTitleText=White
ColorDashboardCellTitleBarBackground=#C5C55B
ColorDashboardCellTitleBarText=White
ColorDashboardCellText=Black
ColorDashboardCellBackground=White
ColorReportviewText=black
ColorReportviewBackground=white
ColorReportviewTableData=Black
ColorFooterLink=#E87510
ColorFooterLinkHover=OrangeRed
ColorFooterBackground=lightgrey
ColorFooterText=Black
ColorBodyBackground=white
ColorDashboardTextAccent=Chartreuse
ColorTitleBackGroundImage=
ColorToggler=Black
ColorDashboardUpIndicator=Chartreuse
ColorDashboardDownIndicator=Red
SteelseriesFramedesign=SHINY_METAL
SteelseriesBackgroundColor=BROWN
SteelseriesPointerColour=RED
SteelseriesPointerType=type3
SteelseriesDirAvgPointertype=TYPE3
SteelseriesDirAvgPointerColour=BLUE
SteelseriesLcdColour=ORANGE
SteelseriesForegroundType=type1
SteelseriesKnobType=STANDARD_KNOB
SteelseriesKnobStyle=SILVER
SteelseriesRainUseSectionColours=true
SteelseriesRainUseGradientColours=true
SteelseriesTempThresholdValue=30
SteelseriesLedVisible=false
ThresholdTempVisible=true
ThresholdTempValue=30
ThresholdHumidityVisible=true
ThresholdHumidityValue=80
ThresholdWindVisible=true
ThresholdWindValue=30
ThresholdRainVisible=true
ThresholdRainValue=20
ThresholdRRateVisible=true
ThresholdRRateValue=10
ThresholdUVVisible=true
ThresholdUVValue=8
HomeGraphTempColor=#058DC7
HomeGraphDewPointColor=#50B432
HomeGraphApparentTempColor=#ED561B
HomeGraphFeelsLikeColor=#DDDF00
HomeGraphWindChillColor=#24CBE5
HomeGraphHeatIndexColor=#64E572
HomeGraphHumidexColor=#FF9655
HomeGraphInsideTempColor=#6AF9C4
HomeGraphPressureColor=#058DC7
HomeGraphBearingColor=#058DC7
HomeGraphAverageBearingColor=#ED561B
HomeGraphWindSpeedColor=#058DC7
HomeGraphWindGustColor=#ED561B
HomeGraphRainfallColor1=#50B432
HomeGraphRainfallColor2=
HomeGraphRainfallColor3=
HomeGraphRainRateColor=#058DC7
HomeGraphHumidityColor=#058DC7
HomeGraphInsideHumidityColor=#50B432
HomeGraphSolarTheoreticalMaxColor1=#DDDF00
HomeGraphSolarTheoreticalMaxColor2=
HomeGraphSolarTheoreticalMaxColor3=
HomeGraphSolarRadiationColor1=#FF9655
HomeGraphSolarRadiationColor2=
HomeGraphSolarRadiationColor3=
HomeGraphUVindexColor=#058DC7
HomeGraphSunHoursColor=gold
HomeGraphDailyRainColor=#058DC7
HomeGraphLineWidth=2
HomeGraphDailyTempAverageColor=#50B432
HomeGraphDailyTempMinColor=#058DC7
HomeGraphDailyTempMaxColor=#ED561B
Panel-1=TemperatureText
Panel-2=PressureText
Panel-3=RainText
Panel-4=Clocks
Panel-8=WindText
Panel-9=SolarDisc
Panel-10=LunarDisc
Panel-11=HumidityText
Panel-12=SolarText
Panel-13=TemperatureGauge
Panel-14=OtherTempsGauge
Panel-15=PressureGauge
Panel-16=HumidityGauge
Panel-20=CloudBaseGauge
Panel-21=RainGauge
Panel-22=RainSpeedGauge
Panel-23=SolarGauge
Panel-24=UVGauge
UseCMXMoonImage=false
ColorTitleBackGroundImage=HPIM3899_day.JPG
ColorTitleBackGroundImageCivil=HPIM3899_civil.JPG
ColorTitleBackGroundImageNautical=HPIM3899_nautical.JPG
ColorTitleBackGroundImageAstronomical=HPIM3899_astronomical.JPG
ColorTitleBackGroundImageNight=HPIM3899_night.JPG

[Forecasts]

SevenDayPredictionURL=http://api.yourweather.co.uk/index.php?[registration specifics]
ForecastSystem=SpotWx
NorwegianURL=https://retro.yr.no/place/Netherlands/Groningen/Wagenborgen/
WXsimURL=

NOTE: the Norwegian site is in process of transition, it will be reworked sometime. At some point it may cease to function.

[SysInfo]

ReportWidth=700
SystemInfoLinesToSkip=
ExtraStationInfo=
CMXport=8998
Tx=

[Thrifty]

Top10RecordsPeriod=1
RainGraphsPeriod=1
TempGraphsPeriod=1
WindGraphsPeriod=3
MiscGraphsPeriod=1
MapsPeriod=1
SolarGraphsPeriod=3

[StationMap]

StationMapMenu=true
ArrowLatitude=53.2948
ArrowLongitude=7.0673
Zoomlevel=13
CompassRosePosition=bottomright
CompassRoseType=2
WindArrowType=1

[Compiler]

DoneToday=04-09-21

[MeteoCam]

MeteoCamMenu=true
MeteoCamDir=./MeteoCam
TimelapseExtension=mp4
MeteoCamName=meteocam.jpg

[AirLink]

(before version 6.1 this section was [AirQuality]

CountrySelected=EU
WantToSeeNow=true
WantToSeeNowCast=true
WantToSee1hr=true
WantToSee3hr=true
WantToSee24hr=true
WantToSeeWind=true
CleanupAirlinkLogs=false
ReferenceLineThickness=4

[ExtraSensors]

ExtraSensors=false                       => If false the module is skipped, no menu entry will be made
ParticipatesSensorCommunity=false        => If false, the menu option SC map will not be generated
CleanupExtraSensorslog=false             => If true will remove old logfiles and keep only the current and the previous month
UserModificationExtraSensorCharts=false  => If true the Extra Sensor charts will not be overwritten in CutilsCharts.def and give the user the possibility to create his own charts
LightningSensor=false                    => [Valid from version 7 and up]
                                           If true the Ecowitt Lightning sensor is present and will be presented in the module.
                                           (NOTE that this sensor is not logged by CMX and therefore does not have a corresponding chart)
ExternalExtraSensors=                    => A comma separated list of strings naming the External Extra Sensors the user wishes to use (See External Extra Sensors)


NOTE:
DoneToday is not configurable but is set/read by the application. Any value you put here will be modified. If the date is today then the corresponding action will not be carried out. You can force the action by emptying this parameter.