Welcome to the Cumulus Support forum.

Latest Cumulus MX V3 release 3.28.5 (build 3282) - 23 February 2024

Cumulus MX V4 beta test release 4.0.0 (build 4017) - 17 March 2024

Legacy Cumulus 1 release v1.9.4 (build 1099) - 28 November 2014 (a patch is available for 1.9.4 build 1099 that extends the date range of drop-down menus to 2030)

Download the Software (Cumulus MX / Cumulus 1 and other related items) from the Wiki

CumulusUtils

Discussion of the Cumulusutils tool and website generator.

Moderator: HansR

Locked
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.5.0 is online - see release notes

Version 5.5.0 (29/05/2021)
  1. Distribution: file CUabout.txt has a name change: CUserAbout-example.txt. CUserAbout.txt - if it exists - will be automatically uploaded with the package
  2. Distribution: file CUsermenu.txt will be automatically uploaded if it exists
  3. Distribution: file CUlicense.txt has been removed and replaced by the file LICENSE (with identical content to the website menu choice)
  4. Compiler: Errorhandling of Expression in case of error, now gives an error in the definition of the charts and fallback to the default charts (it was a warning)
  5. Compiler: STATS and PLOT are now handled as equal entry points of the PLOT section of the CHART (see prev version of CDL image to appreciate the difference)
  6. Compiler: a PLOT variable may now have a non-keyword name but if so, it MUST be followed by an equation which contains a valid Plotvariable, if not an error is generated.
  7. Compiler: And if a PLOT has an Eval equation it MUST now have a non-keyword name to prevent confusion and make a unique legend entry (useful for modification or translation)
  8. Compiler: Added the function LN (being the natural logarithm of its argument)
  9. Compiler: Added the function EXP (being the power function with base e)
  10. Compiler: All Plotvariables can be used in one single equation to be combined with operators and functions NOTE: this must be seen as beta function as it is impossible to check all
  11. combinations of variables, operators and functions. I don't expect this to work flawlessly although confident. Just play with it and provide me with observations and questions for
  12. functionality.
  13. Compiler: The SUM function can only be used once per chart
  14. Wiki: Updates conform development (please notify voids or unclarities)
NOTE:
  • Because meteo-equations can reach a certain complexity (definitely when written on a single line) a change is considered which should make it possible to use Plotvariables as intermediate calculations or have a definition of partial equations (not plotted) which you might use in Plot. As an example (see the last chart below) One might consider calculating a dewpoint with the Actual Vapour pressure as an intermediate equation.
  • A second change which is considered is making the EVAL and STATS available for the RECENT parameters as well.
However, the side effects of the above may be larger than expected, so it requires some study. In the mean time : have fun!

NOTE: All calculations and array handling in the generated code are totally unsophisticated and non-optimised. This will only change slowly as performance is astonishingly good, beyond expectations, even on my old tablet and phone. Performance reports are welcome.

Below you find three test charts as examples to show what is now possible (the full testset is as always in CutilsCharts-example.def in the distribution and viewable on my site):

Code: Select all

CHART DailyTemp TITLE Temp with statistics offset 5
   PLOT ALL AverageTemp colour pink
   PLOT ALL sumAverageTemp EVAL [ ln(Sum(AverageTemp-5)) ] COLOUR green AXIS DegreeDays
   STATS AverageTemp SMA COLOUR crimson
 EndChart Output Statistics.txt

 CHART DailyRain TITLE Rain with statistics
   PLOT ALL RainFall colour CornflowerBlue as column 
   PLOT ALL sumRainFall EVAL [ exp(ln(SUM( RainFall))) ] COLOUR crimson AXIS Free
   STATS RainFall SMA colour green
 EndChart 

 Chart MyDewPoint Title Dewpoint calculations in CDL
   Plot all minBarometer 
   Plot all maxBarometer
   Plot All ActualVapourPressure Eval [ MinHumidity/100 * 6.112 * EXP(17.62*AverageTemp/(243.12+AverageTemp)) ] Axis Pressure
 EndChart
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.5.1 is online (See release notes)

Version 5.5.1 (03/06/2021)
  1. Compiler: Value arrays need to be reinitialised when the chart remains open and has its periodic (ftp upload frequency) refresh.
  2. pwsFWI: the Current pwsFWI button moved to the Left Header Text position to improve handling on a portrait held tablet
  3. General: Provided for non-contiguous data series (missing years and/or months).
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

A note for users of the ChartsCompiler: if you use Plotvariables which you did not activate in CumulusMX (e.g. inside temperature and humidity are likely candidates) , you will have errors in the runtime of the charts which you can spot by pressing F12, choosing console.

You have to either switch those variables on or you have to modify your chart to not include those variables.

If those errors remain many features of cumulusutils will not work (e.g. the click events and the charts themselves).
Please report if you have issues.

