Skip to contents

Add errorband config (ErrorBandConfig) to a vega-lite spec.

Usage

vl_config_errorband(
  spec,
  band = NULL,
  borders = NULL,
  extent = NULL,
  interpolate = NULL,
  tension = NULL,
  .object = NULL
)

Arguments

spec

An input vega-lite spec

band

boolean

Or: MarkConfig

borders

boolean

Or: MarkConfig

extent

The extent of the band. Available options include:

  • "ci": Extend the band to the confidence interval of the mean.

  • "stderr": The size of band are set to the value of standard error, extending from the mean.

  • "stdev": The size of band are set to the value of standard deviation, extending from the mean.

  • "iqr": Extend the band to the q1 and q3.

Default value: "stderr".

interpolate

The line interpolation method for the error band. One of the following:

  • "linear": piecewise linear segments, as in a polyline.

  • "linear-closed": close the linear segments to form a polygon.

  • "step": a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes at the midpoint of each pair of adjacent x-values.

  • "step-before": a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes before the x-value.

  • "step-after": a piecewise constant function (a step function) consisting of alternating horizontal and vertical lines. The y-value changes after the x-value.

  • "basis": a B-spline, with control point duplication on the ends.

  • "basis-open": an open B-spline; may not intersect the start or end.

  • "basis-closed": a closed B-spline, as in a loop.

  • "cardinal": a Cardinal spline, with control point duplication on the ends.

  • "cardinal-open": an open Cardinal spline; may not intersect the start or end, but will intersect other control points.

  • "cardinal-closed": a closed Cardinal spline, as in a loop.

  • "bundle": equivalent to basis, except the tension parameter is used to straighten the spline.

  • "monotone": cubic interpolation that preserves monotonicity in y.

tension

The tension parameter for the interpolation type of the error band.

.object

Directly input an object, rather than creating one via the other arguments. Should not be used in conjunction with the other arguments other than spec. Objects can be of type: ErrorBandConfig

Value

A modified Vega-Lite Spec