
Chart | Data shape | Use when |
|---|---|---|
Date/value pairs using YYYY-MM-DD dates. | Use it for contribution, activity, incident, and habit patterns over weeks or months. | |
Label/value pairs rendered as radial bar segments. | Use it when cyclical comparison benefits from circular layout. | |
Vec<(angle_degrees, radius)>. | Use it for wind, direction, periodic signals, and angular measurements. | |
Vec<(value, size)> on a single horizontal scale. | Use it for timelines, distributions, and event density when a second axis would add noise. |
use fission::prelude::*;
use fission::charts::{Axis, Chart, LineSeries};
pub struct CoordinatesChart;
impl From<CoordinatesChart> for Widget {
fn from(_: CoordinatesChart) -> Widget {
Chart::new()
.title("Coordinates")
.x_axis(Axis::category(vec!["A", "B", "C"]))
.y_axis(Axis::value())
.series(vec![LineSeries::new("Series").data(vec![1.0, 2.0, 3.0]).into()])
.into()
}
}
Area | What to decide | How to verify |
|---|---|---|
Data shape | Keep source rows in typed Rust structs, then map them into the series type shown in the example. | Unit test the mapping separately from rendering. |
Options | Choose axes, legends, labels, animation, and interaction based on the user's task. | Add a screenshot test when changing visual behavior. |
Accessibility | Provide a clear title and adjacent summary text for important trends or outliers. | Inspect the generated semantics and make sure the chart is understandable without color alone. |
Failure handling | Render an empty, loading, or error state before constructing the chart if data is unavailable. | Test empty data, partial data, and failed fetches. |
Performance | Prefer summarized or windowed data for very large datasets; keep full raw history in the data layer. | Profile frame time and interaction latency with representative data volumes. |