RORUTADIS-PostFactum-InvestigateValueChange

Provider:PUT
Version:0.3

Description

Robust Ordinal Regression for value-based sorting: RORUTADIS-PostFactum-InvestigateValueChange service calculates missing value of an alternative utility for that alternative to be possibly (or necessarily) assigned to at least some specific class. 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>
    

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: alternative

    An identifier of alternative for assignment investigation.

    • Constraint description: This identifier cannot be empty
    • Type: string
  • Name: necessary

    Whether necessary or possible assignments to consider.

    • Default value: false
  • Name: atLeastToClass

    An identifier of category of assignment to investigate.

    • Constraint description: This identifier cannot be empty
    • Type: string

XMCDA related:

  • Tag: methodParameters

  • Code:

    <methodParameters>
        <parameter name="strictlyMonotonicValueFunctions">
            <value>
                <boolean>%1</boolean>
            </value>
        </parameter>
                                <parameter name="alternative">
                                        <value><label>%2</label></value>
                                </parameter>
        <parameter name="necessary">
            <value>
                <boolean>%3</boolean>
            </value>
        </parameter>
                                <parameter name="atLeastToClass">
                                        <value><label>%4</label></value>
                                </parameter>
    </methodParameters>
    

Outputs

marginalValueFunctions

Description:

Marginal value functions.

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 result function where missing utility is the smallest).

XMCDA related:

  • Tag: performanceTable

assignments

Description:

Alternative assignments (for result function where missing utility is the smallest).

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>
    

value

Description:

Value of missing utility.

XMCDA related:

  • Tag: alternativesValues

  • Code:

    <alternativesValues mcdaConcept="investigationResultValue">
            <alternativeValue>
                    <alternativeID>[...]</alternativeID>
                    <value>
                            <real>[...]</real>
                    </value>
            </alternativeValue>
    </alternativesValues>
    

thresholds

Description:

Lower threshold for each category/class (for result function where missing utility is the smallest).

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.