Herramientas
Cómo se leen nuestros datos y con qué programas libres se trabajan.
Fundación Sherman Kent — Oficina de Generación de Inteligencia · Publicada el 23 de septiembre de 2026.
Acá no se enseña a programar: se dice qué formato usa cada archivo del registro, qué trae adentro y con qué herramientas libres —sin costo y sin credencial— se puede abrir, cruzar o mapear. El detalle de cada conjunto está en la interfaz de datos; acá lo resumimos para quien quiere usar el dato.
El formato: JSON, con su procedencia adentro
Todo el registro se publica en archivos JSON planos, en
https://siwa.fundacionkent.org/datos/publico/*.json, sin credencial, sin
registrarse y sin límite de consultas. Las cabeceras están abiertas
(Access-Control-Allow-Origin: *), así que se leen desde cualquier dominio o
programa. Conviene empezar por
indice.json: es el
catálogo de los conjuntos, con la dirección y la forma de cada uno.
Cada archivo trae dos bloques fijos, pensados para programar contra ellos sin abrirlos a mano:
procedencia — de dónde sale y de cuándo es:
fuente.nombre, fuente.url, colector,
obtenido_en, la calificación Almirantazgo (letra de fiabilidad y
número de credibilidad) y los vacios_declarados.
registros — la lista de filas, identificadas por
iso (código ISO 3166-1 alfa-3 del Estado) en la mayoría de los conjuntos. Un
Estado sin dato no aparece con cero: no aparece.
El mapa: capas en GeoJSON
Para trabajar el dato sobre un mapa, el registro publica sus fronteras en
GeoJSON: el padrón de los 33 Estados en
paises-alc.geojson,
y el detalle subnacional (provincia, departamento o estado, según el país) en
https://siwa.fundacionkent.org/datos/geo/adm1/<código ISO-3>.geojson —por
ejemplo, ARG.geojson para Argentina—. Son las mismas capas que dibujan el
Mapa de opacidad y el tablero subnacional del registro.
Herramientas libres recomendadas
| Herramienta | Para qué sirve |
|---|---|
| Hoja de cálculo (LibreOffice Calc, Google Sheets, Excel) |
Mirar un conjunto sin programar. Como el archivo de origen es JSON y no CSV,
conviene convertirlo primero con pandas o jq (siguientes
filas) y abrir ese CSV. |
Python — pandas + requests |
requests.get(url).json() trae el archivo entero; con
pandas.json_normalize(datos['registros']) queda como tabla, lista para
.to_csv() o para analizar. |
R — jsonlite |
jsonlite::fromJSON(url) trae el mismo archivo como lista, con
$registros ya en forma de data frame. |
jq |
Para mirar o filtrar un JSON en la terminal sin escribir un programa:
curl -s <url> | jq '.registros[0]'. |
| QGIS | Software libre de mapas (SIG). Abre directo los archivos GeoJSON de arriba como
capas, y permite unirles nuestros indicadores por su código iso
para armar un mapa temático propio. |
Verificar que el archivo es el publicado
Cada conjunto de datos/publico/ lleva su huella SHA-256 en el manifiesto
checksums.txt, en el
formato de sha256sum (huella y nombre de archivo, uno por línea). Quien
descarga un conjunto puede calcular su propia huella —sha256sum archivo.json en
Linux o macOS, Get-FileHash archivo.json -Algorithm SHA256 en PowerShell— y
compararla con la del manifiesto: si coinciden, es exactamente lo que publicamos,
sin alteración en el camino.
datos/publico/. Las capas GeoJSON de datos/geo/ todavía no tienen
su huella publicada ahí.El código: abierto, bajo MIT
Los colectores que arman cada conjunto, el sitio y las propias herramientas de este catálogo están en el repositorio público github.com/fundacion-sherman-kent/siwa, bajo licencia MIT: se puede leer, copiar, ejecutar y modificar. Quien quiera aportar una fuente nueva o corregir un colector encuentra ahí el camino para proponerlo.
Licencia y cómo citar
Los datos se publican bajo Creative Commons Atribución 4.0 (CC BY 4.0) y el código bajo MIT; el detalle completo —qué permite cada licencia y qué conservan las fuentes de base— está en Licencia y uso.
Cómo citar. «SIWA — Fundación Sherman Kent», enlazando a siwa.fundacionkent.org.
SIWA — Reporte de situación de América Latina y el Caribe · Fundación Sherman Kent, Oficina de Generación de Inteligencia · Datos CC BY 4.0 · Código MIT · Interfaz completa de datos · Licencia · Volver al registro