ImpreciseDEA-CCR-SMAA_efficiencies

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

Description

Computes efficiency scores for the given DMUs (alternatives) using SMAA-D method and CCR Data Envelopment Analysis Model with imprecise data. For given number of buckets and samples, returns a matrix with alternatives in each row and buckets representing efficiency intervals in each column. Single cell indicates how many samples gave efficiency scores of respective alternative in respective bucket.

Contact: Anna Labijak <support@decision-deck.org>

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>

inputsOutputs

A list of criteria.

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

<criteria>
                     <criterion>[...]</criterion>
                     [...]
                 </criteria>

inputsOutputsScales

Informations about inputs and outputs scales and optionally about boundaries

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

<criteriaScales>
<criterionScale>

<criterionID>[…]</criterionID> <scales>

<scale>
[…]

</scale>

</scales>

</criterionScale> […]

</criteriaScales>


performanceTable

A list of alternatives (DMUs) minimal performances (or exact performances if intervals should be created by tolerance).

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>

maxPerformanceTable (optional)

A list of alternatives (DMUs) maximal performances.

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>

weightsLinearConstraints (optional)

A list of 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

“samplesNb” represents the number of samples to generate; “intervalsNo” represents the number of buckets which efficiency scores will be assigned to.

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

<programParameters>
    <parameter id="samplesNb">
        <values>
            <value><integer>%1</integer></value>
        </values>
    </parameter>
    <parameter id="intervalsNb">
        <values>
            <value><integer>%2</integer></value>
        </values>
    </parameter>
    <parameter id="tolerance">
        <values>
            <value><real>%3</real></value>
        </values>
    </parameter>
</programParameters>

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.

  • %2 is a parameter named “number of buckets”. 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:

    %2 > 0
    

    The default value is 10.

  • %3 is a parameter named “tolerance”. This is a float, and the value should conform to the following constraint: The value should be a non-negative number.. More formally, the constraint is:

    %3 >= 0
    

    The default value is 0.0.


Outputs

efficiencyDistribution

A performance table for given alternatives. Single performance consists of attribute criterionID representing certain bucket, and a value representing the ratio of efficiency scores in this bucket.

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

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

maxEfficiency

A list of alternatives with maximum efficiency scores (obtained for given sample).

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>

minEfficiency

A list of alternatives with computed minimum efficiency scores (obtained for given sample).

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>

avgEfficiency

A list of alternatives with average efficiency scores (obtained for given sample).

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 <programExecutionResult>.


Original xml description