Compare C1 and MX: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
(New page)
 
Line 1: Line 1:
=Introduction=
=Introduction=


At hte time of writing this text, there are two flavours of software that was originally developed by Steve Loft. The original Cumulus software (now called Legacy Cumulus 1) is no longer capable of being developed any further, as neither its development environment, nor its source, are available now. There was a Cumulus 2, but it is no longer available, some of its functionality was subsequently added to Cumulus 1, and some of its concepts formed the basis for Cumulus 3 (now generally known as Cumulus MX).
At the time of writing this text, there are two flavours of software that was originally developed by Steve Loft. The original Cumulus software (now called Legacy Cumulus 1) is no longer capable of being developed any further, as neither its development environment, nor its source, are available now. There was a Cumulus 2, but it is no longer available, some of its functionality was subsequently added to Cumulus 1, and some of its concepts formed the basis for Cumulus 3 (now generally known as Cumulus MX).


This page compares functionality between the original Cumulus software and the current Cumulus MX software. It is aimed at those who are using the original software, and are unsure whether to keep using Cumulus 1, or to make the swap to Cumulus MX.
This page compares functionality between the original Cumulus software and the current Cumulus MX software. It is aimed at those who are using the original software, and are unsure whether to keep using Cumulus 1, or to make the swap to Cumulus MX.
Line 8: Line 8:


A basic introduction to the functionality available in both flavours of Cumulus software can be found at [[About Cumulus]]. That explains some of the background to its development and what functionality both flavours offer.
A basic introduction to the functionality available in both flavours of Cumulus software can be found at [[About Cumulus]]. That explains some of the background to its development and what functionality both flavours offer.



= Overview comparing Cumulus 1 and MX =
= Overview comparing Cumulus 1 and MX =

Revision as of 19:41, 29 January 2021

Introduction

At the time of writing this text, there are two flavours of software that was originally developed by Steve Loft. The original Cumulus software (now called Legacy Cumulus 1) is no longer capable of being developed any further, as neither its development environment, nor its source, are available now. There was a Cumulus 2, but it is no longer available, some of its functionality was subsequently added to Cumulus 1, and some of its concepts formed the basis for Cumulus 3 (now generally known as Cumulus MX).

This page compares functionality between the original Cumulus software and the current Cumulus MX software. It is aimed at those who are using the original software, and are unsure whether to keep using Cumulus 1, or to make the swap to Cumulus MX.

It is not intended to be a prompt list for features to be considered for future inclusion in MX.

A basic introduction to the functionality available in both flavours of Cumulus software can be found at About Cumulus. That explains some of the background to its development and what functionality both flavours offer.

Overview comparing Cumulus 1 and MX

This is an overview, there will be further explanation later.

Unfortunately, there is no list anywhere of all features in Cumulus 1. About_Cumulus does not cover all features. Nor is there a list of features in, or still to be introduced into, MX. Thus this section is neither authoritative nor definitive.

