Struct ErrorBarArtist 

pub struct ErrorBarArtist {
    pub x: Series,
    pub y: Series,
    pub xerr: Option<ErrorBarData>,
    pub yerr: Option<ErrorBarData>,
    pub color: Color,
    pub label: Option<String>,
    pub cap_size: f64,
    pub line_width: f64,
}

An error bar plot showing data points with uncertainty bars.

Each data point (x, y) can have optional horizontal (xerr) and/or vertical (yerr) error bars. The error bars are drawn as lines with optional caps at the ends.

Fields

x: Series

X-coordinates of the data points.

y: Series

Y-coordinates of the data points.

xerr: Option<ErrorBarData>

Optional x-axis error data.

yerr: Option<ErrorBarData>

Optional y-axis error data.

color: Color

Color for the center line, error bars, and caps.

label: Option<String>

Optional legend label.

cap_size: f64

Cap size in pixels for the error bar ends.

line_width: f64

Stroke width of the error bar lines and caps.

Implementations

impl ErrorBarArtist

pub fn data_bounds(&self) -> (f64, f64, f64, f64)

Computes the data-space bounding box (xmin, xmax, ymin, ymax).

Includes the extent of error bars when present, so that auto-scaling shows the full error range.

impl ErrorBarArtist

pub fn color(&mut self, color: Color) -> &mut Self

Sets the color for the center line, error bars, and caps.

Accepts any Color value, which can be constructed from RGB components, hex strings, or named color constants.

Examples

artist.color(Color::TAB_RED);

pub fn label(&mut self, label: &str) -> &mut Self

Sets the legend label for this error bar plot.

When a label is set, the error bar plot will appear in the legend if one is displayed on the axes. Pass an empty string or omit this call to exclude the plot from the legend.

Examples

artist.label("Measurements");

pub fn cap_size(&mut self, size: f64) -> &mut Self

Sets the cap size in pixels for the error bar ends.

Caps are the small horizontal (or vertical) lines drawn at the tips of the error bars. A value of 0.0 disables caps entirely. The default is 4.0 pixels.

Examples

artist.cap_size(6.0);

pub fn line_width(&mut self, width: f64) -> &mut Self

Sets the stroke width of the error bar lines and caps.

Also affects the center connecting line. A width of 1.0 is the default hairline width.

Examples

artist.line_width(2.0);

pub fn yerr_symmetric(self, errs: &[f64]) -> Self

Sets symmetric y-error values.

Each error value e produces an error bar from y - e to y + e at the corresponding data point. The length of errs must equal the number of data points.

Examples

artist.yerr_symmetric(&vec![0.5, 0.3, 0.4]);

pub fn yerr_asymmetric(self, low: &[f64], high: &[f64]) -> Self

Sets asymmetric y-error values.

Each point gets a separate low and high error. The error bar spans from y - low[i] to y + high[i]. Both slices must have the same length as the data series.

Examples

artist.yerr_asymmetric(&low_errs, &high_errs);

pub fn xerr_symmetric(self, errs: &[f64]) -> Self

Sets symmetric x-error values.

Each error value e produces a horizontal error bar from x - e to x + e at the corresponding data point. The length of errs must equal the number of data points.

Examples

artist.xerr_symmetric(&vec![0.2, 0.1, 0.15]);

pub fn xerr_asymmetric(self, low: &[f64], high: &[f64]) -> Self

Sets asymmetric x-error values.

Each point gets a separate low and high horizontal error. The error bar spans from x - low[i] to x + high[i]. Both slices must have the same length as the data series.

Examples

artist.xerr_asymmetric(&low_errs, &high_errs);

Trait Implementations

impl Clone for ErrorBarArtist

fn clone(&self) -> ErrorBarArtist

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorBarArtist

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.