Configuration

The module-level genplanner.config object holds defaults shared by the planner’s preprocessing steps. Change these before creating a planner when an application needs different defaults.

roads_width_def

Default road widths in meters, keyed by road level. The initial values are 20 for high speed highway, 10 for regulated highway, and 5 for local road.

point_pool_seed and point_pool_size

Seed and size of the candidate point pool used during splitting. Their initial values are 42 and 200. The pool is created when the splitter module is imported, so changing these values later does not rebuild it.

minimum_block_area

Default minimum area used by block generation, initially 20,000 square meters in the projected working CRS.

change_logger_lvl(level)

Replace the Loguru sink on stderr. Accepted levels are TRACE, DEBUG, INFO, WARN, and ERROR.

Example:

from genplanner import config

config.change_logger_lvl("DEBUG")

Planner-specific options such as parallel, roads_extend_distance, and simplify_geometry_value are arguments to genplanner.GenPlanner. Pass seed=7 to GenPlanner to repeat Voronoi site placement with the same inputs and runtime settings. Without seed, each split uses a fresh random seed. max_optimization_iterations limits each Voronoi optimization attempt (default: 2000). max_run_seconds stops generation after 900 seconds by default and raises TimeoutError with the number of completed tasks. Pass None to disable this limit. The time budget starts after input preprocessing and does not return partial zones.