overture-schema-theme-base 0.1.1.dev0__py3-none-any.whl

overture/schema/base/__init__.py

@@ -0,0 +1,45 @@
+"""Base theme.
+
+Fundamental geographic features including bathymetry, infrastructure, land, land cover,
+land use, and water features.
+"""
+
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)
+
+
+from ._common import (
+    Depth,
+    Elevation,
+    Height,
+    SourceTags,
+    SurfaceMaterial,
+)
+from .bathymetry import Bathymetry
+from .infrastructure import Infrastructure, InfrastructureClass, InfrastructureSubtype
+from .land import Land, LandClass, LandSubtype
+from .land_cover import LandCover, LandCoverSubtype
+from .land_use import LandUse, LandUseClass, LandUseSubtype
+from .water import Water, WaterClass, WaterSubtype
+
+__all__ = [
+    "Bathymetry",
+    "Depth",
+    "Elevation",
+    "Height",
+    "Infrastructure",
+    "InfrastructureClass",
+    "InfrastructureSubtype",
+    "Land",
+    "LandClass",
+    "LandCover",
+    "LandCoverSubtype",
+    "LandSubtype",
+    "LandUse",
+    "LandUseClass",
+    "LandUseSubtype",
+    "SourceTags",
+    "SurfaceMaterial",
+    "Water",
+    "WaterClass",
+    "WaterSubtype",
+]

overture/schema/base/_common.py

@@ -0,0 +1,89 @@
+import textwrap
+from enum import Enum
+from typing import Annotated, Any, NewType
+
+from pydantic import BaseModel, Field
+
+from overture.schema.system.numeric import float64, int32
+from overture.schema.system.string import WikidataId
+
+Depth = NewType(
+    "Depth",
+    Annotated[
+        int32,
+        Field(
+            ge=0,
+            description="Depth below surface level of the feature in meters.",
+        ),
+    ],
+)
+
+Elevation = NewType(
+    "Elevation",
+    Annotated[
+        int32,
+        Field(
+            le=9000,
+            description="Elevation above sea level of the feature in meters.",
+        ),
+    ],
+)
+
+Height = NewType(
+    "Height",
+    Annotated[float64, Field(gt=0, description="Height of the feature in meters.")],
+)
+
+
+SourceTags = NewType(
+    "SourceTags",
+    Annotated[
+        dict[str, Any],
+        Field(
+            description=textwrap.dedent("""
+                Key/value pairs imported directly from the source data without change.
+
+                This field provides access to raw OSM entity tags for features sourced from
+                OpenStreetMap.
+            """).strip()
+        ),
+    ],
+)
+
+
+class SourcedFromOpenStreetMap(BaseModel):
+    """
+    Model derived from an OpenStreetMap entity and containing the entity's OSM tags and wikidata ID.
+    """
+
+    source_tags: SourceTags | None = None
+    wikidata: WikidataId | None = None
+
+
+class SurfaceMaterial(str, Enum):
+    """Material that makes up the surface of `Infrastructure` and `Land` features."""
+
+    ASPHALT = "asphalt"
+    COBBLESTONE = "cobblestone"
+    COMPACTED = "compacted"
+    CONCRETE = "concrete"
+    CONCRETE_PLATES = "concrete_plates"
+    DIRT = "dirt"
+    EARTH = "earth"
+    FINE_GRAVEL = "fine_gravel"
+    GRASS = "grass"
+    GRAVEL = "gravel"
+    GROUND = "ground"
+    PAVED = "paved"
+    PAVING_STONES = "paving_stones"
+    PEBBLESTONE = "pebblestone"
+    RECREATION_GRASS = "recreation_grass"
+    RECREATION_PAVED = "recreation_paved"
+    RECREATION_SAND = "recreation_sand"
+    RUBBER = "rubber"
+    SAND = "sand"
+    SETT = "sett"
+    TARTAN = "tartan"
+    UNPAVED = "unpaved"
+    WOOD = "wood"
+    WOODCHIPS = "woodchips"

overture/schema/base/bathymetry.py

@@ -0,0 +1,44 @@
+"""
+The `Bathymetry` feature type model and supporting types.
+"""
+
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.cartography import CartographicallyHinted
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+from ._common import Depth
+
+
+class Bathymetry(
+    OvertureFeature[Literal["base"], Literal["bathymetry"]], CartographicallyHinted
+):
+    """
+    Bathymetry features provide topographic representations of underwater areas, such as parts of
+    lake beds or ocean floors.
+    """
+
+    model_config = ConfigDict(title="bathymetry")
+
+    # Overture Feature
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(GeometryType.POLYGON, GeometryType.MULTI_POLYGON),
+        Field(
+            description="Shape of the underwater area, which may be a polygon or multi-polygon."
+        ),
+    ]
+
+    # Required
+
+    depth: Depth

