Provider: | PUT |
---|---|
Version: | 1.0 |
For a given ranking position n and the alternative a that already attains at least n-th position in ranking, depending on the need, the module find a one of the two possible types of values. These are the maximal deterioration of the performance of the alternative a or the maximal surplus value of the comprehensive score of this alternative. In the first case, the procedure finds a minimal value from the range of 0 to 1, that multiplied by the performances on the indicated criteria allows to maintain at least the desired n-th position. In the other case, it finds the maximal value that may be subtracted from the comprehensive score of this alternative in order to maintain at least n-th position. In both cases it is possible to consider the target for both all or at least one compatible value funtion.
(For outputs, see below)
A list of all considered criteria. The input value should be a valid XMCDA document whose main tag is criteria.
Tag: criteria
Code:
<criteria>
<criterion id="%1" name="%1"></criterion>
[...]
</criteria>
Optional: yes, enabled by default
A set of ids of the criteria that should be taken into account for modification of the performances. This parameter is used only if the modification of performances is searched.
Tag: criteriaSets
Code:
<criteriaSets>
<criteriaSet>
<element>
<criterionID>...</criterionID>
</element>
<element>
<criterionID>...</criterionID>
</element>
[...]
</criteriaSet>
</criteriaSets>
The list of all considered alternatives. The input value should be a valid XMCDA document whose main tag is alternatives. Each alternative may be described using two attributes: id and name. While the first one denotes a machine readable name, the second represents a human readable name.
</alternatives>
Description of evaluation of alternatives on different criteria. It is required to provide the IDs of both criteria and alternatives described previously. The input value should be provided as a valid XMCDA document whose main tag is performanceTable
<alternativeID>a01</alternativeID> <performance>
<criterionID>c01</criterionID> <values>
- <value>
- <real>1.0</real>
</value>
</values>
</performance> […]
</alternativePerformances> […]
<performanceTable>
Optional: yes, enabled by default
A set of values associated with the criteria. This input allows to determine what type of value function should be used for the particular criterion. For each criterion that has an associated greater than one value, a piecewise linear value function is used. In this case, the mentioned value denotes a number of characteristic points of this value function. For the criteria that are not listed in this file, or for these for which the provided values are lower than two uses a general value function. The input value should be provided as a valid XMCDA document whose main tag is criteriaValues. Each element should contain both an id of the criterion, and value tag.
<criterionID>c01</criterionID> <values>
- <value>
- <integer>2</integer>
</value>
</values>
</criterionValue> […]
</criteriaValues>
Optional: yes, enabled by default
Set of pairwise comparisons of reference alternatives. For a pair of alternatives three types of comparisons are supported. These are the strict preference, weak preference, and indifference. The input value should be provided as a valid XMCDA document whose main tag is alternativesComparisons. For each type of comparison, a separate alternativesComparisons tag should be used. Within these groups a mentioned types are denoted using a comparisonType tag by respectively strict, weak, and indif label. Comparisons should be provided as pairs of alternatives ids.
Tag: alternativesMatrix
Code:
<alternativesComparisons>
<comparisonType>
%1<!-- type of preference: strong, weak, or indif -->
</comparisonType>
<pairs>
<pair>
<initial>
<alternativeID>%2</alternativeID>
</initial>
<terminal>
<alternativeID>%3</alternativeID>
</terminal>
</pair>
[...]
</pairs>
</alternativesComparisons>
[...]
Optional: yes, enabled by default
Set of comparisons of intensities of preference. For a pair of preference relations three types of comparisons are supported. These are the strict preference, weak, preference, and indifference. The input value should be provided as a valid XMCDA document whose main tag is alternativesComparisons. For each type of comparison, a separate alternativesComparisons tag should be used. Within these groups aforementioned types are denoted using a comparisonType tag by respectively strict, weak, and indif label. Comparisons should be provided as pairs of two elementary sets of alternatives ids. The following form is expected:
Tag: alternativesMatrix
Code:
<alternativesComparisons>
<comparisonType>%1</comparisonType>
<pairs>
<pair>
<initial>
<alternativesSet>
<element>
<alternativeID>%2</alternativeID>
</element>
<element>
<alternativeID>%3</alternativeID>
</element>
</alternativesSet>
</initial>
<terminal>
<alternativesSet>
<element>
<alternativeID>%4</alternativeID>
</element>
<element>
<alternativeID>%5</alternativeID>
</element>
</alternativesSet>
</terminal>
</pair>
[...]
</pairs>
</alternativesComparisons>
[...]
Description of the target to achieve which has a form of the worst possible position that may be attained by the particular alternative. The input value should be provided as a valid XMCDA document whose main tag is alternativesValues. It should contain one alternative Id and one integer value which denotes the desired ranking position.
<alternativeID>…</alternativeID> <values>
- <value>
- <integer>…</integer>
</value>
</values>
</alternativeValue>
</alternativesValues>
Optional: yes, enabled by default
Set of rank-related requirements. In other words it is a set of ranges of possible positions in the final ranking for a chosen alternatives. The input value should be provided as a valid XMCDA document whose main tag is alternativesValues. Each requirement should contain both an id of the reffered alternative and a pair of values that denote the desired range. These information should be provided within a separate alternativesValues tag.
- <alternativeValue>
<alternativeID>…</alternativeID> <value>
- <interval>
- <lowerBound><integer>…</integer></lowerBound> <upperBound><integer>…</integer></upperBound>
</interval>
</value>
</alternativeValue> […]
</alternativesValues>
Name: Use strictly increasing value functions?
Single boolean value. Determines whether to use sctrictly increasing (true) or monotonously increasing (false) value functions.
Name: type of result
Type of searched value
Name: precision of the result
Name: Whether the target should be achieved possibly or necessarily?
One of the two label values (possible or necessary). This parameter determines does target should be satisfied by one (possible) or all(necessary) value functions
</value>
</values>
</parameter> <parameter name=”type_of_result”>
- <values>
- <value>
- <label>%2</label>
</value>
</values>
</parameter> <parameter name=”precision”>
- <values>
- <value>
- <real>%3</real>
</value>
</values>
</parameter> <parameter name=”possible_or_necessary”>
- <values>
- <value>
- <label>%4</label>
</value>
</values>
</parameter>
</programParameters>
A real value associated with the id of the considered alternative. Depending on chosen option, it may denote the deterioration of performances of this alternative or the surplus value of its comprehensive score. The output value is provided as a valid XMCDA document whose main tag is alternativesValues.
<alternativeID>…</alternativeID> <values>
- <value>
- <real>…</real>
</value>
</values>
</alternativeValue>
</alternativesValues>
A list of messages generated by the algorithm.
For further technical details on the web service underlying this program, have a look at its documentation here.