Normalizes area input and resolves unique area names.

Parameters¶

areas: list or str or pathlib.Path or dict

Accepted area input forms: - list of AreaGeometry objects - list of (name, AreaGeometry) tuples - dict mapping names to AreaGeometry objects - path to GeoJSON file - GeoJSON dictionary

geojson_name_key: str or list of str

Preferred GeoJSON feature property key(s) used to read area names from GeoJSON inputs.

Returns¶

area_map: dict

Mapping from unique resolved area names (str) to foxes.utils.geom2d.AreaGeometry objects. Missing, empty, or duplicate names are replaced with default names of the form area_XXX.