World showcase

Six countries, three styles, one function. Each figure below is a single study_area call — country → region → sub‑region — with heavy customization: different templates, rectangle / circle / overlay highlights, per‑panel graticules and north arrows, custom connectors and shaded‑relief terrain. Non‑bundled countries download from GADM on first run (cached after).

Reproduce any of these

Every figure is generated by the code shown above it. Swap the country and region names to make your own.

Nepal — the Himalaya

Cascade onto Everest‑region terrain (over 8,000 m), with a border‑overlay highlight, dashed teal connectors, and the grid turned off on the focus map.

import acadgis as agis

agis.study_area(
    "Nepal",
    steps=[("state", "East"), ("district", "Sagarmatha")],
    template="cascade", terrain=True,
    highlight_style="overlay", highlight_color="#e76f51", highlight_alpha=0.32,
    graticule=[True, True, False], width_ratios=[1, 2.3], cmap="terrain",
    link_color="#1b9aaa", link_style="--", box=False,
)

France — the Alps

A 2 × 2 grid into Haute‑Savoie (Mont Blanc) with a border‑overlay highlight on terrain.

agis.study_area(
    "France",
    steps=[("state", "Auvergne-Rhône-Alpes"), ("district", "Haute-Savoie")],
    template="grid", terrain=True,
    highlight_style="overlay", highlight_color="#2d6a4f", highlight_alpha=0.30,
    cmap="terrain", graticule=True,
)

Japan — the Japanese Alps

A 2 × 2 grid into Nagano → Ōmachi with a circle highlight on shaded relief.

agis.study_area(
    "Japan",
    steps=[("state", "Nagano"), ("district", "Ōmachi")],
    template="grid", terrain=True,
    highlight_style="circle", highlight_color="#1b9aaa", highlight_alpha=0.22,
    cmap="gist_earth", graticule=True,
)

Scotland — the Highlands

A cascade into Stirling with a circle highlight, dashed connectors and no focus box.

agis.study_area(
    "United Kingdom",
    steps=[("state", "Scotland"), ("district", "Stirling")],
    template="cascade", terrain=True,
    highlight_style="circle", highlight_color="#2b6cb0", highlight_alpha=0.22,
    link_color="#1b9aaa", link_style="--", box=False, cmap="gist_earth",
)

USA — the Sierra Nevada

Three uniform panels into California → Mariposa (Yosemite country), with a rectangle highlight, classic north arrows and a full graticule.

agis.study_area(
    "USA",
    steps=[("state", "California"), ("district", "Mariposa")],
    template="series", terrain=True, uniform_panels=True,
    highlight_style="rect", highlight_color="#e63946", highlight_alpha=0.25,
    north_arrow=True, scale_bar=True, graticule=True, palette="vibrant",
)

China — the Tibetan plateau

A cascade into Sichuan → Garzê (Tibetan) with a custom‑sized focus panel and a rectangle highlight.

agis.study_area(
    "China",
    steps=[("state", "Sichuan"), ("district", "GarzêTibetan")],
    template="cascade",
    highlight_style="rect", highlight_color="#e63946", highlight_alpha=0.28,
    width_ratios=[1, 2.2], palette="vibrant", link_color="#e63946", box=True,
)

---

See the Study‑area layouts guide for every parameter, or the layout presets tutorial for a side‑by‑side of all five templates.