SoftwareMetrics - 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

Parameters

Description

Examples

Calling Sequence

HalsteadMetrics(prc, sm)

Parameters

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

Description

• 

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=Nlog[2]n   (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.

Examples

withSoftwareMetrics:

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

(1)

HalsteadMetrics'sieve','summarize'

131970.308354621.80000000021.70010945126.5550383,3,7,10,12

(2)

Examples using Maple library code

HalsteadMetrics'dsolve','`dsolve/numeric`'

Halstead's MetricsOperator/Operand Count[n,N,V,D,L,E][[n1,N1],[n2,N2]]dsolve1564022928.73169248.222222221.2594622261.41229950510548,185,108,217dsolve/numeric565277725387.63130148.51882851.1509571433.77054125910687,1145,478,1632

(3)

HalsteadMetrics'CurveFitting'

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

(4)

HalsteadMetrics'CurveFitting','summarize'

456296026145.35444172.90000000.87459008024.520531783106,76,1231,380,1729

(5)

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