Skip to main content
v0.1 dev

Data visualization

Graphs and plots

A governed, cross-platform evidence system for machine learning, telemetry, statistics, spatial analytics, networks and operations.

106 factories8 domainsWeb + Flutter + Python + Figma + MCPtable-equivalent

Reference composition

Observed + baseline + missing interval

Ambient temperature

Observed five-minute averages remained near baseline; one missing interval is shown as a gap.

Synchronized
  • Observed
  • Baseline
  • Review threshold
Window5 minutes · 284 valid samples · Europe/DublinMissing14:10–14:15 · no valid data
View equivalent data table
TimeObservedBaseline
14:0518.2 °C18.0 °C
14:10No valid data18.1 °C
14:1518.4 °C18.2 °C

Visual example gallery

Every registered visualization has a token-driven specimen using deterministic synthetic farm, device or model data. These are visual and accessibility references—not live, clinical or diagnostic results.

Portable component contract

Every named factory creates the same serializable specification. The renderer adapter draws it with D3, ECharts, Plotly, Vega, Matplotlib, fl_chart, CustomPainter or a native/BI engine; HealthEye owns the title, state, theme, provenance and accessible-data contract.

Web / TypeScript

import { createConfusionMatrixHeatmapVisualization } from '@healtheye/design-system-web/visualizations';

const spec = createConfusionMatrixHeatmapVisualization({
  variant: 'row-normalized',
  title: 'Cow pose classifier',
  data: matrix,
  accessibleData: rows
});

Flutter

final spec = heConfusionMatrixHeatmapVisualization(
  variant: 'row-normalized',
  title: 'Cow pose classifier',
  data: matrix,
  accessibleData: rows,
);

Python / ML

from healtheye_design_system.visualizations import create_confusion_matrix_heatmap_visualization

spec = create_confusion_matrix_heatmap_visualization(
  variant='row-normalized',
  title='Cow pose classifier',
  data=matrix,
  accessible_data=rows,
)

Visualization components

Use the catalog ID as the stable cross-platform name. Variants alter representation without changing the evidence contract.

Machine Learning, Evaluation & Vector Spaces19

Visualize model architecture, loss landscapes, embedding spaces, classification performance and explainability.

VisualizationVariantsWeb factoryPython factory
Confusion Matrix Heatmap
confusion-matrix-heatmap
count, row-normalized, column-normalizedcreateConfusionMatrixHeatmapVisualization()create_confusion_matrix_heatmap_visualization()
ROC Curve
roc-curve
binary, one-vs-rest, micro-macrocreateROCCurveVisualization()create_roc_curve_visualization()
Precision-Recall Curve
precision-recall-curve
binary, one-vs-rest, iso-f1createPrecisionRecallCurveVisualization()create_precision_recall_curve_visualization()
Calibration Curve (Reliability Diagram)
calibration-curve
uniform-bin, quantile-bin, with-histogramcreateCalibrationCurveVisualization()create_calibration_curve_visualization()
DET Curve (Detection Error Tradeoff)
det-curve
binary, multi-modelcreateDETCurveVisualization()create_det_curve_visualization()
Lift & Gains Charts
lift-gains-chart
lift, cumulative-gainscreateLiftGainsChartVisualization()create_lift_gains_chart_visualization()
Class Activation Map
class-activation-map
cam, grad-cam, eigen-camcreateClassActivationMapVisualization()create_class_activation_map_visualization()
SHAP Explainability Plot
shap-plot
summary, force, dependencecreateSHAPPlotVisualization()create_shap_plot_visualization()
LIME Explainer Graph
lime-explainer-graph
feature-weight, local-surrogatecreateLIMEExplainerGraphVisualization()create_lime_explainer_graph_visualization()
Partial Dependence Plot (PDP)
partial-dependence-plot
one-way, two-waycreatePartialDependencePlotVisualization()create_partial_dependence_plot_visualization()
Individual Conditional Expectation (ICE) Plot
ice-plot
centered, derivative, clusteredcreateICEPlotVisualization()create_ice_plot_visualization()
t-SNE Projection
t-sne-projection
2d, 3dcreateTSneProjectionVisualization()create_t_sne_projection_visualization()
UMAP Projection
umap-projection
2d, 3dcreateUMAPProjectionVisualization()create_umap_projection_visualization()
PCA Biplot
pca-biplot
scores, scores-loadingscreatePCABiplotVisualization()create_pca_biplot_visualization()
MDS Plot
mds-plot
metric, non-metriccreateMDSPlotVisualization()create_mds_plot_visualization()
Manifold Projection
manifold-projection
isomap, llecreateManifoldProjectionVisualization()create_manifold_projection_visualization()
Loss Landscape Surface Plot
loss-landscape-surface
surface-3d, contour, gradient-pathcreateLossLandscapeSurfaceVisualization()create_loss_landscape_surface_visualization()
Neural Network Architecture Diagram
neural-network-architecture
layered, computational-graph, collapsedcreateNeuralNetworkArchitectureVisualization()create_neural_network_architecture_visualization()
Decision Tree / Random Forest Diagram
decision-tree-diagram
decision-tree, forest-summary, path-highlightcreateDecisionTreeDiagramVisualization()create_decision_tree_diagram_visualization()