overture/schema/base/infrastructure.py

@@ -0,0 +1,265 @@
+"""
+The `Infrastructure` feature type model and supporting types.
+"""
+
+import textwrap
+from enum import Enum
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.base._common import Height, SourcedFromOpenStreetMap
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.level import Stacked
+from overture.schema.common.names import Named
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+from ._common import SurfaceMaterial
+
+
+class InfrastructureSubtype(str, Enum):
+    """
+    Broadest classification of the type of infrastructure.
+
+    This broad classification can be refined by `InfrastructureClass`.
+    """
+
+    AERIALWAY = "aerialway"
+    AIRPORT = "airport"
+    BARRIER = "barrier"
+    BRIDGE = "bridge"
+    COMMUNICATION = "communication"
+    EMERGENCY = "emergency"
+    MANHOLE = "manhole"
+    PEDESTRIAN = "pedestrian"
+    PIER = "pier"
+    POWER = "power"
+    QUAY = "quay"
+    RECREATION = "recreation"
+    TOWER = "tower"
+    TRANSIT = "transit"
+    TRANSPORTATION = "transportation"
+    UTILITY = "utility"
+    WASTE_MANAGEMENT = "waste_management"
+    WATER = "water"
+
+
+class InfrastructureClass(str, Enum):
+    """
+    Further classification of the type of infrastructure.
+
+    The infrastructure class adds detail to the broad classification of `InfrastructureSubtype`.
+    """
+
+    AERIALWAY_STATION = "aerialway_station"
+    AIRPORT = "airport"
+    AIRPORT_GATE = "airport_gate"
+    AIRSTRIP = "airstrip"
+    APRON = "apron"
+    AQUEDUCT = "aqueduct"
+    ARTWORK = "artwork"
+    ATM = "atm"
+    BARRIER = "barrier"
+    BELL_TOWER = "bell_tower"
+    BENCH = "bench"
+    BICYCLE_PARKING = "bicycle_parking"
+    BICYCLE_RENTAL = "bicycle_rental"
+    BLOCK = "block"
+    BOARDWALK = "boardwalk"
+    BOLLARD = "bollard"
+    BORDER_CONTROL = "border_control"
+    BREAKWATER = "breakwater"
+    BRIDGE = "bridge"
+    BRIDGE_SUPPORT = "bridge_support"
+    BUMP_GATE = "bump_gate"
+    BUS_ROUTE = "bus_route"
+    BUS_STATION = "bus_station"
+    BUS_STOP = "bus_stop"
+    BUS_TRAP = "bus_trap"
+    CABLE = "cable"
+    CABLE_BARRIER = "cable_barrier"
+    CABLE_CAR = "cable_car"
+    CABLE_DISTRIBUTION = "cable_distribution"
+    CAMP_SITE = "camp_site"
+    CANTILEVER = "cantilever"
+    CATENARY_MAST = "catenary_mast"
+    CATTLE_GRID = "cattle_grid"
+    CHAIN = "chain"
+    CHAIR_LIFT = "chair_lift"
+    CHARGING_STATION = "charging_station"
+    CITY_WALL = "city_wall"
+    COMMUNICATION_LINE = "communication_line"
+    COMMUNICATION_POLE = "communication_pole"
+    COMMUNICATION_TOWER = "communication_tower"
+    CONNECTION = "connection"
+    COOLING = "cooling"
+    COVERED = "covered"
+    CROSSING = "crossing"
+    CUTLINE = "cutline"
+    CYCLE_BARRIER = "cycle_barrier"
+    DAM = "dam"
+    DEFENSIVE = "defensive"
+    DITCH = "ditch"
+    DIVING = "diving"
+    DRAG_LIFT = "drag_lift"
+    DRAIN = "drain"
+    DRINKING_WATER = "drinking_water"
+    ENTRANCE = "entrance"
+    FENCE = "fence"
+    FERRY_TERMINAL = "ferry_terminal"
+    FIRE_HYDRANT = "fire_hydrant"
+    FOUNTAIN = "fountain"
+    FULL_HEIGHT_TURNSTILE = "full-height_turnstile"
+    GASOMETER = "gasometer"
+    GATE = "gate"
+    GENERATOR = "generator"
+    GIVE_WAY = "give_way"
+    GONDOLA = "gondola"
+    GOODS = "goods"
+    GUARD_RAIL = "guard_rail"
+    HAMPSHIRE_GATE = "hampshire_gate"
+    HANDRAIL = "handrail"
+    HEDGE = "hedge"
+    HEIGHT_RESTRICTOR = "height_restrictor"
+    HELIOSTAT = "heliostat"
+    HELIPAD = "helipad"
+    HELIPORT = "heliport"
+    HOSE = "hose"
+    INFORMATION = "information"
+    INSULATOR = "insulator"
+    INTERNATIONAL_AIRPORT = "international_airport"
+    J_BAR = "j-bar"
+    JERSEY_BARRIER = "jersey_barrier"
+    KERB = "kerb"
+    KISSING_GATE = "kissing_gate"
+    LAUNCHPAD = "launchpad"
+    LIFT_GATE = "lift_gate"
+    LIGHTING = "lighting"
+    LIGHTNING_PROTECTION = "lightning_protection"
+    MAGIC_CARPET = "magic_carpet"
+    MANHOLE = "manhole"
+    MILESTONE = "milestone"
+    MILITARY_AIRPORT = "military_airport"
+    MINARET = "minaret"
+    MINOR_LINE = "minor_line"
+    MIXED_LIFT = "mixed_lift"
+    MOBILE_PHONE_TOWER = "mobile_phone_tower"
+    MONITORING = "monitoring"
+    MOTORCYCLE_PARKING = "motorcycle_parking"
+    MOTORWAY_JUNCTION = "motorway_junction"
+    MOVABLE = "movable"
+    MUNICIPAL_AIRPORT = "municipal_airport"
+    OBSERVATION = "observation"
+    PARKING = "parking"
+    PARKING_ENTRANCE = "parking_entrance"
+    PARKING_SPACE = "parking_space"
+    PEDESTRIAN_CROSSING = "pedestrian_crossing"
+    PICNIC_TABLE = "picnic_table"
+    PIER = "pier"
+    PIPELINE = "pipeline"
+    PLANT = "plant"
+    PLANTER = "planter"
+    PLATFORM = "platform"
+    PLATTER = "platter"
+    PORTAL = "portal"
+    POST_BOX = "post_box"
+    POWER_LINE = "power_line"
+    POWER_POLE = "power_pole"
+    POWER_TOWER = "power_tower"
+    PRIVATE_AIRPORT = "private_airport"
+    PYLON = "pylon"
+    QUAY = "quay"
+    RADAR = "radar"
+    RAILWAY_HALT = "railway_halt"
+    RAILWAY_STATION = "railway_station"
+    RECYCLING = "recycling"
+    REGIONAL_AIRPORT = "regional_airport"
+    RESERVOIR_COVERED = "reservoir_covered"
+    RETAINING_WALL = "retaining_wall"
+    ROLLER_COASTER = "roller_coaster"
+    ROPE_TOW = "rope_tow"
+    RUNWAY = "runway"
+    SALLY_PORT = "sally_port"
+    SEAPLANE_AIRPORT = "seaplane_airport"
+    SEWER = "sewer"
+    SILO = "silo"
+    SIREN = "siren"
+    STILE = "stile"
+    STOP = "stop"
+    STOP_POSITION = "stop_position"
+    STOPWAY = "stopway"
+    STORAGE_TANK = "storage_tank"
+    STREET_CABINET = "street_cabinet"
+    STREET_LAMP = "street_lamp"
+    SUBSTATION = "substation"
+    SUBWAY_STATION = "subway_station"
+    SWING_GATE = "swing_gate"
+    SWITCH = "switch"
+    T_BAR = "t-bar"
+    TAXILANE = "taxilane"
+    TAXIWAY = "taxiway"
+    TERMINAL = "terminal"
+    TOILETS = "toilets"
+    TOLL_BOOTH = "toll_booth"
+    TRAFFIC_SIGNALS = "traffic_signals"
+    TRANSFORMER = "transformer"
+    TRESTLE = "trestle"
+    UTILITY_POLE = "utility_pole"
+    VENDING_MACHINE = "vending_machine"
+    VIADUCT = "viaduct"
+    VIEWPOINT = "viewpoint"
+    WALL = "wall"
+    WASTE_BASKET = "waste_basket"
+    WASTE_DISPOSAL = "waste_disposal"
+    WATCHTOWER = "watchtower"
+    WATER_TOWER = "water_tower"
+    WEIR = "weir"
+    ZIP_LINE = "zip_line"
+
+
+class Infrastructure(
+    OvertureFeature[Literal["base"], Literal["infrastructure"]],
+    Named,
+    Stacked,
+    SourcedFromOpenStreetMap,
+):
+    """
+    Infrastructure features provide basic information about real-world infrastructure entities
+    such as bridges, airports, runways, aerialways, communication towers, and power lines.
+    """
+
+    model_config = ConfigDict(title="infrastructure")
+
+    # Overture Feature
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(
+            GeometryType.POINT,
+            GeometryType.LINE_STRING,
+            GeometryType.POLYGON,
+            GeometryType.MULTI_POLYGON,
+        ),
+        Field(
+            description=textwrap.dedent("""
+                Geometry of the infrastructure feature, which may be a point, line string, polygon, or
+                multi-polygon.
+            """).strip()
+        ),
+    ]
+
+    # Required
+
+    class_: Annotated[InfrastructureClass, Field(alias="class")]
+    subtype: InfrastructureSubtype
+
+    # Optional
+
+    height: Height | None = None
+    surface: SurfaceMaterial | None = None

