Charts: Difference between revisions

2,189 bytes added ,  08:09, 8 July 2022
m
mNo edit summary
 
(20 intermediate revisions by the same user not shown)
Line 4: Line 4:
   |}
   |}


One of the most important modules of ''CumulusUtils'' is the charting module as it gives insight in your weather data. A picture says more than a thousand words. The charting is subdivided in five sections: Rain charts, Temperature charts, Solar charts and Wind charts. Miscellaneous completes the charts.
One of the most important modules of ''CumulusUtils'' is the charting module as it gives insight in your weather data. A picture says more than a thousand words. The charting is subdivided in five sections: [[Charts - Rain charts|Rain charts]], [[Charts - Temperature charts|Temperature charts]], [[Charts - Solar charts|Solar charts]] and [[Charts - Wind charts|Wind charts]]. [[Charts - Misc charts|Miscellaneous]] completes the charts.


And if you run the Website Generator, the Home page shows the charts similar (almost equal) to the charts which default to the ''CumulusMX'' [[Highcharts_-_Recent|Recent Charts]]  page and ''CumulusMX'' Historic Charts page. From end of 2020 ''CumulusUtils'' begins to deviate in charting approach from ''CumulusMX'' with respect to those default charts.
And if you run the Website Generator, the Home page shows the charts similar (almost equal) to the charts which default to the ''CumulusMX'' [[Highcharts_-_Recent|Recent Charts]]  page and ''CumulusMX'' Historic Charts page. From end of 2020 ''CumulusUtils'' begins to deviate in charting approach from ''CumulusMX'' with respect to those default charts.


