RORUTADIS-RepresentativeValueFunction

Provider:PUT
Version:0.3

Description

Robust Ordinal Regression for value-based sorting: RORUTADIS-RepresentativeValueFunction service finds representative function. It is possible to provide an additional optional preference information: example alternatives assignments, assignment pairwise comparisons and desired class cardinalities. Service developed by Krzysztof Ciomek (Poznan University of Technology, under supervision of Milosz Kadzinski).

Inputs

(For outputs, see below)

criteria

Description:

A list of criteria (<criteria> tag) with information about preference direction (<criteriaValues mcdaConcept=”preferenceDirection”>, 0 - gain, 1 - cost) and number of characteristic points (<criteriaValues mcdaConcept=”numberOfCharacteristicPoints”>, 0 for the most general marginal utility function or integer grater or equal to 2) of each criterion.

alternatives

Description:

A list of alternatives.

XMCDA related:

  • Tag: alternatives

  • Code:

                        <alternatives>
        <alternative id="[...]">
            <active>[...]</active>
        </alternative>
        [...]
    </alternatives>
    

categories

Description:

A list of categories (classes). List must be sorted from the worst category to the best.

XMCDA related:

  • Tag: categories

  • Code:

                        <categories>
        <category id="[...]" />
        [...]
    </categories>
    

performanceTable

Description:

The performances of the alternatives.

XMCDA related:

  • Tag: performanceTable

assignmentExamples

Optional: yes, enabled by default

Description:

A list of assignment examples of alternatives to intervals of categories (classes) or to a specific category (class).

XMCDA related:

  • Tag: alternativesAffectations

  • Code:

    <alternativesAffectations>
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoryID>[...]</categoryID>
            </alternativeAffectation>
            [...]
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoriesInterval>
                            <lowerBound>
                                    <categoryID>[...]</categoryID>
                            </lowerBound>
                            <upperBound>
                                    <categoryID>[...]</categoryID>
                            </upperBound>
                    </categoriesInterval>
            </alternativeAffectation>
            [...]
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoriesSet>
                            <categoryID>[...]</categoryID>
                            [...]
                    </categoriesSet>
            </alternativeAffectation>
            [...]
    </alternativesAffectations>
    

assignmentComparisons

Optional: yes, enabled by default

Description:

Two lists of assignment pairwise comparisons. A comparison from list with attribute mcdaConcept=”atLeastAsGoodAs” indicates that some alternative should be assigned to class at least as good as class of some other alternative (k = 0) or at least better by k classes (k > 0). A comparison from list with attribute mcdaConcept=”atMostAsGoodAs” indicates that some alternative should be assigned to class at most better by k classes (k > 0) then some other alternative.

XMCDA related:

  • Tag: alternativesComparisons

  • Code:

    <alternativesComparisons mcdaConcept="atLeastAsGoodAs">
            <pairs>
                    <pair>
                            <initial><alternativeID>[...]</alternativeID></initial>
                            <terminal><alternativeID>[...]</alternativeID></terminal>
                            <value><integer>k</integer></value>
                    </pair>
                    [...]
            </pairs>
    </alternativesComparisons>
    
    <alternativesComparisons mcdaConcept="atMostAsGoodAs">
            <pairs>
                    [...]
            </pairs>
    </alternativesComparisons>
    

preferenceRelation

Optional: yes, enabled by default

Description:

Necessary assignment based preference relation between alternatives.

XMCDA related:

  • Tag: alternativesComparisons

  • Code:

    <alternativesComparisons>
            <pairs>
                    <pair>
                            <initial><alternativeID>[...]</alternativeID></initial>
                            <terminal><alternativeID>[...]</alternativeID></terminal>
                    </pair>
                    [...]
            </pairs>
    </alternativesComparisons>
    

categoriesCardinalities

Optional: yes, enabled by default

Description:

A list of category (class) cardinality constraints. It allows to define minimal and/or maximal desired category (class) cardinalities.

XMCDA related:

  • Tag: categoriesValues

  • Code:

    <categoriesValues>
            <categoryValue>
                    <categoryID>[...]</categoryID>
                    <value>
                            <interval>
                                    <lowerBound><integer>[...]</integer></lowerBound>
                                    <upperBound><integer>[...]</integer></upperBound>
                            </interval>
                    </value>
            </categoryValue>
            [...]
    </categoriesValues>
    

methodParameters

Description:

Method parameters.

GUI information:

  • Parameter values can be defined via the GUI or the XMCDA file, by default via GUI.

  • Name: strictlyMonotonicValueFunctions

    Whether marginal value functions strictly monotonic or not.

    • Default value: false
  • Name: mode

    A method of a computing representative utility function.

    • Type: drop-down list
    • Possible values:
      • Iterative (XMCDA label : iterative) (default)
      • Compromise (XMCDA label : compromise)

XMCDA related:

  • Tag: methodParameters

  • Code:

    <methodParameters>
        <parameter name="strictlyMonotonicValueFunctions">
            <value>
                <boolean>%1</boolean>
            </value>
        </parameter>
        <parameter name="mode">
            <value>
                <label>%2</label>
            </value>
        </parameter>
    </methodParameters>
    

Outputs

marginalValueFunctions

Description:

Marginal value functions for found representative function.

XMCDA related:

  • Tag: criteria

  • Code:

    <criteria>
            <criterion id="[...]">
                    <criterionFunction>
                            <points>
                                    <point>
                                            <abscissa><real>[...]</real></abscissa>
                                            <ordinate><real>[...]</real></ordinate>
                                    </point>
                                    [...]
                            </points>
                    </criterionFunction>
            </criterion>
            [...]
    </criteria>
    

alternativesValuesTable

Description:

Marginal utility values of alternatives for found representative function.

XMCDA related:

  • Tag: performanceTable

assignments

Description:

Alternative assignments for found representative function.

XMCDA related:

  • Tag: alternativesAffectations

  • Code:

    <alternativesAffectations>
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoryID>[...]</categoryID>
            </alternativeAffectation>
            [...]
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoriesInterval>
                            <lowerBound>
                                    <categoryID>[...]</categoryID>
                            </lowerBound>
                            <upperBound>
                                    <categoryID>[...]</categoryID>
                            </upperBound>
                    </categoriesInterval>
            </alternativeAffectation>
            [...]
            <alternativeAffectation>
                    <alternativeID>[...]</alternativeID>
                    <categoriesSet>
                            <categoryID>[...]</categoryID>
                            [...]
                    </categoriesSet>
            </alternativeAffectation>
            [...]
    </alternativesAffectations>
    

thresholds

Description:

Lower threshold for each category (class) for found representative function.

XMCDA related:

  • Tag: categoriesValues

  • Code:

    <categoriesValues mcdaConcept="thresholds">
            <categoryValue>
                    <categoryID>[...]</categoryID>
                    <value>
                            <real>[...]</real>
                    </value>
            </categoryValue>
            [...]
    </categoriesValues>
    

messages

Description:

Messages generated by the program.

XMCDA related:

  • Tag: methodMessages

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