overture/schema/base/land.py

@@ -0,0 +1,150 @@
+"""
+The `Land` feature type model and supporting types.
+"""
+
+import textwrap
+from enum import Enum
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.base._common import Elevation, SourcedFromOpenStreetMap
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.level import Stacked
+from overture.schema.common.names import Named
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+from ._common import SurfaceMaterial
+
+
+class LandSubtype(str, Enum):
+    """
+    Broadest classification of the land.
+
+    This broad classification can be refined by `LandClass`.
+    """
+
+    CRATER = "crater"
+    DESERT = "desert"
+    FOREST = "forest"
+    GLACIER = "glacier"
+    GRASS = "grass"
+    LAND = "land"
+    PHYSICAL = "physical"
+    REEF = "reef"
+    ROCK = "rock"
+    SAND = "sand"
+    SHRUB = "shrub"
+    TREE = "tree"
+    WETLAND = "wetland"
+
+
+class LandClass(str, Enum):
+    """
+    Further classification of the land.
+
+    The land class adds detail to the broad classification of `LandSubtype`.
+    """
+
+    ARCHIPELAGO = "archipelago"
+    BARE_ROCK = "bare_rock"
+    BEACH = "beach"
+    CAVE_ENTRANCE = "cave_entrance"
+    CLIFF = "cliff"
+    DESERT = "desert"
+    DUNE = "dune"
+    FELL = "fell"
+    FOREST = "forest"
+    GLACIER = "glacier"
+    GRASS = "grass"
+    GRASSLAND = "grassland"
+    HEATH = "heath"
+    HILL = "hill"
+    ISLAND = "island"
+    ISLET = "islet"
+    LAND = "land"
+    MEADOW = "meadow"
+    METEOR_CRATER = "meteor_crater"
+    MOUNTAIN_RANGE = "mountain_range"
+    PEAK = "peak"
+    PENINSULA = "peninsula"
+    PLATEAU = "plateau"
+    REEF = "reef"
+    RIDGE = "ridge"
+    ROCK = "rock"
+    SADDLE = "saddle"
+    SAND = "sand"
+    SCREE = "scree"
+    SCRUB = "scrub"
+    SHINGLE = "shingle"
+    SHRUB = "shrub"
+    SHRUBBERY = "shrubbery"
+    STONE = "stone"
+    TREE = "tree"
+    TREE_ROW = "tree_row"
+    TUNDRA = "tundra"
+    VALLEY = "valley"
+    VOLCANIC_CALDERA_RIM = "volcanic_caldera_rim"
+    VOLCANO = "volcano"
+    WETLAND = "wetland"
+    WOOD = "wood"
+
+
+class Land(
+    OvertureFeature[Literal["base"], Literal["land"]],
+    Named,
+    Stacked,
+    SourcedFromOpenStreetMap,
+):
+    """
+    Land features are representations of physical land surfaces.
+
+    In Overture data releases, land features are sourced from OpenStreetMap. TODO. Finish this when
+    I get more info from Jennings.
+
+
+
+    Physical representations of land surfaces.
+
+    Global land derived from the inverse of OSM Coastlines. Translates `natural` tags from OpenStreetMap.
+
+    TODO: Update this description when the relationship to `land_cover` is better understood.
+    """
+
+    model_config = ConfigDict(title="land")
+
+    # Overture Feature
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(
+            GeometryType.POINT,
+            GeometryType.LINE_STRING,
+            GeometryType.POLYGON,
+            GeometryType.MULTI_POLYGON,
+        ),
+        Field(
+            description=textwrap.dedent("""
+                Geometry of the land feature, which may be a point, line string, polygon, or
+                multi-polygon.
+            """).strip()
+        ),
+    ]
+
+    # Required
+
+    class_: Annotated[LandClass, Field(default=LandClass.LAND, alias="class")] = (
+        LandClass.LAND
+    )
+    subtype: Annotated[LandSubtype, Field(default=LandSubtype.LAND)] = LandSubtype.LAND
+
+    # Optional
+
+    elevation: Elevation | None = None
+    surface: SurfaceMaterial | None = None

