Charts Definition Language (CDL): Difference between revisions

Charts Definition Language (CDL) (view source)

Revision as of 17:43, 19 September 2021

810 bytes added , 19 September 2021

m

→‎Additional details

HansR

Bureaucrats, Administrators

1,873

edits

Revision as of 09:44, 16 September 2021 (view source) HansR (talk \| contribs) m (→‎Example CutilsCharts.def) ← Older edit		Revision as of 17:43, 19 September 2021 (view source) HansR (talk \| contribs) m (→‎Additional details) Newer edit →
(8 intermediate revisions by the same user not shown)
The text in the ''CutilsCharts.def'' is case independent, however for clarity [https://en.wikipedia.org/wiki/Camel_case CamelCase] or a variety thereof is advised. The [[ChartsCompiler]] is obligatory after the introduction of the [[Extra Sensors\|ExtraSensors]] module from version 6.5 onwards where the [[ChartsCompiler]] is used internally for defining and creating the charts for the [[Extra Sensors\|ExtraSensors]] module which would otherwise - in a generic way - be virtually impossible. The ''CutilsCharts.def'' has a demarcation line which separates the Extra Sensors Charts (below) from the user charts (above). The user ~~can~~may ~~define he wants~~want to create his own Extra Sensor Charts and he can do so by setting the parameter ''UserModificationExtraSensorCharts=true'', if he does so existing [[Extra Sensors]] charts in the ''CutilsCharts.def'' file remain untouched. A standard ''CutilsCharts.def'' and a ''CutilsCharts-example.def'' ~~are~~can be found in the distribution. The first for an initial minimum setup, the second to guide the user into the possibilities. == The specification == #PLOT: Starts the plot specification using one of the possible variables #[[CDL - STATS\|STATS]]: Starts the statistics block using one of the possible variables. Semantics demands the variable to be plotted normally as well. #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)▼ #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) #DAILY: Identical to the ALL keyword but it sets the datarange for the chart to one month while the ALL keyword sets it to one year. #EXTRA: Defines the variable to be an extra sensor variable. It has an implicit datarange of RECENT. #AS: Defines the type of charting for that variable. #[[CDL - EVAL\|EVAL]] [ ]: Defines an expression for the plot variable. The equation must be placed between the square brackets, space has no value here (does not act as separator). #AXIS: Gives the user the possibility to specify an axis when using the EVAL construct otherwise an error is generated. #ENDCHART: End the chart definition #OUTPUT: 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 (implictly: cumuluscharts.txt) accepts click events as defined by CONNECTSTO. The keywords for the actual parameters and the Graph Types speak for themselves. #ppm Translations for the axis titles come from the [Website] section (until '''''EVT''''') and should require no additional effort. Subsequent translations of axis titles come from the [Compiler] section (from '''''Free''''' onwards) and may require translation. == Additional details == #The Legend texts are implemented as translations of the PlotKeywords (the Plot Variables). You will find these in the translation file section [Compiler]. Legend entries can be multiple words (the keywords can not). #The width of the graph container is 100% of the viewport. #The height of the graph container can be specified in the ~~options~~initifile parameters (not defined in the language to prevent overcharge): [~~Compiler~~General] ChartContainerHeight=650 (Default) #The Plot Variables Evapotranspiration, CoolingDegreeDays and Heating DegreeDays are not supplied by CMX in the JSONs. CumulusUtils provides those automatically when used in the definitions (on request) with the commandline parameter [[UserAskedData]]. ~~See also [[ChartsCompiler#Operation\|ChartsCompiler Operation]].~~ #All Extra Sensor Plotvariables are supplied by CumulusUtils through the commandline parameter [[UserAskedData]]. #You have to schedule this command if you wish to use the FTP frequency CMX uses for its JSON's. Note that these JSON files specific to CumulusUtils '''always reside in the website root''' of CumulusUtils, even if you have more websites and define the ''CumulusRealTimeLocation''.▼ #For the commandline parameter [[UserAskedData]]: see also [[ChartsCompiler#Operation\|ChartsCompiler Operation]]. ▲#You have to schedule ~~this~~[[UserAskedData]] command if you wish to use the FTP frequency CMX uses for its JSON's. Note that these JSON files specific to CumulusUtils '''always reside in the website root''' of CumulusUtils, even if you have more websites and define the ''CumulusRealTimeLocation''. #If the user uses different locales for CMX and CumulusUtils the monthly log filenames will be according to the locale of CMX. This creates an issue which is solved by the inifile parameter: [General] The Chart definitions below is included in the distribution of CumulusUtils and serves as an example. <pre style="height: 700px; overflow:scroll; width:auto;" > ; ; ChartsCompiler Demo and test chart definitions - Part of CumulusUtils Chart Zon Title (Max)Straling en UV ConnectsTo 12 23 24 Plot UV zIndex 100 Plot SolarRadiation As Area Opacity 0.4 Colour Orange zIndex 50 Plot TheoreticalSolarMax As Area Colour Gold zIndex 10 Opacity 0.2 EndChart ; https://iridl.ldeo.columbia.edu/dochelp/QA/Basic/dewpoint.html ; ; Compare the Dewpoint from Cumulus with the ~~calculated~~caclculated approximation ; Later I will enter the Cumulus Calculation and have the Humidity be produced by the Davis station ; Nice comparison Plot RECENT pwsFWI Eval [ Psat2008 * (1 - Humidity/100)*WindSpeed ] As spline Axis Free Colour Red EndChart </pre> [[Category:CumulusUtils]]