HierarchicalDEA-CCR-SMAA_ranks

Version:1.0
Provider:PUT
SOAP service’s name:
 HierarchicalDEA-CCR-SMAA_ranks-PUT (see SOAP requests for details)

Description

Computes ranks for the given DMUs (alternatives) using SMAA-D method and CCR Data Envelopment Analysis Model with hierarchical structure of outputs. For given number of samples returns a matrix with alternatives in each row and rankings in each column. Single cell indicates how many samples of respective alternative gave respective position in ranking.

Contact:
Anna Labijak <anna.labijak@cs.put.poznan.pl>

Inputs

(For outputs, see below)

units

A list of alternatives (DMUs).

The input value should be a valid XMCDA document whose main tag is <alternatives>. It must have the following form:

<alternatives>
        <alternative>
            [...]
        </alternative>
        [...]
    </alternatives>

performanceTable

A list of alternatives (DMUs) performances (on leaf hierarchy criteria).

The input value should be a valid XMCDA document whose main tag is <performanceTable>. It must have the following form:

<performanceTable>
                                <alternativePerformances>
                                        <alternativeID> [...] </alternativeID>
                                        <performance>
                                                <criterionID>
                                                        [...]
                                                </criterionID>
                                                <value>[...]</value>
                                        </performance>
                                        [...]
                                </alternativePerformances>
                                [...]
                        </performanceTable>

hierarchy

The hierarchical structure of criteria.

The input value should be a valid XMCDA document whose main tag is <hierarchy>. It must have the following form:

<hierarchy>
    <node>
        <criterionID>[...]</criterionID>
        <node>
            <criterionID>[...]</criterionID>
            <node>
                [...]
            </node>
            [...]
        </node>
        [...]
    </node>
</hierarchy>

weightsLinearConstraints (optional)

A list of hierarchy criteria linear constraints.

The input value should be a valid XMCDA document whose main tag is <criteriaLinearConstraints>. It must have the following form:

<criteriaLinearConstraints>
                                <constraint>
                                        <element>
                                                <criterionID> [...] </criterionID>
                                                <coefficient>
                                                        [...]
                                                </coefficient>
                                        </element>
                                        [...]
                                        <operator>[...]</operator>
                                        <rhs>
                                                [...]
                                        </rhs>
                                </constraint>
                                [...]
                        </criteriaLinearConstraints>

methodParameters

“number of samples” represents the number of samples to generate; “hierarchy node” is the ID of the hierarchy criterion for which the analysis should be performed.

The input value should be a valid XMCDA document whose main tag is <methodParameters>. It must have the following form:

 <methodParameters>
    <parameter id="samplesNb">
        <value><integer>%1</integer></value>
    </parameter>
    <parameter id="hierarchyNode">
        <value><label>%3</label></value>
    </parameter>
    <parameter id="randomSeed">
        <value><integer>%4</integer></value>
    </parameter>
</methodParameters>

where:

  • %1 is a parameter named “number of samples”. This is a int, and the value should conform to the following constraint: The value should be a positive integer.. More formally, the constraint is:

    %1 > 0
    

    The default value is 100.

  • %3 is a parameter named “hierarchy node”. This is a string. The default value is root.

  • %4 is a parameter named “random seed (-1 for default time-based seed)”. This is a int, and the value should conform to the following constraint: The value should be a non-negative integer or -1 if no constant seed required.. More formally, the constraint is:

    %4 >= -1
    

    The default value is -1.


Outputs

rankAcceptabilityIndices

A performance table for given alternatives. Single performance consists of attribute criterionID representing certain ranking, and a value representing ratio of samples attaining this ranking.

The returned value is a XMCDA document whose main tag is <performanceTable>. It has the following form:

<performanceTable>
                                <alternativePerformances>
                                        <alternativeID> [...] </alternativeID>
                                        <performance>
                                                <criterionID> Rank [...]</criterionID>
                                                        <value>
                                                        [...]
                                                        </value>
                                        </performance>
                                        [...]
                                </alternativePerformances>
                        </performanceTable>

avgRank

A list of alternatives with average rank (obtained with sampling).

The returned value is a XMCDA document whose main tag is <alternativesValues>. It has the following form:

<alternativesValues>
                                <alternativeValue>
                                  <alternativeID> [...] </alternativeID>
                                  <values>
                                          <value>
[...]
</value>
                                  </values>
                                </alternativeValue>
                                [...]
                        </alternativesValues>

messages

A list of messages generated by the algorithm.

The returned value is a XMCDA document whose main tag is <methodMessages>.


Original xml description