# Geo

Geographic sources, manifests, and the scripts that turn them into Blender imports.

OSM is layout data only. It is not authoritative for façade detail, height, or pavement, and it is never sampled as a texture or panorama source.

## Layout

| Path | Contents |
| --- | --- |
| `Geo/raw/` | Verbatim source responses, checksummed. Never edited by hand. |
| `Geo/verification/` | Per-pass verification notes: address, footprint, bounds, and what remains unresolved |
| `Geo/manifests/` | One manifest per saved extract (see below) |
| `Geo/scripts/` | Repeatable fetch and conversion helpers |

Current state: the two El Capitan footprints are verified in [`verification/2026-11-06-el-capitan-block.md`](verification/2026-11-06-el-capitan-block.md). The block-wide extract, boundary intersections, north-side enumeration, and elevation check are open.

## Required manifest

Every extract gets a manifest file `Geo/manifests/<source>-<date>.md` recording:

| Field | Example |
| --- | --- |
| Source | Overpass API / Geofabrik / OSM extract provider |
| Extract date | date the query ran or the file was downloaded |
| Query or file URL | the exact query text or download URL |
| Data timestamp | OSM data date reported by the source (may differ from the extract date) |
| Bounds | west, south, east, north in WGS84 decimal degrees |
| Licence | ODbL 1.0, attribution string |
| Checksum | SHA-256 of the committed file |
| CRS and local origin | projected CRS plus the chosen origin, with its WGS84 coordinates |
| Files | every file produced from this extract |

## Demo bounds

`0.1.0` covers 6840 Hollywood Blvd / El Capitan Entertainment Centre, buildings on the south side of Hollywood Boulevard between Highland Avenue and Orange Drive, and north-side buildings whose footprint lies within 50 m of the north frontage. Verify address, footprints, and boundaries against source data before modeling; anything unverifiable is recorded here as unresolved and is not modeled.

## Coordinate convention

- Work in a local projected CRS (EPSG:26911, NAD83 / UTM zone 11N, is the default candidate) and record the local origin explicitly.
- Blender and Unreal both take metres → Unreal units at 1 m = 100 uu. The conversion is applied once, in one place, and recorded in the manifest. Never apply a second silent scale on import.
- Preserve the original geographic coordinates in metadata so any asset can be traced back to its position.

## Unresolved items

Record here any structure whose address, footprint, or boundary could not be verified from permitted sources, with the sources checked. It does not get modeled.