dadams/data-centers
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

expanded voter data

Browse Source
This commit is contained in:
David Adams
2026-05-22 14:18:01 -07:00
parent dc8755cde0
commit c95f22fcdb
4 changed files with 628 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
build_fcc_bdc_broadband_connection_table.ipynb
View File

@@ -1478,6 +1478,48 @@
"- `fcc_max_advertised_download_mbps` / `fcc_max_advertised_upload_mbps` are estimated from the highest speed tier with non-zero availability share.\n",
"- Provider-count columns are populated from the separate provider-summary catalog, which is global catalog context rather than geography-specific broadband coverage."
]
},
{
"cell_type": "markdown",
"id": "28",
"metadata": {},
"source": [
"## Tables Created by This Notebook and Their Relationships\n",
"\n",
"This notebook creates and/or maintains five PostgreSQL tables in the `public` schema:\n",
"\n",
"1. `public.fcc_bdc_as_of`\n",
"- One row per FCC BDC release date and data type.\n",
"- Primary metadata table used to track versioning (`as_of_date`) for downstream loads.\n",
"\n",
"2. `public.fcc_bdc_files`\n",
"- One row per file discovered/downloaded for a release.\n",
"- Linked to releases via `as_of_date` and used as file-level lineage/provenance.\n",
"\n",
"3. `public.fcc_bdc_broadband_by_datacenter`\n",
"- Fact table keyed by `(master_id, as_of_date)` for per-data-center broadband availability metrics.\n",
"- Includes scalar broadband fields and summary JSON payloads.\n",
"- `master_id` aligns with `public.master_data_centers.master_id`.\n",
"\n",
"4. `public.fcc_bdc_broadband_summary`\n",
"- Aggregated summary metrics by release (`as_of_date`) used for QA and reporting.\n",
"\n",
"5. `public.fcc_bdc_provider_summary`\n",
"- Provider catalog/aggregation table by release (`as_of_date`) with provider class rollups.\n",
"\n",
"### Relationship Summary\n",
"\n",
"- `public.fcc_bdc_as_of (as_of_date)`\n",
" - 1-to-many -> `public.fcc_bdc_files (as_of_date)`\n",
" - 1-to-many -> `public.fcc_bdc_broadband_by_datacenter (as_of_date)`\n",
" - 1-to-many -> `public.fcc_bdc_broadband_summary (as_of_date)`\n",
" - 1-to-many -> `public.fcc_bdc_provider_summary (as_of_date)`\n",
"\n",
"- `public.master_data_centers (master_id)`\n",
" - 1-to-many over time -> `public.fcc_bdc_broadband_by_datacenter (master_id, as_of_date)`\n",
"\n",
"In short: **release metadata (`as_of` + `files`) supports reproducible loads, while per-DC broadband facts and release-level/provider-level summaries support analysis.**"
]
}
],
"metadata": {