Piper Diagram Widget

<< Click to Display Table of Contents >>

EQuIS 7  >>  Enterprise > Widgets >

Piper Diagram Widget

The Piper Diagram widget is designed to display user reports based on the EnviroInsite Piper Diagram report, which is included in the EnviroInsite Report module. For the Piper Diagram widget to be operational, the EQuIS database must contain the appropriate data and EnviroInsite reports. The Piper Diagram widget can only display properly configured piper diagram reports. Please contact support@earthsoft.com for more information about this module.


A Piper diagram is a graphical representation of the chemistry of water samples in the form of the trilinear diagram. The relative abundance of common ions (cations and anions) are shown by separate ternary plots. The Piper diagram is comprised of three components as shown in the image below:

1) The lower left ternary plot representing cations (magnesium, sodium plus potassium, and calcium);

2) The lower right ternary plot representing anions (carbonate plus bicarbonate, sulfate, and chloride); and

3) A middle diamond plot, which is a matrix transformation of the two ternary diagrams.

The plots display the relative concentrations of each sample (i.e., sum of cations = 100 and sum of anions = 100). The data points in the center diamond are located by extending the points in the lower triangles to the point of intersection in the center plot.  The axis values at the top and bottom of the center diamond are 100; the axis values on the left and right side of the center plot are 0.




The Piper diagram is based on parameter concentrations expressed in equivalents per volume. The Equivalent Weight field in the constituents table is used to convert between the measured mass concentration and the concentration in equivalents or milliequivalents (meq) per liter. Equivalent weight is the mass per charge. Charge concentration is the mass concentration of an ion in water divided by the equivalent weight. The equivalent weight field should be entered as positive for cations and negative for anions.


In each sample, the three cation/anion results (in milliequivalents) are divided by the sum of the three values to produce a percent of total cations. For example, if Ca= 0.80 meq, Mg =0.26 meq, and Na+K = 0.89 meq, then %Ca = 41, %Mg = 13, and %[Na+K] = 46.



Widget Properties


The Piper Diagram widget is empty when added to a dashboard and must be configured to show report results. To select a report or change properties of this widget, open the Widget Editor by selecting the More Options dashboard_chooser icon in the upper right corner of the widget to display the drop-down menu and then select the Edit menu option.


Widget Title – By default, the widget title is Piper Diagram. The title can be modified.

Widget Color – The color of the widget can be changed using the Change Widget Themecolor_iconicon to the left of the widget title.

Report Chooser This control is used to select the report to be used with this instance of the Piper Diagram widget. The name of the currently selected report (if applicable) is displayed by default. To select a different report, click the Choose a Report button or name of the report. The Report Chooser will open and display available reports. Select the desired report.


Note: The report cannot be created or edited through the Report Parameter Editor. The Piper Diagram report must already exist in the database.