HierarchicalDEA-ValueAdditive-SMAA_preferenceRelations

Provider:PUT
Version:1.0

Description

Determines dominance relations 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 samples returns a matrix with alternatives in each row and column. Single cell indicates how many samples of alternative in a row dominates alternative in a column.

Inputs

(For outputs, see below)

units

Description:

A list of alternatives (DMUs).

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>
    

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>
    

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.
“hierarchy node” is the ID of the hierarchy criterion for which the analysis should be performed, “transform to utilities” means if data should be tranformed into values from range [0-1], “boundaries provided” means if inputsOutputs file contains information about min and max data for each factor, “number of samples” determines number of samples used to calculate results.

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: 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="hierarchyNode">
                    <value><label>%2</label></value>
            </parameter>
            <parameter id="transformToUtilities">
                    <value><boolean>%3</boolean></value>
            </parameter>
            <parameter id="boundariesProvided">
                    <value><boolean>%4</boolean></value>
            </parameter>
    <parameter id="randomSeed">
                    <value><integer>%5</integer></value>
            </parameter>
    </methodParameters>
    

Outputs

pairwise outranking indices

Description:

A performance table for given alternatives. Single performance consists of attribute criterionID representing dominated alternative, and a value representing ratio of samples dominating this alternative.

XMCDA related:

  • Tag: performanceTable

  • Code:

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

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.