Spread.NET 17 Formula Reference
Formula Functions / Functions A to C / BOXPLOTSPARKLINE
In This Topic
    BOXPLOTSPARKLINE
    In This Topic

    This function returns a data set used for representing a boxplot sparkline.

    Syntax

    BOXPLOTSPARKLINE( points, boxPlotClass, [showAverage, scaleStart, scaleEnd, acceptableStart, acceptableEnd, colorScheme, style, vertical] )

    Arguments

    This function has the following arguments:

    Argument Description
    Points

    A reference that represents the cell range that contains the values, such as "A1:A4".
    boxPlotClass

    Q1–>25% percentile, Q3–>75% percentile, IQR-->Q3-Q1.
    5ns: whisker ends at minimum and maximum, median, no outliers.

    7ns: whisker ends at 2% percentile and 98% percentile, hatch marks at 9% percentile and 91% percentile, outliers beyond 2% percentile and 98% percentile.

    tukey: whisker ends at a value (the minimum of the points between Q1 and Q1 - 1.5*IQR, use the point if it exists or use the minimum) and a value (the maximum of the points between Q3 and Q3 + 1.5 * IQR, use the point if it exists or use the maximum), outliers beyond Q1 - 1.5*IQR and Q3 + 1.5 * IQR, and extreme outliers beyond Q1 - 3 * IQR and Q3 + 3 * IQR.

    bowley: whisker ends at minimum and maximum, hatch marks at 10% percentile and 90% percentile, no outliers.

    sigma3: whisker ends at a value (average - 2 * StDev > scaleStart ? average - 2 * StDev :  minimum) and a value (average + 2 * StDev < scaleEnd ? average = 2 * StDev : maximum), box at average +/- stdev, outliers beyond average - 2 * StDev and average + 2 * StDev, and extreme outliers beyond average - 3 * StDev and average + 3 * StDev.
    showAverage

    (Optional) A boolean that represents whether to show the average. The default value is FALSE.
    scaleStart

    (Optional) A number or reference that represents the minimum boundary of the sparkline, such as 1 or "A6". The default value is the minimum of all values.
    scaleEnd

    (Optional) A number or reference that represents the maximum boundary of the sparkline, such as 8 or "A7". The default value is the maximum of all values.
    acceptableStart

    (Optional) A number or reference that represents the start of the acceptable line, such as 3 or "A8". The default value is None.
    colorScheme

    (Optional) A string that represents the color of the sparkline's box. The default value is "#D2D2D2".
    style

    (Optional) A number or reference that represents the sparkline style. This setting is optional. The default value is 0 (Classical). The style can be 0 or 1.

    • 0: The whisker is a line and outlier is a circle.
    • 1: The whisker is a rectangle and outlier is a line.
    vertical

    (Optional) A boolean that represents whether to display the sparkline vertically. The default value is FALSE.

    Data Types

    Returns sparkline.

    Example

    activeSheet.setFormula(0,1,'=BOXPLOTSPARKLINE(C1:P1,"5ns",TRUE,0,100,-1,100,"red",0,FALSE)');