Aplica exactamente una de las cuatro agregaciones del marco: ratio,
ratio_umbral, promedio o promedio_ponderado. La transición se valida
contra el grafo de transiciones_granularidad().
agregar(
medidas,
destino,
funcion = c("ratio", "ratio_umbral", "promedio", "promedio_ponderado"),
umbral = NULL,
pesos = NULL,
coleccion = NULL,
colecciones = NULL,
organizacion = NULL,
organizaciones = NULL
)Objeto medicion agregado, con una fila por objeto de destino.
Data frame producido por medir() o una agregación anterior.
Debe contener una sola métrica específica, una corrida y una granularidad.
Granularidad de destino.
Una de "ratio", "ratio_umbral", "promedio" o
"promedio_ponderado".
Umbral en [0, 1] requerido por ratio_umbral.
Vector numérico requerido por promedio_ponderado, con una
entrada por fila de medidas. Si trae nombres, se emparejan con
objeto_medible o con el nombre de la parte —el que declaró la frontera,
o el del objeto que la lista renombró— y se falla nombrando lo que sobra o
falta —igual que en indice_calidad(), también cuando un nombre sólo
difiere en su forma Unicode—, así que la misma declaración escrita en otro
orden da el mismo número. Si los nombres casan con los dos vocabularios y
reparten distinto, se rechaza: no se puede saber a cuáles se refieren. Sin
nombres se leen por posición. Con otra funcion se rechaza, como umbral
fuera de ratio_umbral: no pesarían nada y se publicarían igual.
Frontera declarada, exigida cuando destino es
"coleccion": el objeto de coleccion() o el perfil de
perfilar_coleccion(). Sin ella no se sabe sobre qué tablas se está
agregando, y el número resultante no describiría nada.
Lista nombrada de objetos de coleccion() o
perfilar_coleccion(), exigida cuando destino es
"conjuntoColecciones". Los nombres declaran la identidad y la frontera
del conjunto, y mandan sobre el del objeto, que la sigue reconociendo; no
se agregan organizaciones ni otros alcances implícitos.
Frontera institucional declarada con organizacion(),
exigida cuando destino es "organizacion". Qué bases pertenecen a un
organismo no está en los datos, así que lo declara quien lo sabe.
Lista de objetos de organizacion(), exigida cuando
destino es "conjuntoOrganizaciones".
Los dos niveles institucionales son opcionales: un análisis de calidad
no siempre tiene una organización detrás —una entrega suelta, un archivo
que alguien mandó, una base sin dueño declarado—, y nada obliga a pasar por
ellos. Existen para quien los necesita, y sin declaración agregar() se
niega y explica cómo declararla, que es distinto de inventar una frontera
que nadie nombró.
Una agregación hereda lo que sus partes declararon: configuracion_modelo,
configuracion_aplicabilidad, cobertura_metricas, marco_calidad y
fecha_declarada viajan en el objeto. Lo último no es decorativo: sin
fecha_declarada, la guarda que impide comparar dos entregas en orden
invertido queda desactivada y comparar_evaluaciones() publicaría el delta
con el signo al revés.
alcance_medidas —«midió tres celdas de cuatro»— también viaja, pero
reexpresado en la clave del agregado: la tabla que publica medir() está
indexada por metrica_instanciada ([email protected]) y el agregado renombra la
métrica (agregada:ratio:Formato), así que arrastrarla tal cual dejaría una
declaración que no se podría atribuir a ninguna fila. Los conteos se
suman por objeto de destino, y sólo cuando todas las partes declaran la
misma
unidad; si no, la fila declara la mezcla en lugar de publicar un total que no
estaría en ninguna unidad. Las partes completas también suman —una
columna de 6 de 6 junto a una de 5 de 6 da 11 de 12—, también cuando se
agregaron por separado y se unieron con rbind(); y en un destino por
fila (instanciaEntidad) cada fila cuenta sus propias celdas: se declaran
sólo las incompletas, con su número de fila en el motivo.
Una medida repetida —el mismo id_medida dos veces, como deja una medición
unida consigo misma— se rechaza, como en evaluar(). El id_medida de cada
fila agregada nombra lo que agrega —destino, función, métrica y objeto, como
[email protected]—, así que dos partes agregadas por separado
se pueden unir y subir de nivel, y el mismo agregado repetido sigue
repitiendo su identificador. Cada nombre lleva escapados los signos que lo
separan del siguiente —el punto, la coma—, y desde la colección para arriba
el identificador nombra también las partes que reúne: dos conjuntos
distintos, o dos colecciones sin nombre, no comparten identificador. Un valor que no se
puede agregar se rechaza nombrando la métrica y la causa: un tipo no
acotado, una medida ausente o suprimida, o un valor fuera de [0, 1].
Cuando el origen es una instancia de entidad y el destino es una entidad,
el nombre de la métrica agregada conserva también la instancia completa,
incluida la entidad y sus atributos: agregada:ratio:[email protected].
Eso mantiene separadas dos claves distintas de la misma tabla.
umbral sólo se acepta con ratio_umbral, y el borde se compara con
tolerancia de redondeo: 1 - 0.9 alcanza el umbral 0.1.
Las coberturas de frontera (cobertura_coleccion y sus hermanas) no se
arrastran: cada agregación calcula la de su propio destino con las partes que
entraron a ese número, y hereda las de sus partes en cobertura_de_partes.
Dos partes agregadas por separado y unidas con rbind() conservan cada una
la suya, en cualquier orden de la unión, y el tablero, el índice, el
informe, evaluar() e historico_calidad() las publican todas. Unidas
dos corridas distintas, cada cobertura lleva además su id_medicion, y el
histórico registra la parte no medida en la corrida a la que le faltó. Una
colección lleva en cobertura_metricas sólo la de sus propias tablas.
Cuando hay pesos, el objeto los publica en pesos_declarados, con el nombre
de la parte que recibió cada uno, de modo que el número se pueda rehacer con
lo que el objeto trae. Y si alguna parte entró con peso cero, se declara en
partes_con_peso_cero: entró al número sin aportarle nada, queda contada en
la identidad de la fila y leerlo sin saberlo es leer otra cosa. La
declaración depende de que haya un peso cero, no del destino: va como
atributo en todos, también en conjuntoEntidades, y en los cuatro destinos
que tienen cobertura de frontera entra además en esa cobertura, que es la
que se imprime.
Cuando el destino es conjuntoEntidades, promedio combina las partes sin
pesos porque las medidas de nivel entidad no llevan su cantidad de filas.
El resultado lo declara en advertencia_agregacion: es un promedio sin pesos
y agregar() no conoce el alcance de cada parte. En coleccion, la frontera
se declara y por eso sólo se admite promedio_ponderado: sin pesos no se
puede decidir cuanto debe aportar cada tabla de esa coleccion.
No existe una transición hacia factor, dimensión o modelo: esos campos son taxonómicos y esta función no calcula un índice global.
ratio sólo acepta medidas booleanas. ratio_umbral sólo acepta medidas
reales. Los promedios aceptan esos dos tipos y ningún otro, y siempre
producen resultado real en [0, 1]. Los tres tipos no acotados
—numero_real, entero y duracion— se rechazan nombrando la métrica que
los declara: el promedio de una duración en días es un número de días, y
publicarlo como resultado real en [0, 1] lo presentaría como una
proporción. La guarda es por tipo declarado, no por el valor observado:
una duración de 0,25 y 0,75 días se rechaza igual que una de 1,5 días,
así que el mismo modelo se comporta igual con cualquier dato que le toque.
Para el promedio ponderado, los pesos deben estar en
[0, 1] y sumar uno dentro de cada objeto de destino. La columna
orientacion se conserva sin invertir el resultado: un ratio de una métrica
de defecto sigue siendo la proporción de defectos.
nucleo <- metricas_nucleo()
especifica <- especializar(nucleo$NoNulo)
instancia <- instanciar(especifica, "personas", "edad")
medidas <- medir(modelo(instancia), data.frame(edad = c(20, NA, 35)))
agregar(medidas, "atributo", "ratio")
Run the code above in your browser using DataLab