RORUTADIS-PreferentialReducts

Provider:PUT
Version:0.1

Description

Robust Ordinal Regression for value-based sorting: RORUTADIS-PreferentialReducts service allows to obtain explanation of assignments. It finds all preferential reducts and calculates preferential core.

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

possibleAssignments

Description:

Possible assignments (calculated with RORUTADIS-PossibleAndNecessaryAssignments service).

XMCDA related:

  • Tag: alternativesAffectations

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:

Whether marginal value functions strictly monotonic (true) or weakly monotonic (false).

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 to explain.

    • 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>
    </methodParameters>
    

Outputs

preferentialReducts

Description:

All preferential reducts. Each reduct consists of three types of information (alternative assignments, pairwise alternative comparisons and desired class cardinalities) and it is identified by a string stored in attribute ‘id’ of root level tags.

XMCDA related:

  • Tag: alternativesAffectations,alternativesComparisons,categoriesValues

preferentialCore

Description:

preferential core.

XMCDA related:

  • Tag: alternativesAffectations,alternativesComparisons,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.