RORUTADIS-ExtremeClassCardinalities

Version:0.1
Provider:PUT
SOAP service’s name:
 RORUTADIS-ExtremeClassCardinalities-PUT (see SOAP requests for details)

Description

Robust Ordinal Regression for value-based sorting: RORUTADIS-ExtremeClassCardinalities calculates minimal and maximal possible cardinality of each category (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).

Contact:
Krzysztof Ciomek (k.ciomek@gmail.com), Milosz Kadzinski (milosz.kadzinski@cs.put.poznan.pl)

Web page: https://github.com/kciomek/rorutadis

Reference: None

Inputs

(For outputs, see below)

criteria

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.

The input value should be a valid XMCDA document whose main tag is <criteria>. It must have the following form:

<criteria>
<criterion id=”[…]” /> […]

</criteria>

<criteriaValues mcdaConcept=”preferenceDirection”>
<criterionValue>
<criterionID>[…]</criterionID> <values><value><integer>[…]</integer></value></values>

</criterionValue> […]

</criteriaValues>

<criteriaValues mcdaConcept=”numberOfCharacteristicPoints”>
<criterionValue>
<criterionID>[…]</criterionID> <values><value><integer>[0|integer greater or equal to 2]</integer></value></values>

</criterionValue> […]

</criteriaValues>

alternatives

A list of alternatives.

The input value should be a valid XMCDA document whose main tag is <alternatives>. It must have the following form:

<alternatives>
<alternative id=”[…]”>
<active>[…]</active>

</alternative> […]

</alternatives>

categories

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

The input value should be a valid XMCDA document whose main tag is <categories>. It must have the following form:

<categories>
<category id=”[…]” /> […]

</categories>

performanceTable

The performances of the alternatives.

The input value should be a valid XMCDA document whose main tag is <performanceTable>.

assignmentExamples (optional)

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

The input value should be a valid XMCDA document whose main tag is <alternativesAssignments>. It must have the following form:

<alternativesAssignments>
<alternativeAssignment>
<alternativeID>[…]</alternativeID> <categoryID>[…]</categoryID>

</alternativeAffectation> […] <alternativeAssignment>

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

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

</lowerBound> <upperBound>

<categoryID>[…]</categoryID>

</upperBound>

</categoriesInterval>

</alternativeAssignment> […] <alternativeAssignment>

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

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

</categoriesSet>

</alternativeAssignment> […]

</alternativesAffectations>

assignmentComparisons (optional)

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.

The input value should be a valid XMCDA document whose main tag is <alternativesComparisons>. It must have the following form:

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

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

The input value should be a valid XMCDA document whose main tag is <categoriesValues>. It must have the following form:

<categoriesValues>
<categoryValue>

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

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

</interval>

</value>

</categoryValue> […]

</categoriesValues>

strictlyMonotonicValueFunctions

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

The input value should be a valid XMCDA document whose main tag is <methodParameters>. It must have the following form:

<programParameters>
<parameter name=”strictlyMonotonicValueFunctions”>
<values>
<value>
<boolean>%1</boolean>

</value>

</values>

</parameter>

</programParameters>

where:

  • %1 is a parameter named “strictlyMonotonicValueFunctions”. This is a boolean. The default value is false.

Outputs

categoriesExtremeCardinalities

Category extreme cardinalities.

The returned value is a XMCDA document whose main tag is <categoriesValues>. It has the following form:

<categoriesValues>
<categoryValue>

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

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

</interval>

</value>

</values>

</categoryValue> […]

</categoriesValues>

messages

Messages generated by the program.

The returned value is a XMCDA document whose main tag is <programExecutionResult>.

Original xml description