Welcome to the Cumulus Support forum.

Latest Cumulus MX release 3.11.4 (build 3133) - 25 May 2021 (please see announcement regarding releases since 3.5.0)
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: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

User avatar
HansR
Posts: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

User avatar
HansR
Posts: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

User avatar
HansR
Posts: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

User avatar
HansR
Posts: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

User avatar
HansR
Posts: 2159
Joined: Sat 20 Oct 2012 6:53 am
Weather Station: Davis Vantage Pro 2+
Operating System: Raspbian GNU/Linux 10 (Buster)
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
Cumulus build 3132 ● Davis Vantage Pro 2+ ● RPi 3B+ ● Raspbian 5.10.17-v7+ ● Mono 5.18.0.240

Locked