RAVE-SCOUT/README.md

# RAVE SCOUT

Barrido de los 498.528 km² de la España peninsular y balear, celda a celda sobre
una malla de 100 m, buscando los puntos más alejados de cualquier rastro de gente
a los que **además** se pueda llegar con un coche cargado.

Salen **355 localizaciones**, valoradas de 1 a 5 estrellas, con un visor para
explorarlas sobre relieve, ortofoto y catastro.

![vista del visor](docs/visor.png)

## Cómo usarlo

**En el navegador, sin instalar nada** — si está publicado en GitLab Pages:
`https://<usuario>.gitlab.io/<proyecto>/`. Funciona igual en Windows, Android y
Linux.

**En local**, tras clonar:

```bash
xdg-open out/visor.html      # Linux
start out\visor.html         # Windows
open out/visor.html          # macOS
```

No hace falta servidor ni conexión. Ojo: `visor.html` necesita la carpeta
`out/ortho/` al lado, que es donde están las fotos aéreas.

## Qué hay dentro

| | |
|---|---|
| `out/visor.html` | El visor: mapa de España con relieve, filtros, ficha por localización con foto aérea y relieve 3D, y mapa deslizante con satélite, topográfico, catastro y espacios protegidos |
| `out/informe.html` | El método explicado, los mapas y la tabla de las mejores |
| `out/candidatos_estrellas.csv` | Las 355 con todos los campos, para abrir en LibreOffice o QGIS |
| `out/ortho/` | Ortofoto PNOA de cada localización, 640 m de lado |
| `out/stats.json` | Cifras del modelo, que leen el informe y el visor |
| `src/` | El pipeline entero, reproducible |

## Cómo se calcula

Sobre una malla de 100 m en proyección equiárea (EPSG:3035) se vuelcan 12,5
millones de edificios y 1,4 millones de kilómetros de viales de OpenStreetMap, y
para cada celda se calcula por transformada de distancia a qué distancia real
está lo más cercano de cada tipo.

**Primero se descarta.** Una celda queda fuera si está en espacio protegido
oficial o a menos de 300 m de su borde, en zona militar, en agua, a menos de
2 km de un edificio, a menos de 400 m de una carretera, a más de 800 m de un
vial por el que meter un coche, o con más de 10° de pendiente.

**Después manda el sonido.** Se estima el nivel que llega a la casa más cercana
con propagación real —divergencia esférica, absorción atmosférica en frecuencias
bajas, apantallamiento del relieve y absorción del arbolado, desde 130 dB a 1 m— y
se exige que no pase de 45 dB, el límite nocturno típico en suelo rural. Es el
filtro que de verdad corta: de 47.519 km² que pasan lo anterior, solo **505 km²**
bajan de 45 dB.

**Lo que sobrevive se puntúa** en seis criterios: sonido (30 %), soledad (22 %),
acceso (18 %), agua (12 %), arbolado (10 %) y clima (8 %). Las estrellas salen de
la media ponderada penalizada por el eslabón más débil, para que un sitio
perfecto al que no se puede llegar no salga con cuatro estrellas.

Los candidatos se eligen cogiendo el mejor punto de cada bloque de 20 km y
exigiendo después 10 km de separación entre los elegidos.

## Reproducirlo

Hacen falta ~25 GB de disco y un par de horas. Los datos de partida no están en
el repositorio: se descargan solos.

```bash
python3 -m venv .venv
./.venv/bin/pip install numpy scipy rasterio osmium shapely pyproj requests pillow
make all
```

O paso a paso, ver el `Makefile`.

## Lo que este análisis no sabe

- **No ve vallas ni propiedad.** Casi todo el suroeste que domina la lista es
  dehesa privada, en fincas cerradas y cotos de caza. Ve la pista que llega; no
  ve la cadena y el candado. Por eso el visor lleva la capa de catastro.
- **Los protegidos son de diciembre de 2024.** Son los límites oficiales, pero
  las figuras autonómicas cambian y hay ordenanzas municipales que no están en
  ningún mapa nacional.
- **El modelo acústico es de manual.** Una inversión térmica nocturna o el viento
  a favor llevan el bajo mucho más lejos de lo que dice el número.
- **Ignora la estación.** Buena parte de estos sitios son monte mediterráneo en
  riesgo extremo de incendio de junio a septiembre.
- **Distancia en línea recta, no tiempo de coche.**

## Fuentes y licencias

| Dato | Fuente | Licencia |
|---|---|---|
| Edificios, viales, agua, arbolado, roca, límites administrativos | [OpenStreetMap](https://www.openstreetmap.org/copyright) vía Geofabrik | ODbL |
| Red Natura 2000 y espacios de designación nacional | Agencia Europea de Medio Ambiente / MITECO | reutilización con atribución |
| Ortofotos PNOA | [Instituto Geográfico Nacional](https://www.ign.es) | CC BY 4.0 |
| Cartografía catastral | [Dirección General del Catastro](https://www.sedecatastro.gob.es) | reutilización con atribución |
| Modelo de elevaciones | Copernicus DEM GLO-90 | Copernicus |
| Clima | [WorldClim 2.1](https://www.worldclim.org) | CC BY-SA 4.0 |
| Mapa deslizante | [Leaflet](https://leafletjs.com) 1.9.4 | BSD-2 |

El código de este repositorio, bajo licencia MIT (ver `LICENSE`). Los datos
mantienen la licencia de su fuente.

## Aviso

Esto localiza sitios despoblados; no es permiso para nada. Casi todo el terreno
es privado, muchas zonas tienen restricciones de acceso por incendios, y celebrar
una concentración sin autorización tiene consecuencias administrativas y, si
prende algo, penales. Comprueba propiedad, figura de protección y época del año
antes de moverte.