Statistical Distributions & Data Spread16

Analyze frequency, probability density, variation and outliers in continuous or categorical datasets.

VisualizationVariantsWeb factoryPython factory
Histogram
histogram
standard, stacked, mirroredcreateHistogramVisualization()create_histogram_visualization()
Kernel Density Estimation (KDE) Plot
kde-plot
single, multiple, filledcreateKDEPlotVisualization()create_kde_plot_visualization()
Box and Whisker Plot
box-whisker-plot
standard, notched, groupedcreateBoxWhiskerPlotVisualization()create_box_whisker_plot_visualization()
Violin Plot
violin-plot
single, split, groupedcreateViolinPlotVisualization()create_violin_plot_visualization()
Beanplot
beanplot
single, groupedcreateBeanplotVisualization()create_beanplot_visualization()
Ridgeline Plot (Joyplot)
ridgeline-plot
overlap, stackedcreateRidgelinePlotVisualization()create_ridgeline_plot_visualization()
Cumulative Distribution Function (CDF) Plot
cdf-plot
empirical, theoreticalcreateCDFPlotVisualization()create_cdf_plot_visualization()
Probability Density Function (PDF) Plot
pdf-plot
continuous, multiplecreatePDFPlotVisualization()create_pdf_plot_visualization()
Q-Q Plot
q-q-plot
normal, two-samplecreateQQPlotVisualization()create_q_q_plot_visualization()
P-P Plot
p-p-plot
probability, detrendedcreatePPPlotVisualization()create_p_p_plot_visualization()
Dot Plot
dot-plot
wilkinson, clevelandcreateDotPlotVisualization()create_dot_plot_visualization()
Stem-and-Leaf Plot
stem-leaf-plot
standard, split-stemcreateStemLeafPlotVisualization()create_stem_leaf_plot_visualization()
Bar Chart
bar-chart
horizontal, vertical, grouped, stacked, 100-percent-stackedcreateBarChartVisualization()create_bar_chart_visualization()
Frequency Polygon
frequency-polygon
single, multiplecreateFrequencyPolygonVisualization()create_frequency_polygon_visualization()
Population Pyramid
population-pyramid
count, percentagecreatePopulationPyramidVisualization()create_population_pyramid_visualization()
Fan Chart
fan-chart
quantile-band, confidence-bandcreateFanChartVisualization()create_fan_chart_visualization()

Relationships, Correlation & Dependencies11

Isolate mathematical correlation, multi-variable interactions and relative trends without implying causation.

VisualizationVariantsWeb factoryPython factory
Scatter Plot
scatter-plot
2d, 3d, bubblecreateScatterPlotVisualization()create_scatter_plot_visualization()
Scatter Plot Matrix (SPLOM / Pair Plot)
scatter-plot-matrix
scatter, density-diagonalcreateScatterPlotMatrixVisualization()create_scatter_plot_matrix_visualization()
Correlogram
correlogram
matrix-heatmap, circle, coefficientcreateCorrelogramVisualization()create_correlogram_visualization()
Parallel Coordinates Plot
parallel-coordinates
continuous, brushedcreateParallelCoordinatesVisualization()create_parallel_coordinates_visualization()
Parallel Categories Plot
parallel-categories
weighted, unweightedcreateParallelCategoriesVisualization()create_parallel_categories_visualization()
Radviz Plot
radviz-plot
2d, class-coloredcreateRadvizPlotVisualization()create_radviz_plot_visualization()
Andrews Curves
andrews-curves
class-grouped, sampledcreateAndrewsCurvesVisualization()create_andrews_curves_visualization()
Chernoff Faces
chernoff-faces
grid, clusteredcreateChernoffFacesVisualization()create_chernoff_faces_visualization()
Connected Scatter Plot
connected-scatter-plot
time-ordered, annotatedcreateConnectedScatterPlotVisualization()create_connected_scatter_plot_visualization()
Jointplot
jointplot
scatter, hexbin, kdecreateJointplotVisualization()create_jointplot_visualization()
Residuals Plot
residuals-plot
fitted, scale-location, leveragecreateResidualsPlotVisualization()create_residuals_plot_visualization()