NOTE: also take care of the settings of GeneratejQueryInclude and DoLibraryIncludes
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.5.2 is online (See release notes)
  1. pwsFWI: the Current pwsFWI button now has forced text colour (not inherited by the background)
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.6.0 is online (See Release Notes)
  1. MeteoCam: First release of a simple MeteoCam (Webcam) module. See Wiki.
  2. ChartsCompiler: Lines starting with a semicolon [;] are now treated as comment.
  3. ChartsCompiler: Equations section added (see wiki for CDL) and they can be substituted in other EVAL equations
  4. ChartsCompiler: EVAL and STATS now work for both the ALL and the RECENT ranges
NOTE: The combination of the EQUATIONS block and the EVAL of PLOT makes it possible to evaluate more complex (as in meteorological) Equations. The Possibility of combining Plotvariables and calculations makes it possible to evaluate different approximations for e.g. Dewpoint. Both clarified by the example below. The release contains as usual a complete set of test charts. Sometimes with meaning, sometimes just for testing. This set of test charts is an example and a test. Nothing more.

Code: Select all

Equations
  test1 EVAL [ Humidity/100 * 6.112 ]
  test2 EVAL [ EXP(17.62*Temperature/(243.12+Temperature)) ]

; Documentation:
; https://iridl.ldeo.columbia.edu/dochelp/QA/Basic/dewpoint.html
; Compare the Dewpoint from Cumulus with a calculated approximation
; Later I will enter the Cumulus Calculation and have the Dewpoint be produced by the Davis station
; Nice comparison
;
Chart MyDewpoint Title Dewpoint Calculations in CDL
  Plot RECENT Dewpoint
  Plot RECENT CalcDewpoint EVAL [ Temperature - ((100 - Humidity)/5) ] Axis Temp
;  STATS Dewpoint SMA colour green
EndChart

Chart MyPressure Title Vapour pressure calculations in CDL
  Plot RECENT Pressure
  Plot RECENT MyActualVapourPressure Eval [ test1 * test2 ] Axis Free
EndChart
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.6.1 is online (Bug fix compiler See Release Notes)
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 5.6.2 is online (See Release Notes)

Please note that I will be out of the loop until somewhere the 20th July.
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.0.0 is online (See Release Notes)

The ChartsCompiler will no doubt get some additions and modification in future but at the moment it can generate all charts by CMX and it can also plot additional data which are not standard charted by CMX (like e.g. heating degreedays). It can also generate plots of elementary meteorological equations which are not standard in CMX (like e.g. the Saturation pressure according to the equation in 2008 and 1980 (WMO) which shows an interesting difference. It can be easily used by any website using the output with the usual inclusion technique. Up to you to see where it can go.

There is a Change Request thread now ;)
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.0.1 is online (See Release Notes)

Though functional minor changes, not only the executable has been affected. Please read the release notes.
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.1.0 is online (See Release Notes)

This is functionally a minor release but it has some traps in it (if you are a module user) so take care, read the release notes:
  1. The chart container now has a General parameter: ChartContainerHeight=650 (in px) giving it a standard height for all chart occurrences. This is especially important for module users who generally want to vary the height of the chart container to fit their own sites design but it is also useful if you have the website on a wide or vertical. The value holds for all charts (Home page, Compiler and Graphs)
  2. All charts are now boxed with the thin line with curved corner for uniform appearance. Same as point 1.
  3. I changed all references of AirQuality to AirLink where the device was meant. This also holds for all variables the user does not see. The user does see however the output file of the AirLink module: airlink.txt (which was airquality.txt. For the website users it is irrelevant but for the one user (yes he exists) who uses this module as singular module be aware!
  4. Changed the inifile section AirQuality to section AirLink (Note the capital L). You may want to rename the section to prevent reconfiguration of the AirLink.
Next release is intended to carry support for the Extra Sensors, at least partially.
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.1.1 is online (See Release Notes)

Bug fix release for logging information which was missing
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.5.0 is online (See Release Notes)

This version contains the first release of the Extra Sensors module. It is a rather complex module in the sense that it organises in a generic way the Extra Sensors which have been left somewhat disorganised by CumulusMX. Please read the Wiki and if any problem occurs ask on the forum.

Please note that from this version on it is obligatory to use the CutilsCharts.def file (see distribution) and make use of the ChartsCompiler.
The ExtraSensors module can't do without and has effect on the home button charts.

All other modules remain unmodified.
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.5.1 is online (See Release Notes)

This is just a minor finishing touch in the 6.5.0 ExtraSensors release.

It seems to me, with the current standings, that there is nothing more to add ( I believe I said that before 8-) ) unless CMX changes fundamentally.
So next releases, if any, will probably focus on performance and other technical improvements.

Unless of course you come up with some great suggestions.
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.5.2 is online (See Release Notes)

This is bug fix release to version 6.5.1
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
User avatar
HansR
Posts: 5831
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: GW1100 (WS80/WH40)
Operating System: Raspberry OS/Bullseye
Location: Wagenborgen (NL)
Contact:

Re: CumulusUtils

Post by HansR »

Version 6.6.0 is online. On Linux Mono 6 and up is required. (See release notes)
Hans

https://meteo-wagenborgen.nl
CMX build 4017+ ● RPi 3B+ ● Raspbian Linux 6.1.21-v7+ armv7l ● dotnet 8.0.3
Locked