reading surface
Art and perception
- words
- 2,857reader scope
- sections
- 22article map
- references
- 27source trail
- compendium links
- 43wiki graph
Working Definition
Permalink to Working DefinitionData visualization is the craft of making data inspectable. A good visualization helps a reader compare values, see distribution, follow change, notice exceptions, understand uncertainty, and ask a better next question. It is not the decorative layer after analysis. It is part of the analysis.
The strongest visualizations preserve enough structure that the claim can be checked. They reveal scale, denominator, time window, sampling, missingness, transformation, and the software libraries that shaped the display. They connect data sources, data storage, design, maps, graphs, and mathematics.
Visualization is often how anomalies first become visible: an outlier, cluster, missing band, residual pattern, or spatial hotspot. The chart should make that exception inspectable without pretending that visual surprise is already an explanation.
For consciousness research, visualization should separate report, behavior, physiology, neural measurement, and interpretation. A clean brain image or time series is not enough unless the viewer can see what claim the measure actually supports.
Charts are also multimodal AI inputs: a system may read pixels, labels, axes, alt text, table data, and surrounding prose at the same time. The useful record keeps the plotted data and the visual mark together so the model's answer can point back to a real value, not just a screenshot impression.
Training neural networks turns this into an operational habit: loss curves, gradient norms, throughput charts, calibration plots, and failure galleries should stay attached to the examples and datasets that produced them.
Linear algebra is the hidden machinery behind many visual summaries: projections, principal components, embeddings, distance matrices, graph layouts, and dimensionality reduction. A visualization that compresses a vector space should say what was projected, which distance or norm mattered, and what structure may have been lost.
Music adds a temporal version of the same problem. Waveforms, spectrograms, meters, MIDI piano rolls, and audio-reactive visuals encode sound, but the display has to preserve timing, scale, and listening context instead of becoming decorative motion.
Art is the deeper visual neighbor: charts inherit older problems of composition, symbol, scale, color, and attention, but they add the extra obligation that visual form remain accountable to source data.
Overlanding adds a field-systems version: route timelines, elevation profiles, fuel range, water uncertainty, closure status, and repair events can be visualized without publishing exact sensitive coordinates.
Reading A Chart
Permalink to Reading A ChartAsk:
- What is the unit?
- What is the denominator?
- What was filtered out?
- Is the axis linear, logarithmic, normalized, cumulative, or truncated?
- Is uncertainty shown or hidden?
- Is color encoding a real variable or just decoration?
- Does the chart make comparison easier than the raw table?
These questions are rules of thumb, not proof. They help a reader notice scale, denominator, and uncertainty quickly, then point toward stronger evidence: source data, transformation steps, and a reproducible query.
Visualization Record Contract
Permalink to Visualization Record ContractA reusable visualization record should preserve:
- chart type and mark type;
- source dataset, source query, date pulled, and transformation steps;
- grain, unit, denominator, time window, and filters;
- x/y encodings, color/size/shape encodings, labels, and legend meaning;
- title, takeaway, caveats, and uncertainty method;
- alt text and a route back to the underlying data.
This keeps a chart from becoming a loose screenshot. It becomes an evidence object that semantic web metadata, search, and the knowledge graph can reuse.
Chart Claim Contract
Permalink to Chart Claim ContractEvery chart makes at least one claim, even when the claim is only implied by title, scale, or ordering. A durable chart record should separate the visual from the claim it supports. The visual might show a line moving upward; the claim might be that revenue is accelerating, a route is becoming less safe, a model is overfitting, or an archive has a missing decade. Those are different statements with different evidence requirements.
A practical claim contract names the metric, comparator, threshold, time window, population, and caveat. It also says whether the chart is descriptive, diagnostic, predictive, or prescriptive. Descriptive charts answer "what happened." Diagnostic charts suggest "why it may have happened." Predictive charts estimate "what could happen." Prescriptive dashboards suggest "what to do." Mixing those modes is how a harmless trend line becomes an unsupported recommendation.
For compendium pages, this distinction is especially useful because a chart may be cited by training neural networks, anomalies, maps, music, or overlanding. The graph should know whether the visualization merely displays a measurement or whether the prose uses it as evidence for a stronger interpretation.
Choosing A Form
Permalink to Choosing A FormThe chart form should match the question. Use lines for change over ordered time, bars for discrete comparison, scatterplots for relationships between measures, histograms for distributions, maps for spatial patterns, networks for relationships, and tables when exact lookup matters more than shape.
Network diagrams deserve special caution. A layout can make clusters, bridges, and central nodes feel obvious even when they are artifacts of force settings. Before drawing a network, use graph theory to decide what the nodes, edges, weights, and directed relationships mean.
Topology adds a second caution: some visual features are meant to preserve connectedness, boundaries, holes, or neighborhoods rather than precise metric distance. Persistence diagrams, Mapper graphs, manifold projections, and map generalizations should keep their scale choices and modeling assumptions close to the picture so the viewer can tell what structure survived the transformation.
When the audience needs to act, put the decision near the chart. A dashboard without a decision becomes decorative telemetry. A report chart should make one claim inspectable, then leave enough data and caveats for the reader to challenge it.
Common Chart Families
Permalink to Common Chart Families- Change over time: line charts, area charts, slope charts, sparklines, and event-annotated timelines.
- Comparison: bar charts, dot plots, ranked tables, small multiples, and bullet charts.
- Distribution: histograms, box plots, violin plots, quantile plots, and beeswarms.
- Relationship: scatterplots, correlograms, residual plots, and binned heatmaps.
- Part-to-whole: stacked bars and treemaps when the denominator is visible.
- Spatial and network: maps, flow maps, node-link diagrams, adjacency matrices, and neighborhood graphs.
The family should follow the question, not the tool's default chart menu.
Encoding Choices
Permalink to Encoding ChoicesEvery visual mark encodes something. Position is usually best for precise comparison, length is strong for magnitude, color is useful for category or intensity, shape can separate a few classes, and size is easy to overread. A good chart uses the strongest channel for the most important question.
This is where visualization meets semantics. If color means "region," "risk," or "model family," that meaning should also appear in labels, legends, source tables, alt text, and metadata. Otherwise the visual grammar is trapped in pixels and cannot travel into search, accessibility tools, or a semantic web record.
Color should be treated as a symbol, not paint. It needs a domain, legend, accessible fallback, and consistent mapping across related charts. If red means "danger" in one panel and "north region" in another, the reader has to relearn the system midstream.
Visualization Workflow
Permalink to Visualization Workflow- Inspect the source data before charting.
- Define grain, unit, denominator, and time window.
- Choose the comparison that matters.
- Make missingness and uncertainty visible when they affect interpretation.
- Check the chart on a small screen and in grayscale.
- Pair the visualization with a concise takeaway and a path back to the source.
This connects visualization to data sources, data storage, and design: the visual layer is only trustworthy when the data and presentation agree.
Uncertainty And Provenance
Permalink to Uncertainty And ProvenanceThe more persuasive a chart looks, the more provenance it needs. Keep the source query, date pulled, transformation notes, exclusions, sample size, missing-data handling, and uncertainty method close to the visualization. If the chart summarizes a model, say which model and what the model saw. If the chart uses manual annotation, say who annotated and what rule they followed.
For wiki use, this metadata should be reusable by the knowledge graph: chart claim, source dataset, metric definition, grain, time window, dimensions, and caveats. A visualization should become an inspectable evidence object rather than a loose screenshot.
Accessibility And Mobile Reading
Permalink to Accessibility And Mobile ReadingA chart that only works on a wide monitor is unfinished for the web. Use readable labels, avoid tiny legends, preserve table access for exact values, and make the takeaway understandable without hover. For mobile compendium pages, prefer chart descriptions, compact tables, and image widths that do not force horizontal scrolling unless the data itself requires it.
For human-machine interaction, the reader should be able to ask: what am I looking at, what changed, what can I inspect, and what source supports this view?
Dashboard Versus Report
Permalink to Dashboard Versus ReportA dashboard is for repeated monitoring; a report is for an argument. Mixing those modes creates weak displays. A dashboard should emphasize freshness, filters, alert thresholds, and stable definitions. A report should emphasize the claim, source, method, caveat, and conclusion. Both can use the same data, but they need different typography, density, annotation, and navigation.
For compendium pages, this distinction matters because charts may appear inside explanatory articles, graph explorers, field reports, and operational tools. A dense operations dashboard can be correct but unreadable in prose. A beautiful report chart can be persuasive but useless for live monitoring. Record the intended use so the visualization can be judged by the right standard.
Interactive State And Reproducible Views
Permalink to Interactive State And Reproducible ViewsInteractive charts add another recordkeeping problem: the view depends on state. Filters, hover selections, zoom level, color mappings, sort order, hidden series, and date ranges can change the interpretation without changing the underlying chart code. A saved screenshot is not enough if the reader cannot recover the state that produced it.
Reusable interactive visualizations should preserve a default view, stable query parameters, filter definitions, and a path back to the source table. If the chart supports brushing, linked views, map layers, or graph exploration, the article should name what state is shareable and what state is only local interaction. This matters for the compendium network because a reader may arrive through a URL that selects one node, article, or graph neighborhood.
For human-machine interaction, good interaction design prevents false precision. Hover details should not hide the only exact values. Zooming should not make small samples look more certain. Filtering should reveal when a denominator changed. A visualization is more trustworthy when its interface preserves the audit trail instead of turning every view into a new unrecorded claim.
SEO, Alt Text, And Source Tables
Permalink to SEO, Alt Text, And Source TablesCharts are often invisible to search and difficult for assistive technology unless the surrounding page carries the meaning. A useful chart needs a text title, a plain-language takeaway, axis labels, alt text, source note, and access to the underlying values when exact reading matters. The prose should say what changed, what comparison matters, and which caveat limits the claim.
This is not just accessibility hygiene. It makes the visualization more reusable by semantic web metadata, internal search, and transformer-based reading systems. A model or reader should be able to recover the chart's claim without guessing from pixels. The source table keeps the image accountable; the alt text keeps the meaning portable.
Compendium Display Checklist
Permalink to Compendium Display ChecklistEvery chart embedded in a compendium article should answer five reader questions near the visual: what is being compared, what unit is shown, where the data came from, what transformation was applied, and what caveat limits the takeaway. If the chart is interactive, the static page should still preserve the default view and the core claim.
This checklist keeps visualization tied to evidence. It also makes graph pages easier to audit because the chart, source table, claim, caveat, and article section can become separate but connected records.
The chart should never be the only place where the claim exists.
Source Table Pattern
Permalink to Source Table PatternThe source table is the chart's memory. It does not have to expose every private or oversized row, but it should preserve the grain of the visible data: one row per plotted point, interval, category, region, or relationship. Include fields for dimensions, measures, units, source, transformation, and caveat. If the rendered chart uses aggregated data, say what was aggregated and what was excluded.
This pattern helps readers, screen readers, search, and multimodal AI systems. A model that sees a chart image may misread a label, but a model that can inspect the source table and chart metadata can ground its answer in explicit values. The same table also helps the knowledge graph connect a visual claim to a dataset, source query, metric definition, and article section.
Theory and Fundamentals
Permalink to Theory and FundamentalsBooks
Permalink to Books- The Visual Display of Quantitative Information (opens in new tab) by Edward Tufte
- Envisioning Information (opens in new tab) by Edward Tufte
- Visual Explanations (opens in new tab) by Edward Tufte
- Beautiful Evidence (opens in new tab) by Edward Tufte
Tools for Data Visualization
Permalink to Tools for Data VisualizationVisualization tools should be recorded as dependency choices, not interchangeable paintbrushes. A charting library decides whether the output is SVG, canvas, WebGL, static image, HTML, or client-side interaction; it also changes accessibility, export, mobile layout, and the ease of preserving source rows.
Python
Permalink to Python- Matplotlib (opens in new tab)
- Seaborn (opens in new tab)
- Bokeh (opens in new tab)
- Plotly (opens in new tab)
- Vega-Altair (opens in new tab)
- pygal (opens in new tab)
Rust visualization usually appears either as chart generation inside data tools, interactive visualization in native UI, or WebAssembly-backed rendering. For compendium purposes, it connects to Rust, WebAssembly, and graphs.
Swift
Permalink to SwiftSwift visualization usually means product-facing charts, interface diagnostics, or personal analytics surfaces. It matters when the visualization is part of a native workflow rather than an exported report.
Knowledge Graph Use
Permalink to Knowledge Graph UseVisualization is also a graph utility problem. A compendium node, relationship, or claim becomes more useful when readers can see clusters, bridges, isolated nodes, and suspiciously dense regions. For graphs, the display should reveal structure without pretending that proximity alone proves causation or importance.
Useful graph views include neighborhood diagrams for one entity, timeline-linked networks for historical topics, bipartite graphs for people and institutions, map overlays for place-based content, and small-multiple charts for comparing topic families. The best view depends on the question: exploration, verification, navigation, teaching, or anomaly detection.
For music, useful views include waveform overviews, spectrograms, tempo maps, MIDI piano rolls, release graphs, sample lineage diagrams, and live-control state displays. These are visualizations of time-sensitive data, not merely album art.
For overlanding, useful views include route layers, planned-versus-actual tracks, fuel and water range bands, closure timelines, maintenance logs, and public-safe generalized maps.
Useful graph edges include visualizes, encodes, summarizes, filters, derives_from, caveated_by, compares, highlights, and contradicts. These typed relationships make the visualization useful beyond the article where it first appears.
Visual Claim Review
Permalink to Visual Claim ReviewA visualization should be reviewed as a claim, not as an image. The review starts with the sentence the chart is meant to support. If that sentence cannot name the measure, comparison, population, time window, transformation, and caveat, the chart is not ready. This is especially important for dashboards, where a reader may see dozens of indicators without a clear statement of what changed or what decision follows.
The strongest review pattern keeps four artifacts together: the chart, the source table, the claim sentence, and the caveat. The chart shows the pattern. The table preserves exact values. The claim says what the author believes the pattern means. The caveat says what the chart cannot prove. Those four artifacts give semantic web, multimodal AI, and internal search systems enough structure to reuse the visualization without turning it into unsupported prose.
Review should also check whether the visual encoding matches the data type. Time series need honest time spacing. Part-to-whole views need a stable denominator. Maps need projection, scale, and boundary notes. Network layouts need a warning that position may be algorithmic rather than geographic or causal. Uncertainty should be visual when possible and textual when necessary.
Evidence-Preserving Exports
Permalink to Evidence-Preserving ExportsExport format changes what survives. A PNG preserves pixels but loses rows, labels, and interaction. SVG preserves vector marks and text but may not carry the data model. HTML can preserve interaction but may depend on runtime code. A PDF may be durable but hard to inspect programmatically. A proper compendium record should therefore keep the export and the data contract together.
For long-lived pages, prefer a stable static view plus a linked source table or machine-readable data file. If the visualization was generated by code, preserve the library, version, query, and transformation notes. If the chart is a screenshot of a third-party tool, say so. That small provenance note keeps a visual argument auditable after styles, libraries, dashboards, or vendors change.
Failure Modes
Permalink to Failure Modes- Hiding the denominator.
- Using color scales that imply order where no order exists.
- Showing a dashboard without a clear decision attached.
- Reporting precision that the source data cannot justify.
- Treating a chart as proof when it is only a view into a modeled or filtered dataset.
Reference Sources
Permalink to Reference SourcesStable source anchors should keep chart grammar, implementation, accessibility, and source-data claims separated.
- Vega-Lite (opens in new tab)
- D3 (opens in new tab)
- Observable Plot (opens in new tab)
- Matplotlib (opens in new tab)
- ggplot2 (opens in new tab)
- W3C complex images tutorial (opens in new tab)
- WCAG non-text contrast guidance (opens in new tab)
- The Visual Display of Quantitative Information (opens in new tab)
- Envisioning Information (opens in new tab)
- Fundamentals of Data Visualization (opens in new tab)
- Vega-Altair documentation (opens in new tab)
- Bokeh documentation (opens in new tab)