This page describes only the common features and requirements, the graphs themselves are discussed on their own page.
This page describes only the common features and requirements, the graphs themselves are discussed on their own page. Please note that [https://sciencing.com/the-best-stem-kits-to-get-your-kids-started-with-coding-13763826.html the words chart and graph] are used interchangably. Within CumulusUtils however in a stricter sense mostly graph is intended.  


The charts are created using [https://www.highcharts.com/ HighCharts] using their [https://shop.highsoft.com/highsoft/form/noncommercialform non-commercial license]. If you want to use the charts or the [[Website Generator]] of ''CumulusUtils'', please make yourself acquainted with this license.
The charts are created using [https://www.highcharts.com/ HighCharts] using their [https://shop.highsoft.com/highsoft/form/noncommercialform non-commercial license]. If you want to use the charts or the [[Website Generator]] of ''CumulusUtils'', please make yourself acquainted with this license.
Line 55: Line 55:


Miscellaneous charts:
Miscellaneous charts:
    TempSum=true
    GrowingDegreeDays=true
    Seasons=true              => For the ''Thermal Seasons'' chart
     DailyEVT=true
     DailyEVT=true
     MonthlyEVT=true
     MonthlyEVT=true
Line 69: Line 72:
     WindRoseInversed=false | true                            (default = false)
     WindRoseInversed=false | true                            (default = false)
     WindrunClassWidth=75                                    (default = 75)
     WindrunClassWidth=75                                    (default = 75)
     HeatmapNumberOfYearsPerPage=10                           (default = 10)
     HeatmapNumberOfYearsPerPage=10                           (default = 10)
    GrowingDegreeDaysReferenceTemp=5                        (default = 5)
    WinterToSpringTemperatureLimit=0                        (default = 0)
    SpringToSummerTemperatureLimit=10                        (default =10)


Map Colour parameters (see [[Charts behaviour]])
Map Colour parameters (see [[Charts behaviour]])
Line 86: Line 92:
=== Defaults, Colours and Language ===
=== Defaults, Colours and Language ===
==== Defaults ====
==== Defaults ====
Defaults are taken from the Highcharts theme which is current. See the page for the [[HighCharts themes|HighCharts theme]].
Defaults are taken from the Highcharts theme which is current. See the page for the [[HighCharts themes|HighCharts theme]].<br/>
 
One special feature for all charts in CumulusUtils is the possibility for the background image. This is described in [[Website_Generator#Chart_Background_Images|the chapter on the website]]


==== Colours ====
==== Colours ====
NOTE: the colours of the lines in the [[Website Generator]] Home page have their own specification, see the [[Website Generator]] and [[Charts Compiler]].
NOTE: the colours of the lines in the [[Website Generator]] Home page have their own specification, see the [[Website Generator]] and [[ChartsCompiler]].


A very important thing with the graphs is the '''Colour''' selection. For some charts, users can specify colours in multiples ways for other charts no specification is possible. In general for line charts, the user can choose the colour per line, for specific charts like the heatmap no choice is possible. See each chart description for the specification. If any colour specification in reality is not according to this specification, please report as a bug (either in documentation of in software)
A very important thing with the graphs is the '''Colour''' selection. For some charts, users can specify colours in multiples ways for other charts no specification is possible. In general for line charts, the user can choose the colour per line, for specific charts like the heatmap no choice is possible. See each chart description for the specification. If any colour specification in reality is not according to this specification, please report as a bug (either in documentation of in software)
Line 119: Line 127:


==== UseNormalRainReference====
==== UseNormalRainReference====
This parameter has effect on the ''Monthly Rain'' chart.
This parameter has effect on the ''Daily rain'' chart and the ''Monthly Rain'' chart.


The functional behaviour of this parameter is similar to the above.
The functional behaviour of this parameter is similar to the above.
In addition, this parameter determines the presence of the reference lines for the ''Normal Total Rainfall'' and/or the ''Station Average Rainfall'' as shown in the ''Daily Rain'' chart.


==== MaxNrOfSeriesVisibileInGraph ====
==== MaxNrOfSeriesVisibileInGraph ====
This parameter has effect in both ''Monthly Temperature'' and ''Monthly Rain''.  
This parameter has effect in both ''Monthly Temperature'', ''Monthly Rain'' and the ''Agri Charts''.  


A high number of series shown can severely clutter the chart. Therefore the user can limit the number of lines initially made visible.
A high number of series shown can severely clutter the chart. Therefore the user can limit the number of lines initially made visible.
When the chart is on screen, the  user can click on the legend to show additional charts.
When the chart is on screen, the  user can click on the legend to show additional charts.


====PeriodMovingAverage ====
==== PeriodMovingAverage ====
This parameter has effect on the ''Daily Rain'' chart.  
This parameter has effect on the ''Daily Rain'' chart and the ''Daily EVT'' chart.  


The running average as shown in the ''Daily Rain'' chart shows a [https://en.wikipedia.org/wiki/Moving_average#Simple_moving_average_(boxcar_filter) Simple Moving Average]. The period of that moving average - or the number of days in the current value of the moving average - can be set through this parameter.
The running average as shown in the ''Daily Rain'' and ''Daily EVT'' charts, shows a [https://en.wikipedia.org/wiki/Moving_average#Simple_moving_average_(boxcar_filter) Simple Moving Average]. The period of that moving average - or the number of days in the current value of the moving average - can be set through this parameter.


==== WindRoseNrOfWindforceClasses & WindRoseMaxWindSpeed ====
==== WindRoseNrOfWindforceClasses & WindRoseMaxWindSpeed ====
Line 144: Line 154:


==== WindRoseInversed====
==== WindRoseInversed====
This parameter have effect on the ''Wind Rose'' chart.
This parameter has effect on the ''Wind Rose'' chart.


This parameter determines the order of the legend (and the stacking of the values in the rose).
This parameter determines the order of the legend and the stacking of the values in the rose from inside to outside or the other way around.


==== WindrunClassWidth ====
==== WindrunClassWidth ====
This parameter have effect on the ''Windrun'' chart.
This parameter has effect on the ''Windrun'' chart.


With the same arguments as with the WindRose chart, the Windrun chart requires some configuration because of unit and local situation. To give the chart meaning a class width which shows but not clutters is best. It is also personal taste which counts.
With the same arguments as with the WindRose chart, the Windrun chart requires some configuration because of unit and local situation. To give the chart meaning a class width which shows but not clutters is best. It is also personal taste which counts.
Line 157: Line 167:


The heatmap does get a bit compressed when the series get longer. If more than ten years are available the years are split up in pages and buttons appear to switch between pages or display all data. This has to do with taste. There is also the button ''All'' which gives the user the possibility to undo the split.
The heatmap does get a bit compressed when the series get longer. If more than ten years are available the years are split up in pages and buttons appear to switch between pages or display all data. This has to do with taste. There is also the button ''All'' which gives the user the possibility to undo the split.
==== GrowingDegreeDaysReferenceTemp ====
This parameter contains the reference temperature for the chart Growing Degree Days and represents the heuristic temperature at which plants come out of their winter rest. In principle the chart ''Temperature Sum'' has a non modifiable ''reference temperature'' of 0.
==== WinterToSpringTemperatureLimit ====
With a default of zero degrees Celsius this parameter defines the thermal boundary between winter and spring.
If 10 successive days have an average temperature above 0 °C then Spring is declared. The same boundary works the other way around to declare transition from autumn to winter.
==== SpringToSummerTemperatureLimit ====
With a default of 10 °C this parameter defines the thermal boundary between spring and summer.
If 10 successive days have an average temperature above 10 °C then Summer is declared. The same boundary works the other way around to declare transition from summer to autumn.


[[Category:CumulusUtils]]
[[Category:CumulusUtils]]