QC plot y-scale option to show delta from mean (#7307)

Author: ankurjuneja

core/webapp/vis/src/plot.js

@@ -1612,7 +1612,7 @@ boxPlot.render();
  * @param {Number} [config.properties.boundType] Either 'absolute' or 'stddev', to describe how to interpret the upperBound and lowerBound.
  *                          Used by LeveyJennings only. Defaults to 'stddev'.
  * @param {String} [config.properties.valueConversion] The data property name for the conversion of the plot to either percent
- *                          of the mean ('percentDeviation') or standard deviations ('standardDeviation').
+ *                          of the mean ('percentDeviation'), standard deviations ('standardDeviation') or delta from mean ('deltaFromMean').
  *                          Used by LeveyJennings and Moving Range only.
  * @param {String} [config.properties.defaultGuideSets] The data property name for default std dev and mean needed for percentDeviation
  *                          or standardDeviation conversion.
@@ -1784,22 +1784,26 @@ boxPlot.render();
                     config.properties.TrailingMeanRight ||
                     config.properties.TrailingCVRight;
 
-        var convertToPercentDeviation = function(value, mean) {
+        let convertToPercentDeviation = function(value, mean) {
             var calc = Math.round(((value / mean) * 100) * 100) / 100;
             if (isNaN(calc))
                 return 100;
 
             return calc;
         };
 
-        var convertToStandardDeviation = function(value, mean, stddev) {
+        let convertToStandardDeviation = function(value, mean, stddev) {
             var calc = Math.round(((value - mean) / stddev) * 100) / 100;
             if (isNaN(calc))
                 return 0;
 
             return calc;
         };
 
+        let convertToDeltaFromMean = function(value, mean) {
+            return (value - mean);
+        };
+
         var convertValues = function(conversion) {
             if (!conversion)
                 return;
@@ -1813,6 +1817,9 @@ boxPlot.render();
                 if (conversion === LABKEY.vis.PlotProperties.ValueConversion.PercentDeviation) {
                     row[valProp] = convertToPercentDeviation(row[valProp], row[meanProp]);
                 }
+                else if (conversion === LABKEY.vis.PlotProperties.ValueConversion.DeltaFromMean) {
+                    row[valProp] = convertToDeltaFromMean(row[valProp], row[meanProp]);
+                }
                 else {
                     row[valProp] = convertToStandardDeviation(row[valProp], row[meanProp], row[sdProp]);
                 }
@@ -1822,6 +1829,9 @@ boxPlot.render();
                 if (conversion === LABKEY.vis.PlotProperties.ValueConversion.PercentDeviation) {
                     row[valRightProp] = convertToPercentDeviation(row[valRightProp], row[meanProp]);
                 }
+                else if (conversion === LABKEY.vis.PlotProperties.ValueConversion.DeltaFromMean) {
+                    row[valRightProp] = convertToDeltaFromMean(row[valRightProp], row[meanProp]);
+                }
                 else {
                     row[valRightProp] = convertToStandardDeviation(row[valRightProp], row[meanProp], row[sdProp]);
                 }
@@ -1843,6 +1853,10 @@ boxPlot.render();
                         maxValue = config.properties.upperBound + cushion;
                         minValue = config.properties.lowerBound - cushion;
                     }
+                    else if (config.properties.valueConversion === LABKEY.vis.PlotProperties.ValueConversion.DeltaFromMean) {
+                        maxValue = config.properties.upperBound + mean + cushion;
+                        minValue = config.properties.lowerBound - mean - cushion;
+                    }
                     else {
                         maxValue = mean + ((config.properties.upperBound + cushion) * stddev);
                         minValue = mean + ((config.properties.lowerBound - cushion) * stddev);
@@ -1981,7 +1995,6 @@ boxPlot.render();
                 // Handle value conversions
                 convertValues(config.properties.valueConversion);
                 if (config.qcPlotType === LABKEY.vis.TrendingLinePlotType.LeveyJennings) {
-
                     if (config.properties.boundType === LABKEY.vis.PlotProperties.BoundType.Absolute) {
                         row.upperBound = config.properties.upperBound;
                         row.lowerBound = config.properties.lowerBound;
@@ -2028,6 +2041,11 @@ boxPlot.render();
                         }
                     }
 
+                    else if (config.properties.valueConversion === LABKEY.vis.PlotProperties.ValueConversion.DeltaFromMean) {
+                        row.upperBound = convertToDeltaFromMean(row.upperBound, row[meanProp]);
+                        row.lowerBound = convertToDeltaFromMean(row.lowerBound, row[meanProp]);
+                    }
+
                     if (config.properties.yAxisDomain) {
                         if (config.properties.yAxisDomain[0] > row.lowerBound) {
                             config.properties.yAxisDomain[0] = row.lowerBound - cushion;
@@ -2045,6 +2063,10 @@ boxPlot.render();
                     row[sdProp] = 1;
                     row[meanProp] = 0;
                 }
+                else if (config.properties.valueConversion === LABKEY.vis.PlotProperties.ValueConversion.DeltaFromMean) {
+                    row[sdProp] = 0;
+                    row[meanProp] = 0;
+                }
 
                 if (!config.properties.valueRight &&
                         !config.properties.valueRightMR &&

core/webapp/vis/src/utils.js

@@ -40,7 +40,8 @@ if (!LABKEY.vis.PlotProperties) {
     if (!LABKEY.vis.PlotProperties.ValueConversion) {
         LABKEY.vis.PlotProperties.ValueConversion = {
             StandardDeviation: 'standardDeviation',
-            PercentDeviation: 'percentDeviation'
+            PercentDeviation: 'percentDeviation',
+            DeltaFromMean: 'deltaFromMean'
         }
     }
 }