Ejecutar el análisis descriptivo completo

Es la puerta de entrada al recorrido de lupa. Construye el perfil, las distribuciones, asociaciones, diagnóstico temporal, clasificación confirmable de variables, propuesta de modelo, medición agregada, tablero, cobertura conceptual y plan de limpieza. No modifica los datos.

Usage

analizar(
  datos,
  nombre = .nombre_de_los_datos(substitute(datos)),
  fecha = Sys.time(),
  argumentos_perfil = list(),
  metadatos_variables = NULL,
  modelo_confirmado = NULL,
  propuesta_confirmada = NULL,
  marco = NULL,
  perfil_evaluacion = NULL,
  id_medicion = NULL,
  medir_propuesta = TRUE,
  conservar_detalle_medicion = FALSE,
  muestra = 1e+05,
  muestra_asociacion = 10000,
  max_valores = 20L,
  probabilidades = c(0, 0.25, 0.5, 0.75, 1),
  umbral_asociacion = 0.3,
  max_columnas_asociacion = 50L,
  max_niveles_asociacion = 50L,
  max_pares_asociacion = 500L,
  metodo_asociacion_numerica = c("pearson", "spearman"),
  calendario = 1:7,
  frecuencia_dias = NULL,
  max_huecos = 20L,
  max_columnas_temporales = 50L,
  conservar_datos = FALSE,
  proteger_datos_personales = TRUE,
  ...
)

Arguments

datos

Tabla que se desea analizar.

nombre

Nombre de la entrega.

fecha

Fecha y hora reproducible de la corrida.

argumentos_perfil

Lista de argumentos adicionales para perfilar().

metadatos_variables

Declaraciones para clasificar_variables().

modelo_confirmado

Modelo creado por modelo() o NULL.

propuesta_confirmada

Propuesta editada por el usuario o NULL.

marco

Taxonomía opcional creada por marco_calidad(). Si se omite, usa la asociada a modelo_confirmado y, en último término, marco_agesic().

perfil_evaluacion

Perfil explícito para evaluar() o NULL.

id_medicion

Identificador opcional enviado a medir(). Si argumentos_perfil declara aplicabilidad, esa misma declaración viaja a la medición: el universo se declara una vez y gobierna todo el análisis, así que el perfil y el tablero cuentan el mismo dato de la misma manera.

medir_propuesta

Si se mide automáticamente la propuesta en estado "lista" cuando no se recibe un modelo o una propuesta confirmada. Use FALSE para conservar el comportamiento descriptivo anterior.

conservar_detalle_medicion

Si se retienen las medidas fila a fila. Es FALSE por omisión: el tablero y la medición agregada permanecen, y la medición se hace métrica por métrica, agregando cada una antes de pasar a la siguiente, así que el detalle entero no existe nunca a la vez. Con TRUE el detalle es parte del resultado y su memoria crece con las filas por las métricas: una tabla de 19 columnas producía 21 filas de medida por fila de datos. Si ninguna métrica del modelo produce medidas, el tablero sale vacío y lleva el motivo de cada una en cobertura_metricas, en lugar de abortar el análisis.

muestra

Límite de filas para perfil, distribuciones y enumeración de niveles observados.

muestra_asociacion

Límite común de filas para asociaciones.

max_valores

Máximo de valores por tabla de frecuencias.

probabilidades

Cuantiles solicitados.

umbral_asociacion

Asociación mínima informada.

max_columnas_asociacion

Máximo de columnas para asociaciones.

max_niveles_asociacion

Máximo de niveles categóricos.

max_pares_asociacion

Máximo de pares devueltos.

metodo_asociacion_numerica

Medida entre columnas numéricas que usa detectar_asociaciones(): "pearson" por omisión, o "spearman" para asociación monótona sobre los rangos, que no supone linealidad.

calendario

Días ISO usados por el análisis temporal.

frecuencia_dias

Frecuencia temporal conocida o NULL para proponerla.

max_huecos

Máximo de grupos de huecos por columna.

max_columnas_temporales

Máximo de columnas temporales analizadas.

conservar_datos

Si el objeto retiene una copia de la entrada. Es FALSE por omisión para limitar tamaño y exposición. Con protección activa, las columnas personales de esa copia también se enmascaran; para conservar sus valores debe usarse proteger_datos_personales = FALSE al crear el analisis y al guardarlo. La opcion del guardado no recupera valores que el analisis ya enmascaro.

proteger_datos_personales

Si perfiles y resúmenes ocultan valores de columnas cuya clasificación activa protección automática, incluidos estadísticos de orden, cuantiles y rangos temporales.

...

Argumentos con nombre enviados a perfilar(). Es una alternativa concisa a argumentos_perfil.

Value

Objeto S3 analisis con todos los componentes y su cobertura.