overture/schema/base/land_cover.py

@@ -0,0 +1,65 @@
+"""
+The `LandCover` feature type model and supporting types.
+"""
+
+from enum import Enum
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.cartography import CartographicallyHinted
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+
+class LandCoverSubtype(str, Enum):
+    """Primary or dominant material covering the land."""
+
+    BARREN = "barren"
+    CROP = "crop"
+    FOREST = "forest"
+    GRASS = "grass"
+    MANGROVE = "mangrove"
+    MOSS = "moss"
+    SHRUB = "shrub"
+    SNOW = "snow"
+    URBAN = "urban"
+    WETLAND = "wetland"
+
+
+class LandCover(
+    OvertureFeature[Literal["base"], Literal["land_cover"]], CartographicallyHinted
+):
+    """
+    Land cover features indicate the primary natural or artificial surface material covering a land
+    area on the earth, including vegetation types like forests and crops, built environments like
+    cities, and natural surfaces like wetlands or barren ground.
+
+    Land cover features relate to `LandUse` features in the following way: land cover is the
+    physical thing covering the land, while land use is the human use to which the land is being
+    put.
+
+    TODO: Explain relationship to `Land` features.
+    """
+
+    model_config = ConfigDict(title="land_cover")
+
+    # Overture Feature
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(GeometryType.POLYGON, GeometryType.MULTI_POLYGON),
+        Field(
+            description="Shape of the covered land area, which may be a polygon or multi-polygon."
+        ),
+    ]
+
+    # Required
+
+    subtype: LandCoverSubtype

