egutierrez
faac610745
Extrae al registry funciones del proyecto interno footprint_aurgi: - core (6): slugify_ascii, normalize_for_join, cp_provincia_es, infer_provincia_from_cp, safe_read_csv_fallback, csv_to_parquet_duckdb - geo puras (7): haversine_km, point_in_ring, point_in_polygon, point_in_polygons_bbox, polygon_bbox, extent_with_padding, distance_bucket - geo I/O (4): load_geojson_polygons, load_boundary_gdf, add_basemap_osm, add_basemap_with_timeout - valhalla client (4): valhalla_route, valhalla_isochrone, valhalla_isochrones_async, valhalla_matrix_1_to_n - datascience stats (7): trimmed_mean, geometric_mean, detect_distribution_type, best_central_tendency, summary_stats, kde_density_levels, alpha_shape_concave_hull - datascience fuzzy (3): fuzzy_merge_adaptive (rapidfuzz), words_to_dataset, remove_words_from_column - datascience viz (2): plot_kde_2d, plot_heatmap_log - infra (4): compress_pdf_ghostscript, render_table_page_pdfpages, add_header_logo, osm2pgsql_ingest - pipelines (4): setup_geo_stack_docker, compute_centers_reachability, generate_isochrones_by_zone, count_points_per_zone - types geo (4): LonLat, BBox, IsochroneRequest, Centro Incluye: - apps/footprint_geo_stack/ (PostGIS + Martin + Valhalla via docker-compose) - 131/132 tests pasan (1 skip esperado: osm2pgsql en PATH) - Issue tracker dev/issues/0052-footprint-aurgi-extraction.md - Atribucion uniforme: source_repo internal:footprint_aurgi, source_license internal-aurgi - Build con 9 agentes en paralelo (8 wave 1 + 1 wave 2 pipelines) Tambien commitea trabajo previo no commiteado: aggregate_extraction_results, chunk_with_overlap, clean_pdf_text, merge_entity_aliases, extract_graph_gliner2, extract_relations_mrebel, extract_triples_spacy_es, gliner2/mrebel/marianmt/rebel/spacy_es load_model, parse_rebel_output, translate_es_to_en, issue 0050/0051. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
39 lines
1.3 KiB
Python
39 lines
1.3 KiB
Python
"""Add an OpenStreetMap basemap to a matplotlib Axes."""
|
||
|
||
from __future__ import annotations
|
||
|
||
from pathlib import Path
|
||
|
||
|
||
def add_basemap_osm(
|
||
ax: "Axes",
|
||
zoom: int = 9,
|
||
cache_dir: "str | Path | None" = None,
|
||
) -> None:
|
||
"""Add an OpenStreetMap Mapnik basemap to a matplotlib Axes.
|
||
|
||
Uses contextily to fetch and render map tiles. Network errors and tile
|
||
fetch failures are silently captured — the map will render without a
|
||
basemap rather than raising.
|
||
|
||
Args:
|
||
ax: matplotlib Axes with a projected extent (CRS must match tile CRS,
|
||
typically EPSG:3857). The caller is responsible for ensuring the
|
||
Axes limits are set before calling this function.
|
||
zoom: Tile zoom level (1–19). Higher values fetch more tiles and
|
||
produce a sharper basemap at the cost of more network requests.
|
||
cache_dir: Optional directory for caching downloaded tiles. If None,
|
||
contextily uses its default cache location.
|
||
"""
|
||
try:
|
||
import contextily as ctx # type: ignore
|
||
except ImportError:
|
||
return
|
||
|
||
try:
|
||
if cache_dir is not None:
|
||
ctx.set_cache_dir(str(cache_dir))
|
||
ctx.add_basemap(ax, source=ctx.providers.OpenStreetMap.Mapnik, zoom=zoom)
|
||
except Exception: # noqa: BLE001
|
||
pass
|