genplanner 1.0.0

GenPlanner python+rust library

---

---

GenPlanner is a territorial zoning engine for generating spatially consistent territorial zones (and optionally blocks) from polygonal territories.

It combines:

• ratio-based functional zoning

• adjacency constraints via relation matrices

• optional spatial anchor points

• integration of existing zones

• road-based splitting

• MILP-based multi-feature allocation

• geometric optimization via Voronoi splitting

Installation

pip install genplanner

Quick Example

import geopandas as gpd
from genplanner import GenPlanner
from genplanner.zones import basic_func_zone

territory = gpd.read_file("territory.geojson")

gp = GenPlanner(features_gdf=territory)

zones, roads = gp.features2terr_zones(
    funczone=basic_func_zone
)

Generate blocks:

blocks, roads = gp.features2terr_zones2blocks(
    funczone=basic_func_zone
)

Example with relation constraints

zones, roads = gp.features2terr_zones(
    relation_matrix="default"
)

Example with spatial anchors

from shapely.geometry import Point
from genplanner.zones import default_terr_zones

fix_points = gpd.GeoDataFrame(
    {
        "fixed_zone": [default_terr_zones.residential_terr],
        "geometry": [Point(30.1, 59.9)],
    },
    crs=territory.crs,
)

zones, roads = gp.features2terr_zones(
    terr_zones_fix_points=fix_points
)

Documentation

Full documentation is available at:

https://your-docs-url-here

Core modules:

• GenPlanner

• Zones

• Zone Relations

• Errors

Design Philosophy

GenPlanner is built around a small set of composable primitives:

• Zones define what spatial program should be achieved.

• Relations define which zones may be adjacent.

• The planner orchestrates preprocessing, validation and optimization.

• Errors are explicit and structured.

The goal is deterministic, reproducible zoning with clear constraints and explicit spatial control.