SoftwareMetrics
HalsteadMetrics
compute Halstead's software science metrics
Calling Sequence
Parameters
Description
Examples
HalsteadMetrics(prc, sm)
prc
-
Maple procedure, module, or list of procedures or modules
sm
(optional) BooleanOpt(summarize); specifies whether to return the output in a tabular format or as an expression sequence containing a row Vector and a listlist structure
The HalsteadMetrics routine computes Maurice Halstead's software science metrics for each procedure or module contained in the parameter prc. Altogether, there are six metrics, all of which are functions of the following four variables:
n1 = the number of unique operators
n2 = the number of unique operands
N1 = the total number of operators
N2 = the total number of operands
The six software science metrics include:
Vocabulary: n=n1+n2 (the total number of unique operators and operands)
Length: N=N1+N2 (the sum of all occurrences of operators and operands)
Volume: V=N⁢log2⁡n (quantifies the total size of a given procedure)
Program Difficulty: D=n1⁢N22⁢n2 (reflects the effort required to understand, code, and maintain a given procedure)
Language Level: L=VD2 (indicates how well a programmer uses features of the language)
Effort: E=D⁢V (indicates a level of program complexity in units of time that it takes to write, modify, or maintain a piece of code)
The summarize option (sm) controls how the result is returned.
If the summarize option is omitted (or is given as summarize=false), the result returned is an Array which tabulates the six Halstead metrics along with the operator/operand counts for each procedure and module contained in the parameter prc.
To force the display of large Arrays, you can increase the rtablesize setting using the interface function.
If given as summarize=true, the result returned is an expression sequence containing a row Vector and a listlist structure. The row Vector stores the six Halstead metrics and the listlist structure stores the operator/operand counts. For this case, the metrics are computed just once and take into account all procedures and modules contained in prc.
The condition summarize=true can be abbreviated as summarize.
with⁡SoftwareMetrics:
Example procedure taken from the Maple Programming Guide
sieve := proc(n::integer) local i, k, flags, count, twice_i; count := 0; for i from 2 to n do flags[i] := true end do; for i from 2 to n do if flags[i] then twice_i := 2*i; for k from twice_i by i to n do flags[k] := false end do; count := count+1; end if; end do; count; end proc:
HalsteadMetrics⁡sieve
Halstead's MetricsOperator/Operand Count[n,N,V,D,L,E][[n1,N1],[n2,N2]]sieve131970.308354621.80000000021.70010945126.55503833,7,10,12
HalsteadMetrics⁡sieve,summarize
131970.308354621.80000000021.70010945126.5550383,3,7,10,12
Examples using Maple library code
HalsteadMetrics⁡dsolve,`dsolve/numeric`
Halstead's MetricsOperator/Operand Count[n,N,V,D,L,E][[n1,N1],[n2,N2]]dsolve1624283141.45580144.038461541.619819699138344.880545,199,117,229dsolve/numeric580286526300.43954150.86991871.1554673923.967945175×10688,1178,492,1687
HalsteadMetrics⁡CurveFitting
HalsteadMetrics⁡CurveFitting,summarize
492294726353.59024174.30000000.86745112544.593430779×106,82,1204,410,1743
See Also
Array
interface
ProgrammingGuide/Debugging
type/listlist
Vector
Download Help Document