2,050
edits
Charts Definition Language (CDL): Difference between revisions
m
→Example CutilsCharts.def
m (→Axis Types) |
|||
| (8 intermediate revisions by the same user not shown) | |||
|
INFO " <free text> "
CHART […] ENDCHART [OUTPUT] [INFO] blocks repeated
Plot blocks can be repeated as many times as you wish but different parameters can result in many yAxis (making the plot area smaller) and the chart may become crowded and unreadable. Experiment and try-out.
#ZOOM (Optional construct): Indicates which range selector button is the default when the chart is displayed; Defaults depend on chart range.
#PLOT: Starts the plot specification using one of the possible variables. Each chart requires at least one PLOT.
#[[CDL - STATS|STATS]]: Starts the statistics block using one of the possible variables. Semantics demands the variable to be plotted normally as well. IF a STATS of an equation plot is to be requested, the PLOT statement of the equation must precede the STATS statement.
#RECENT: Defines the variable to be governed by the CMX parameter ''GraphHours'' and are similar to the CMX RECENT graphs (though not equal).
#ALL: Defines the variable to be taken from the [[Dayfile.txt|Dayfile]] and all data for that variable will be plotted (Note that the CMX parameter ''ChartMaxDays'' will not be used)
#OUTPUT (Optional construct): Gives an optional name of an outputfile which starts at the chart where it is defined. Any chart after this OUTPUT specifier goes to this OUTPUT until another OUTPUT is found. Only the first OUTPUT specifier (implicitly: cumuluscharts.txt) accepts click events as defined by CONNECTSTO.
#INFO (Optional construct): Introduces a helptext section for the chart. The free text is enclosed in double quotes and cannot contain double quotes. The double quotes are delimited by a space character.
#PERIOD: Only in the context of the STATS function SMA. Gives the period of that specific running average
NOTE: The RECENT qualifier is optional as it is the default for a chart.<br/>
NOTE: The zoom buttons for the RECENT represent chart <math>1/4</math> and <math>1/2</math> the value of the hours specified in the CMX parameter ''GraphHours''.
===== With the ALL/DAILY qualifier =====
"MinBarometer", "MaxBarometer",
"MinHumidity", "MaxHumidity",
"HeatingDegreeDays","CoolingDegreeDays","DayEVT",
"Snow24h", "SnowDepth"
Note: The difference between ALL and DAILY is only between the displayed datarange (6 months or 1 month)
"AirQualityAvg1","AirQualityAvg2","AirQualityAvg3","AirQualityAvg4",
"UserTemp1","UserTemp2","UserTemp3","UserTemp4","UserTemp5","UserTemp6","UserTemp7","UserTemp8",
"LeafWetness1","LeafWetness2","LeafWetness3","LeafWetness4","LeafWetness5","LeafWetness6","LeafWetness7","LeafWetness8",
"LaserDist1","LaserDist2","LaserDist3","LaserDist4","LaserDepth1","LaserDepth2","LaserDepth3","LaserDepth4",
"CO2", "CO2_24h", "CO2_pm2p5", "CO2_pm2p5_24h","CO2_pm10","CO2_pm10_24h","CO2_temp","CO2_hum"
The following Axis are possible.
Temp, Wind, Distance, Height, Hours, Solar, UV, Rain, Rrate, Pressure, Humidity, DegreeDays, EVT, AQ, ppm, Free
Temp, Pressure, Rain, Rrate, Wind, Direction, Humidity, Solar, UV, Hours, Distance, Height, DegreeDays, EVT, Free, AQ, ppm, SoilMoisture
This only has meaning if there is an [[CDL - EVAL|EVAL]] with a valid expression present. As an [[CDL - EVAL|EVAL]] may modify the value of the plot variable to something completely different, the original Axis belonging to that plot variable may be useless or scale wrongly. Therefore you can choose your own Axis. If there is no valid equation, a warning is given and no axis is generated.
#'''AQ''' - automatic scaling for maximum, minimum is 0
#'''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.
#'''SoiMoisture''' - automatic selection of the unit. '''cb''' (centibar) for a Davis soilmoisture sensor or '''%''' for an Ecowitt soilmoisture sensor and automatic scaling 0 - 200 (cb) and 0 - 100 for %
Translations for the axis titles come from the [Website] section (until '''''EVT''''') and should require no additional effort.
== Example CutilsCharts.def ==
The Chart definitions
Rename this file to ''CutilsCharts.def'' and move it to the utils directory.
<pre style="height: 700px; overflow:scroll; width:auto;" >
;
; ChartsCompiler
;
; This file is part of the distribution. Users may modify this file up to the indicator line
; Anything beyond that line will be removed at generation time (by the ExtraSensors module)
;
; The first set goes to cumuluscharts.txt and is seen as standard charts and obligatory
; These charts may be modified and charts may be added.
; cumuluscharts.txt is userdefinable but must be present.
;
; The user can create multiple output files. Checkout the Wiki for this.
;
; The bottom part, below the Demarcation line: ExtraSensorCharts and CustomLogsSensorCharts
; is filled in by CumulusUtils and will be replaced every run so don't modify
; unless you set the right to modify through the parameter 'UserModificationExtraSensorCharts' or 'UserModificationCustomLogsCharts' (see Wiki)
;
Chart Overview Title Overview of the current weather status
ConnectsTo 2 4 15 20
Has WindBarbs Above colour black
Zoom 3
PLOT Temperature Colour #058DC7 zindex 90
PLOT DewPoint Colour #50B432 zindex 80
PLOT pressure Colour red zindex 70
Plot Humidity Colour #64E572 zindex 60
Plot
Plot RainFall As Area colour #33B4FF opacity 0.2 zindex 10
EndChart
Chart
ConnectsTo 1 13 14
Plot InsideTemp As Spline Colour #DDDF00 zIndex 100
PLOT Temperature As SPline Colour #058DC7 zindex 90
EndCHART
Chart Wind Title Wind
ConnectsTo 5 8
Plot WindSpeed
EndCHART
Chart
ConnectsTo 6 7
Plot AverageBearing As Scatter
EndCHART
Chart
ConnectsTo 3 21 22
Plot RainFall As Area Colour green Opacity 0.2
Plot RainRate zIndex 100
EndChart
Chart Humidity Title Relative Humidity
ConnectsTo 11 16
Plot Humidity
Plot InsideHumidity
EndChart
Chart
ConnectsTo 12 23 24
Plot UV zIndex 100
Plot TheoreticalSolarMax As Area Colour Gold zIndex 10 Opacity 0.2
EndChart
CHART
PLOT DAILY AverageTemp colour green As ColumnRange
PLOT DAILY AverageTemp colour black As spline
EndChart
CHART
PLOT DAILY MinBarometer colour Crimson As ColumnRange
PLOT DAILY AverageBarometer EVAL [ (MinBarometer + MaxBarometer)/2 ] colour black As spline Axis Pressure
EndChart
; DO NOT CHANGE ANYTHING BELOW THIS INDICATOR LINE
; ExtraSensorCharts
</pre>
| |||