τTau SolutionsReferencia

Mapa de relaciones entre métricas

Actualizado el 15 de noviembre de 2026

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 (n1n_1), operandos distintos (n2n_2) y sus apariciones (N1N_1, N2N_2). Todo lo demás se calcula con ellos.

n1: operadoresdistintosn = n1 + n2n2: operandosdistintosN1: aparicionesde operadoresN = N1 + N2N2: aparicionesde operandosV = N · log2 nD = n1/2 · N2/n2E = D · VB = E^(2/3) /3000T = E / 18MI, con v(G) yLOC

En texto: el «vocabulario» es n=n1+n2n = n_1 + n_2 y la «longitud», N=N1+N2N = N_1 + N_2. El «volumen» es V=Nlog⁡2nV = N \log_2 n. La «dificultad» es D=n12⋅N2n2D = \frac{n_1}{2} \cdot \frac{N_2}{n_2}. El «esfuerzo» es E=D⋅VE = D \cdot V. De él salen los «errores estimados», B=E2/3/3000B = E^{2/3} / 3000, y el «tiempo de programación», T=E/18T = E / 18.

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, V/3000V / 3000. 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 calcula T.

Las métricas de paquetes de Martin

Las «métricas de Martin» forman una cadena corta.

Ca: clases defuera que usanel paqueteI = Ce / (Ca +Ce)Ce: clases delpaquete queusan otras defueraclasesabstractas einterfacesA = Na / Ncclases delpaqueteD = |A + I - 1|

La «inestabilidad» sale de los «acoplamientos aferentes» y «eferentes»:

I=CeCa+CeI = \frac{C_e}{C_a + C_e}

La «abstracción» es A=Na/NcA = N_a / N_c, las clases abstractas e interfaces entre el total de clases del paquete. La «distancia a la secuencia principal» combina las dos:

D=∣A+I−1∣D = |A + I - 1|

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 D de Martin y la D de 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.

sumaentre el número demétodossumamediamáximotérmino Vv(G) de cadamétodov(G)tot:paquete,módulo,proyectov(G)avg:paquete,módulo,proyectorecuento declase: sin &&, ||ni catchWMC: claseOCavg: claseOCmax: claseQCP_CRCT,QCP_MAINT,QCP_RLBTY:método

En texto:

  • «v(G)tot» suma la v(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 de v(G). Las dos usan el mismo recuento que v(G).
  • «WMC» es ∑ci\sum c_i sobre los métodos de la clase. Chidamber y Kemerer dejaron sin definir cic_i; la lectura más extendida es la ciclomática, y con ci=1c_i = 1 es un recuento de métodos. «OCavg» es la media y «OCmax» el máximo de los mismos valores.
  • En Stau Metro, WMC, OCavg, OCmax y el término V de los perfiles QCP usan un recuento que no incluye &&, || ni catch. Por eso el WMC de una clase puede ser menor que la suma de la v(G) de sus métodos, y la suma de los WMC de un paquete no coincide con su v(G)tot. Además, un método native suma 1 en WMC y no entra en OCavg, así que OCavg no es exactamente WMC entre el número de métodos cuando hay métodos native.

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» =D+CONTROL+EXEC+2V= D + CONTROL + EXEC + 2V, «QCP_MAINT» =3N+EXEC+CONTROL+NEST+2V+BRANCH= 3N + EXEC + CONTROL + NEST + 2V + BRANCH y «QCP_RLBTY» =N+2⋅NEST+3V+BRANCH+CONTROL+EXEC= N + 2 \cdot NEST + 3V + BRANCH + CONTROL + EXEC. D y N son las de Halstead; NEST se parece a NBD, 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 LOC de un método cuenta sus líneas; el de un paquete suma ficheros enteros. PDcy y PDpt tienen versión de clase y de paquete con la misma sigla.
  • No siempre se suma. El Ce de un paquete no es la suma de los Dcy de sus clases: cuenta clases del paquete que dependen de fuera, una vez cada una. Y Ca y Ce cuentan clases, mientras que PDpt y PDcy cuentan paquetes, que es lo que JDepend llama Ca y Ce.
  • 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 (OCavg y OCmax, OSavg y OSmax). 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 210=10242^{10} = 1024 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

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 con NCLOC;
  • «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, B y los perfiles QCP;
  • «CogC»: los métodos largos tienden a sumar más;
  • «LCOM1 y LCOM2», cuya escala fija el número de pares, n(n−1)/2n(n-1)/2, 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.