Dos diferencias respecto de llamar a las funciones sueltas, y las dos son deliberadas. La entrada puede ser una matriz de dos dimensiones: se la pasa a perfilar() sin convertir, para que sea él quien la convierta y lo declare en meta$entrada_convertida. Y cuando una columna temporal pertenece a una columna protegida, temporal$resumen gana la columna proteccion_temporal con el texto [rangos y huecos protegidos]: la protección se aplica y se declara en la misma tabla donde faltan los valores. La llamada directa a analizar_tiempo() respeta la misma declaración cuando recibe ese perfil.

Details

Por omisión mide todas las sugerencias de la propuesta cuyo estado es "lista", aunque no estuvieran activas, y declara que esa selección fue realizada por lupa sin confirmación. Agrega inmediatamente el detalle y conserva tablero_calidad(); las medidas fila a fila sólo quedan en el resultado si conservar_detalle_medicion = TRUE. La evaluación, cuando se solicita, usa la medición agregada. Los hallazgos casi_clave del perfil se reiteran en advertencias, con su columna, valores en colisión, frecuencias y criterio observado, para que no queden ocultos dentro del recorrido integral.

See also

guardar_analisis(), reportar(), cobertura_analisis()

Examples

resultado <- analizar(
  datos_administrativos, analizar_dependencias = FALSE,
  fecha = as.POSIXct("2026-01-15", tz = "UTC")
)
resultado
#> 
#> ── Analisis de datos: datos_administrativos ────────────────────────────────────
#> Filas: 13
#> Columnas: 10
#> Hallazgos del perfil: 22
#> Advertencias de alcance: 2
#> Asociaciones informadas: 4
#> Series temporales: 1
#> Modelo medido: si
#> Detalle fila a fila: no conservado
#> 
#> ── Tablero de calidad ──
#> 
#> ── Tablero de calidad ──────────────────────────────────────────────────────────
#>       componente    dimension                 factor
#>  componente-0001     Unicidad         No-duplicación
#>  componente-0002  Completitud               Densidad
#>  componente-0003  Completitud               Densidad
#>  componente-0004  Completitud               Densidad
#>  componente-0005  Completitud               Densidad
#>  componente-0006    Exactitud Correctitud sintáctica
#>  componente-0007    Exactitud Correctitud sintáctica
#>  componente-0008    Exactitud Correctitud sintáctica
#>  componente-0009    Exactitud Correctitud sintáctica
#>  componente-0010    Exactitud Correctitud sintáctica
#>  componente-0011 Consistencia  Integridad de dominio
#>                      metrica metrica_instanciada               entidad
#>             EntidadDuplicada     sugerencia-0001 datos_administrativos
#>                       NoNulo     sugerencia-0002 datos_administrativos
#>                       NoNulo     sugerencia-0003 datos_administrativos
#>                       NoNulo     sugerencia-0004 datos_administrativos
#>                       NoNulo     sugerencia-0005 datos_administrativos
#>                      Formato     sugerencia-0006 datos_administrativos
#>                      Formato     sugerencia-0007 datos_administrativos
#>                      Formato     sugerencia-0008 datos_administrativos
#>                      Formato     sugerencia-0009 datos_administrativos
#>                      Formato     sugerencia-0010 datos_administrativos
#>  ValoresPosiblesPorExtension     sugerencia-0011 datos_administrativos
#>            objeto     valor orientacion agregacion umbral universo
#>           (tabla) 0.1538462     defecto      ratio     NA    filas
#>            cedula 1.0000000 conformidad      ratio     NA   celdas
#>  fecha_nacimiento 1.0000000 conformidad      ratio     NA   celdas
#>           ingreso 1.0000000 conformidad      ratio     NA   celdas
#>              sexo 1.0000000 conformidad      ratio     NA   celdas
#>            correo 0.8461538 conformidad      ratio     NA   celdas
#>      departamento 0.9230769 conformidad      ratio     NA   celdas
#>        id_tramite 1.0000000 conformidad      ratio     NA   celdas
#>              pais 1.0000000 conformidad      ratio     NA   celdas
#>              sexo 0.8461538 conformidad      ratio     NA   celdas
#>              sexo 1.0000000 conformidad      ratio     NA   celdas
#> 
#> ── Alcance del marco ──
#> 
#>  factores_marco factores_medidos sin_metrica_declarada no_aplican
#>              17                4                     8          4
#>  fuera_de_alcance medidos_fuera_del_marco
#>                 1                       0
#> ── Cobertura conceptual ──
#> 
#>            estado factores
#>            medida        4
#>      no_declarada        8
#>         no_aplica        4
#>  fuera_de_alcance        1
#> ── Advertencias de alcance ──
#> 
#>  componente                     tipo
#>      tiempo frecuencia_no_confirmada
#>   variables   escalas_no_confirmadas
#>                                                                       descripcion
#>  Las frecuencias temporales son propuestas observadas, no requisitos confirmados.
#>        Algunas escalas se propusieron desde los valores y requieren confirmacion.