Mapa de relaciones entre métricas
Muchas métricas no son independientes. Unas se calculan a partir de otras, otras repiten la misma idea en un nivel distinto, otras se leen por parejas y otras compiten por responder a la misma pregunta. Saberlo evita dos errores comunes: sumar como evidencias distintas dos números que dicen lo mismo, y comparar valores que se parecen por el nombre pero no por la definición.
Esta página ordena esas relaciones en cinco tipos:
| Tipo de relación | Qué quiere decir | Ejemplo |
|---|---|---|
| Derivación | Una métrica sale de otras con una fórmula | I se calcula con Ca y Ce |
| Misma idea, otro nivel | La pregunta es la misma; cambia el elemento medido | Dcy (clase) y Ce (paquete) |
| Complementarias y duales | Dos caras de una misma relación, o dos partes de un total | CALL y CALLED |
| Alternativas | Responden a la misma pregunta con definiciones distintas | v(G), CogC y NPath |
| Ligadas al tamaño | Crecen casi siempre con el tamaño del elemento | WMC, RFC, V |
Cada relación se resume en una línea y enlaza a la página de la métrica, que tiene la definición completa. Las fórmulas son las de esas páginas; cuando Stau Metro se aparta de la definición general, se indica.
Derivaciones
La cadena de Halstead
Las «medidas de Halstead» parten de cuatro recuentos: operadores distintos (), operandos distintos () y sus apariciones (, ). Todo lo demás se calcula con ellos.
En texto: el «vocabulario» es y la «longitud», . El «volumen» es . La «dificultad» es . El «esfuerzo» es . De él salen los «errores estimados», , y el «tiempo de programación», .
Dos consecuencias prácticas. E, B y T ordenan los métodos igual: son la misma información con otra escala.
Y todas heredan las reglas de qué es operador y qué es operando, que cambian de una herramienta a otra; por eso dos
herramientas casi nunca dan la misma longitud para el mismo código.
Ojo. Hay una segunda fórmula de
B, . Stau Metro usa la que parte del esfuerzo; otras herramientas usan la del volumen. Dan valores del mismo orden, pero no son la misma medida. Stau Metro no calculaT.
Las métricas de paquetes de Martin
Las «métricas de Martin» forman una cadena corta.
La «inestabilidad» sale de los «acoplamientos aferentes» y «eferentes»:
La «abstracción» es , las clases abstractas e interfaces entre el total de clases del paquete. La «distancia a la secuencia principal» combina las dos:
Como D depende de I, no está definida en un paquete sin acoplamientos; A solo necesita que tenga clases. Una
misma D puede venir de la zona de dolor o de la de inutilidad; para saber cuál, hay que mirar A e I por separado.
Nota. La
Dde Martin y laDde Halstead comparten sigla y nada más.
Agregados de la complejidad ciclomática
La «complejidad ciclomática» de los métodos se agrega en dos familias de métricas. En Stau Metro usan recuentos distintos, y eso importa al comparar.
En texto:
- «
v(G)tot» suma lav(G)de los métodos de un paquete, módulo o proyecto, y «v(G)avg» es ese total entre el número de métodos con valor dev(G). Las dos usan el mismo recuento quev(G). - «
WMC» es sobre los métodos de la clase. Chidamber y Kemerer dejaron sin definir ; la lectura más extendida es la ciclomática, y con es un recuento de métodos. «OCavg» es la media y «OCmax» el máximo de los mismos valores. - En Stau Metro,
WMC,OCavg,OCmaxy el términoVde los perfiles QCP usan un recuento que no incluye&&,||nicatch. Por eso elWMCde una clase puede ser menor que la suma de lav(G)de sus métodos, y la suma de losWMCde un paquete no coincide con suv(G)tot. Además, un métodonativesuma 1 enWMCy no entra enOCavg, así queOCavgno es exactamenteWMCentre el número de métodos cuando hay métodosnative.
El mismo esquema de media y máximo se repite con otras medidas por método:
«OSavg» y «OSmax» con el
«número de sentencias» (STAT), y
«OPavg» con el
«número de parámetros» (NP).
Proporciones
Las proporciones dividen un recuento entre otro. Lo que conviene mirar en cada una es el denominador, porque es donde las herramientas difieren.
| Métrica | Numerador | Denominador |
|---|---|---|
«COM_RAT» |
CLOC, líneas con comentario |
LOC, líneas no vacías |
«TCOM_RAT» |
líneas de comentario puro | líneas con código (NCLOC en método, clase e interfaz) |
«TEST_RAT» |
LOCt |
LOCt + LOCp |
«CDENS» |
CONTROL |
sentencias del método (cercano a STAT) |
«RLOC» |
LOC del método |
LOC de su clase, sin sus clases anidadas |
Las líneas de comentario puro son LOC - NCLOC; «CLOC» no
coincide con esa diferencia, porque cuenta también las líneas que mezclan código y comentario. El denominador marca
el techo: el de COM_RAT incluye los comentarios, así que casi nunca pasa de 100 %; el de TCOM_RAT los deja
fuera, y puede pasar. TEST_RAT es una fracción del total, no el cociente test entre producción: un 50 % es una
línea de test por cada una de producción.
Las proporciones del «grupo MOOD» siguen la misma lógica a escala de proyecto:
«MHF» y
«AHF» aplican la misma fórmula a métodos y campos;
«MIF» divide los métodos heredados entre los disponibles; el
numerador de «PF» es la suma de las
«operaciones sobrescritas» (NOOC) de cada clase; y en Stau Metro
el numerador de «CF» es la suma de los
«Dcy» sin las dependencias hacia antepasados ni fuera del ámbito.
Sumas, uniones y particiones
| Relación | Dónde se explica |
|---|---|
CSOA = CSO + CSA |
«tamaño de la clase (operaciones + atributos)» |
CSA = NAAC + NAIC en Stau Metro |
«número de atributos añadidos» |
NOAC + NOOC = métodos no abstractos declarados, sin constructores |
«operaciones sobrescritas» |
AC + CC + EC + IC = C |
«número de clases» |
CBO = unión de dependencias y dependientes |
«acoplamiento entre objetos» |
Cyclic = tamaño de la componente fuertemente conexa menos 1 |
«dependencias cíclicas» |
Level* = Level si el grafo no tiene ciclos |
«orden de nivel ajustado» |
SUB - NOC = descendientes indirectos |
«número de hijos» |
suma de Dcy* = suma de Dpt* sobre un mismo grafo |
«dependencia acumulada de componentes» |
Algunas relaciones son cotas, no igualdades: IF_NEST y LOOP_NEST nunca superan
«NBD»; v(G) es la cota superior de
«ev(G)» y de
«iv(G)»; PDcy* nunca es menor que
«PDcy».
Métricas compuestas
Dos familias combinan varias métricas con pesos fijos.
- El «índice de mantenibilidad» (
MI) combina el volumen de Halstead (el esfuerzo, en la versión original), la complejidad ciclomática y las líneas de código, con un término opcional de comentarios. Stau Metro no lo calcula. - Los perfiles QCP combinan recuentos de método:
«
QCP_CRCT» , «QCP_MAINT» y «QCP_RLBTY» .DyNson las de Halstead;NESTse parece aNBD, pero con otra regla para lambdas y clases internas.
Una compuesta no aporta información que no esté en sus ingredientes. Cuando una sale mala, mira qué ingrediente la mueve.
La misma idea en otro nivel
Muchas preguntas se hacen a varios niveles. La tabla sigue cada una de método a proyecto; una celda vacía quiere decir que no hay métrica de ese nivel.
| Pregunta | Método | Clase o interfaz | Paquete | Módulo y proyecto |
|---|---|---|---|---|
| ¿Cuántas líneas? | «LOC», «NCLOC» |
«LOC», «NCLOC» |
«LOC», «NCLOC» |
ídem |
| ¿Cuántas decisiones? | «v(G)» |
WMC, OCavg, OCmax |
v(G)tot, v(G)avg |
ídem |
| ¿De qué depende? | «CALL» |
«Dcy», «PDcy», «MPC», «RFC» |
«Ce», «PDcy» |
|
| ¿Quién depende de él? | «CALLED» |
«Dpt», «PDpt» |
«Ca», «PDpt» |
|
| ¿Hasta dónde llega? | «Dcy*», «Dpt*» |
«PDcy*», «PDpt*» |
||
| ¿Cuánto acoplamiento en total? | «CBO» («interfaz») |
«CF» (proyecto) |
||
| ¿Ciclos y capas? | «Cyclic», «Level», «Level*» |
ídem | ||
| ¿Forma una unidad? | «LCOM» |
«H» |
||
| ¿Cuánto oculta? | «E_RAT» |
E_RAT (módulo), AHF, MHF (proyecto) |
||
| ¿Cuántas sobrescrituras? | «OVER» |
«NOOC» |
«PF» (proyecto) |
|
| ¿Cuánto hereda? | «NOIC», «NAIC» |
«MIF», «AIF» (proyecto) |
Tres avisos al subir de nivel:
- El mismo nombre no es la misma regla. El
LOCde un método cuenta sus líneas; el de un paquete suma ficheros enteros.PDcyyPDpttienen versión de clase y de paquete con la misma sigla. - No siempre se suma. El
Cede un paquete no es la suma de losDcyde sus clases: cuenta clases del paquete que dependen de fuera, una vez cada una. YCayCecuentan clases, mientras quePDptyPDcycuentan paquetes, que es lo que JDepend llamaCayCe. - Las medias esconden. Al pasar de método a clase o a paquete, la media pierde los extremos; por eso algunas
medias tienen su máximo al lado (
OCavgyOCmax,OSavgyOSmax). La página de «agregación» trata el problema en general.
Complementarias y duales
Son pares que se leen juntos porque cada uno ve una cara de la misma relación, o porque reparten un total.
| Par | Relación |
|---|---|
Dcy y Dpt; Ce y Ca; PDcy y PDpt |
Las dos direcciones de una dependencia, en clase y en paquete |
Dcy* y Dpt*; PDcy* y PDpt* |
Las mismas direcciones, a cualquier distancia |
«CALL» y «CALLED» |
Las llamadas que hace un método y las que recibe |
«CALLEDp» y «CALLEDt» |
CALLED separado por el origen de la llamada |
«CAUGHT» y «THROWS» |
Lo que el método resuelve frente a lo que deja pasar |
«NII» y «IMP» |
Interfaces que implementa una clase; clases que implementan una interfaz |
«DIT» y «NOC» |
Profundidad hacia arriba; anchura hacia abajo |
«ROOT» y «LEAF» |
Los dos extremos de las jerarquías; una hoja tiene NOC 0 |
«NOAC» y «NOOC» |
Especializar añadiendo o redefiniendo |
«NAAC» y «NAIC» |
Campos propios y heredados |
«Command» y «Query» |
Reparten los métodos de una clase sin contar constructores |
«Cp» y «Ct»; «LOCp» y «LOCt» |
Producción y test |
«AHF» y «AIF»; «MHF» y «MIF» |
Lo privado no se hereda: ocultar más limita lo heredable |
«MIF» y «PF» |
Un método sobrescrito deja de contar como heredado en MIF y suma en PF |
«v(G)» y «NBD» |
Cuántas decisiones y lo hondo que están: v(G) alta con NBD baja es lógica en fila |
«STAT» y «EXEC» |
STAT - EXEC es el esqueleto de control del método |
«JTM» y «JTA» |
Su cociente es el promedio de aserciones por test |
La lectura conjunta suele decir más que cada una. Un CBO alto puede ser una clase que usa a muchas o una que
muchas usan; Dcy y Dpt dicen cuál. Una I cercana a 0 es buena en un paquete abstracto y mala en uno concreto;
A lo decide.
Alternativas para la misma pregunta
¿Cuánto cuesta entender o probar este método?
| Métrica | Qué cuenta | Anidamiento | Crecimiento |
|---|---|---|---|
«v(G)» |
decisiones, más 1 | no lo ve | aditivo: una decisión suma 1 |
«CogC» |
estructuras que cortan la lectura, desde 0 | cada nivel suma | aditivo, con peso por nivel |
| «NPath» | caminos completos | más anidamiento da menos caminos | multiplicativo en secuencia |
«ABC» |
asignaciones, llamadas y condiciones | no lo ve | magnitud de un vector |
Las tres primeras parten de las mismas construcciones. v(G) cuenta los caminos independientes, que acotan los
tests necesarios para cubrir las ramas; CogC estima lo que cuesta leer el método; NPath cuenta sus caminos
completos. Diez if sin else en
fila valen 11 en v(G) y en NPath. Un switch plano dispara v(G) y apenas mueve CogC. Stau
Metro calcula v(G) y CogC, no NPath ni ABC.
¿Está cohesionada esta clase?
| Variante | Qué cuenta | Escala | Dirección |
|---|---|---|---|
«LCOM1» |
pares de métodos sin campos en común | sin normalizar | más alto es peor |
«LCOM2» |
pares sin campos en común menos pares con alguno, o 0 | sin normalizar | más alto es peor |
LCOM3 |
grupos de métodos unidos por campos compartidos | número de grupos | más alto es peor |
«LCOM4» |
grupos unidos por campos o por llamadas | número de grupos | más alto es peor |
«LCOM*» (LCOM5) |
métodos que usan cada campo, normalizado | 0 a 1; hasta 2 con campos sin usar | más alto es peor |
«TCC, LCC» |
pares de métodos visibles que comparten campos, directamente (TCC) o también a través de otros métodos (LCC) |
0 a 1 | más alto es mejor |
Todas llevan el nombre LCOM o lo corrigen, y no son comparables entre sí. La numeración de esta tabla es la de
Briand, Daly y Wüst (1998); otras fuentes, como Aivosto, numeran distinto. LCOM2 es la que suele citarse como «la
LCOM de CK»; LCOM4 da una lectura directa, el número de piezas en que se puede partir la clase. Stau Metro
calcula LCOM4. Antes de aplicar un umbral publicado de «LCOM», averigua cuál de ellas mide.
Otras parejas que se confunden
- «
COM_RAT» y «TCOM_RAT»: dos ratios de comentarios con numerador y denominador distintos. - «
NP» y «NTP», y «ASSERT» y «JTA»: se confunden por el nombre y miden cosas distintas. - «
LOC», «NCLOC», «STAT», la «longitud de Halstead» y los «puntos de función»: cinco formas de medir el tamaño; las dos primeras dependen del formato, las dos siguientes no, y la última se cuenta sobre los requisitos, no sobre el código.
Las que crecen con el tamaño
Un elemento más grande tiene, casi por fuerza, más decisiones, más llamadas, más dependencias y más pares de métodos. Varias métricas heredan así buena parte de su variación del tamaño:
- «
v(G)» y su suma «v(G)tot», que se correlaciona sobre todo conNCLOC; - «
WMC», que con ponderación unitaria es un recuento de métodos; - «
RFC», que incluye los propios métodos de la clase, y «CBO»; - el «volumen» y la «longitud» de
Halstead, y con ellos
E,By los perfiles QCP; - «
CogC»: los métodos largos tienden a sumar más; - «
LCOM1yLCOM2», cuya escala fija el número de pares, , y «LCOM4»: con más métodos es más fácil que aparezcan grupos; - el «
MI», en el que las líneas de código son el término que más pesa.
La evidencia lo respalda. Shepperd (1988) concluyó que, en muchos conjuntos de datos, la complejidad ciclomática aporta poco más que las líneas de código. El Emam, Benlarbi, Goel y Rai (2001) encontraron que las métricas de Chidamber y Kemerer, y un subconjunto de las de Lorenz y Kidd, dejaban de asociarse con los fallos al controlar el tamaño de la clase. Gil y Lalouche (2017) fueron más lejos: sostienen que la validez de una métrica de código se explica en gran parte por su correlación con el tamaño. La página de «evidencia empírica» recoge el debate.
Qué hacer con esto. Lee estas métricas junto a una de tamaño (NCLOC o STAT en método, LOC o CSO en
clase) antes de concluir que algo es «complejo» o «acoplado» y no simplemente grande. Si las dos señalan lo mismo,
cuentan como una sola evidencia. Las proporciones y las métricas que no dependen del volumen (NBD, DIT, I,
A, TCC) aportan una información que el tamaño no da.
Referencias
- Briand, L. C., Daly, J. W. y Wüst, J. (1998). «A Unified Framework for Cohesion Measurement in Object-Oriented Systems». Empirical Software Engineering, 3(1), 65-117. https://doi.org/10.1023/A:1009783721306
- El Emam, K., Benlarbi, S., Goel, N. y Rai, S. N. (2001). «The Confounding Effect of Class Size on the Validity of Object-Oriented Metrics». IEEE Transactions on Software Engineering, 27(7), 630-650. https://doi.org/10.1109/32.935855
- Gil, Y. y Lalouche, G. (2017). «On the correlation between size and metric validity». Empirical Software Engineering, 22(5), 2585-2611. https://doi.org/10.1007/s10664-017-9513-5
- Shepperd, M. (1988). «A Critique of Cyclomatic Complexity as a Software Metric». Software Engineering Journal, 3(2), 30-36.