overture/schema/base/land_use.py

@@ -0,0 +1,223 @@
+"""
+The `LandUse` feature type model and supporting types.
+"""
+
+import textwrap
+from enum import Enum
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.base._common import Elevation, SourcedFromOpenStreetMap
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.level import Stacked
+from overture.schema.common.names import Named
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+from ._common import SurfaceMaterial
+
+
+class LandUseSubtype(str, Enum):
+    """
+    Broadest classification of the land use.
+
+    This broad classification can be refined by `LandUseClass`.
+    """
+
+    AGRICULTURE = "agriculture"
+    AQUACULTURE = "aquaculture"
+    CAMPGROUND = "campground"
+    CEMETERY = "cemetery"
+    CONSTRUCTION = "construction"
+    DEVELOPED = "developed"
+    EDUCATION = "education"
+    ENTERTAINMENT = "entertainment"
+    GOLF = "golf"
+    GRASS = "grass"
+    HORTICULTURE = "horticulture"
+    LANDFILL = "landfill"
+    MANAGED = "managed"
+    MEDICAL = "medical"
+    MILITARY = "military"
+    PARK = "park"
+    PEDESTRIAN = "pedestrian"
+    PROTECTED = "protected"
+    RECREATION = "recreation"
+    RELIGIOUS = "religious"
+    RESIDENTIAL = "residential"
+    RESOURCE_EXTRACTION = "resource_extraction"
+    TRANSPORTATION = "transportation"
+    WINTER_SPORTS = "winter_sports"
+
+
+class LandUseClass(str, Enum):
+    """
+    Further classification of the land use.
+
+    The land use class adds detail to the broad classification of `LandUseSubtype`.
+    """
+
+    ABORIGINAL_LAND = "aboriginal_land"
+    AIRFIELD = "airfield"
+    ALLOTMENTS = "allotments"
+    ANIMAL_KEEPING = "animal_keeping"
+    AQUACULTURE = "aquaculture"
+    BARRACKS = "barracks"
+    BASE = "base"
+    BEACH_RESORT = "beach_resort"
+    BROWNFIELD = "brownfield"
+    BUNKER = "bunker"
+    CAMP_SITE = "camp_site"
+    CEMETERY = "cemetery"
+    CLINIC = "clinic"
+    COLLEGE = "college"
+    COMMERCIAL = "commercial"
+    CONNECTION = "connection"
+    CONSTRUCTION = "construction"
+    DANGER_AREA = "danger_area"
+    DOCTORS = "doctors"
+    DOG_PARK = "dog_park"
+    DOWNHILL = "downhill"
+    DRIVING_RANGE = "driving_range"
+    DRIVING_SCHOOL = "driving_school"
+    EDUCATION = "education"
+    ENVIRONMENTAL = "environmental"
+    FAIRWAY = "fairway"
+    FARMLAND = "farmland"
+    FARMYARD = "farmyard"
+    FATBIKE = "fatbike"
+    FLOWERBED = "flowerbed"
+    FOREST = "forest"
+    GARAGES = "garages"
+    GARDEN = "garden"
+    GOLF_COURSE = "golf_course"
+    GRASS = "grass"
+    GRAVE_YARD = "grave_yard"
+    GREEN = "green"
+    GREENFIELD = "greenfield"
+    GREENHOUSE_HORTICULTURE = "greenhouse_horticulture"
+    HIGHWAY = "highway"
+    HIKE = "hike"
+    HOSPITAL = "hospital"
+    ICE_SKATE = "ice_skate"
+    INDUSTRIAL = "industrial"
+    INSTITUTIONAL = "institutional"
+    KINDERGARTEN = "kindergarten"
+    LANDFILL = "landfill"
+    LATERAL_WATER_HAZARD = "lateral_water_hazard"
+    LOGGING = "logging"
+    MARINA = "marina"
+    MEADOW = "meadow"
+    MILITARY = "military"
+    MILITARY_HOSPITAL = "military_hospital"
+    MILITARY_SCHOOL = "military_school"
+    MUSIC_SCHOOL = "music_school"
+    NATIONAL_PARK = "national_park"
+    NATURAL_MONUMENT = "natural_monument"
+    NATURE_RESERVE = "nature_reserve"
+    NAVAL_BASE = "naval_base"
+    NORDIC = "nordic"
+    NUCLEAR_EXPLOSION_SITE = "nuclear_explosion_site"
+    OBSTACLE_COURSE = "obstacle_course"
+    ORCHARD = "orchard"
+    PARK = "park"
+    PEAT_CUTTING = "peat_cutting"
+    PEDESTRIAN = "pedestrian"
+    PITCH = "pitch"
+    PLANT_NURSERY = "plant_nursery"
+    PLAYGROUND = "playground"
+    PLAZA = "plaza"
+    PROTECTED = "protected"
+    PROTECTED_LANDSCAPE_SEASCAPE = "protected_landscape_seascape"
+    QUARRY = "quarry"
+    RAILWAY = "railway"
+    RANGE = "range"
+    RECREATION_GROUND = "recreation_ground"
+    RELIGIOUS = "religious"
+    RESIDENTIAL = "residential"
+    RESORT = "resort"
+    RETAIL = "retail"
+    ROUGH = "rough"
+    SALT_POND = "salt_pond"
+    SCHOOL = "school"
+    SCHOOLYARD = "schoolyard"
+    SKI_JUMP = "ski_jump"
+    SKITOUR = "skitour"
+    SLED = "sled"
+    SLEIGH = "sleigh"
+    SNOW_PARK = "snow_park"
+    SPECIES_MANAGEMENT_AREA = "species_management_area"
+    STADIUM = "stadium"
+    STATE_PARK = "state_park"
+    STATIC_CARAVAN = "static_caravan"
+    STRICT_NATURE_RESERVE = "strict_nature_reserve"
+    TEE = "tee"
+    THEME_PARK = "theme_park"
+    TRACK = "track"
+    TRAFFIC_ISLAND = "traffic_island"
+    TRAINING_AREA = "training_area"
+    TRENCH = "trench"
+    UNIVERSITY = "university"
+    VILLAGE_GREEN = "village_green"
+    VINEYARD = "vineyard"
+    WATER_HAZARD = "water_hazard"
+    WATER_PARK = "water_park"
+    WILDERNESS_AREA = "wilderness_area"
+    WINTER_SPORTS = "winter_sports"
+    WORKS = "works"
+    ZOO = "zoo"
+
+
+class LandUse(
+    OvertureFeature[Literal["base"], Literal["land_use"]],
+    Named,
+    Stacked,
+    SourcedFromOpenStreetMap,
+):
+    """
+    Land use features specify the predominant human use of an area of land, for example commercial
+    activity, recreation, farming, housing, education, or military use.
+
+    Land use features relate to `LandCover` features in the following way: land use is the human
+    activity being done with the land, while land cover is the physical thing that covers it.
+
+    TODO: Explain relationship to `Land` features.
+    """
+
+    model_config = ConfigDict(title="land_use")
+
+    # Core
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(
+            GeometryType.POINT,
+            GeometryType.LINE_STRING,
+            GeometryType.POLYGON,
+            GeometryType.MULTI_POLYGON,
+        ),
+        Field(
+            description=textwrap.dedent(
+                """
+                Geometry of the land use area, which may be a point, line string, polygon, or
+                multi-polygon.
+                """
+            ).strip(),
+        ),
+    ]
+
+    # Required
+
+    class_: Annotated[LandUseClass, Field(alias="class")]
+    subtype: LandUseSubtype
+
+    # Optional
+
+    elevation: Elevation | None = None
+    surface: SurfaceMaterial | None = None

