provide details about nesting depth - Maple Help

Online Help

All Products    Maple    MapleSim


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

SoftwareMetrics[NestingMetrics] - provide details about nesting depth

Calling Sequence

NestingMetrics(prc, dst, sm)

Parameters

prc

-

Maple procedure, module, or list of procedures or modules

dst

-

(optional) BooleanOpt(distinguish); specifies whether to distinguish between selection and repetition structures

sm

-

(optional) BooleanOpt(summarize); specifies whether to return the output in a tabular format or as an expression sequence containing one (or two) row Vector(s)

Description

• 

The NestingMetrics routine provides details about nesting depth of selection and repetition structures for each procedure or module contained in the parameter prc.

  

Selection structures include if statements and if operators.

  

Repetition structures include for-from and for-in statements as well as seq, $, map, add, and mul operators.

• 

The distinguish option (dst) controls how selection and repetition structures are treated with regards to nesting depth.

  

If omitted (or given as distinguish=false), no distinctions are made between selection and repetition structures, and vice-versa.

  

The condition distinguish=true can be abbreviated as distinguish.

• 

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 details of the nesting depths for each procedure and module contained in prc. Additionally, if prc contains at least two procedures (or a module with more than one export), the routine computes the total nesting depth for of all the procedures and modules combined. This total is included in the last row of the output Array.

  

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 a row Vector (when distinguish=false) or an expression sequence of two row Vectors (when distinguish=true). These row Vectors represent total nesting depth for all of the procedures and modules contained in prc.

  

Regardless of the value of summarize, the j-th element of the Vectors contained in the output represent the number of structures for the j-th nesting level.

  

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:

NestingMetrics'sieve'

sieve211

(1)

NestingMetrics'sieve','distinguish'

Selection StructuresRepetition Structuressieve121

(2)

NestingMetrics'sieve','distinguish','summarize'

1,21

(3)

Examples using Maple library code

NestingMetrics'dsolve','`dsolve/numeric`','distinguish'=false

dsolve4121162dsolve/numeric619965256341TOTAL6511176318341

(4)

NestingMetrics'dsolve','`dsolve/numeric`','distinguish'=true

Selection StructuresRepetition Structuresdsolve410948dsolve/numeric626945613735TOTAL6679541013815

(5)

NestingMetrics'CurveFitting'

1..11 x 1..2 ArrayData Type: anythingStorage: rectangularOrder: Fortran_order

(6)

NestingMetrics'CurveFitting','summarize'

968461251312

(7)

See Also

Array, interface, ProgrammingGuide/Debugging, SoftwareMetrics, 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