ONS Balances — Wiki

gas-first ONS grid data dashboard
← Back to dashboard

ONS Balances — Wiki

A gas-first dashboard for Brazil's grid operator (ONS) open data: daily subsystem balances, plant-level thermal dispatch, installed capacity, and reservoir storage, aggregated into a single self-contained HTML page. No server, no database, no API — the data is embedded in the file itself.

This wiki covers what the README doesn't: how to read the live dashboard, how the pieces are deployed and wired together, and what to take with a grain of salt.

Pages

  • Using the Dashboard — the three tabs, what each number means, controls, exports, and the "Refresh data" button. Start here if you're reading the live site and want to know what you're looking at.
  • Architecture and Deployment — the fetch → build → dashboard pipeline, the CI/CD workflow, and how this repo relates to the other gasbrazil.com properties. Start here if you're maintaining the code.
  • Known Limitations and Assumptions — every place a number on the dashboard rests on an assumption rather than a published ONS figure, plus the standing data-quality caveats. Worth reading before quoting a number from this tool to someone else.

Live sites

One repo, path-based URLs. The same pages are on the custom domain and the GitHub Pages host:

Site gasbrazil.com Mirror
Landing page gasbrazil.com gasbrazil.github.io
ONS Balances gasbrazil.com/ons gasbrazil.github.io/ons
POC Results gasbrazil.com/poc gasbrazil.github.io/poc
POC Contracts gasbrazil.com/contratos gasbrazil.github.io/contratos
About gasbrazil.com/about gasbrazil.github.io/about

Repo at a glance

ons_pipeline.py     downloader + aggregator + CLI
dashboard.py        HTML/JS dashboard generator (imported by the CLI)
make_mock.py        generates ONS-shaped fake data for offline testing
check_bulletin.py   reconciles the store against an ONS DIARIO_*.xlsx bulletin
../.github/workflows/ons.yml   twice-daily rebuild + commit of ons/index.html
../shared/fonts/Degular.ttf    self-hosted font, embedded at build time
requirements.txt

Full setup, CLI flags, and local usage are in the README — this wiki assumes you've already got it running and focuses on the dashboard itself and how it's deployed.