cityjson-index 0.9.0

Python bindings for cityjson-index

cityjson-index

Python bindings for the cityjson-index Rust crate — a SQLite-backed random-access index over CityJSONSeq streams for CityJSON 2.0 data.

The distribution name is cityjson-index; the import name is cityjson_index. The package ships its own prebuilt native library (built from the Rust C-ABI core) and wraps it with ctypes — no Rust toolchain is required on the user side. cityjson-index also depends on cityjson-lib==0.8.0 at runtime; each package ships its own native library (there is no shared .so).

Install

pip install cityjson-index

Prebuilt wheels are published for:

• Linux x86_64 (manylinux)
• macOS x86_64 and arm64
• Windows AMD64

Python 3.11, 3.12, and 3.13 are supported.

Quick start

from cityjson_index import OpenedIndex

with OpenedIndex.open("city.idx") as index:
    feature = index.get("building-42")
    print(feature.id, len(feature.payload))

Filtered reads

from cityjson_index import FeatureFilter, FeatureFilterSummary, LodSelection, OpenedIndex

with OpenedIndex.open("dataset") as index:
    refs = index.feature_ref_page(0, 100)
    filter = FeatureFilter(
        cityobject_types={"Building"},
        default_lod=LodSelection.HIGHEST,
        lods_by_type={"Building": LodSelection.Exact("2.0")},
    )

    summary = FeatureFilterSummary()
    for feature in index.read_filtered_features(refs, filter):
        summary.add(feature.diagnostics)
        print(feature.model.summary().model_type)

    summary.ensure_requested_lods_available(filter)

Links

• Rust workspace and docs: https://github.com/3DGI/cityjson
• CityJSON specification: https://www.cityjson.org
• Issues: https://github.com/3DGI/cityjson/issues

License

Dual-licensed under MIT or Apache-2.0, at your option.