vigencia() reúne el contrato temporal que las métricas de actualidad y
oportunidad no pueden inferir de los datos: columna de actualización,
fecha de acceso, último cambio conocido, fecha límite, intervalo y frecuencia
esperada. Cada métrica valida los campos que necesita y se abstiene si faltan:
declara en cobertura_metricas cuál falta y cómo declararlo, en lugar de
abortar la medición de las demás métricas.
vigencia(
columna_actualizacion,
fecha_acceso = Sys.time(),
fecha_ultimo_cambio = NULL,
fecha_limite = NULL,
inicio_intervalo = NULL,
fin_intervalo = NULL,
frecuencia_cambio = NULL
)escala(error, tipo = c("absoluto", "relativo"))
vigencia() devuelve un objeto vigencia_datos; escala() devuelve
un objeto escala_medicion. Ambos son contratos de configuración y no
examinan datos.
Nombre de la columna Date o POSIXt que registra la última actualización de cada fila.
Momento de acceso usado para estimar actualidad. De la
misma clase que la columna de actualización: con una columna Date,
Sys.Date() en lugar del Sys.time() por omisión.
Fecha conocida del último cambio en el mundo real; puede ser escalar o tener una entrada por fila.
Fecha límite escalar o por fila para oportunidad.
Extremos del intervalo de vigencia.
Frecuencia esperada como difftime o número de días.
Error no negativo escalar, vectorial o función del valor.
Interpretación "absoluto" o "relativo" del error.
Las dos puntas de cada comparación tienen que ser de la misma clase. Un
Date se ancla a la medianoche UTC y un POSIXct vale por su instante, así
que mezclarlos puede hacer contar como tarde una actualización del día del
límite, y si el POSIXct se leyó sin huso el resultado depende de la sesión.
Cuando una métrica compara clases distintas lo avisa. Como fecha_acceso vale
Sys.time() por omisión, con una columna Date conviene declararlo también
como Date: fecha_acceso = Sys.Date().
escala() declara el error de un instrumento o de otra escala experta. Con
error absoluto, Escala calcula 1 - error / abs(valor) y acota el resultado
a [0, 1]; con error relativo calcula 1 - error. No se aprende el error de
la distribución observada.
metricas_nucleo(), especializar(), cobertura_analisis()
contrato <- vigencia(
"actualizado", fecha_limite = as.Date("2026-02-01"),
frecuencia_cambio = 30, fecha_acceso = as.Date("2026-02-15")
)
instrumento <- escala(error = 0.5, tipo = "absoluto")
Run the code above in your browser using DataLab