compute Halstead's software science metrics - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Programming : Packages : SoftwareMetrics Package : SoftwareMetrics/HalsteadMetrics

SoftwareMetrics[HalsteadMetrics] - compute Halstead's software science metrics

Calling Sequence

HalsteadMetrics(prc, sm)




Maple procedure, module, or list of procedures or modules



(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=Nlog2n   (quantifies the total size of a given procedure)


Program Difficulty: D=12n1N2n2   (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=DV   (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.



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;
end proc:


Halstead's MetricsOperator/Operand Count[n,N,V,D,L,E][[n1,N1],[n2,N2]]sieve131970.308354621.80000000021.70010945126.55503833,7,10,12





Examples using Maple library code


Halstead's MetricsOperator/Operand Count[n,N,V,D,L,E][[n1,N1],[n2,N2]]dsolve1564022928.73169248.222222221.2594622261.41229950510548,185,108,217dsolve/numeric545252722970.71409134.02164501.2788647233.07857288910683,1035,462,1492



1..12 x 1..3 ArrayData Type: anythingStorage: rectangularOrder: Fortran_order





See Also

Array, interface, ProgrammingGuide/Debugging, SoftwareMetrics, type/listlist, Vector

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam