HierarchicalDEA-ValueAdditive-SMAA_efficiencies

Provider:PUT
Version:1.0

Description

Computes efficiency scores for the given DMUs (alternatives) using SMAA-D method and Additive Data Envelopment Analysis Model with hierarchical structure of inputs and outputs. 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.

Inputs

(For outputs, see below)

  • units
  • performanceTable
  • inputsOutputs
  • hierarchy
  • weightsLinearConstraints (optional)
  • methodParameters

units

Description:

A list of alternatives (DMUs).

performance

Description:

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

XMCDA related:

  • Tag: performanceTable

  • Code:

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

inputs/outputs

Description:

A list of performance criteria (hierarchy leafs) and their preference direction. List has to contain at least one criterion that will be minimized (input) and at least one criterion that will be maximized (output) for each hierarchy category.

XMCDA related:

  • Tag: criteria

  • Code:

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

hierarchy

Description:

The hierarchical structure of criteria.

XMCDA related:

  • Tag: hierarchy

  • Code:

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

weights constraints

Optional: yes, disabled by default

Description:

A list of hierarchy criteria linear constraints.

XMCDA related:

  • Tag: criteriaLinearConstraints

  • Code:

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

parameters

Description:

Represents parameters.
“number of samples” represents the number of samples to generate; “number of buckets” represents the number of buckets which efficiency scores will be assigned to; “hierarchy node” is the ID of the hierarchy criterion for which the analysis should be performed; “transformToUtilities” means if data should be tranformed into values from range [0-1]; “boundariesProvided” means if inputsOutputs file contains information about min and max data for each factor.

GUI information:

  • Parameter values can be defined via the GUI or the XMCDA file, by default via GUI.
  • Name: number of samples
    • Constraint description: The value should be a positive integer.
    • Type: integer
    • Default value: 100
  • Name: number of intervals
    • Constraint description: The value should be a positive integer.
    • Type: integer
    • Default value: 10
  • Name: hierarchy node
    • Type: string
    • Default value: “root”
  • Name: transform to utilities
    • Default value: true
  • Name: boundaries provided
    • Default value: false
  • Name: random seed (-1 for default time-based seed)
    • Constraint description: The value should be a non-negative integer or -1 if no constant seed required.
    • Type: integer
    • Default value: -1

XMCDA related:

  • Tag: methodParameters

  • Code:

    <methodParameters>
        <parameter id="samplesNb">
                <value><integer>%1</integer></value>
        </parameter>
        <parameter id="intervalsNb">
                <value><integer>%2</integer></value>
        </parameter>
        <parameter id="hierarchyNode">
    <value><label>%3</label></value>
</parameter>
        <parameter id="transformToUtilities">
                <value><boolean>%4</boolean></value>
        </parameter>
        <parameter id="boundariesProvided">
                <value><boolean>%5</boolean></value>
        </parameter>
<parameter id="randomSeed">
                <value><integer>%6</integer></value>
        </parameter>
</methodParameters>

Outputs

  • efficiencyDistribution
  • maxEfficiency
  • minEfficiency
  • avgEfficiency
  • messages

efficiency distribution

Description:

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.

XMCDA related:

  • Tag: performanceTable

  • Code:

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

max efficiency

Description:

A list of alternatives with maximum efficiency scores (obtained with sampling).

XMCDA related:

  • Tag: alternativesValues

  • Code:

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

min efficiency

Description:

A list of alternatives with computed minimum efficiency scores (obtained with sampling).

XMCDA related:

  • Tag: alternativesValues

  • Code:

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

average efficiency

Description:

A list of alternatives with average efficiency scores (obtained with sampling).

XMCDA related:

  • Tag: alternativesValues

  • Code:

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

messages

Description:

A list of messages generated by the algorithm.

XMCDA related:

  • Tag: methodMessages

For further technical details on the web service underlying this program, have a look at its documentation here.