143 lines
5.1 KiB
Python
143 lines
5.1 KiB
Python
"""Canonical operator scope definitions for GeoIntel.
|
|
|
|
These definitions describe administrative/policy scopes only. They do not
|
|
claim that a policy boundary equals a cultural or physical landscape region.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class ScopeMember:
|
|
name: str
|
|
nis_code: str
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class GeographicScope:
|
|
key: str
|
|
display_name: str
|
|
project_name: str
|
|
project_region: str
|
|
area_name: str
|
|
authority_name: str
|
|
authority_url: str
|
|
scope_type: str
|
|
limitation_message: str
|
|
members: tuple[ScopeMember, ...]
|
|
all_municipalities: bool = False
|
|
|
|
@property
|
|
def nis_codes(self) -> tuple[str, ...]:
|
|
return tuple(member.nis_code for member in self.members)
|
|
|
|
|
|
MOL_SCOPE = GeographicScope(
|
|
key="mol",
|
|
display_name="Mol",
|
|
project_name="Mol Municipality Workbench",
|
|
project_region="Mol, Kempen",
|
|
area_name="Gemeente Mol - officiële grens",
|
|
authority_name="Digitaal Vlaanderen VRBG",
|
|
authority_url="https://geo.api.vlaanderen.be/VRBG/ogc/features/v1/collections/Refgem/items",
|
|
scope_type="municipality",
|
|
limitation_message="Officiële gemeentegrens; dit is geen perceelsgrens.",
|
|
members=(ScopeMember("Mol", "13025"),),
|
|
)
|
|
|
|
|
|
KEMPEN_TRANSPORT_REGION_SCOPE = GeographicScope(
|
|
key="kempen-transport-region",
|
|
display_name="Kempen (28 gemeenten)",
|
|
project_name="Kempen Regional Workbench",
|
|
project_region="Vervoerregio Kempen, Vlaanderen",
|
|
area_name="Vervoerregio Kempen - officiële operationele grens",
|
|
authority_name="Vlaamse overheid - Vervoerregio Kempen",
|
|
authority_url=(
|
|
"https://www.vlaanderen.be/mobiliteitsprofessionals/personenvervoer/"
|
|
"basisbereikbaarheid/mobiliteitsuitdagingen-regionaal-aanpakken/"
|
|
"vervoerregios/over-de-vervoerregio-kempen"
|
|
),
|
|
scope_type="transport_region",
|
|
limitation_message=(
|
|
"Operationele beleidsgrens van de Vlaamse vervoerregio Kempen; "
|
|
"geen claim over de ruimere culturele, landschappelijke of historische Kempen."
|
|
),
|
|
members=(
|
|
ScopeMember("Arendonk", "13001"),
|
|
ScopeMember("Baarle-Hertog", "13002"),
|
|
ScopeMember("Balen", "13003"),
|
|
ScopeMember("Beerse", "13004"),
|
|
ScopeMember("Dessel", "13006"),
|
|
ScopeMember("Geel", "13008"),
|
|
ScopeMember("Grobbendonk", "13010"),
|
|
ScopeMember("Herentals", "13011"),
|
|
ScopeMember("Herenthout", "13012"),
|
|
ScopeMember("Herselt", "13013"),
|
|
ScopeMember("Hoogstraten", "13014"),
|
|
ScopeMember("Hulshout", "13016"),
|
|
ScopeMember("Kasterlee", "13017"),
|
|
ScopeMember("Laakdal", "13053"),
|
|
ScopeMember("Lille", "13019"),
|
|
ScopeMember("Meerhout", "13021"),
|
|
ScopeMember("Merksplas", "13023"),
|
|
ScopeMember("Mol", "13025"),
|
|
ScopeMember("Nijlen", "12026"),
|
|
ScopeMember("Olen", "13029"),
|
|
ScopeMember("Oud-Turnhout", "13031"),
|
|
ScopeMember("Ravels", "13035"),
|
|
ScopeMember("Retie", "13036"),
|
|
ScopeMember("Rijkevorsel", "13037"),
|
|
ScopeMember("Turnhout", "13040"),
|
|
ScopeMember("Vorselaar", "13044"),
|
|
ScopeMember("Vosselaar", "13046"),
|
|
ScopeMember("Westerlo", "13049"),
|
|
),
|
|
)
|
|
|
|
BELGIUM_SCOPE = GeographicScope(
|
|
key="belgium",
|
|
display_name="België",
|
|
project_name="Belgium and North Sea Workbench",
|
|
project_region="Belgium and Belgian North Sea",
|
|
area_name="Belgium land",
|
|
authority_name="National Geographic Institute (NGI), AdminVector",
|
|
authority_url="https://www.geo.be/catalog/details/fb1e2993-2020-428c-9188-eb5f75e284b9",
|
|
scope_type="country",
|
|
limitation_message=(
|
|
"De nationale Statbel-sectorlaag dekt het Belgische landgebied. "
|
|
"Belgische maritieme zones bevatten geen statistische bevolkingssectoren."
|
|
),
|
|
members=(),
|
|
all_municipalities=True,
|
|
)
|
|
|
|
|
|
GEOGRAPHIC_SCOPES = {
|
|
scope.key: scope
|
|
for scope in (MOL_SCOPE, KEMPEN_TRANSPORT_REGION_SCOPE, BELGIUM_SCOPE)
|
|
}
|
|
|
|
|
|
def validate_scope(scope: GeographicScope) -> None:
|
|
if not scope.key or not scope.project_name or not scope.area_name:
|
|
raise ValueError("Geographic scope identity fields must not be empty")
|
|
if len(scope.members) == 0 and not scope.all_municipalities:
|
|
raise ValueError(f"Geographic scope {scope.key} has no members")
|
|
if scope.all_municipalities and scope.scope_type != "country":
|
|
raise ValueError(f"Geographic scope {scope.key} can include all municipalities only for a country scope")
|
|
names = [member.name.casefold() for member in scope.members]
|
|
codes = [member.nis_code for member in scope.members]
|
|
if len(names) != len(set(names)):
|
|
raise ValueError(f"Geographic scope {scope.key} contains duplicate municipality names")
|
|
if len(codes) != len(set(codes)):
|
|
raise ValueError(f"Geographic scope {scope.key} contains duplicate NIS codes")
|
|
if any(len(code) != 5 or not code.isdigit() for code in codes):
|
|
raise ValueError(f"Geographic scope {scope.key} contains an invalid NIS code")
|
|
|
|
|
|
for _scope in GEOGRAPHIC_SCOPES.values():
|
|
validate_scope(_scope)
|