Time-Series, Telemetry & IoT13

Present continuous streaming data, operational monitoring, temporary sessions and statistically governed process change.

VisualizationVariantsWeb factoryPython factory
Line Chart
line-chart
standard, multi-series, stepped, splinecreateLineChartVisualization()create_line_chart_visualization()
Area Chart
area-chart
standard, stacked, streamgraphcreateAreaChartVisualization()create_area_chart_visualization()
Sparkline
sparkline-chart
line, bar, win-losscreateSparklineChartVisualization()create_sparkline_chart_visualization()
Control / Shewhart Chart
control-chart
x-bar, r-chart, p-chart, c-chartcreateControlChartVisualization()create_control_chart_visualization()
CUSUM Chart
cusum-chart
one-sided, two-sidedcreateCUSUMChartVisualization()create_cusum_chart_visualization()
EWMA Chart
ewma-chart
standard, with-control-limitscreateEWMAChartVisualization()create_ewma_chart_visualization()
Horizon Chart
horizon-chart
mirrored, offsetcreateHorizonChartVisualization()create_horizon_chart_visualization()
Spiral Time-Series Chart
spiral-time-series
radial-line, radial-bandcreateSpiralTimeSeriesVisualization()create_spiral_time_series_visualization()
Calendar Heatmap
calendar-heatmap
daily, hour-daycreateCalendarHeatmapVisualization()create_calendar_heatmap_visualization()
Gantt Chart
gantt-chart
schedule, dependency, progresscreateGanttChartVisualization()create_gantt_chart_visualization()
Timeline Diagram
timeline-diagram
single-lane, multi-lanecreateTimelineDiagramVisualization()create_timeline_diagram_visualization()
VAR Impulse Response Plot
var-impulse-response
single-response, matrixcreateVARImpulseResponseVisualization()create_var_impulse_response_visualization()
Seasonal Decomposition Plot
seasonal-decomposition
additive, multiplicative, stlcreateSeasonalDecompositionVisualization()create_seasonal_decomposition_visualization()

Hierarchies, Part-to-Whole & Composition11

Map structural proportions, organizational breakdowns, set relationships and nested structures.

VisualizationVariantsWeb factoryPython factory
Pie & Donut Chart
pie-donut-chart
pie, donut, nested-donutcreatePieDonutChartVisualization()create_pie_donut_chart_visualization()
Treemap
treemap
squarified, slice-dicecreateTreemapVisualization()create_treemap_visualization()
Sunburst Chart
sunburst-chart
radial, zoomablecreateSunburstChartVisualization()create_sunburst_chart_visualization()
Circle Packing Diagram
circle-packing
nested, zoomablecreateCirclePackingVisualization()create_circle_packing_visualization()
Marimekko / Mosaic Plot
marimekko-chart
marimekko, mosaiccreateMarimekkoChartVisualization()create_marimekko_chart_visualization()
Waffle Chart
waffle-chart
square, iconcreateWaffleChartVisualization()create_waffle_chart_visualization()
Dendrogram
dendrogram
vertical, horizontal, radialcreateDendrogramVisualization()create_dendrogram_visualization()
Radial Tree Diagram
radial-tree
tidy, clustercreateRadialTreeVisualization()create_radial_tree_visualization()
Mind Map / Concept Web
mind-map
radial, hierarchicalcreateMindMapVisualization()create_mind_map_visualization()
Venn & Euler Diagram
venn-euler-diagram
venn, eulercreateVennEulerDiagramVisualization()create_venn_euler_diagram_visualization()
UpSet Plot
upset-plot
count, weightedcreateUpsetPlotVisualization()create_upset_plot_visualization()

Flows, Networks & Topologies10

Chart connections, directional pathways, dependencies, pipelines and industrial workflows.

