| Version: | 1.0.0 |
|---|---|
| Provider: | PUT |
| SOAP service’s name: | |
Outranking-ScoreBin-WithPreferenceInformation_scores-PUT (see SOAP requests for details) |
|
Module for calculation ScoreBin scores using preference information given by decision maker. The preferences can be given as a complete pairwise comparison matrix where the value determines the degree of preference 0.0 or 1.0. The second type of preference input is to specify pairs of alternatives for which there is a preference.
Contact: Krzysztof Martyn <krzysztof.martyn@wp.pl>
(For outputs, see below)
Alternatives to consider.
The input value should be a valid XMCDA document whose main tag is <alternatives>.
Aggregated preferences binary matrix or pairs for which the outrank relationship occurs.
The input value should be a valid XMCDA document whose main tag is <alternativesComparisons>.
Preference information about alternatives. Strength for the alternative is given to the value of true, weakness for false, when no value is given, the alternative does not gain strength or weakness.
The input value should be a valid XMCDA document whose main tag is <alternativesValues>.
First parameter specifies if preference are given by matrix or pairs. Second parameter specifies the algorithm to calculate ranking. There are three algorithms to choose from: PageRank, HITS and Salsa.
The input value should be a valid XMCDA document whose main tag is <methodParameters>.
It must have the following form:
<methodParameters>
<parameter id="input_type" name="input_type">
<value>
<label>%1</label>
</value>
</parameter>
<parameter id="algorithm_type" name="algorithm_type">
<value>
<label>%2</label>
</value>
</parameter>
<parameter id="q" name="q">
<value>
<real>%3</real>
</value>
</parameter>
<parameter id="number_of_iteration" name="number_of_iteration">
<value>
<integer>%4</integer>
</value>
</parameter>
<parameter id="check_convergence" name="check_convergence">
<value>
<boolean>%5</boolean>
</value>
</parameter>
<parameter id="early_stopping" name="early_stopping">
<value>
<boolean>%6</boolean>
</value>
</parameter>
</methodParameters>
where:
%1 is a parameter named “input type”. It can have the following values:
matrix: Preferences given by whole matrix 1-0 valued.pair: Preferences given by pairs for whom the outranking relationship occurs (crisp).The default value is item0.
%2 is a parameter named “algorithm type”. It can have the following values:
scorebin_with_preference_information_1: ScoreBin with preference information Iscorebin_with_preference_information_2: ScoreBin with preference information IIscorebin_with_preference_information_3: ScoreBin with preference information IIIThe default value is item0.
%3 is a parameter named “damping factor”. This is a float, and the value should conform to the following constraint: The real value must be between 0 and 1. More formally, the constraint is:
%3 >= 0 && %3 <= 1
The default value is 0.15.
%4 is a parameter named “number of iteration”. This is a int, and the value should conform to the following constraint: The value should be greater than 1. More formally, the constraint is:
%4 > 1
The default value is 100.
%5 is a parameter named “Run averaging if not converge?”. This is a boolean. The default value is false.
%6 is a parameter named “Earlier stop if converge?”. This is a boolean. The default value is true.
Positive outranking flows.
The returned value is a XMCDA document whose main tag is <alternativesValues>.
Negative outranking flows.
The returned value is a XMCDA document whose main tag is <alternativesValues>.
Final flows computed from the given data.
The returned value is a XMCDA document whose main tag is <alternativesValues>.
ScoreBin computed from the given data.
The returned value is a XMCDA document whose main tag is <alternativesComparisons>.
Messages or errors generated by this module.
The returned value is a XMCDA document whose main tag is <methodMessages>.