Outranking-ScoreBin_scores

alternatives

Alternatives to consider.

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

preferences

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

parameters

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

<programParameters>
        <parameter id="input_type" name="input_type">
                <values>
                        <value>
                                <label>%1</label>
                        </value>
                </values>
        </parameter>
        <parameter id="algorithm_type" name="algorithm_type">
                <values>
                        <value>
                                <label>%2</label>
                        </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 “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_1: ScoreBin I
  • scorebin_2: ScoreBin II
  • scorebin_3: ScoreBin III

  The default value is item0.

• %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 1000.

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

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

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