VisualizationVariantsWeb factoryPython factory
Sankey Diagram
sankey-diagram
horizontal, verticalcreateSankeyDiagramVisualization()create_sankey_diagram_visualization()
Alluvial Diagram
alluvial-diagram
categorical, time-orderedcreateAlluvialDiagramVisualization()create_alluvial_diagram_visualization()
Chord Diagram
chord-diagram
directed, undirectedcreateChordDiagramVisualization()create_chord_diagram_visualization()
Node-Link Network Graph
node-link-network
force-directed, circular, hierarchicalcreateNodeLinkNetworkVisualization()create_node_link_network_visualization()
Dependency Wheel
dependency-wheel
directed, weightedcreateDependencyWheelVisualization()create_dependency_wheel_visualization()
Arc Diagram
arc-diagram
linear, radialcreateArcDiagramVisualization()create_arc_diagram_visualization()
Tree Diagram
tree-diagram
spanning-tree, minimum-spanning-treecreateTreeDiagramVisualization()create_tree_diagram_visualization()
PERT Chart
pert-chart
activity-on-node, critical-pathcreatePERTChartVisualization()create_pert_chart_visualization()
Value Stream Map
value-stream-map
current-state, future-statecreateValueStreamMapVisualization()create_value_stream_map_visualization()
Swimlane Flowchart
swimlane-flowchart
horizontal, verticalcreateSwimlaneFlowchartVisualization()create_swimlane_flowchart_visualization()

Geospatial & Spatial Analytics13

Map coordinates, localized assets, region boundaries, sensor fields, computer-vision overlays and 3D environments.

VisualizationVariantsWeb factoryPython factory
Choropleth Map
choropleth-map
sequential, diverging, categoricalcreateChoroplethMapVisualization()create_choropleth_map_visualization()
Isarithmic / Isopleth Map
isarithmic-map
contour-line, filled-contourcreateIsarithmicMapVisualization()create_isarithmic_map_visualization()
Dot Density / Pin Map
dot-density-map
dot-density, pin, clustered-pincreateDotDensityMapVisualization()create_dot_density_map_visualization()
Spatial Heatmap / Kernel Density Map
spatial-heatmap
screen-grid, kernel-densitycreateSpatialHeatmapVisualization()create_spatial_heatmap_visualization()
Cartogram
cartogram
contiguous, non-contiguous, dorlingcreateCartogramVisualization()create_cartogram_visualization()
Proportional Symbol Map
proportional-symbol-map
bubble, graduated-symbolcreateProportionalSymbolMapVisualization()create_proportional_symbol_map_visualization()
Flow Map
flow-map
origin-destination, bundledcreateFlowMapVisualization()create_flow_map_visualization()
Spike Map
spike-map
2d, 3dcreateSpikeMapVisualization()create_spike_map_visualization()
Hexbin / Grid Map
hexbin-map
hexbin, square-gridcreateHexbinMapVisualization()create_hexbin_map_visualization()
Voronoi Tessellation Map
voronoi-map
planar, weightedcreateVoronoiMapVisualization()create_voronoi_map_visualization()
Point Cloud Visualization
point-cloud-visualization
3d, height-colored, class-coloredcreatePointCloudVisualization()create_point_cloud_visualization()
Bounding Box / Cuboid Overlay
bounding-box-overlay
2d-box, 3d-cuboid, trackingcreateBoundingBoxOverlayVisualization()create_bounding_box_overlay_visualization()
Skeleton / Keypoint Wireframe Overlay
skeleton-keypoint-overlay
2d, 3d, confidence-coloredcreateSkeletonKeypointOverlayVisualization()create_skeleton_keypoint_overlay_visualization()

Finance, Economics & Operations13

Track market dynamics, variances, sensitivity, conversion, operational performance and budget controls.

VisualizationVariantsWeb factoryPython factory
Candlestick Chart
candlestick-chart
standard, volumecreateCandlestickChartVisualization()create_candlestick_chart_visualization()
OHLC Chart
ohlc-chart
standard, volumecreateOHLCChartVisualization()create_ohlc_chart_visualization()
Kagi Chart
kagi-chart
price, percentage-reversalcreateKagiChartVisualization()create_kagi_chart_visualization()
Renko Chart
renko-chart
fixed-brick, atr-brickcreateRenkoChartVisualization()create_renko_chart_visualization()
Point and Figure Chart
point-figure-chart
fixed-box, percentage-boxcreatePointFigureChartVisualization()create_point_figure_chart_visualization()
Waterfall Chart
waterfall-chart
bridge, variancecreateWaterfallChartVisualization()create_waterfall_chart_visualization()
Bullet Graph
bullet-graph
horizontal, verticalcreateBulletGraphVisualization()create_bullet_graph_visualization()
Gauge / Dial Meter
gauge-meter
radial, semicircle, linearcreateGaugeMeterVisualization()create_gauge_meter_visualization()
Funnel Chart
funnel-chart
stage, conversioncreateFunnelChartVisualization()create_funnel_chart_visualization()
Radar / Spider / Polar Chart
radar-chart
radar, filled-radar, polar-linecreateRadarChartVisualization()create_radar_chart_visualization()
Nightingale Rose / Polar Area Diagram
nightingale-rose
polar-area, stacked-polarcreateNightingaleRoseVisualization()create_nightingale_rose_visualization()
Tornado Diagram
tornado-diagram
sensitivity, scenariocreateTornadoDiagramVisualization()create_tornado_diagram_visualization()
Cost-Budget Meter / Burndown Chart
cost-budget-burndown
budget-meter, burndown, burnupcreateCostBudgetBurndownVisualization()create_cost_budget_burndown_visualization()

