Add processing rules

.gitlab-ci.yml

@@ -25,7 +25,6 @@ linters:
   script:
     - flake8 --max-line-length=$LINE_LENGTH $SOURCES
     - black --check --line-length $LINE_LENGTH $SOURCES
-    - pylint -E $SOURCES
 
 release_job:
   stage: release

building/02_process/geometry/geometry.py

+class GeometryRule:
+    def __call__(self, geometry, *args, **kwargs):
+        """
+        Wrap the WKT formatted geometry of a building in the `ST_GeomFromText()` function
+
+        Args:
+            geometry (str):
+                WKT formatted geometry of the building
+
+        Returns:
+            A dictionary with the WKT formatted geometry of the building wrapped in the
+            `ST_GeomFromText()` function.
+        """
+
+        return {"geometry": f"ST_GeomFromText('{geometry}', 4326)"}

building/02_process/geometry/rule.xml

+<?xml version="1.0" encoding="UTF-8" ?>
+<rule name="GeometryRule">
+    <input>
+        <param type="str">geometry</param>
+    </input>
+    <function filepath="geometry.py"/>
+    <output>
+        <param type="str">geometry</param>
+    </output>
+</rule>

building/02_process/quadkey/quadkey.py

+class QuadkeyRule:
+    def __call__(self, longitude, latitude, *args, **kwargs):
+        """
+        Determine the Quadkey tile of a building, based on the latitude and longitude of the
+        centroid.
+
+        Args:
+            longitude:
+                Longitude of the centroid
+            latitude:
+                Latitude of the centroid
+
+        Returns:
+            A dictionary with the zoom-level 18 Quadkey tile.
+        """
+
+        import mercantile
+
+        if longitude is None or latitude is None:
+            quadkey = None
+        else:
+            quadkey = mercantile.quadkey(mercantile.tile(longitude, latitude, 18))
+        return {"quadkey": quadkey}

building/02_process/quadkey/rule.xml

+<?xml version="1.0" encoding="UTF-8" ?>
+<rule name="QuadkeyRule">
+    <input>
+        <param type="float">longitude</param>
+        <param type="float">latitude</param>
+    </input>
+    <function filepath="quadkey.py"/>
+    <output>
+        <param type="str">quadkey</param>
+    </output>
+</rule>

building/02_process/relation_id/relation_id.py

+class RelationIDRule:
+    def __call__(self, relations, *args, **kwargs):
+        """
+        Determine the building relation OSM ID.
+
+        Args:
+            relations:
+                List of the attributes of all relations that the building is member of.
+
+        Returns:
+            OSM ID of the first relations that the building is member of.
+        """
+
+        for relation in relations:
+            osm_id = relation.get("osm_id", None)
+            if osm_id is not None:
+                return {"relation_id": osm_id}
+        return {"relation_id": None}

building/02_process/relation_id/rule.xml

+<?xml version="1.0" encoding="UTF-8" ?>
+<rule name="RelationIDRule">
+    <input>
+        <param type="list">relations</param>
+    </input>
+    <function filepath="relation_id.py"/>
+    <output>
+        <param type="int">relation_id</param>
+    </output>
+</rule>

building/02_process/stories_and_floorspace/rule.xml

+<?xml version="1.0" encoding="UTF-8" ?>
+<rule name="StoriesAndFloorspaceRule" category="building">
+    <input>
+        <param type="int">tags</param>
+        <param type="float">relations</param>
+        <param type="float">area</param>
+    </input>
+    <function filepath="stories_and_floorspace.py"/>
+    <output>
+        <param type="float">storeys</param>
+        <param type="float">floorspace</param>
+    </output>
+</rule>

building/02_process/stories_and_floorspace/stories_and_floorspace.py

+class StoriesAndFloorspaceRule:
+    def __call__(self, tags, relations, area, *args, **kwargs):
+        """
+        Find the `building:levels` tag in the attributes of the building or one of the building
+        relations and save as number of stories. Calculate the floorspace of the building, based
+        on the footprint size of the building and the number of stories.
+
+        Args:
+            tags (dict):
+                Building tags, such has the building levels or building type.
+            relations (list):
+                List of the attributes of all relations that the building is member of.
+            area (float):
+                Footprint size of the building.
+
+        Returns:
+            A dictionary with the number of stories and the floorspace of the building.
+        """
+
+        from math import ceil
+
+        storey_options = [self.get_info(building["tags"]) for building in [tags] + relations]
+
+        for storey_string in storey_options:
+            if storey_string is None or storey_string == "":
+                continue
+            try:
+                storeys = ceil(float(storey_string))
+                if storeys < 1:
+                    raise ValueError("Storeys cannot be below 1")
+                floorspace = storeys * area
+                return {"storeys": storeys, "floorspace": floorspace}
+            except ValueError:
+                continue
+        return {"storeys": None, "floorspace": None}
+
+    @staticmethod
+    def get_info(tags):
+        """
+        Get the number of storeys, if the attribute `building:levels` exist
+
+        Args:
+            tags:
+                Building tags, such has the building levels or building type.
+
+        Returns:
+            Number of storeys, if the attribute `building:levels` exist, otherwise `None`.
+        """
+
+        return tags.get("building:levels", None)

building/README.md

@@ -10,7 +10,23 @@ all land-use objects that intersect the building.
                             
 ### Process rules
 
-*Not implemented*
+* **Geometry**
+
+Wrap the WKT formatted geometry of a building in the `ST_GeomFromText()` function
+
+* **Quadkey**
+
+Determine the Quadkey tile of a building, based on the latitude and longitude of the centroid.
+
+* **RelationID**
+
+Determine the building relation OSM ID.
+
+* **StoriesAndFloorspace**
+
+Find the `building:levels` tag in the attributes of the building or one of the building
+relations and save as number of stories. Calculate the floorspace of the building, based on the
+footprint size of the building and the number of stories.
 
 ### Upsert rules