HierarchicalDEA-CCR_preferenceRelations

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

Description

Computes necessary and possible preference relations for the pairs of DMUs (alternatives) using CCR Data Envelopment Analysis Model with hierarchical structure of outputs.

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>
                                                             <values><value>[...]</value></values>
                                                     </performance>
                                                     [...]
                                             </alternativePerformances>
                                             [...]
                                     </performanceTable>

hierarchy

The hierarchical structure of criteria.

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

<criteriaHierarchy>
                                <nodes>
            <node>
                <criterionID>[...]</criterionID>
                <nodes>
                    <node>
                        <criterionID>[...]</criterionID>
                        [...]
                    </node>
                    [...]
                </nodes>
            </node>
        <nodes>
                        </criteriaHierarchy>

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>
    <constraints>
        <constraint>
            <elements>
                <element>
                    <criterionID> [...] </criterionID>
                    <coefficient>
                        [...]
                    </coefficient>
                </element>
                [...]
            </elements>
            <operator>[...]</operator>
            <rhs>
                [...]
            </rhs>
        </constraint>
        [...]
    </constraints>
</criteriaLinearConstraints>

methodParameters

Represents parameters (hierarchyNode).

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

<programParameters>
    <parameter id="hierarchyNode">
        <values>
            <value><label>%1</label></value>
        </values>
    </parameter>
</programParameters>

where:

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

Outputs

necessaryDominance

A matrix containing necessary preference relation between pairs of DMUs.

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

<alternativesMatrix>
                            <row>
        <alternativeID>[...]</alternativeID>
        <column>
            <alternativeID>[...]</alternativeID>
            <values>
                <value><integer>1</integer></value>
            </values>
        </column>
        [...]
    </row>
    [...]
                    </alternativesMatrix>

possibleDominance

A matrix containing possible preference relation between pairs of DMUs.

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

<alternativesMatrix>
                            <row>
        <alternativeID>[...]</alternativeID>
        <column>
            <alternativeID>[...]</alternativeID>
            <values>
                <value><integer>1</integer></value>
            </values>
        </column>
        [...]
    </row>
    [...]
                    </alternativesMatrix>

messages

A list of messages generated by the algorithm.

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

Original xml description