Files
gig-line/Geo

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.

The OSM source files are © OpenStreetMap contributors, available under the Open Database License 1.0; see OpenStreetMap attribution. Public use of a derivative database can require sharing that database or the changes needed to recreate it under ODbL. Review the applicable obligations for each distributed product.

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 extract, both El Capitan footprints, the demo bounds, the building sets, the street profile, and the designated crossing are recorded in verification/. The local CRS and origin are fixed in manifests/local-origin.md, with the projected easting/northing still to be computed. Elevation is measured and the 3DEP 1 m DEM window is committed (EPSG:26911, NAVD88, 984 KB). The street cross-sections (crown ~2 %, gutters at ±10–11 m) are in verification/. The hero façade width is resolved at 25.75 m. The geo pipeline is ready for the Blender blockout.

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.