Download training_code/scripts/05_aoi.py from TrendeX90/expected-greenness: direct link, hf CLI and curl.
- Browser
- Download file 4.56 kB
-
https://huggingface.co/TrendeX90/expected-greenness/resolve/refs%2Fpr%2F1/training_code/scripts/05_aoi.py
- Command line
-
hf download hf://TrendeX90/expected-greenness@refs/pr/1/training_code/scripts/05_aoi.py
-
curl -L -o 05_aoi.py https://huggingface.co/TrendeX90/expected-greenness/resolve/refs%2Fpr%2F1/training_code/scripts/05_aoi.py
4.56 kB
| """Build the area of interest: Naryn oblast, its districts, and a 20 km buffer for AppEEARS. | |
| Source: geoBoundaries (gbOpen, KGZ ADM1/ADM2). Writes GeoJSON to --out and prints a summary, | |
| including whether the PRD's known places fall inside the oblast and inside the buffer. | |
| """ | |
| from __future__ import annotations | |
| import argparse | |
| import json | |
| from pathlib import Path | |
| import geopandas as gpd | |
| import requests | |
| from shapely.geometry import Point, box | |
| API = "https://www.geoboundaries.org/api/current/gbOpen/KGZ/{level}/" | |
| SINU = "+proj=sinu +lon_0=0 +x_0=0 +y_0=0 +R=6371007.181 +units=m +no_defs" # MODIS grid, equal-area | |
| BUFFER_M = 20_000 | |
| SIMPLIFY_DEG = 0.005 # ~0.5 km, keeps the AppEEARS polygon small | |
| # Official districts of Naryn oblast. geoBoundaries' ADM1 "Naryn Region" also contains Toguz-Toro, | |
| # which (to our knowledge) belongs to Jalal-Abad oblast, so the oblast is built from these five instead. | |
| OFFICIAL_DISTRICTS = ["Ak-Talaa", "At-Bashy", "Jumgal", "Kochkor", "Naryn"] | |
| # PRD known places outside the oblast get their own box in the AppEEARS request (approximate extents). | |
| EXTRA_BOXES = { | |
| "Suusamyr valley (Chuy oblast)": (73.60, 41.95, 74.50, 42.30), # lon_min, lat_min, lon_max, lat_max | |
| "Ak-Shyirak massif (Issyk-Kul oblast)": (77.90, 41.70, 78.50, 42.00), | |
| } | |
| # Approximate coordinates (lat, lon) of the PRD's "known places"; used only for the inside/outside check. | |
| KNOWN_PLACES = { | |
| "Son-Kul lake": (41.83, 75.13), | |
| "Naryn city": (41.43, 75.99), | |
| "Ak-Shyirak (Kumtor area, approx.)": (41.86, 78.19), | |
| "Suusamyr village": (42.17, 73.97), | |
| } | |
| def fetch(level: str, cache: Path) -> gpd.GeoDataFrame: | |
| path = cache / f"geoBoundaries-KGZ-{level}.geojson" | |
| if not path.exists(): | |
| meta = requests.get(API.format(level=level), timeout=60).json() | |
| r = requests.get(meta["gjDownloadURL"], timeout=300) | |
| r.raise_for_status() | |
| path.write_bytes(r.content) | |
| return gpd.read_file(path).to_crs(4326) | |
| def main() -> None: | |
| ap = argparse.ArgumentParser() | |
| ap.add_argument("--out", type=Path, default=Path("/root/trendex-ml/data/aoi")) | |
| args = ap.parse_args() | |
| args.out.mkdir(parents=True, exist_ok=True) | |
| adm1 = fetch("ADM1", args.out) | |
| adm2 = fetch("ADM2", args.out) | |
| print("ADM1 names:", sorted(adm1["shapeName"])) | |
| gb_naryn = adm1[adm1["shapeName"].str.contains("Naryn", case=False)] | |
| reps = adm2.geometry.representative_point() | |
| in_gb_naryn = sorted(adm2[reps.within(gb_naryn.geometry.iloc[0])]["shapeName"]) | |
| districts = adm2[adm2["shapeName"].isin(OFFICIAL_DISTRICTS)][["shapeName", "shapeID", "geometry"]] | |
| districts = districts.reset_index(drop=True) | |
| missing = sorted(set(OFFICIAL_DISTRICTS) - set(districts["shapeName"])) | |
| if missing: | |
| raise SystemExit(f"Districts not found in geoBoundaries ADM2: {missing}") | |
| naryn = gpd.GeoDataFrame({"shapeName": ["Naryn oblast (5 districts)"]}, | |
| geometry=[districts.union_all()], crs=4326) | |
| naryn_geom = naryn.geometry.iloc[0] | |
| naryn_sinu = naryn.to_crs(SINU) | |
| area_km2 = naryn_sinu.area.iloc[0] / 1e6 | |
| buffered = naryn_sinu.buffer(BUFFER_M).to_crs(4326).simplify(SIMPLIFY_DEG) | |
| names = ["Naryn oblast + 20 km"] + list(EXTRA_BOXES) | |
| geoms = [buffered.iloc[0]] + [box(*b) for b in EXTRA_BOXES.values()] | |
| aoi = gpd.GeoDataFrame({"name": names}, geometry=geoms, crs=4326) | |
| aoi_union = aoi.union_all() | |
| naryn.to_file(args.out / "naryn_oblast.geojson", driver="GeoJSON") | |
| districts.to_file(args.out / "naryn_districts.geojson", driver="GeoJSON") | |
| aoi.to_file(args.out / "aoi_request.geojson", driver="GeoJSON") # what AppEEARS gets | |
| summary = { | |
| "oblast_name": naryn["shapeName"].iloc[0], | |
| "oblast_area_km2": round(area_km2), | |
| "expected_1km_cells_approx": round(area_km2 / 0.8586), | |
| "districts": sorted(districts["shapeName"]), | |
| "geoboundaries_adm1_naryn_contains": in_gb_naryn, | |
| "oblast_area_km2_note": "official figure is about 45,200 km2; compare", | |
| "aoi_bbox_lon_lat": [round(v, 3) for v in aoi.total_bounds], | |
| "aoi_features": names, | |
| "known_places": { | |
| name: {"in_oblast": naryn_geom.contains(Point(lon, lat)), | |
| "in_request": aoi_union.contains(Point(lon, lat))} | |
| for name, (lat, lon) in KNOWN_PLACES.items() | |
| }, | |
| } | |
| (args.out / "aoi_summary.json").write_text(json.dumps(summary, indent=2, ensure_ascii=False)) | |
| print(json.dumps(summary, indent=2, ensure_ascii=False)) | |
| if __name__ == "__main__": | |
| main() | |