PairwiseComparisons-HeuristicRatingEstimation

alternatives (optional)

Alternatives that will be ranked. By default (no active tag), alternatives are considered as active. If absent, the program behaves as if it was supplied with all alternatives being active

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

<alternatives>
    <alternative id="..."></alternative>
    [...]
</alternatives>

knownRankings (optional)

Initially known rankings for alternatives.

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

<alternativesValues>
    <alternativeValue>
        <alternativeID> [...] </alternativeID>
        <values>
            <value><real> [...] </real></value>
        </values>
    </alternativeValue>
    [...]
</alternativesValues>

alternativesMatrix

Partial assessments pairs over the set of alternatives.

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

<alternativesMatrix>
    <row>
        <alternativeID>[...]</alternativeID>
        <column>
            <alternativeID>[...]</alternativeID>
            <values>
                <value><real>[...]</real></value>
            </values>
        </column>
        [...]
    </row>
    [...]
</alternativesMatrix>

parameters

A set of method parameters to tune the algorithm:

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

<methodParameters>
    <parameter id="TryToReciprocalMatrix">
        <value>
            <boolean>%1</boolean>
        </value>
    </parameter>

    <parameter id="NormalizeResults">
        <value>
            <boolean>%2</boolean>
        </value>
    </parameter>

    <parameter id="CalculationMethod">
        <value>
            <label>%3</label>
        </value>
    </parameter>

    <parameter id="WithSmallestError">
        <value>
            <boolean>%4</boolean>
        </value>
    </parameter>

     <parameter id="MaxIterations">
        <value>
            <integer>%5</integer>
        </value>
    </parameter>
</methodParameters>

where:

• %1 is a parameter named “Try reciprocity restoration procedure for pairwise comparisons matrix?”. This is a boolean. The default value is false.

• %2 is a parameter named “Normalize results?”. This is a boolean. The default value is true.

• %3 is a parameter named “Calculation method”. It can have the following values:

  • Arithmetic: Arithmetic
  • Geometric: Geometric
  • MinimizingEstimationError: Minimizing estimation error with arithmetic approach

  The default value is item0.

• %4 is a parameter named “Try minimal absolute estimation error?”. This is a boolean. The default value is false.

• %5 is a parameter named “Maximum iterations”. This is a int, and the value should conform to the following constraint: Iterations should be positive. More formally, the constraint is:

  %1 > 0
  

  The default value is 100.

alternativesValues

Calculated rankings for all alternatives.

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

<alternativesValues>
    <alternativeValue>
        <alternativeID> [...] </alternativeID>
        <values>
            <value><real> [...] </real></value>
        </values>
    </alternativeValue>
    [...]
</alternativesValues>

messages

Log message about program status. This can be ‘ok’ when algorithm finish successfully or ‘error’ when something goes wrong.

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

<methodMessages>
    <message>
        <text> [...] </text>
    </message>
</methodMessages>