Cumulus 1

  • Cumulus 1 is software that only runs on Windows Operating System
  • Cumulus 1 has an installer that you download and run to create all the files that are needed
  • Cumulus 1 has a built-in Graphic User Interface
    • The main screen summarises key current values (with some extra ones revealed when you mouse over parts of the screen) with a menu giving access to the other screens
    • The View menu let you view data (e.g. View period shows you data for any one day, for any week, month, year, season or any other period) and lets you view the standard data logs and the extra sensor data logs
    • The Edit menu lets you edit the extreme records and some of the log files (in original Cumulus, you can edit any file that contains extremes for one day or more, you cannot edit the standard data logs nor the extra sensor data logs)
    • The Configuration menu lets you adjust the most useful of many settings available
    • The file menu lets you request an upload, print a screen shot, or exit the software
    • Select-a-graph gives you ability to plot whatever variable and period you want
  • Cumulus 1 comes with an example set of web templates (showing how Web tags can be used to add the weather outputs that Cumulus generates to a web page
  • Cumulus 1 can generate file containing images of graphs that you can view (and customise) on the view menu, and optionally upload to a web server (web site).
  • Cumulus 1 creates a special log containing just temperature and humidity values, this is NOT available in MX.
  • Cumulus 1 generates a moon phase image, that is produced from a picture of a full moon by applying a mask so the final image can also represent a waning/waxing moon (such as a crescent).

Cumulus MX

  • MX runs on multiple Operating Systems (OS).
    • MX runs on all UNIX-derived OS (principally Linux, Raspberry Pi Operating System, Apple Mac OS X), but it needs Mono runtime software to support running of executables
    • To run MX on Windows, you need .NET installed, which is included on Windows 7 upwards. (This does mean MX cannot run on Vista, XP, or older Windows OS).
  • MX releases are made available as a zip containing all the files in the distribution in their hierachic positions
    • There are two executables included in a MX release
    • A pre-built image, combining the MX distribution, and a Raspberry Lite OS, is also made available by the developer, this is for those with 2 devices on their local network; who run their Raspberry Pi computer in headless mode, and do all setting-up via their second computer
    • There are third party tools to aid installation, and upgrade
  • Like Cumulus 2, the MX executable is just an engine to drive the various processes, but CumulusMX.exe generates a web server
  • The web server generated by CumulusMX.exe runs the separate admin interface where you can adjust settings, and locally view all the data that MX outputs
  • MX comes with an example set of web templates (showing how Web tags can be used to add the weather outputs that Cumulus generates to a web page
  • MX generates charts that you can view on the admin interface, and generates data for trends page that can be optionally uploaded to a web server (web site) where that data is used to draw charts.
  • MX (except in early releases) has a full moon image and uses a system routine to create an image that correctly shows the current phase, updated at every hour, and optionally uploaded to your web server


Comparing these two lists it is already obvious each of the two flavours has some features that are not available in the other. Some of the functionality listed above was not available in early releases. There is a section later on this page indicating which releases added certain functionality. Initially, there was an attempt to add some Cumulus 1 features that were not in the MX beta. But MX development is now largely focussed on resolving bugs (and there seem to be many in the beta) and adding new functionality (it might take a few releases before the new functionality is bug free).

There are no plans to add two useful Cumulus 1 (C1) features to MX:

  • Select-a-graph (although both C1 and MX have control over what is plotted, C1 offers more control over period to be plotted than MX does)
  • View Period (C1 allows a table summarising various derivatives to be output for any period from 1 day to all-time, MX pre-determines what period its tables cover, and as shown below omits several derivatives).

Derivatives only available in original Cumulus

This period.PNG

Cumulus 1 (but not MX) calculates various additional parameters for any period from one day, through a month or year, to any number of days, in current or past years (you select start and end dates):

  • Average temperature from all readings (at 1 minute intervals if Cumulus is left running) in period
  • Average temperature from daily highest plus lowest in each day in period
  • Average of all daily maximum temperature
  • Average of all daily minimum temperature
  • Number of gale days (when average wind speed sufficient to earn Beaufort description as a gale)
  • Snow index for period (cumulative totals of snow depths over days in period)
  • Number of days with snow falling
  • Number of days with snow lying
  • Number of dry days in period (threshold set in settings, counts days in period below threshold)
  • Number of wet days in period

Differences in way flavours calculate derivatives

The following derivatives use different calculations depending on the flavour, and therefore if you swap flavours these will show a discontinuity:

  • rain rate
  • dew point
  • wind chill
  • heat index
  • humidity index (humidex)

Interogation of Weather Stations

Cumulus MX has ability to work with every web station that the original Cumulus worked with, but it can also work with newer weather station hardware. The definitive list is on the Supported_Devices page.

Also, there are some weather station specific differences between Cumulus 1 and MX for reading variables from the same weather station. As just one example, the original Cumulus has an error in the code for reading absolute pressure from a Fine Offset station and sometimes calculates the wrong value for sea-level pressure, this has been corrected in (all but earliest releases of) MX, meaning MX is more reliable, and more accurate, for use with those old models.

Files used by Cumulus

It was mentioned above that Speciallog.txt is only generated by the original Cumulus. There are no plans for mX to generate this file.

Basic files used by both flavours=

  • Cumulus.ini (The configuration file Cumulus.ini has some differences between Cumulus 1 and MX, see that wiki page for more information, but essentially each flavour will ignore the parts they don't understand, and add the additional parts that they need but the other did not use.),
  • today.ini (This file holds some derived values, and time-stamps; although both flavours use the same file structure, there are differences in the format of the date, at the start of the file, that stops the file being interchangable),
  • yesterday.ini,
  • dayfile.txt (The number of fields changes at certain releases, see daily summary log page, but also MX releases 3.7.0 onwards are more fussy about how fields are formatted and so the file is no longer interchangable between flavours)
  • month.ini,
  • year.ini,
  • alltime.ini,
  • monthlyalltimelog.txt
  • monthlyalltime.ini
  • sample string.ini
  • strings.ini (optional file)

The format used for dates in each of the extreme record files depends on whether the individual parameter was last updated by the original Cumulus (day, then month, then year) or by MX (ISO format with 4 digit year, then hyphen, then 2 digit month number, then hyphen, then 2 digit day of month number). This means MX can read both date formats, but Cumulus 1 can only read its date format. For time-stamps, MX uses date-time entries in the "2019-03-06T02:05:00" style, while the original Cumulus uses a format like "02/09/2008 04:00:45".

More information about all of these files can be accessed by following links on Log Files index page.

Example Web Templates

Processed frequently

Both Cumulus 1 and Cumulus MX supply a number of templates that can be optionally processed into web pages.

  • indexT.htm,
  • todayT.htm,
  • yesterdayT.htm,
  • thismonthT.htm,
  • thisyearT.htm.

The above templates have same filename for both flavours, but are not interchangeable. These templates use web tags that Cumulus has to processs to create the related web page, so the frequency of processing the template determines the frequency that it can be uploaded to show fresh information on your web server

If you have edited a Cumulus 1 template, listed above, to customise what you see, you will have to start again with the equivalent MX template, and you will need to check information on the Webtags page, because any output formatters will either need to be changed, or perhaps added where modifiers were not needed before.

For Cumulus 1 only, there is one more template that needs to be updated frequently.

  • gaugesT.htm (The gauges page provided with original Cumulus uses "Web Dashboard Components for FreeWX and FreeWX-Wi", plus Microsoft Silverlight tool)

Processed just once

The following template for original Cumulus software does not contain any variable data, so it only need to be processed once (to create heading), and optionally uploaded that one time.

  • trendsT.htm

The following MX templates do not contain any variable data, so they only need to be processed once (to create heading), and optionally uploaded that one time.

  • trendsT.htm,
  • gaugesT.htm (The gauges page provided with MX is based on Mark's implementation of steel series)

These two templates are totally different between flavours, this is because Cumulus generates locally some images containing graphs and gauges, then uploads those images, in constrast MX generates files containing data, that it can optionally upload so that the web page then uses that data to draw charts or gauges.