overture/schema/base/water.py

@@ -0,0 +1,167 @@
+"""Water feature models for Overture Maps base theme."""
+
+import textwrap
+from enum import Enum
+from typing import Annotated, Literal
+
+from pydantic import ConfigDict, Field
+
+from overture.schema.base._common import SourcedFromOpenStreetMap
+from overture.schema.common import (
+    OvertureFeature,
+)
+from overture.schema.common.level import Stacked
+from overture.schema.common.names import Named
+from overture.schema.system.geometric import (
+    Geometry,
+    GeometryType,
+    GeometryTypeConstraint,
+)
+
+
+class WaterSubtype(str, Enum):
+    """
+    The broad classification of water body such as river, ocean or lake.
+
+    This broad classification can be refined using `WaterClass`.
+    """
+
+    CANAL = "canal"
+    HUMAN_MADE = "human_made"
+    LAKE = "lake"
+    OCEAN = "ocean"
+    PHYSICAL = "physical"
+    POND = "pond"
+    RESERVOIR = "reservoir"
+    RIVER = "river"
+    SPRING = "spring"
+    STREAM = "stream"
+    WASTEWATER = "wastewater"
+    WATER = "water"
+
+
+class WaterClass(str, Enum):
+    """
+    Further description of the type of water body.
+
+    The water class adds detail to the broad classification of `WaterSubtype`.
+    """
+
+    BASIN = "basin"
+    BAY = "bay"
+    BLOWHOLE = "blowhole"
+    CANAL = "canal"
+    CAPE = "cape"
+    DITCH = "ditch"
+    DOCK = "dock"
+    DRAIN = "drain"
+    FAIRWAY = "fairway"
+    FISH_PASS = "fish_pass"
+    FISHPOND = "fishpond"
+    GEYSER = "geyser"
+    HOT_SPRING = "hot_spring"
+    LAGOON = "lagoon"
+    LAKE = "lake"
+    MOAT = "moat"
+    OCEAN = "ocean"
+    OXBOW = "oxbow"
+    POND = "pond"
+    REFLECTING_POOL = "reflecting_pool"
+    RESERVOIR = "reservoir"
+    RIVER = "river"
+    SALT_POND = "salt_pond"
+    SEA = "sea"
+    SEWAGE = "sewage"
+    SHOAL = "shoal"
+    SPRING = "spring"
+    STRAIT = "strait"
+    STREAM = "stream"
+    SWIMMING_POOL = "swimming_pool"
+    TIDAL_CHANNEL = "tidal_channel"
+    WASTEWATER = "wastewater"
+    WATER = "water"
+    WATER_STORAGE = "water_storage"
+    WATERFALL = "waterfall"
+
+
+class Water(
+    OvertureFeature[Literal["base"], Literal["water"]],
+    Stacked,
+    Named,
+    SourcedFromOpenStreetMap,
+):
+    """
+    Water features represent ocean and inland water bodies.
+
+    In Overture data releases, water features are sourced from OpenStreetMap. There are two main
+    categories of water feature: ocean and inland water bodies.
+
+    Ocean
+    -----
+    The `subytpe` value `"ocean"` indicates an ocean area feature whose geometry represents the
+    surface area of an ocean or part of an ocean. Ocean area may be tiled into many small polygons
+    of consistent complexity to ensure manageable geometry. In Overture data releases, ocean area
+    features are created from OpenStreetMap coastlines data (`natural=coastline`) using a QA'd
+    version of the output from the OSMCoastline tool. In aggregate, all the ocean area features
+    represent the inverse of the land features with subtype `"land"` and class `"land"`.
+
+    The names and recommended label position for oceans and seas can be found in features with the
+    subtype `"physical"` and the class `"ocean"` or `"sea"`.
+
+    Inland Water
+    ------------
+    Subtypes other than `"ocean"` (and `"physical"`) represent inland water bodies. In Overture data
+    releases, these features are sourced from the OpenStreetMap tag `natural=*` where the tag value
+    indicates a water body, as well as the tags `natural=water`,  `waterway=*`,
+    and `water=*`.
+    """
+
+    model_config = ConfigDict(title="water")
+
+    # Overture Feature
+
+    geometry: Annotated[
+        Geometry,
+        GeometryTypeConstraint(
+            GeometryType.POINT,
+            GeometryType.LINE_STRING,
+            GeometryType.POLYGON,
+            GeometryType.MULTI_POLYGON,
+        ),
+        Field(
+            description=textwrap.dedent("""
+                Geometry of the water feature, which may be a point, line string, polygon, or
+                multi-polygon.
+            """).strip()
+        ),
+    ]
+
+    # Required
+
+    class_: Annotated[
+        WaterClass,
+        Field(
+            default=WaterClass.WATER,
+            alias="class",
+        ),
+    ] = WaterClass.WATER
+    subtype: Annotated[
+        WaterSubtype,
+        Field(
+            default=WaterSubtype.WATER,
+        ),
+    ] = WaterSubtype.WATER
+
+    # Optional
+
+    is_intermittent: Annotated[
+        bool | None,
+        Field(
+            description="Whether the water body exists intermittently, not permanently",
+            strict=True,
+        ),
+    ] = None
+    is_salt: Annotated[
+        bool | None,
+        Field(description="Whether the water body contains salt water", strict=True),
+    ] = None

