Outranking-PrefRank-WithPreferenceInformation_scores

Version:1.0.0
Provider:PUT
SOAP service’s name:
 Outranking-PrefRank-WithPreferenceInformation_scores-PUT (see SOAP requests for details)

Description

Module for calculation PrefRank scores using preference information given by decision maker.

Contact: Krzysztof Martyn <krzysztof.martyn@wp.pl>

Web page: https://bitbucket.org/Krzysztof_Martyn/prefrank

Inputs

(For outputs, see below)

alternatives

Alternatives to consider.

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


preferences

Aggregated preferences matrix.

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


preference_information

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


parameters

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 <programParameters>. It must have the following form:

<programParameters>
        <parameter id="algorithm_type" name="algorithm_type">
                <values>
                        <value>
                                <label>%1</label>
                        </value>
                </values>
        </parameter>
        <parameter id="q" name="q">
                <values>
                        <value>
                                <real>%2</real>
                        </value>
                </values>
        </parameter>
        <parameter id="number_of_iteration" name="number_of_iteration">
                <values>
                        <value>
                                <integer>%3</integer>
                        </value>
                </values>
        </parameter>
        <parameter id="check_convergence" name="check_convergence">
                <values>
                        <value>
                                <boolean>%4</boolean>
                        </value>
                </values>
        </parameter>
        <parameter id="early_stopping" name="early_stopping">
                <values>
                        <value>
                                <boolean>%5</boolean>
                        </value>
                </values>
        </parameter>
</programParameters>

where:

  • %1 is a parameter named “algorithm type”. It can have the following values:

    • prefrank_with_preference_information_1: PrefRank with preference information I
    • prefrank_with_preference_information_2: PrefRank with preference information II
    • prefrank_with_preference_information_3: PrefRank with preference information III

    The default value is item0.

  • %2 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:

    %2 >= 0 && %2 <= 1
    

    The default value is 0.15.

  • %3 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:

    %3 > 1
    

    The default value is 100.

  • %4 is a parameter named “Run averaging if not converge?”. This is a boolean. The default value is false.

  • %5 is a parameter named “Earlier stop if converge?”. This is a boolean. The default value is true.


Outputs

positive_flows

Positive outranking flows.

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


negative_flows

Negative outranking flows.

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


total_flows

Final flows computed from the given data.

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


ranking

PrefRank scores computed from the given data.

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


messages

Messages or errors generated by this module.

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


Original xml description