RORUTADIS-PostFactum-InvestigatePerformanceDeterioration

Provider:PUT
Version:0.3

Description

Robust Ordinal Regression for value-based sorting: RORUTADIS-PostFactum-InvestigatePerformanceDeterioration service checks how much an alternative evaluations can be deteriorated so that that alternative would stay possibly (or necessarily) in at least some specific class. Deterioration is based on minimization value of rho in multiplication of an alternative evaluations on selected criteria by rho (where 0 < rho <= 1). Note! This function works for problems with only non-negative alternative evaluations. 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

criteriaManipulability

Description:

A list of criteria values which denote whether multiplying by rho on corresponding criterion is allowed (value 1) or not (value 0). Values for all criteria have to be provided and at least one criterion has to be available for manipulation.

XMCDA related:

  • Tag: criteriaValues
  • Code:
<criteriaValues>
<criterionValue>
<criterionID>[…]</criterionID> <value><integer>[…]</integer></value>

</criterionValue> […]

</criteriaValues>


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: alternativesAssignments
  • Code:
<alternativesAssignments>
<alternativeAssignment>
<alternativeID>[…]</alternativeID> <categoryID>[…]</categoryID>

</alternativeAssignment> […] <alternativeAssignment>

<alternativeID>[…]</alternativeID> <categoriesInterval>

<lowerBound>
<categoryID>[…]</categoryID>

</lowerBound> <upperBound>

<categoryID>[…]</categoryID>

</upperBound>

</categoriesInterval>

</alternativeAssignment> […] <alternativeAssignment>

<alternativeID>[…]</alternativeID> <categoriesSet>

<categoryID>[…]</categoryID> […]

</categoriesSet>

</alternativeAssignment> […]

</alternativesAssignments>


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: alternativesMatrix
  • Code:
<alternativesMatrix mcdaConcept=”atLeastAsGoodAs”>
<row>

<alternativeID>[…]</alternativeID> <column>

<alternativeID>[…]</alternativeID> <values>

<value>
<integer>k</integer>

</value>

</values>

</column>

</row> […]

</alternativesMatrix>

<alternativesMatrix mcdaConcept=”atMostAsGoodAs”>
<row>[…]</row> […]

</alternativesMatrix>


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> <values>

<value>
<interval>
<lowerBound><integer>[…]</integer></lowerBound> <upperBound><integer>[…]</integer></upperBound>

</interval>

</value>

</values>

</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 deterioration.

    • 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: programParameters
  • Code:
<programParameters>
<parameter name=”strictlyMonotonicValueFunctions”>
<values>
<value><boolean>%1</boolean></value>

</values>

</parameter> <parameter name=”alternative”>

<values>
<value><label>%2</label></value>

</values>

</parameter> <parameter name=”necessary”>

<values>
<value><boolean>%3</boolean></value>

</values>

</parameter> <parameter name=”atLeastToClass”>

<values>
<value><label>%4</label></value>

</values>

</parameter>

</programParameters>


Outputs

deterioration value

Description:

Deterioration value (value of rho).

XMCDA related:

  • Tag: alternativesValues
  • Code:
<alternativesValues mcdaConcept=”deteriorationValue”>
<alternativeValue>

<alternativeID>[…]</alternativeID> <values>

<value>
<real>[…]</real>

</value>

</values>

</alternativeValue>

</alternativesValues>


messages

Description:

Messages generated by the program.

XMCDA related:

  • Tag: programExecutionResult

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