Charts - Rain charts: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
mNo edit summary
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Introduction ==
== Introduction ==
{|align=right
  |__TOC__
  |}
The Rain charts submodule consists of four charts:
The Rain charts submodule consists of four charts:
#Daily Rain - Plotting the rainfall for every day in the dayfile;
#Daily Rain - Plotting the rainfall for every day in the dayfile;
Line 6: Line 9:
#Yearly Rain statistics per month = plotting the average, range and standard deviation for for the rainfall in each month in every year
#Yearly Rain statistics per month = plotting the average, range and standard deviation for for the rainfall in each month in every year
Below you will find an example image of each chart and an explanation of the origin of the numbers
Below you will find an example image of each chart and an explanation of the origin of the numbers
For the calculations the standard C# LINQ-functions Min, Max and Avg are used. For the standard deviation this [https://stackoverflow.com/questions/2253874/standard-deviation-in-linq LINQ-extension] is used with a modification for a minimum number of observations required of 2, if less the StdDev returns 0 (zero).


== Daily Rain ==
== Daily Rain ==
[[File:Charts Daily Rain.jpg|thumb|right|Daily Rain]]
[[File:Charts Daily Rain.jpg|thumb|right|Daily Rain]]
The chart is a timeseries of rainfall. Every day it rained it is plotted in the chart as column.  
The chart is a timeseries of rainfall with data coming from the Dayfile. Every day it rained it is plotted in the chart as column.  
The cumulative value of the rain starts january 1 at zero and augments with every amount measured until 31 december after which  it resets to zero.
The cumulative value of the rain starts january 1 at zero and augments with every amount measured until 31 december after which  it resets to zero.
Also visible is a [https://en.wikipedia.org/wiki/Moving_average#Simple_moving_average_(boxcar_filter) moving average] with a configurable period (default is 180 days).
Also visible is a [https://en.wikipedia.org/wiki/Moving_average#Simple_moving_average_(boxcar_filter) moving average] with a [[Charts#PeriodMovingAverage|configurable period]] (default is 180 days).


If the value of the inifile parameter ''UseNormalRainReference'' is ''Normal'' the  user sees a red dotted horizontal line at the Y-axis value of the Normal total rainfall per year. When ''UseNormalRainReference'' is ''StationAverage'' the  user sees a green dotted line ate the value of the calculated average total rainfall for the station. And obviously when the parameter value is both, the user sees both lines.
If the value of the inifile parameter ''UseNormalRainReference'' is ''Normal'' the  user sees a red dotted horizontal line at the Y-axis value of the Normal total rainfall per year. When ''UseNormalRainReference'' is ''StationAverage'' the  user sees a green dotted line ate the value of the calculated average total rainfall for the station. And obviously when the parameter value is both, the user sees both lines.
Line 17: Line 22:
There are three Y-axis: one on the left, the main Y-axis, showing the actual rainfall amount. On the right we see the Y-axis with value of the moving average and the Y-axis with the value of the accumulated rainfall value.
There are three Y-axis: one on the left, the main Y-axis, showing the actual rainfall amount. On the right we see the Y-axis with value of the moving average and the Y-axis with the value of the accumulated rainfall value.


The rangeselector gives the user the option to view a selected period with fixed buttons (left) or by specific dates (right).
The rangeselector gives the user the option to view a selected period with fixed buttons (left) or by specific dates (right).<br>
 
== Monthly Rain ==
[[File:Charts Monthly Rain.jpg|thumb|right|Monthly Rain]]
The chart shows the monthly values of total rain that month for each year. The years have a different colour according to [[Charts#Colours|the colour scheme]]. The number of series directly visible is governed by the parameter [[Charts#MaxNrOfSeriesVisibileInGraph|MaxNrOfSeriesVisibleInGraphs]].
 
If the value of the inifile parameter [[Charts#UseNormalRainReference|UseNormalRainReference]] is ''Normal'' the user sees a black line representing the normal average values of total rainfall. When UseNormalRainReference is ''StationAverage'' the user sees a grey line representing the station average values of total rainfall. And obviously when the parameter value is ''Both'', the user sees both lines. In addition to the Station Average Value line, the estimator '''s''' for the [https://en.wikipedia.org/wiki/Standard_deviation standard deviation] <math>\boldsymbol{\sigma}</math> belonging to that line, is always shown as a grey surface with the width of '''s''' for a specific month.
 
== Yearly Rain statistics ==
[[File:Year Rain Statistics.jpg|thumb|right|Yearly Rain Statistics]]
For each year the charts shows the average of the daily rainfall, the range of the daily rain fall and the estimator '''s''' for the [https://en.wikipedia.org/wiki/Standard_deviation standard deviation] <math>\boldsymbol{\sigma}</math> belonging to that average. The colours of this chart are hardcoded and cannot be changed. Moving the mouse around provides the specific values in the tooltips.
 
NOTE: the Y-axis scale is logarithmic. This type of scaling has provided for possible negative values to accommodate proper charting even if  not mathematical correct.<br>
 
== Yearly Rain statistics per Month ==
[[File:Year Month Rain Statistics.jpg|thumb|right|Yearly Rain statistics per Month]]
This chart is similar to the previous one, only now the the user can select a specific month through a row of buttons on top of the chart.
 
[[Category:CumulusUtils]]

Revision as of 08:45, 9 April 2021

Introduction

The Rain charts submodule consists of four charts:

  1. Daily Rain - Plotting the rainfall for every day in the dayfile;
  2. Monthly Rain - Plotting the monthly rainfall for every year in the dayfile
  3. Yearly Rain statistics - Plotting the average, range and standard deviation for for the rainfall in every year
  4. Yearly Rain statistics per month = plotting the average, range and standard deviation for for the rainfall in each month in every year

Below you will find an example image of each chart and an explanation of the origin of the numbers

For the calculations the standard C# LINQ-functions Min, Max and Avg are used. For the standard deviation this LINQ-extension is used with a modification for a minimum number of observations required of 2, if less the StdDev returns 0 (zero).

Daily Rain

Daily Rain

The chart is a timeseries of rainfall with data coming from the Dayfile. Every day it rained it is plotted in the chart as column. The cumulative value of the rain starts january 1 at zero and augments with every amount measured until 31 december after which it resets to zero. Also visible is a moving average with a configurable period (default is 180 days).

If the value of the inifile parameter UseNormalRainReference is Normal the user sees a red dotted horizontal line at the Y-axis value of the Normal total rainfall per year. When UseNormalRainReference is StationAverage the user sees a green dotted line ate the value of the calculated average total rainfall for the station. And obviously when the parameter value is both, the user sees both lines.

There are three Y-axis: one on the left, the main Y-axis, showing the actual rainfall amount. On the right we see the Y-axis with value of the moving average and the Y-axis with the value of the accumulated rainfall value.

The rangeselector gives the user the option to view a selected period with fixed buttons (left) or by specific dates (right).

Monthly Rain

Monthly Rain

The chart shows the monthly values of total rain that month for each year. The years have a different colour according to the colour scheme. The number of series directly visible is governed by the parameter MaxNrOfSeriesVisibleInGraphs.

If the value of the inifile parameter UseNormalRainReference is Normal the user sees a black line representing the normal average values of total rainfall. When UseNormalRainReference is StationAverage the user sees a grey line representing the station average values of total rainfall. And obviously when the parameter value is Both, the user sees both lines. In addition to the Station Average Value line, the estimator s for the standard deviation belonging to that line, is always shown as a grey surface with the width of s for a specific month.

Yearly Rain statistics

Yearly Rain Statistics

For each year the charts shows the average of the daily rainfall, the range of the daily rain fall and the estimator s for the standard deviation belonging to that average. The colours of this chart are hardcoded and cannot be changed. Moving the mouse around provides the specific values in the tooltips.

NOTE: the Y-axis scale is logarithmic. This type of scaling has provided for possible negative values to accommodate proper charting even if not mathematical correct.

Yearly Rain statistics per Month

Yearly Rain statistics per Month

This chart is similar to the previous one, only now the the user can select a specific month through a row of buttons on top of the chart.