Getting Started¶

This guide shows the fastest path to the current nyc-mesh workflow.

Install¶

pip install nyc-mesh

For local development:

make install-dev

Export GeoJSON from official CityGML¶

nyc-mesh export-geojson --input "C:/path/to/DA_WISE_GML.zip" --output buildings.geojson

You can also clip to a WGS84 bounding box:

nyc-mesh export-geojson \
  --input "C:/path/to/DA_WISE_GML.zip" \
  --output buildings.geojson \
  --min-lat 40.70 \
  --min-lon -74.02 \
  --max-lat 40.72 \
  --max-lon -73.99

Use the Python API¶

from pathlib import Path

from nyc_mesh import models, pipeline

pipeline.export_citygml_geojson(
    Path("C:/path/to/DA_WISE_GML.zip"),
    Path("buildings.geojson"),
    bbox=models.BoundingBox(
        min_lat=40.70,
        min_lon=-74.02,
        max_lat=40.72,
        max_lon=-73.99,
    ),
)

More than GeoJSON¶

The same extracted buildings can also feed:

nyc_mesh.export.export_geoparquet() for analysis workflows
nyc_mesh.export.export_gltf() for lightweight 3D viewers
nyc_mesh.export.export_3d_tiles() for a minimal Cesium package

Current assumptions¶

The official-data workflow is intentionally opinionated:

large official archives are expected to live in a local cache path
buildings must expose bldg:measuredHeight
source coordinates are treated as EPSG:2263
outputs are reprojected to EPSG:4326