{ "regiones": { "description": "Capa derivada de regiones para filtros, joins y referencias administrativas de alto nivel.", "join_keys": [ "codigo_region" ], "confidence_tier": "Tier B", "extractor": "src/extractors/subdere_extractor.py", "expected_record_count": 16, "reuse_policy": { "status": "open-attribution", "license": "CC BY", "license_url": "https://datos.bcn.cl/es/informacion/lo-que-esta-haciendo-bcn", "attribution_required": true, "redistribution_ok": true, "summary": "Derivada de datos abiertos BCN reutilizables con atribucion." }, "freshness_policy": { "max_age_hours": 2160, "label": "estable" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('regiones')", "duckdb": "SELECT *\nFROM 'data/normalized/regiones.parquet'\nORDER BY codigo_region;", "cli": "chile-hub show regiones" }, "outputs": { "parquet": "data/normalized/regiones.parquet", "json": "data/normalized/regiones.json", "duckdb_table": "regiones", "sqlite_table": "regiones", "excel_sheet": "Regiones" }, "documentation": "docs/datasets/regiones.md" }, "provincias": { "description": "Capa derivada de provincias para cruces intermedios entre region y comuna.", "join_keys": [ "codigo_provincia", "codigo_region" ], "confidence_tier": "Tier B", "extractor": "src/extractors/subdere_extractor.py", "expected_record_count": 56, "reuse_policy": { "status": "open-attribution", "license": "CC BY", "license_url": "https://datos.bcn.cl/es/informacion/lo-que-esta-haciendo-bcn", "attribution_required": true, "redistribution_ok": true, "summary": "Derivada de datos abiertos BCN reutilizables con atribucion." }, "freshness_policy": { "max_age_hours": 2160, "label": "estable" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('provincias')", "duckdb": "SELECT *\nFROM 'data/normalized/provincias.parquet'\nWHERE codigo_region = '13';", "cli": "chile-hub show provincias" }, "outputs": { "parquet": "data/normalized/provincias.parquet", "json": "data/normalized/provincias.json", "duckdb_table": "provincias", "sqlite_table": "provincias", "excel_sheet": "Provincias" }, "documentation": "docs/datasets/provincias.md" }, "comunas": { "description": "Base territorial normalizada para cruces por region, provincia y comuna.", "join_keys": [ "codigo_comuna", "codigo_region" ], "confidence_tier": "Tier B", "extractor": "src/extractors/subdere_extractor.py", "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "CC BY", "license_url": "https://datos.bcn.cl/es/informacion/lo-que-esta-haciendo-bcn", "attribution_required": true, "redistribution_ok": true, "summary": "Fuente operativa BCN dentro de su superficie de datos abiertos; atribucion requerida." }, "freshness_policy": { "max_age_hours": 2160, "label": "estable" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('comunas')", "duckdb": "SELECT codigo_comuna, nombre_comuna, nombre_region\nFROM 'data/normalized/comunas.parquet'\nLIMIT 10;", "cli": "chile-hub path comunas --output parquet" }, "outputs": { "parquet": "data/normalized/comunas.parquet", "json": "data/normalized/comunas.json", "duckdb_table": "comunas", "sqlite_table": "comunas", "excel_sheet": "Comunas y Regiones" }, "documentation": "docs/datasets/comunas.md" }, "comunas_enriquecidas": { "description": "Comunas con coordenadas de cabecera y poblacion estimada INE, listas para analisis territorial sin joins adicionales.", "alias_for": "comunas", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": "src/extractors/subdere_extractor.py", "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "CC BY", "license_url": "https://datos.bcn.cl/es/informacion/lo-que-esta-haciendo-bcn", "attribution_required": true, "redistribution_ok": true, "summary": "Derivada de datos abiertos BCN con coordenadas e informacion INE." }, "freshness_policy": { "max_age_hours": 2160, "label": "estable" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('comunas_enriquecidas')", "duckdb": "SELECT codigo_comuna, nombre_comuna, latitud_cabecera, longitud_cabecera, poblacion_estimada\nFROM 'data/normalized/comunas.parquet'\nORDER BY poblacion_estimada DESC LIMIT 10;", "cli": "chile-hub show comunas_enriquecidas" }, "outputs": { "parquet": "data/normalized/comunas.parquet", "json": "data/normalized/comunas.json", "duckdb_table": "comunas_enriquecidas", "sqlite_table": "comunas_enriquecidas", "excel_sheet": "Comunas y Regiones" }, "documentation": "docs/datasets/comunas_enriquecidas.md" }, "indicadores": { "description": "Serie de indicadores economicos diarios de referencia para analisis y software.", "join_keys": [ "fecha", "codigo_indicador" ], "confidence_tier": "Tier A/B", "extractor": "src/extractors/bcentral_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "Reproducción libre con citación (BCCh / INE)", "license_url": "https://www.bcentral.cl/web/banco-central/terminos-y-condiciones", "attribution_required": true, "redistribution_ok": true, "summary": "Datos del Banco Central de Chile (BCCh) e INE. Libre reproducción con citación. Acceso vía mindicador.cl (API pública de la comunidad)." }, "freshness_policy": { "max_age_hours": 72, "label": "diaria" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('indicadores')", "duckdb": "SELECT *\nFROM 'data/normalized/indicadores.parquet'\nORDER BY fecha DESC, codigo_indicador;", "cli": "chile-hub show indicadores" }, "outputs": { "parquet": "data/normalized/indicadores.parquet", "json": "data/normalized/indicadores_hoy.json", "duckdb_table": "indicadores", "sqlite_table": "indicadores", "excel_sheet": "Indicadores Diarios" }, "documentation": "docs/datasets/indicadores.md", "expected_record_count": null }, "censo_comunal": { "description": "Perfil demografico comunal del Censo 2024 con sexo y grandes grupos de edad.", "join_keys": [ "codigo_comuna", "codigo_region" ], "confidence_tier": "Tier A", "extractor": "src/extractors/censo_extractor.py", "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "CC BY 4.0", "license_url": "https://www.ine.gob.cl/terminos-de-uso", "attribution_required": true, "redistribution_ok": true, "summary": "Resultados oficiales del Censo 2024 publicados por el INE." }, "freshness_policy": { "max_age_hours": 87600, "label": "decenal" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('censo_comunal')", "duckdb": "SELECT * FROM 'data/normalized/censo_comunal.parquet' ORDER BY poblacion_censada DESC;", "cli": "chile-hub show censo_comunal" }, "outputs": { "parquet": "data/normalized/censo_comunal.parquet", "json": "data/normalized/censo_comunal.json", "duckdb_table": "censo_comunal", "sqlite_table": "censo_comunal", "excel_sheet": "Censo Comunal" }, "documentation": "docs/datasets/censo_comunal.md" }, "censo_hogares_viviendas": { "description": "Viviendas y hogares censados por comuna, ocupacion y tamano medio del hogar.", "join_keys": [ "codigo_comuna", "codigo_region" ], "confidence_tier": "Tier A", "extractor": "src/extractors/censo_hogares_viviendas_extractor.py", "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "CC BY 4.0", "license_url": "https://www.ine.gob.cl/terminos-de-uso", "attribution_required": true, "redistribution_ok": true, "summary": "Resultados oficiales del Censo 2024 publicados por el INE." }, "freshness_policy": { "max_age_hours": 87600, "label": "decenal" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('censo_hogares_viviendas')", "duckdb": "SELECT * FROM 'data/normalized/censo_hogares_viviendas.parquet';", "cli": "chile-hub show censo_hogares_viviendas" }, "outputs": { "parquet": "data/normalized/censo_hogares_viviendas.parquet", "json": "data/normalized/censo_hogares_viviendas.json" }, "documentation": "docs/datasets/censo_hogares_viviendas.md" }, "establecimientos_salud": { "description": "Directorio vigente de establecimientos de salud con tipo, dependencia, urgencia y ubicacion.", "join_keys": [ "codigo_establecimiento", "codigo_comuna" ], "confidence_tier": "Tier A", "extractor": "src/extractors/salud_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "CC0", "license_url": "http://www.opendefinition.org/licenses/cc-zero", "attribution_required": false, "redistribution_ok": true, "summary": "Directorio oficial MINSAL publicado en datos.gob.cl bajo CC0." }, "freshness_policy": { "max_age_hours": 1080, "label": "mensual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('establecimientos_salud')", "duckdb": "SELECT codigo_comuna, count(*) FROM 'data/normalized/establecimientos_salud.parquet' GROUP BY 1;", "cli": "chile-hub show establecimientos_salud" }, "outputs": { "parquet": "data/normalized/establecimientos_salud.parquet", "json": "data/normalized/establecimientos_salud.json", "duckdb_table": "establecimientos_salud", "sqlite_table": "establecimientos_salud", "excel_sheet": "Establecimientos Salud" }, "documentation": "docs/datasets/establecimientos_salud.md", "expected_record_count": null }, "distritos_electorales": { "description": "Asociación de comunas a distritos electorales (diputados) y circunscripciones senatoriales.", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier A", "extractor": "src/extractors/electoral_extractor.py", "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "CC0", "license_url": "http://www.opendefinition.org/licenses/cc-zero", "attribution_required": false, "redistribution_ok": true, "summary": "Asociación comunal a distritos y circunscripciones electorales basada en Ley N° 20.840." }, "freshness_policy": { "max_age_hours": 87600, "label": "estable" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('distritos_electorales')", "duckdb": "SELECT * FROM 'data/normalized/distritos_electorales.parquet';", "cli": "chile-hub show distritos_electorales" }, "outputs": { "parquet": "data/normalized/distritos_electorales.parquet", "json": "data/normalized/distritos_electorales.json" }, "documentation": "docs/datasets/distritos_electorales.md" }, "establecimientos_educacionales": { "description": "Directorio oficial del Ministerio de Educación (MINEDUC) con Rol Base de Datos (RBD), ubicación y dependencia administrativa.", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier A", "extractor": "src/extractors/mineduc_establecimientos_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "CC-BY-3.0", "license_url": "https://creativecommons.org/licenses/by/3.0/cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Directorio oficial MINEDUC publicado por el Centro de Estudios del Ministerio de Educación de Chile bajo licencia CC BY." }, "freshness_policy": { "max_age_hours": 8760, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('establecimientos_educacionales')", "duckdb": "SELECT nombre_establecimiento, dependencia_administrativa FROM 'data/normalized/establecimientos_educacionales.parquet' LIMIT 10;", "cli": "chile-hub show establecimientos_educacionales" }, "outputs": { "parquet": "data/normalized/establecimientos_educacionales.parquet", "json": "data/normalized/establecimientos_educacionales.json", "duckdb_table": "establecimientos_educacionales", "sqlite_table": "establecimientos_educacionales", "excel_sheet": "Establecimientos Educacionales" }, "documentation": "docs/datasets/establecimientos_educacionales.md", "expected_record_count": null }, "finanzas_municipales": { "description": "Indicadores financieros municipales anuales desde SINIM/SUBDERE. CAPA PARCIAL/CANDIDATO: 3 de 346 comunas (0.9%). Usar con precaución; no representa cobertura nacional.", "join_keys": [ "anio", "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": [ "src/extractors/sinim_finanzas_extractor.py", "src/extractors/sinim_finanzas_live_extractor.py" ], "coverage_note": "parcial_candidato_3_de_346_comunas", "coverage_pct": 0.9, "expected_record_count": null, "reuse_policy": { "status": "public-api-review-terms", "license": "Datos públicos municipales; términos de reutilización sujetos a revisión", "license_url": "https://datos.sinim.gov.cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Información municipal pública publicada por SINIM/SUBDERE; citar fuente oficial." }, "freshness_policy": { "max_age_hours": 8760, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('finanzas_municipales')", "duckdb": "SELECT * FROM 'data/normalized/finanzas_municipales.parquet' WHERE codigo_comuna = '13101';", "cli": "chile-hub show finanzas_municipales" }, "outputs": { "parquet": "data/normalized/finanzas_municipales.parquet", "json": "data/normalized/finanzas_municipales.json", "duckdb_table": "finanzas_municipales", "sqlite_table": "finanzas_municipales", "excel_sheet": "Finanzas Municipales" }, "documentation": "docs/datasets/finanzas_municipales.md" }, "resultados_educacionales": { "description": "Resultados educacionales agregados por comuna y año, sin registros personales.", "join_keys": [ "anio", "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": "src/extractors/mineduc_resultados_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "CC-BY-3.0", "license_url": "https://creativecommons.org/licenses/by/3.0/cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Datos agregados desde publicaciones del Centro de Estudios MINEDUC; citar fuente oficial." }, "freshness_policy": { "max_age_hours": 8760, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('resultados_educacionales')", "duckdb": "SELECT anio, codigo_comuna, matricula_total FROM 'data/normalized/resultados_educacionales.parquet';", "cli": "chile-hub show resultados_educacionales" }, "outputs": { "parquet": "data/normalized/resultados_educacionales.parquet", "json": "data/normalized/resultados_educacionales.json", "duckdb_table": "resultados_educacionales", "sqlite_table": "resultados_educacionales", "excel_sheet": "Resultados Educacionales" }, "documentation": "docs/datasets/resultados_educacionales.md", "expected_record_count": null }, "indicadores_urbanos_siedu": { "description": "Indicadores urbanos SIEDU en formato largo con cobertura comunal parcial esperada.", "join_keys": [ "anio", "codigo_comuna", "codigo_indicador" ], "confidence_tier": "Tier B", "extractor": "src/extractors/siedu_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "Licencia de Datos Abiertos INE", "license_url": "https://www.ine.gob.cl/terminos-de-uso", "attribution_required": true, "redistribution_ok": true, "summary": "Indicadores urbanos SIEDU publicados por INE para comunas urbanas seleccionadas." }, "freshness_policy": { "max_age_hours": 8760, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('indicadores_urbanos_siedu')", "duckdb": "SELECT * FROM 'data/normalized/indicadores_urbanos_siedu.parquet' WHERE codigo_indicador = 'siedu_acceso_areas_verdes';", "cli": "chile-hub show indicadores_urbanos_siedu" }, "outputs": { "parquet": "data/normalized/indicadores_urbanos_siedu.parquet", "json": "data/normalized/indicadores_urbanos_siedu.json", "duckdb_table": "indicadores_urbanos_siedu", "sqlite_table": "indicadores_urbanos_siedu", "excel_sheet": "SIEDU" }, "documentation": "docs/datasets/indicadores_urbanos_siedu.md", "expected_record_count": null }, "perfil_territorial_comunal": { "description": "Perfil comunal curado que consolida DPA, censo, salud, educación, finanzas, SIEDU y distritos.", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": null, "expected_record_count": 346, "reuse_policy": { "status": "open-attribution", "license": "Derivada de fuentes abiertas con atribución", "license_url": "https://github.com/cortega26/chile-hub", "attribution_required": true, "redistribution_ok": true, "summary": "Capa derivada a partir de datasets validados de chile-hub." }, "freshness_policy": { "max_age_hours": 1080, "label": "derivada" }, "usage_examples": { "python": "from chile_hub import ChileHub\nhub = ChileHub()\ndf = hub.load_polars('perfil_territorial_comunal')", "duckdb": "SELECT codigo_comuna, nombre_comuna, establecimientos_salud_total FROM 'data/normalized/perfil_territorial_comunal.parquet';", "cli": "chile-hub show perfil_territorial_comunal" }, "outputs": { "parquet": "data/normalized/perfil_territorial_comunal.parquet", "json": "data/normalized/perfil_territorial_comunal.json", "duckdb_table": "perfil_territorial_comunal", "sqlite_table": "perfil_territorial_comunal", "excel_sheet": "Perfil Territorial" }, "documentation": "docs/datasets/perfil_territorial_comunal.md" }, "empresas": { "description": "Registro de Empresas y Sociedades (RES) con RUT, razon social, tipo societario, capital, fecha de constitucion y comuna de domicilio.", "join_keys": [ "rut" ], "confidence_tier": "Tier B", "extractor": "src/extractors/res_extractor.py", "reuse_policy": { "status": "open-attribution", "license": "CC-BY", "license_url": "https://creativecommons.org/licenses/by/3.0/cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Registro de Empresas y Sociedades (RES) del Ministerio de Economia, publicado en datos.gob.cl bajo CC-BY. Solo incluye constituciones bajo Ley 20.659 (regimen simplificado) desde 2013." }, "freshness_policy": { "max_age_hours": 1080, "label": "mensual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('empresas')\n# Empresas por comuna\ndf.group_by('comuna_tributaria').len().sort('len', descending=True)", "duckdb": "SELECT comuna_tributaria, count(*) AS n\nFROM 'data/normalized/empresas.parquet'\nGROUP BY 1 ORDER BY n DESC LIMIT 10;", "cli": "chile-hub show empresas" }, "outputs": { "parquet": "data/normalized/empresas.parquet", "duckdb_table": "empresas", "excel_sheet": "Empresas RES" }, "documentation": "docs/datasets/empresas.md", "_notes": "JSON y SQLite omitidos: >1.5M registros. Usa Parquet o DuckDB.", "expected_record_count": null }, "pobreza_comunal": { "description": "Estimaciones de pobreza comunal por ingresos y multidimensional derivadas de la encuesta CASEN mediante metodología SAE (Estimación de Áreas Pequeñas). Incluye tasa, límite inferior y superior del intervalo de confianza por comuna, año y dimensión.", "join_keys": [ "codigo_comuna", "codigo_region" ], "confidence_tier": "Tier A", "extractor": "src/extractors/pobreza_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "open-attribution", "license": "Datos abiertos MDS", "license_url": "https://observatorio.ministeriodesarrollosocial.gob.cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Estimaciones de pobreza comunal publicadas por el Observatorio Social del MDS. Atribución requerida." }, "freshness_policy": { "max_age_hours": 175200, "label": "bienal/trienal" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('pobreza_comunal')\n# Filtrar pobreza por ingresos 2022\npobreza_2022 = df.filter(pl.col('anio') == 2022, pl.col('dimension') == 'ingresos')", "duckdb": "SELECT codigo_comuna, nombre_comuna, tasa, limite_inferior, limite_superior\nFROM 'data/normalized/pobreza_comunal.parquet'\nWHERE anio = 2022 AND dimension = 'ingresos'\nORDER BY tasa DESC;", "cli": "chile-hub show pobreza_comunal" }, "outputs": { "parquet": "data/normalized/pobreza_comunal.parquet", "json": "data/normalized/pobreza_comunal.json" }, "documentation": "docs/datasets/pobreza_comunal.md" }, "consumo_electrico_comunal": { "description": "Consumo eléctrico anual por comuna y tipo de cliente (Residencial, Comercial, Industrial, Agrícola, Alumbrado Público, Otros), publicado por la Comisión Nacional de Energía (CNE) en el portal Energía Abierta. DEPRECATED: la fuente Junar de energiaabierta.cl fue decomisionada (investigado 2026-07-07); el dataset solo publica datos de muestra (FALLBACK_ROWS), no está en el bundle público. Ver data/source_registry.json.", "join_keys": [ "codigo_comuna", "codigo_region" ], "confidence_tier": "Tier C", "extractor": "src/extractors/consumo_electrico_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "open-attribution", "license": "CC BY", "license_url": "http://energiaabierta.cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Consumo eléctrico anual por comuna publicado por la CNE en Energía Abierta. Atribución requerida." }, "freshness_policy": { "max_age_hours": 17520, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars('consumo_electrico_comunal')\n# Consumo residencial por comuna\nresidencial = df.filter(pl.col('tipo_cliente') == 'Residencial')", "duckdb": "SELECT codigo_comuna, nombre_comuna, tipo_cliente, consumo_kwh\nFROM 'data/normalized/consumo_electrico_comunal.parquet'\nWHERE tipo_cliente = 'Residencial'\nORDER BY consumo_kwh DESC;", "cli": "chile-hub show consumo_electrico_comunal" }, "outputs": { "parquet": "data/normalized/consumo_electrico_comunal.parquet", "json": "data/normalized/consumo_electrico_comunal.json" }, "documentation": "docs/datasets/consumo_electrico_comunal.md" }, "geometria_comunal": { "description": "Límites poligonales de las 346 comunas de Chile (GeoParquet, geometría 'generalizada' — simplificada para cartografía a escala nacional, no apta para trabajo de precisión geodésica ni catastral). Fuente: BCN ArcGIS (tematico/Comunas_Generalizadas). Artefacto separado de `comunas`, unido por `codigo_comuna`.", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": "src/extractors/geometria_comunal_extractor.py", "expected_record_count": 345, "reuse_policy": { "status": "open-attribution", "license": "Uso libre con atribución a la Biblioteca del Congreso Nacional de Chile (bcn.cl/siit/mapas_vectoriales). Geometría generalizada, no apta para precisión geodésica.", "license_url": "https://www.bcn.cl/siit/mapas_vectoriales/index_html", "attribution_required": true, "redistribution_ok": true, "summary": "Límites comunales (geometría generalizada) desde BCN ArcGIS. Carril CANDIDATE mientras madura la cobertura (345/346 comunas — falta codigo_comuna=12202/Antártica, ver ADR-012). Ver ADR-012 para el gate de licencia completo." }, "freshness_policy": { "max_age_hours": 87600, "label": "bajo_demanda" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"geometria_comunal\")\n# geometry llega como WKB; usa geopandas para trabajar con la columna geometrica\nimport geopandas as gpd\ngdf = gpd.read_parquet(\"data/normalized/geometria_comunal.parquet\")", "duckdb": "-- DuckDB con la extension spatial puede leer GeoParquet directamente\nINSTALL spatial; LOAD spatial;\nSELECT codigo_comuna, nombre_comuna, ST_Area(geometry) AS area\nFROM 'data/normalized/geometria_comunal.parquet'\nORDER BY area DESC;", "cli": "chile-hub show geometria_comunal" }, "documentation": "docs/datasets/geometria_comunal.md" }, "delincuencia_comunal": { "description": "DEPRECATED 2026-09-15: Casos policiales de Delitos de Mayor Connotación Social (DMCS) y otras categorías por comuna y mes. Sin fuente estructurada oficial (solo scraping frágil) y no redistribuible; extractor neutralizado y fuera del scrape mensual. Ver docs/datasets/delincuencia_comunal.md.", "join_keys": [ "codigo_comuna" ], "confidence_tier": "Tier C", "extractor": "src/extractors/cead_delincuencia_live_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "public-api-review-terms", "license": "Sin licencia explícita. Datos públicos agregados de la SPD.", "license_url": "https://cead.minsegpublica.gob.cl/estadisticas-delictuales/", "attribution_required": true, "redistribution_ok": false, "summary": "Casos policiales por comuna desde CEAD. Carril CANDIDATE — NO redistribuible en el bundle público." }, "freshness_policy": { "max_age_hours": 2160, "label": "mensual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"delincuencia_comunal\")\n# Casos de robos violentos por comuna en 2024\nrobos = df.filter(pl.col(\"familia_delito\") == \"robos_violentos\")", "duckdb": "SELECT codigo_comuna, nombre_comuna, mes, casos\nFROM 'data/normalized/delincuencia_comunal.parquet'\nWHERE familia_delito = 'robos_violentos' AND anio = 2024\nORDER BY casos DESC;", "cli": "chile-hub show delincuencia_comunal" }, "documentation": "docs/datasets/delincuencia_comunal.md" }, "partidos_politicos": { "description": "Roster de partidos políticos de Chile (Cámara de Diputadas y Diputados), con estado_legal y fecha_constitucion completados por join de nombre contra el registro público de SERVEL.", "join_keys": [ "id_partido" ], "confidence_tier": "Tier B", "extractor": "src/extractors/partidos_politicos_extractor.py", "expected_record_count": 36, "reuse_policy": { "status": "open-attribution", "license": "CC-BY", "license_url": "https://creativecommons.org/licenses/by/4.0/", "attribution_required": true, "redistribution_ok": true, "summary": "Roster institucional de partidos políticos (Cámara de Diputadas y Diputados), enriquecido con estado legal y fecha de constitución desde SERVEL. ambito (nacional/regional) queda nullable: no se encontró esa señal en ninguna fuente." }, "freshness_policy": { "max_age_hours": 87600, "label": "bajo_demanda" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"partidos_politicos\")\n# Partidos con estado legal constituido\nconstituidos = df.filter(pl.col(\"estado_legal\") == \"constituido\")", "duckdb": "SELECT nombre, sigla, estado_legal, fecha_constitucion\nFROM 'data/normalized/partidos_politicos.parquet'\nWHERE estado_legal = 'constituido'\nORDER BY fecha_constitucion;", "cli": "chile-hub show partidos_politicos" }, "outputs": { "parquet": "data/normalized/partidos_politicos.parquet", "json": "data/normalized/partidos_politicos.json" }, "documentation": "docs/datasets/partidos_politicos.md" }, "autoridades_electas": { "description": "Autoridades electas en ejercicio de Chile (diputados y senadores): partido, distrito electoral/circunscripción senatorial, región y período de mandato.", "join_keys": [ "distrito_electoral", "circunscripcion_senatorial", "codigo_region" ], "confidence_tier": "Tier B", "extractor": "src/extractors/autoridades_electas_extractor.py", "expected_record_count": 205, "reuse_policy": { "status": "open-attribution", "license": "CC-BY", "license_url": "https://creativecommons.org/licenses/by/4.0/", "attribution_required": true, "redistribution_ok": true, "summary": "Autoridades electas en ejercicio (diputados y senadores) desde la Cámara de Diputadas y Diputados y el Senado de Chile. Gobernador_regional y alcalde viven en el dataset segregado autoridades_locales (CC-BY-SA)." }, "freshness_policy": { "max_age_hours": 87600, "label": "bajo_demanda" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"autoridades_electas\")\n# Senadores por región\nsenadores = df.filter(pl.col(\"cargo\") == \"senador\")", "duckdb": "SELECT nombre, cargo, partido, codigo_region\nFROM 'data/normalized/autoridades_electas.parquet'\nWHERE cargo = 'senador'\nORDER BY codigo_region;", "cli": "chile-hub show autoridades_electas" }, "outputs": { "parquet": "data/normalized/autoridades_electas.parquet", "json": "data/normalized/autoridades_electas.json" }, "documentation": "docs/datasets/autoridades_electas.md" }, "autoridades_locales": { "description": "Autoridades locales/subnacionales de Chile: gobernadores regionales (Wikipedia, CC-BY-SA) y alcaldes (BCN SIIT, dato público gubernamental). Wikipedia se mantiene como fuente de gobernadores y enriquecimiento opcional de periodo_inicio para alcaldes. Dataset segregado de autoridades_electas por licencia mixta.", "join_keys": [ "codigo_region", "codigo_comuna" ], "confidence_tier": "Tier B", "extractor": "src/extractors/autoridades_locales_extractor.py", "expected_record_count": 362, "reuse_policy": { "status": "open-attribution", "license": "CC BY / CC BY-SA", "license_url": "https://creativecommons.org/licenses/by-sa/4.0/", "attribution_required": true, "redistribution_ok": false, "summary": "Autoridades locales: alcaldes desde BCN SIIT (dato público gubernamental, 346/346 comunas, 100% cobertura) y gobernadores regionales desde Wikipedia (CC-BY-SA, 16 regiones). Carril CANDIDATE — NO redistribuible en el bundle público mientras los gobernadores dependan de fuente share-alike." }, "freshness_policy": { "max_age_hours": 87600, "label": "bajo_demanda" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"autoridades_locales\")\n# Alcaldes con titular identificado\nalcaldes = df.filter((pl.col(\"cargo\") == \"alcalde\") & pl.col(\"nombre\").is_not_null())", "duckdb": "SELECT nombre, cargo, codigo_comuna, codigo_region\nFROM 'data/normalized/autoridades_locales.parquet'\nWHERE cargo = 'alcalde';", "cli": "chile-hub show autoridades_locales" }, "documentation": "docs/datasets/autoridades_locales.md" }, "estadisticas_vitales": { "description": "Nacimientos y defunciones por comuna de residencia y sexo, desde los Anuarios de Estadísticas Vitales del INE (definitivos, 2010 en adelante).", "join_keys": [ "anio", "codigo_comuna" ], "confidence_tier": "Tier A", "extractor": "src/extractors/estadisticas_vitales_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "open-attribution", "license": "CC BY 4.0", "license_url": "https://www.ine.gob.cl/terminos-de-uso", "attribution_required": true, "redistribution_ok": true, "summary": "Anuarios de Estadísticas Vitales del INE (nacimientos y defunciones por comuna). Datos abiertos con atribución requerida." }, "freshness_policy": { "max_age_hours": 8760, "label": "anual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"estadisticas_vitales\")\n# Nacimientos por comuna 2023\nnac_2023 = df.filter((pl.col(\"anio\") == 2023) & (pl.col(\"evento\") == \"nacimiento\"))", "duckdb": "SELECT anio, codigo_comuna, sum(cantidad) AS hechos\nFROM 'data/normalized/estadisticas_vitales.parquet'\nWHERE evento = 'nacimiento'\nGROUP BY 1, 2 ORDER BY 1, 3 DESC;", "cli": "chile-hub show estadisticas_vitales" }, "outputs": { "parquet": "data/normalized/estadisticas_vitales.parquet", "json": "data/normalized/estadisticas_vitales.json", "duckdb_table": "estadisticas_vitales", "sqlite_table": "estadisticas_vitales", "excel_sheet": "Estadísticas Vitales" }, "documentation": "docs/datasets/estadisticas_vitales.md" }, "permisos_edificacion": { "description": "Viviendas en unidades y superficie (m2) por comuna y año —casas y departamentos— desde las estadísticas de permisos de edificación del CEDOC (MINVU), serie desde 2002.", "join_keys": [ "anio", "codigo_comuna" ], "confidence_tier": "Tier A", "extractor": "src/extractors/permisos_edificacion_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "open-attribution", "license": "Uso autorizado con cita (MINVU CEDOC)", "license_url": "https://centrodeestudios.minvu.gob.cl/repositorio/categoria/permisos-de-edificacion", "attribution_required": true, "redistribution_ok": true, "summary": "Estadísticas de permisos de edificación del CEDOC (MINVU). El Centro autoriza el uso de la información citando la fuente." }, "freshness_policy": { "max_age_hours": 1080, "label": "mensual" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"permisos_edificacion\")\n# Unidades autorizadas por comuna 2023\nunid_2023 = df.filter(pl.col(\"anio\") == 2023).sort(\"unidades_total\", descending=True)", "duckdb": "SELECT anio, codigo_comuna, unidades_total, superficie_m2_total\nFROM 'data/normalized/permisos_edificacion.parquet'\nWHERE anio = 2023 ORDER BY unidades_total DESC LIMIT 10;", "cli": "chile-hub show permisos_edificacion" }, "outputs": { "parquet": "data/normalized/permisos_edificacion.parquet", "json": "data/normalized/permisos_edificacion.json", "duckdb_table": "permisos_edificacion", "sqlite_table": "permisos_edificacion", "excel_sheet": "Permisos Edificación" }, "documentation": "docs/datasets/permisos_edificacion.md" }, "calidad_aire": { "description": "Promedios diarios de contaminantes atmosféricos (MP2.5, MP10, SO2, NO2, CO, O3) por estación de monitoreo, desde el SINCA (MMA). Cobertura parcial: ~65 comunas con estación.", "join_keys": [ "fecha", "codigo_comuna", "codigo_contaminante" ], "confidence_tier": "Tier B", "extractor": "src/extractors/calidad_aire_extractor.py", "expected_record_count": null, "reuse_policy": { "status": "public-api-review-terms", "license": "Datos públicos MMA; sin licencia explícita, citar fuente oficial", "license_url": "https://sinca.mma.gob.cl/", "attribution_required": true, "redistribution_ok": true, "summary": "Mediciones de calidad del aire del SINCA (MMA), API JSON pública. Organismo público chileno sin restricción explícita de reúso; citar fuente oficial." }, "freshness_policy": { "max_age_hours": 72, "label": "diaria" }, "usage_examples": { "python": "from chile_hub import ChileHub\n\nhub = ChileHub()\ndf = hub.load_polars(\"calidad_aire\")\n# Promedio diario de MP2.5 por comuna\ndf.filter(pl.col(\"codigo_contaminante\") == \"mp25\").sort(\"valor_promedio_diario\", descending=True)", "duckdb": "SELECT fecha, codigo_comuna, avg(valor_promedio_diario) AS mp25\nFROM 'data/normalized/calidad_aire.parquet'\nWHERE codigo_contaminante = 'mp25'\nGROUP BY 1, 2 ORDER BY 1 DESC, 3 DESC;", "cli": "chile-hub show calidad_aire" }, "outputs": { "parquet": "data/normalized/calidad_aire.parquet", "json": "data/normalized/calidad_aire.json", "duckdb_table": "calidad_aire", "sqlite_table": "calidad_aire", "excel_sheet": "Calidad Aire" }, "documentation": "docs/datasets/calidad_aire.md" } }