Enum GraphError 

#[non_exhaustive]
pub enum GraphError {
    Render(String),
    Io(Error),
    Curve(CurveError),
    Surface(SurfaceError),
    Decimal(Box<DecimalError>),
    Backtest(Box<BacktestError>),
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    TooSmall {
        width: u32,
        height: u32,
        min_width: u32,
        min_height: u32,
    },
    NoRoom {
        width: u32,
        height: u32,
    },
    InvalidLineWidth {
        name: String,
        width: f64,
    },
    LengthMismatch {
        name: String,
        x: usize,
        y: usize,
    },
    SurfaceLengthMismatch {
        name: String,
        x: usize,
        y: usize,
        z: usize,
    },
    DegenerateSurface {
        name: String,
        columns: usize,
        rows: usize,
    },
    DuplicateSurfacePoint {
        name: String,
        x: Decimal,
        y: Decimal,
    },
    IncompleteSurface {
        name: String,
        expected: usize,
        found: usize,
    },
    NotRepresentable(Decimal),
    InvalidColor {
        color: String,
        reason: String,
    },
    MissingGlyph {
        character: char,
        code: u32,
        text: String,
    },
    NotXmlText {
        character: char,
        code: u32,
        text: String,
    },
    UnsupportedText(String),
}

Represents errors that can occur during graph generation and rendering operations.

This error type encapsulates failures that may happen when creating, rendering, or saving graphical representations of financial data such as option chains, volatility surfaces, or strategy payoffs.

The PNG and SVG export (static_export) reports data it cannot draw faithfully with its own variants rather than repairing it: a surface with missing or repeated grid points, series whose coordinate arrays differ in length, a colour or a label character it cannot reproduce. The enum is #[non_exhaustive]: match it with a wildcard arm, since later releases may add variants.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Render(String)

Represents errors that occur during the rendering process. Contains a descriptive message about what went wrong.

Io(Error)

Represents I/O errors that occur when reading from or writing to files (e.g., when saving graphs to disk).

Curve(CurveError)

Error from curve operations.

Surface(SurfaceError)

Error from surface operations.

Decimal(Box<DecimalError>)

A figure a report derives for display (a total, an average) left the representable Decimal range.

Backtest(Box<BacktestError>)

The backtest figures a report shows could not be computed, for example when the statistics of a SimulationStats accumulator overflow Decimal.

InvalidDimensions

The configured figure width or height is zero or larger than the 16384 pixels the static export draws.

Fields

width: u32

Configured width in pixels.

height: u32

Configured height in pixels.

TooSmall

The figure is too small to lay the chart out.

Fields

width: u32

Configured width in pixels.

height: u32

Configured height in pixels.

min_width: u32

Smallest width the chart is laid out in.

min_height: u32

Smallest height the chart is laid out in.

NoRoom

The title, legend or colour bar leave no pixels to draw the chart in.

Fields

width: u32

Configured width in pixels.

height: u32

Configured height in pixels.

InvalidLineWidth

A line width is not a finite number of pixels between 0 and 100.

Fields

name: String

Name of the series.

width: f64

The width given.

LengthMismatch

A 2D series has a different number of x and y values. Plotly drew the shorter length; the static export does not drop points.

Fields

name: String

Name of the series.

x: usize

Number of x values.

y: usize

Number of y values.

SurfaceLengthMismatch

A surface has a different number of x, y and z values.

Fields

name: String

Name of the surface.

x: usize

Number of x values.

y: usize

Number of y values.

z: usize

Number of z values.

DegenerateSurface

A surface needs at least two distinct x and two distinct y values.

Fields

name: String

Name of the surface.

columns: usize

Distinct x values.

rows: usize

Distinct y values.

DuplicateSurfacePoint

A surface grid point appears more than once. Plotly kept the last value; the static export does not choose.

Fields

name: String

Name of the surface.

x: Decimal

x of the repeated point.

y: Decimal

y of the repeated point.

IncompleteSurface

A surface grid point is missing: expected is distinct x times distinct y, found the number of points given. Plotly filled the gaps with zero; the static export does not invent values.

Fields

name: String

Name of the surface.

expected: usize

Points a complete grid has.

found: usize

Points the surface has.

NotRepresentable(Decimal)

A value has no f64 representation for drawing.

InvalidColor

A colour string is none of the CSS Color 4 forms the static export accepts: a named colour, #rgb, #rgba, #rrggbb, #rrggbbaa, rgb()/rgba() or hsl()/hsla().

Fields

color: String

The string as given.

reason: String

Why it was rejected.

MissingGlyph

A label uses a character the bundled font has no glyph for. The static export never substitutes or drops it.

Fields

character: char

The character without a glyph.

code: u32

Its code point, for display.

text: String

The whole label.

NotXmlText

A label, or the chart title or description an SVG carries, contains a character XML 1.0 cannot represent: a C0 control other than tab, line feed and carriage return, U+FFFE or U+FFFF.

Fields

character: char

The character XML cannot carry.

code: u32

Its code point, for display.

text: String

The string it was found in.

UnsupportedText(String)

Text the static export cannot draw: a font style other than the bundled regular face, or SVG text outside the form it converts.

Trait Implementations

impl Debug for GraphError

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

Formats the value using the given formatter.

impl Display for GraphError

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

Formats the value using the given formatter.

impl Error for GraphError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BacktestError> for GraphError

fn from(err: BacktestError) -> Self

Converts to this type from the input type.

impl From<CurveError> for GraphError

fn from(err: CurveError) -> Self

Converts to this type from the input type.

impl From<DecimalError> for GraphError

fn from(err: DecimalError) -> Self

Converts to this type from the input type.

impl From<Error> for GraphError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SurfaceError> for GraphError

fn from(err: SurfaceError) -> Self

Converts to this type from the input type.