overture_schema_theme_base-0.1.1.dev0.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: overture-schema-theme-base
+Version: 0.1.1.dev0
+Summary: Overture Maps base theme shared structures and models (bathymetry, infrastructure, land, land_cover, land_use, water)
+License-Expression: MIT
+Requires-Dist: overture-schema-common>=0.1.1
+Requires-Dist: overture-schema-system>=0.1.1
+Requires-Dist: pydantic>=2.13.0
+Maintainer: Overture Maps Schema Working Group
+Requires-Python: >=3.10
+Project-URL: Homepage, https://overturemaps.org
+Project-URL: Source, https://github.com/OvertureMaps/schema
+Project-URL: Issues, https://github.com/OvertureMaps/schema/issues
+Description-Content-Type: text/markdown
+
+# Overture Schema Base Theme
+
+Shared structures and validation logic for Overture Maps' base theme.
+Contains common surface materials, validation utilities, and foundational patterns.

overture_schema_theme_base-0.1.1.dev0.dist-info/RECORD

@@ -0,0 +1,13 @@
+overture/schema/base/__init__.py,sha256=14W_41sF8rgANy_Lkqpdp3H2t-BkrACUAG28QOUAaHo,1031
+overture/schema/base/_common.py,sha256=TFBqAPyUQP4xvX9EX87RBmsb_23hDO20q2ANk5sR6Sw,2158
+overture/schema/base/bathymetry.py,sha256=IYREZai1rpf1V9pSYyTyy4f2t6N5EOK8ejDfnTOWGks,1029
+overture/schema/base/infrastructure.py,sha256=FzqLYgyXQESIZXT7VO2o6oYUYLVA1xNpNeKnWau1Vko,7417
+overture/schema/base/land.py,sha256=DJbmR1AlvjeSHZjsXnI5yqBRP3V_48t8bsTvPLTsuQo,3565
+overture/schema/base/land_cover.py,sha256=HB2rGOHpBe40hrYjL4zUTEhHy3Sein3kuCjkGPp9Qa0,1726
+overture/schema/base/land_use.py,sha256=A_1jSpdU8k_c5UL8x-Wo9JCRpB25_ras434A0lpvo34,6161
+overture/schema/base/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture/schema/base/water.py,sha256=aWODVhpzBazn4d5bWgTDf5Jfgl5Ma2IEV9yp096z0ss,4643
+overture_schema_theme_base-0.1.1.dev0.dist-info/WHEEL,sha256=Lkz__M3n3EKWmzMwHnFILNW2SHO43bOxmbqnBjwb--4,80
+overture_schema_theme_base-0.1.1.dev0.dist-info/entry_points.txt,sha256=wF4G9-zzS8BrqUKI8LSX87BJ9yE55JtGTikyaBcuBvU,340
+overture_schema_theme_base-0.1.1.dev0.dist-info/METADATA,sha256=om4_ZrY_IWS5eWYF9_ABxAM5P0hrH7BA7KF9MnYrqn8,819
+overture_schema_theme_base-0.1.1.dev0.dist-info/RECORD,,

overture_schema_theme_base-0.1.1.dev0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.6
+Root-Is-Purelib: true
+Tag: py3-none-any

overture_schema_theme_base-0.1.1.dev0.dist-info/entry_points.txt

@@ -0,0 +1,11 @@
+[overture.models]
+bathymetry = overture.schema.base:Bathymetry
+infrastructure = overture.schema.base:Infrastructure
+land = overture.schema.base:Land
+land_cover = overture.schema.base:LandCover
+land_use = overture.schema.base:LandUse
+water = overture.schema.base:Water
+
+[pytest11]
+overture_baselines = overture.schema.system.testing.plugin
+