Boston BERDO building energy and emissions disclosure, 2015 to 2024: sample notebook
A worked notebook for Boston BERDO building energy and emissions disclosure, 2015 to 2024, with 1 code cell and the output each one printed. On Scigantic it opens in a hosted JupyterLab with the dataset already mounted, so nothing is downloaded first.
- Provider
- City of Boston (Environment Department)
- License
- Open Data Commons Public Domain Dedication and License (PDDL) 1.0
- Format
- Parquet (in sampled files)
- Stored at
- Amazon S3, s3://scigantic-boston-open-data/berdo (us-east-1)
- Access
- Free and public. No account with the data provider is needed.
The notebook
Boston BERDO building energy and emissions disclosure, 2015 to 2024
One row is one building (or campus) in one reporting year.
Nothing is mounted. This archive is served over the data.boston.gov API, so there are no files to browse — the cell below fetches the data over the network.
import json, urllib.parse, urllib.request
import pandas as pd
# 2023-reported-energy-and-water-metrics.xlsx — 5,981 rows
RESOURCE = "cb9ad2aa-eec6-4726-a308-945a215056d5"
url = "https://data.boston.gov/api/3/action/datastore_search?" + urllib.parse.urlencode(
{"resource_id": RESOURCE, "limit": 100}
)
with urllib.request.urlopen(url, timeout=120) as r:
df = pd.DataFrame(json.load(r)["result"]["records"])
print(df.shape)
df.head()
Next
- limit is capped at 32,000 per request. This dataset has 5,981 rows, so aggregate server-side rather than pulling it all.
- Most columns come back as text even when they hold numbers or dates — cast before you compare or total.
- Ask the AI panel on the right for a query. It already has this dataset's full schema card, including the other resources and the traps.
- Source: https://data.boston.gov/dataset/building-emissions-reduction-and-disclosure-ordinance
Run it
Open this notebook to run it, see the dataset page for the full description, or browse the full catalog.