laser.measles.demographics.gadm
gadm
GADM shapefiles
GADMShapefile
Bases: AdminShapefile
Shapefile reader for GADM (Global Administrative Areas) boundary data.
Automatically determines the admin level from the GADM filename and
downloads shapefiles from the GADM servers when needed. Use
download to
fetch a country's boundaries, or construct directly from a local file.
Examples:
1 2 | |
check_dotname_fields()
Check dotname_fields from shapefile name if not explicitly provided.
download(country_code, admin_level, directory=None, timeout=60)
classmethod
Download the GADM shapefile for a given country code and return a GADMShapefile instance.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
country_code
|
str
|
The country code to download the shapefile for. |
required |
admin_level
|
int
|
The admin level to download the shapefile for. |
required |
directory
|
str | Path | None
|
The directory to download the shapefile to. If None, uses current directory. |
None
|
timeout
|
int
|
The timeout for the request. |
60
|
Returns:
| Type | Description |
|---|---|
GADMShapefile
|
A GADMShapefile instance for the downloaded shapefile. |