Creating Charts with the opCharts Chart Editor

Introduction

opCharts has the capability to create custom charts that may present any combination of data sets to the user in a single easy to read medium.

Creating a New Custom Chart

From the opCharts home page navigate to the charts view.

 

The resulting Charts page will look something like the following.  From here via the administrative action palette we can add, edit, delete, and set permissions to charts.

 

 

Click the blue '+' button to create a new chart and we will be presented with a page such as the following.  The only mandatory field is the chart name.  All other fields and be left blank and edited at a latter time.

 

Field Descriptions

Field NameFunction

Name

This name is primarily administrative and will be used to identify the chart on the Views->Home->Charts page.
Desc.A description field that will appear on the Views->Home->Charts page.
TitleThis title will appear at the top of the chart.
Time PeriodThe default time period of the chart when it is initially displayed.  Once you start typing the format and options will display.  A user may change this once the chart is selected in order to access the time period they are interested in.
Left Y-Axis TitleThis description will appear on the left side of the chart representing the scale of 'axis 0'.  When selecting the data set we well be presented with the axis option.
Right Y-Axis TitleThis description will appear on the right side of the chart represting the scale of 'axis 1' .  When selecting the data set we well be presented with the axis option.
Only Stacks in LegendWhen true only the unique stack entries found in the datasets added are shown in the legend along with each stacks last value.
SaveSelect this to save the chart.
Add DatasetSelect this to add data sets to the chart.

 

 

 

 

 



Click 'Add Dataset' in order to add data sets to the chart.  A window such as the following will be presented.



It is important to first select the 'Data Type'.  Clicking on this field the user will be presented with two choices; 'NMIS Graph' or 'NMIS Dataset'.  For this example choose 'NMIS Dataset'. 

The NMIS Graph option allows embedding a predefined graph from NMIS into an opCharts chart. 

The NMIS Dataset option allows selecting individual datasets from data collected by NMIS.

 A chart can only have one NMIS graph embedded in it and as many NMIS Dataset's as desired (the two can be mixed).

 

 

 

 

 

 

 

 

 

 

 

 

 

After selecting the Data Type 'NMIS Dataset', the form will change slightly as below.

 

FieldFunction

Data Type

Drop down menu that offers two choices, 'NMIS Dataset' or 'NMIS Graph'.
NodeA configured node.  As the user starts typing options are presented.
ResourceA drop down menu that will present available choices.
IndexA drop down menu that will present available choices.
ClassA drop down menu that will present available choices.
FieldA drop down menu that will present available choices.
Dataset TitleThe name that will appear in the legend for this resource.
Line TypeA drop down menu that will present available choices.
AxisA drop down menu that presents 0 or 1.  If 0 is selected the scale for the resource will be on the left side.  If 1 is selected the scale for the resource will be on the right side.
ColorIf left blank a color will automatically be selected.  If you wish to specify the color it must be represented with the appropriate hexadecimal number preceded with a '#' sign.  https://en.wikipedia.org/wiki/Web_colors can assist in finding the code for the color you would like to use.
Legend MinWhen true the minimum value (in the current period) of the dataset will be displayed in the legend below the dataset key
Legend MaxWhen true the maximum value (in the current period) of the dataset will be displayed in the legend below the dataset key
Legend AvgWhen true the average value (in the current period) of the dataset will be displayed in the legend below the dataset key
Reverse AxisWhen true the dataset values will be multiplied by -1 before being displayed so they will appear below the X axis, this is useful when displaying input/output data on the same graph.
StackUsed to group datasets together and display them on top of each other so their values appear to add in the graph. This can be any string, all datasets with the same string will be stacked together. Only works when the line type is area.
SuffixText to display after the value in the tooltip, eg " bytes"
DecimalsThe number of decimal places to display the value with in the tooltip
Dataset MultiplierEach value in the data will be multiplied by this value before being displayed. This is useful for changing the unit or base of the value. Eg, if the value is in bytes and you would like to display bits set this to 8. If the value is in bytes and you would like to display in megabytes then set this to 1/(1024*1024) or 0.000000953674316

After completing the appropriate entires click 'Add' to add and save the data set, this action will return you to the 'New Chart' edit page.  At this point you may add more datasets or save the chart.  Once the chart is saved you may add it to a dashboard, export the data to a CSV file, or further edit the chart properties.