Diary

From Cumulus Wiki
Revision as of 08:32, 10 December 2024 by HansR (talk | contribs) (→‎Operation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

Introduction

Snow measurement has been part of Cumulus already for a long time but reporting has been more or less ignored. This module tries to fill that gap. That is especially important because the future will bring automated snowDepth measurement.

Dependency

The reporting of snowDepth is only dependent on data being entered in the database. This is done through the Edit=>Weather Diary menu choice in CMX. Without data in snow24h or snowDepth the menu choice in CumulusUtils will not appear and the Diary module will not result in output.

Translation/Language

There are some translatable strings in CUstringsxx.ini

Operation

CumulusUtils must be run once with the command Diary or Website to create the required parameters in the section [Diary] in the inifile.

If there is data in the diary.db in the data directory (through the edit menu choice of CMX or in future automatic laser input) there will be output and the menu choice in the website will be visible.

The Diary can also be used as a module.

Output

The output consists of :

  1. The module file (diary.txt) containing the code.
  2. The datafiles for the TableView with the names Diary<year>.txt. Year being the obvious, starting at the first data entered in the Diary.
  3. The data for the chart come from CumulusMX in the file alldailysnowdata.json which you need to upload (CMX menu: Internet Settings=>Interval Configuration=>Normal Interval Settings=>Daily Graph File Settings)

Inifile Parameters

The Diary module has the following inifile parameters defining the colouring of the report (same as the NOAA reports):

[Diary]
ColorDiaryText=Black
ColorDiaryBackground=#f9f8EB

The module also uses the ModulePath and the CumulusRealTimeLocation (section general).

Inner working

The command reads the diary.db and generates the report files and the code. No special algorithms.