nyc-mesh 0.1.0

Python toolkit for converting NYC CityGML and LiDAR into web-ready 3D geodata.

nyc-mesh

Python toolkit for converting NYC open 3D source data into web-ready geodata.

nyc-mesh focuses on the messy middle between raw public CityGML releases and practical outputs for browsers, notebooks, and reproducible analysis workflows.

What ships in the 0.1 line

The current release implements one honest end-to-end path:

• load a local CityGML file
• extract footprint and measured height
• reproject source coordinates from EPSG:2263 to EPSG:4326
• optionally clip by WGS84 bounding box
• export height-aware GeoJSON
• run the same flow from the installed nyc-mesh CLI

Everything else stays scaffolded with explicit NotImplementedError placeholders until the implementation is real.

Why this exists

NYC publishes unusually rich 3D geospatial data, but the raw formats are hard to use in practice. The source files are large, specialist, and awkward to transform into lightweight outputs for web rendering or neighborhood-scale analysis.

This package aims to make the first useful workflow feel like:

1. point at a CityGML source file
2. extract and clip the buildings you care about
3. export a web-friendly GeoJSON artifact

Quickstart

Install:

pip install nyc-mesh

Export GeoJSON from CityGML:

nyc-mesh export-geojson --input sample.gml --output buildings.geojson

Python example

from pathlib import Path

from nyc_mesh import BoundingBox, export_citygml_geojson

export_citygml_geojson(
    Path("sample.gml"),
    Path("buildings.geojson"),
    bbox=BoundingBox(
        min_lat=40.70,
        min_lon=-74.02,
        max_lat=40.72,
        max_lon=-73.99,
    ),
)

Current assumptions

The implemented 0.1 path is intentionally narrow:

• local CityGML files only
• only buildings with bldg:measuredHeight
• source coordinates are treated as EPSG:2263
• outputs are reprojected to EPSG:4326
• optional clipping uses a WGS84 bounding box

Notebook walkthrough

The repo includes a small reproducible notebook at notebooks/dumbo-citygml-geojson-walkthrough.ipynb for the current happy path.

Documentation

• Hosted docs: nyc-mesh.readthedocs.io
• Local preview: make docs
• Strict docs build: make docs-build

Development

make install-dev
make test
make lint
make docs-build
make ci

License

MIT.