Skip to content

docs(templates): fix stale UTM zone in from_template FRA example#3544

Merged
brendancol merged 1 commit into
mainfrom
deep-sweep-documentation-templates-2026-06-26
Jun 26, 2026
Merged

docs(templates): fix stale UTM zone in from_template FRA example#3544
brendancol merged 1 commit into
mainfrom
deep-sweep-documentation-templates-2026-06-26

Conversation

@brendancol

Copy link
Copy Markdown
Contributor

The from_template docstring example for preserve="shape" showed EPSG:32631 (UTM 31N) for France, but the function returns EPSG:32630 (UTM 30N).

The GADM FRA bounding box spans longitude -61.79 to 55.84 because it includes overseas territories (French Guiana, Reunion, and others), so the centroid falls at longitude -2.98 in UTM zone 30N. The preserve="shape" path picks the centroid's UTM zone, which is the documented contract, so 32630 is correct. The example value and inline comment were stale.

Documentation-only change: corrected the expected value to 32630 and the inline comment to UTM 30N. No behavior change. All 63 test_templates.py tests pass.

Found by the documentation sweep on the templates module.

Closes #3541

The from_template docstring example for preserve="shape" showed
EPSG:32631 (UTM 31N) for France, but the function returns EPSG:32630
(UTM 30N). The GADM FRA bounding box includes overseas territories, so
the centroid falls at longitude -2.98 in UTM zone 30N. The code is
correct per the documented centroid-UTM contract; only the example
value and inline comment were stale.

Doc-only change. All 63 templates tests pass.

Closes #3541
@brendancol brendancol merged commit 29b178b into main Jun 26, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

from_template docstring: FRA preserve="shape" example shows wrong UTM zone

1 participant