Boundaries

README.md

@@ -44,7 +44,7 @@ Datasets for efficient handling in Python.
 
 
 **UK Office of National Statistics population tables**
-- Alsias: from agrifoodpy.population.population import UK_ONS
+- Alias: from agrifoodpy.population.population import UK_ONS
 which can be downloaded in zip format here: [ons.gov.uk/file](https://www.ons.gov.uk/file?uri=/peoplepopulationandcommunity/populationandmigration/populationprojections/datasets/z1zippedpopulationprojectionsdatafilesuk/2022based/uk.zip)
 
 
@@ -55,6 +55,13 @@ which can be downloaded in zip format here: [ons.gov.uk/file](https://www.ons.go
 - This dataset provides country-level population estimates and projections by year, using multiple scenarios for fertility, mortality, and international migration. In Agrifood these are employed to project the change in domestic consumption relative to today’s values. 
 
 
+**UK Office of National Statistics boundary data**
+- Alias: from agrifoodpy.land import ONS_CTRY_DEC_2024_UK_BUC_1000
+- Available for download from the Office for National Statistics [Open Geography Portal](https://geoportal.statistics.gov.uk/)
+- Boundaries for Local Authority District, countries and other administrative
+regions.
+
+
 For a full list of datasets please visit
 
 ## Installation

agrifoodpy_data/land/ONS/README.md

@@ -0,0 +1,36 @@
+# Office for National Statistics (ONS)
+
+Boundaries for Local Authority District, countries and other administrative
+regions can be downloaded from the Office for National Statistics
+[Open Geography Portal](https://geoportal.statistics.gov.uk/).
+
+Datasets are provided at various levels of resolution and extents with a 3
+letter code starting with B used to identify each dataset:
+
+### Resolution
+
+From greater to lower detail:
+
+- **F**: Full
+- **G**: Intermediate/Generalised
+- **S**: Super Generalised
+- **U**: Ultra Generalised
+
+### Extent
+- **E**: Extent of the realm boundary sets, extending to mean low water and,
+  ocasionally, to island off the coast
+- **C**: Clipped to the coastline boundary sets, showing boundaries to mean
+  high water
+
+(See the
+[Boundary Dataset Guidance](https://geoportal.statistics.gov.uk/datasets/0e35523a5e37459eb7853b807014a2e8/about) for more information)
+
+### Example
+
+"Local Authority Districts (December 2024) Boundaries UK BUC" provides an ultra
+generalised (lowest resolution), clipped to the coastline boundary map of local authority districts.
+
+## Available datasets
+
+- **ONS_CTRY_DEC_2024_UK_BUC_1000** Countries in the UK (England, Wales, Scotland, Northern ireland), December 2024, BUC
+- **ONS_LAD_MAY_2025_UK_BUC_1000** Local Authority Districts, May 2025, BUC