Data Analytics, CSVW Web Worker & PSPP Statistical Suite

The Hugo-Carbon Data & Analytics Suite provides an enterprise-grade, client-side data exploration, statistical analysis, and operational dashboard environment. It computes initial KPI aggregates at build time for zero layout shift and instantaneous load times, while utilizing a background Web Worker for interactive filtering, sorting, and GNU PSPP statistics.

[!NOTE] Static Architecture Notice: All analytics, metrics, charts, and maps operate on static, versioned dataset files (.csv, .csv-metadata.json, .geojson). Computations occur purely at build time and within client-side Web Workers without backend servers or live streaming endpoints. Source datasets can be downloaded directly from the toolbar links.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

┌────────────────────────────────────────────────────────────────────────┐
│             Hugo-Carbon Client-Side Static Data Architecture           │
├────────────────────────────┬───────────────────────────────────────────┤
│ Build Time (Hugo Compiler) │ Background Web Worker (csvw-worker.js)    │
├────────────────────────────┼───────────────────────────────────────────┤
│ • Exact Precomputed KPIs   │ • Asynchronous CSV text tokenizer         │
│ • Static HTML Rendering    │ • Full-text search & column filter engine │
│ • Full-Width Responsive Map│ • Descriptives (Mean, StdDev, Skew, Kurt) │
│ • PSPP Variable View Grid  │ • Contingency Crosstabs & Chi-Square      │
│ • Direct Source Downloads  │ • Pearson / Spearman Correlation Matrices │
└────────────────────────────┴───────────────────────────────────────────┘

1. The CSVW Data Engine & Web Worker Pipeline

The data engine conforms to the W3C CSV on the Web (CSVW) recommendation. Tabular datasets (.csv) are coupled with JSON-LD schema metadata files (.csv-metadata.json) defining column types, titles, units, and constraints.

Automatic Metadata Resolution

When providing csv: "/data/server-telemetry.csv", the engine automatically discovers and binds /data/server-telemetry.csv-metadata.json without requiring duplicate parameter configuration.

Direct Source Dataset Downloads

Rather than generating synthetic client-side exports, the table toolbar provides direct download links for:

• Download CSV: Direct link to the source .csv file.
• CSVW Meta: Direct link to the W3C CSVW .csv-metadata.json JSON-LD schema.
• GeoJSON: Direct link to the source .geojson vector file on maps and modal viewers.

2. YAML-Driven Analytics Suite Shortcode

The analytics-suite shortcode calculates KPI aggregates at compile time and renders full-width maps and tables with clean YAML instructions:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

{{< analytics-suite >}}
title: "Global Node Infrastructure & Performance Dataset"
description: "Static cluster fleet matrix with GNU PSPP statistical engine and geospatial coordination."
csv: "/data/server-telemetry.csv"

kpis:
  - variable: "cpu_utilization"
    calculation: "mean"
    label: "Mean CPU Load"
    suffix: "%"
    accent: "blue"
  - variable: "memory_usage"
    calculation: "mean"
    label: "Mean Memory Usage"
    suffix: "%"
    accent: "purple"
  - variable: "uptime_days"
    calculation: "sum"
    label: "Total Cumulative Uptime"
    suffix: " Days"
    accent: "green"
  - variable: "server_id"
    calculation: "count"
    label: "Monitored Edge Nodes"
    suffix: " Nodes"
    accent: "magenta"

map:
  enable: true
  source: "/data/sample-infrastructure.geojson"
  lat: 38.0
  lng: 15.0
  zoom: 2
  height: "440px"
  title: "Global Node Geospatial Distribution"

table:
  enable: true
  title: "Edge Server Fleet Matrix"
  variables: ["server_id", "cluster_name", "region", "cpu_utilization", "memory_usage", "uptime_days", "status"]
  summaryRow: "both" # "totals" | "averages" | "both" | "none"
  pageSize: 6
{{< /analytics-suite >}}

3. Application Variant 1: Research Demographics & GNU PSPP Statistical Suite

This showcase demonstrates a behavioral research dataset with active Variable View, Descriptives, and the GNU PSPP Analytics Studio:

4. Application Variant 2: Environmental Climate Network (GeoJSON + CSVW Table)

This variation links spatial coordinates in Lisbon, Madrid, Paris, London, and Tokyo with an air quality sensor table. Clicking a map marker filters the data table, and clicking a row pans the map:

5. Application Variant 3: Modal-Triggered Analytics Dashboard

The suite allows any dashboard to be launched as an elevated, distraction-free modal dialog using the dashboard-modal shortcode:

6. GNU PSPP Command Syntax Reference

When clicking PSPP Studio, the engine generates standard GNU PSPP command syntax:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

* GNU PSPP Command Syntax for Static Research Demographics Dataset.
DATA LIST FREE / participant_id age gender education_level cognitive_score reaction_time_ms stress_index treatment_group.
BEGIN DATA.
P-101 24 Female Master 88.5 312 4.2 Experimental
P-102 29 Male Bachelor 76.0 345 6.8 Control
P-103 35 Female PhD 94.2 289 3.1 Experimental
END DATA.

* Run descriptive statistics with standard error.
DESCRIPTIVES VARIABLES=age cognitive_score reaction_time_ms stress_index
  /STATISTICS=MEAN STDDEV MIN MAX SEMEAN VARIANCE SKEWNESS KURTOSIS.

* Run frequency distributions and bar charts.
FREQUENCIES VARIABLES=gender education_level treatment_group
  /BARCHART FREQ.

* Run crosstabulation with Pearson Chi-Square test of independence.
CROSSTABS
  /TABLES=treatment_group BY education_level
  /STATISTICS=CHISQ
  /CELLS=COUNT ROW COLUMN TOTAL.

7. MapLibre GL Vector Tile Architecture & Carbon Styling

The platform employs MapLibre GL JS to render GPU-accelerated vector tiles with custom Carbon Design System v11 Dark & Light color schemes:

Vector Tile Layer Specifications

• Base Background: #161616 (--cds-background dark) / #f4f4f4 (light)
• Water Bodies & Rivers: #0d2137 / #d6e8f2 (soft marine and jeans blue)
• Buildings & Footprints: #262626 (--cds-layer-01 dark) / #ffffff (light)
• Motorways / Expressways: #0f62fe (Interactive Blue 60 accent)
• Primary & Secondary Roads: #525252 / #a8a8a8
• Minor & Residential Roads: #262626 / #e0e0e0
• Administrative Boundaries: #69a280 / #8d8d8d (sage green accent)
• Typography & Place Labels: Configured with Plex Sans glyphs

User-Configurable Default Layers & Toggles

In shortcodes and YAML configurations, authors can specify default layer states:

1
2
3
4
5
6
7
8
9

map:
  enable: true
  source: "/data/sample-infrastructure.geojson"
  roads: true
  buildings: true
  labels: true
  boundaries: true
  theme: "auto" # "auto" | "dark" | "light"
  height: "440px"

Interactive switches in the map toolbar allow users to dynamically toggle Roads, Buildings, and Labels with instantaneous WebGL layer updates, as well as switch between Auto, Dark Vector, and Light Vector styles.