Add UK local authorities

.gitignore

@@ -14,6 +14,7 @@ dist/*
 **/*.h5
 **/*.csv.gz
 .env
+.DS_Store
 
 # Ignore generated credentials from google-github-actions/auth
 gha-creds-*.json

changelog_entry.yaml

@@ -0,0 +1,5 @@
+- bump: minor
+  changes:
+    added:
+    - Metadata for UK local authorities
+    - Calculation of UK local authority-level outputs

policyengine_api/constants.py

@@ -38,6 +38,7 @@
     "national",  # National level (e.g., "uk")
     "country",  # UK countries (e.g., "country/england", "country/scotland")
     "constituency",  # UK parliamentary constituencies (e.g., "constituency/Aldershot")
+    "local_authority",  # UK local authorities (e.g., "local_authority/Maidstone")
 )
 
 # Valid region prefixes for each country
@@ -51,6 +52,7 @@
     "uk": [
         "country/",  # UK countries (e.g., "country/england", "country/scotland")
         "constituency/",  # UK parliamentary constituencies (e.g., "constituency/Aldershot")
+        "local_authority/",  # UK local authorities (e.g., "local_authority/Maidstone")
     ],
 }
 

policyengine_api/country.py

@@ -73,6 +73,7 @@ def build_microsimulation_options(self) -> dict:
                 Path(__file__).parent / "data" / "constituencies_2024.csv"
             )
             constituency_names = pd.read_csv(constituency_names_path)
+            constituency_names = constituency_names.sort_values("name")
             region = [
                 dict(name="uk", label="the UK", type="national"),
                 dict(name="country/england", label="England", type="country"),
@@ -92,6 +93,19 @@ def build_microsimulation_options(self) -> dict:
                         type="constituency",
                     )
                 )
+            local_authority_names_path = (
+                Path(__file__).parent / "data" / "local_authorities_2021.csv"
+            )
+            local_authority_names = pd.read_csv(local_authority_names_path)
+            local_authority_names = local_authority_names.sort_values("name")
+            for i in range(len(local_authority_names)):
+                region.append(
+                    dict(
+                        name=f"local_authority/{local_authority_names.iloc[i]['name']}",
+                        label=local_authority_names.iloc[i]["name"],
+                        type="local_authority",
+                    )
+                )
             time_period = [
                 dict(name=2024, label="2024"),
                 dict(name=2025, label="2025"),