feat: extraccion masiva footprint_aurgi (41 funcs + 4 types + stack Docker geo)

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>
This commit is contained in:
2026-05-04 23:35:22 +02:00
parent f73ea072bd
commit faac610745
193 changed files with 13146 additions and 3 deletions
@@ -0,0 +1,66 @@
---
id: compute_centers_reachability_pipeline_py_pipelines
name: compute_centers_reachability_pipeline
kind: pipeline
lang: py
domain: pipelines
version: "1.0.0"
purity: impure
signature: "async def compute_centers_reachability_pipeline(origins, centers, isochrone_minutes, base_url, concurrency) -> dict"
description: "Calcula la accesibilidad de centros de servicio: matriz tiempo/distancia clientes→centros e isócronas por centro usando Valhalla."
tags: [pipeline, geo, footprint, valhalla, isochrone, matrix, reachability]
uses_functions: ["valhalla_matrix_1_to_n_py_geo", "valhalla_isochrones_async_py_geo"]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
example: |
import asyncio
result = asyncio.run(compute_centers_reachability_pipeline(
origins=[(40.4168, -3.7038), (37.3891, -5.9845)],
centers=[(41.3851, 2.1734), (43.2627, -2.9253)],
isochrone_minutes=15,
))
# result["matrix"] tiene 4 entries (2 orígenes × 2 centros)
# result["isochrones"] tiene 2 GeoJSON dicts
tested: true
tests: ["test_compute_centers_reachability_pipeline"]
test_file_path: "python/functions/pipelines/tests/test_compute_centers_reachability_pipeline.py"
file_path: "python/functions/pipelines/compute_centers_reachability_pipeline.py"
params:
- {name: origins, desc: "Lista de (lat, lon) de los clientes u orígenes. Coordenadas WGS84."}
- {name: centers, desc: "Lista de (lat, lon) de los centros de servicio. Coordenadas WGS84."}
- {name: isochrone_minutes, desc: "Minutos de tiempo de viaje para las isócronas de cada centro. Default 15."}
- {name: base_url, desc: "URL base del servidor Valhalla. Default http://localhost:8002."}
- {name: concurrency, desc: "Número máximo de requests async simultáneos para isócronas. Default 6."}
output: "Dict con 'matrix' (list[dict] con i,j,meters,seconds,error por par) e 'isochrones' (list[dict|None] con GeoJSON por centro)."
source_repo: "internal:footprint_aurgi"
source_license: "internal-aurgi"
source_file: "internal:composed"
---
## Ejemplo
```python
import asyncio
result = asyncio.run(compute_centers_reachability_pipeline(
origins=[(40.4168, -3.7038), (37.3891, -5.9845)], # Madrid, Sevilla
centers=[(41.3851, 2.1734), (43.2627, -2.9253)], # Barcelona, Bilbao
isochrone_minutes=15,
base_url="http://localhost:8002",
))
for entry in result["matrix"]:
print(f"origen[{entry['i']}] → centro[{entry['j']}]: {entry['meters']:.0f}m / {entry['seconds']:.0f}s")
print(f"Isócronas calculadas: {sum(1 for iso in result['isochrones'] if iso is not None)}")
```
## Notas
Función async — requiere `asyncio.run(...)` o `await` dentro de un contexto async.
La matriz se calcula con threads (valhalla_matrix_1_to_n usa ThreadPoolExecutor).
Las isócronas se calculan con httpx async (valhalla_isochrones_async).
Orden de la matrix: [(0,0),(0,1),...,(0,N-1),(1,0),...,(M-1,N-1)] donde M=orígenes, N=centros.