Skip to content

update docs to match new download format (and correct column names)#388

Merged
Shane98c merged 4 commits intomainfrom
Shane98c/download-docs-update
Apr 22, 2026
Merged

update docs to match new download format (and correct column names)#388
Shane98c merged 4 commits intomainfrom
Shane98c/download-docs-update

Conversation

@Shane98c
Copy link
Copy Markdown
Member

@Shane98c Shane98c commented Apr 14, 2026

Updates docs to match new direct download pattern from carbonplan/ocr-web#155

Swaps in a new screenshot, and updates locations in the docs to match GeoPackage => GeoJSON change as well as csv column name correction.

@Shane98c Shane98c changed the title udpate docs to match new download format (and correct column names) update docs to match new download format (and correct column names) Apr 14, 2026
@Shane98c Shane98c requested a review from katamartin April 21, 2026 17:49
Comment thread docs/access-data.md Outdated
| `GEOID` | int | [Geographic Identifier](https://www.census.gov/programs-surveys/geography/guidance/geo-identifiers.html) representing building (multiple buildings might belong to the same GEOID) |
| `longitude` | degrees | Longitude of building centroid |
| `latitude` | degrees | Latitude of building centroid |
| `centroid_longitude` | degrees | Longitude of building centroid (CSV only; encoded in `geometry` for GeoJSON) |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oof looks like these have gotten really out-of-whack!

We updated both these columns and and the analogous columns for regional statistics downloads to drop the verbose centroid_* prefix. The goal of that PR was to document complementary changes that would be made on the data processing side, but it looks like that didn't quite happen (cc @norlandrhagen).

Rather than make any pipeline changes, I'd suggest the following:

  • Subsetted data downloads: Is it possible to remove the centroid_* prefix in Client downloads via duckdb-wasm ocr-web#155 and revert this change?
  • Regional statistics downloads: It looks like lat/lon have been dropped from these entirely 😕 . Shall we just update the documentation to reflect that?
    • By deleting these entries in the schema:

      ocr/docs/access-data.md

      Lines 63 to 64 in f90484e

      | `longitude` | degrees | Longitude of centroid of region |
      | `latitude` | degrees | Latitude of centroid of region |

Comment thread docs/access-data.md Outdated
| `longitude` | degrees | Longitude of building centroid |
| `latitude` | degrees | Latitude of building centroid |
| `centroid_longitude` | degrees | Longitude of building centroid (CSV only; encoded in `geometry` for GeoJSON) |
| `centroid_latitude` | degrees | Latitude of building centroid (CSV only; encoded in `geometry` for GeoJSON) |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we also add an entry for geometry?

Comment thread docs/access-data.md Outdated
Shane98c and others added 2 commits April 21, 2026 13:59
Co-authored-by: Kata Martin <katasm@gmail.com>
@Shane98c Shane98c merged commit b74a1cb into main Apr 22, 2026
11 checks passed
@Shane98c Shane98c deleted the Shane98c/download-docs-update branch April 22, 2026 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants