nyc-geo-toolkit 0.1.2

Reusable NYC geography resources, normalization helpers, and boundary loaders for Python tools.

nyc-geo-toolkit

Reusable NYC geography resources, normalization helpers, and boundary loaders for Python tools.

Authored by Blaise Albis-Burdige.

What this package provides

nyc-geo-toolkit packages canonical NYC boundary layers and the small helper API needed to discover, normalize, load, subset, and convert them.

The initial release focuses on:

• packaged boundary layers for boroughs, community districts, council districts, NTAs, ZCTAs, and census tracts
• canonical normalization helpers for layer names and boundary values
• typed boundary models for boundary collections and features
• GeoJSON and optional DataFrame / GeoDataFrame helpers
• bbox clipping for typed boundary collections

Install

Base install:

pip install nyc-geo-toolkit

With pandas helpers:

pip install "nyc-geo-toolkit[dataframes]"

With geopandas + shapely helpers:

pip install "nyc-geo-toolkit[spatial]"

With all optional helpers:

pip install "nyc-geo-toolkit[all]"

Quick example

from nyc_geo_toolkit import load_nyc_boundaries, list_boundary_layers

print(list_boundary_layers())
queens = load_nyc_boundaries("borough", values="Queens")
print(queens.features[0].geography_value)

Public surface

The stable public API centers on:

• list_boundary_layers()
• list_boundary_values()
• load_boundaries()
• load_nyc_boundaries()
• load_nyc_boundaries_geodataframe()
• load_nyc_census_tracts()
• load_nyc_council_districts()
• load_nyc_neighborhood_tabulation_areas()
• normalize_boundary_layer()
• normalize_boundary_value()
• normalize_boundary_values()
• boundaries_to_geojson()
• boundaries_to_dataframe()
• clip_boundaries_to_bbox()

Documentation

Docs: Home, Getting Started, API Reference, Architecture, Contributing

License

MIT.