Charts Definition Language (CDL): Difference between revisions

m
Line 163: Line 163:
== The Chart Axis ==
== The Chart Axis ==
All PlotVariables have their own defined axis and those axis will be coupled automatically to the chart. Multiple axis will be alternately added left-right where the order in the definition files determines this order. So it is the user who ultimately can define where the axis are placed: left or right and from inside to the outside in the order where they are encountered during the parsing process.
All PlotVariables have their own defined axis and those axis will be coupled automatically to the chart. Multiple axis will be alternately added left-right where the order in the definition files determines this order. So it is the user who ultimately can define where the axis are placed: left or right and from inside to the outside in the order where they are encountered during the parsing process.
The scaling of the axis is flexible i.e. it starts with a reasonable value for the upper and lower bounds and adjusts if the real values are higher or lower. For some axis the lower bound is always 0 (e.g. rain) for another the upper and lower bounds are fixed. Specifics are found below.


The following axis are currently defined and implicit for the plot variables (the user has no options here):
The following axis are currently defined and implicit for the plot variables (the user has no options here):
#None
#None
#Temp
#Temp - automatic scaling for min/max
#Pressure
#Pressure - scaling with a pseudo-fixed scale which means the min/max values of the scale are set to the min/max all time records found in ''alltime.ini''. Highcharts itself sets the scale values such that there is a tick at the end of the scale and the min/max values fall between the ticks at the end of the scale. If the pressure gets a lower/higher value the axis will adjust automatically. The idea is that any barometer you have at home has a fixed scale and with small variations there is little movement of the needle. However when the pressure starts falling/rising significantly it is very obvious. This behaviour is mimicked by CUtils (as far as possible)
#Rain
#Rain - automatic scaling with minimum value of 0 and an initial maximum of 1 (to accommodate measurement in inches)
#Rrate
#Rrate - automatic scaling with minimum value of 0 and an initial maximum of 1 (to accommodate measurement in inches)
#Wind
#Wind - automatic scaling for min/max
#Direction
#Direction - scaling is fixed for 0 to 360 degree. When only direction is plotted two axis are created: in degrees and in wind directions (N, E, S, W). When combined with another unit only the axis with wind directions is used.
#Humidity
#Humidity - scaling is fixed between 0 and 100
#Solar
#Solar - scaling is fixed between 0 and a rough estimate of the maximum theoretical value for radiation + 150. If the actual value goes beyond that, the scale will adjust.
#UV
#UV - automatic scaling for maximum, minimum is 0
#Hours
#Hours - automatic scaling for maximum, minimum is 0
#Distance
#Distance - automatic scaling for maximum, minimum is 0
#DegreeDays
#DegreeDays - automatic scaling for maximum, minimum is 0
#EVT
#EVT - automatic scaling for maximum, minimum is 0
#Free (has no title, unit or context associated with it. It just displays values)
#Free - has no title, unit or context associated with it. It just displays values. Automatic scaling for min/max.
#AQ
#AQ - automatic scaling for maximum, minimum is 0
#ppm
#ppm - automatic scaling for maximum which starts at 500, minimum is 0. The default maximum is because the CO<sub>2</sub> value is around 420 (in 2022) outdoors.


Translations for the axis titles come from the [Website] section (until '''''EVT''''') and should require no additional effort.
Translations for the axis titles come from the [Website] section (until '''''EVT''''') and should require no additional effort.