Core decision grammars

These eight common decision patterns remain the recommended starting point for product analytics; specialist factories extend them for scientific and engineering work.

GrammarUse whenAvoid whenRequired evidence
time-series-lineShowing a continuous metric over ordered timeSamples are categorical or intervals are incomparablemetric, unit, timezone, aggregationWindow, sampleCount, freshness, accessibleTable
threshold-areaExplaining time spent above or below an operational thresholdThe threshold is clinically unvalidatedthresholdLabel, thresholdSource, duration, accessibleTable
grouped-barComparing a small number of categories across farms, herds or periodsThere are more than twelve categorieszeroBaseline, categoryLabels, valueLabels, accessibleTable
distributionShowing spread, median and outliers for a populationThe audience needs individual animal recordspopulation, sampleCount, median, quartiles, outlierDefinition
scatterExploring association between two measured variablesThe relationship could be interpreted as causationxMetric, yMetric, units, sampleCount, accessibleTable
heatmapFinding patterns across time and many entitiesExact values are the primary tasklegend, scaleDomain, missingPattern, keyboardTable
event-timelineRelating alerts, interventions and evidence over timeEvents have no reliable timestamptimezone, eventType, source, actor, accessibleList
small-multiplesComparing the same metric and scale across a bounded set of entitiesPanels require different scalessharedScale, panelLabel, sortingRule, accessibleTable

Evidence encoding

EvidenceLabelToken or rendering
observedObservedcolor.data.categorical.1
baselineBaselinecolor.data.categorical.2
predictedModel estimatecolor.data.categorical.3
uncertaintyUncertainty rangecolor.data.categorical.3
thresholdReview thresholdcolor.status.review.border
missingNo valid datagap

Accessibility and missing data

All factories bind to healtheye-visualization-aa-v1. The rules apply equally to Web, Flutter, Python/ML, Figma handoff and BI renderer adapters.

  • Every visual has a visible title and a concise plain-language interpretation that states the decision it supports. A user can understand the main finding without inspecting marks.
  • Every visual has an equivalent table, structured list or downloadable accessible dataset containing the same values and units. Compare visual values with the accessible representation.
  • Colour is never the only carrier of series, severity, freshness, selection or missingness. Visual remains interpretable in grayscale and simulated colour-vision deficiency.
  • Text meets 4.5:1; meaningful marks, axes, focus and adjacent graphical objects meet at least 3:1. Automated token contrast plus representative rendered-image review.
  • Interactive marks, filters and disclosures are keyboard operable with visible focus and logical order; otherwise the equivalent data view provides the full task. Complete the analysis task without mouse or touch.
  • Animation never conveys unique information, auto-advances or blocks comprehension; reduced-motion mode is static or near-instant. Verify reduced-motion/system animation settings.
  • At 320 px, 200% browser zoom and text scale 2.0, titles, summaries, legends and controls reflow without loss or two-dimensional scrolling. Audit compact, medium and expanded containers.
  • Loading, empty, delayed, stale, offline, error, missing and excluded data are explicitly named; provenance, units, aggregation and time context remain available. Inspect every state without relying on colour or icon alone.
  • Maps, point clouds, camera overlays, pose skeletons and 3D scenes provide a non-spatial summary of detected entities, confidence, coordinates/region and relationships. Complete identification and review tasks without interpreting the canvas.
  • Avoid deceptive perspective, unexplained acronyms, unlabeled thresholds and unsupported causal claims; use farmer-readable language for customer-facing views. Domain comprehension review with representative farmers and operators.
Never bridge missing observations

Show a visible gap and name the invalid or absent interval in the summary and equivalent table.