additiveValueFunctionsIdentification

Version:1.1
Provider:RXMCDA
SOAP service’s name:
 additiveValueFunctionsIdentification-RXMCDA (see SOAP requests for details)

Description

Identifies an set of piecewise linear additive value functions according to a ranking of the alternatives. If the number of segments is not given, a general additive value function is looked for.

Contact: Helene Schmitz and Patrick Meyer (patrick.meyer@telecom-bretagne.eu)

Web page: None

Inputs

(For outputs, see below)

criteria

A list of criteria. Criteria can be activated or desactivated via the <active> tag (true or false). By default (no <active> tag), criteria are considered as active.

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

<criteria>
    <criterion>
        <active>[...]</active>
        [...]
    </criterion>
    [...]
</criteria>

alternatives

A list of alternatives. Alternatives can be activated or desactivated via the <active> tag (true or false). By default (no <active> tag), alternatives are considered as active.

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

<alternatives>
    <alternative>
        <active>[...]</active>
        [...]
    </alternative>
    [...]
</alternatives>

performanceTable

A performance table. The evaluations should be numeric values, i.e. <real>, <integer> or <rational>.

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


alternativesRanks

The ranking of the alternatives, the best alternative having the lowest rank.

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


separationThreshold

Threshold value indicating the minimal difference in terms of the overall value between two neighbor alternatives in the given ranking.

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

<methodParameters>
    <parameter
         name="separationThreshold"> <!-- REQUIRED  -->
        <value>
            <real>%1</real>
        </value>
    </parameter>
</methodParameters>

where:

  • %1 is a parameter named “separationThreshold”. This is a float, and the value should conform to the following constraint: The value should be a strictly positive float, less than the highest possible overall value.. More formally, the constraint is:

    %1 > 0
    

segments (optional)

The number of segments for the additive value functions. If it is not given, then a general additive value function is searched for.

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

<methodParameters>
    <parameter
         name="criteriaSegments"> <!-- REQUIRED  -->
        <value>
            <integer>%1</integer>
        </value>
    </parameter>
</methodParameters>

where:

  • %1 is a parameter named “numberOfSegments”. This is a int, and the value should conform to the following constraint: The value should be a strictly positive integer.. More formally, the constraint is:

    %1 > 0
    

    The default value is 1.


Outputs

valueFunctions

The value functions of the selected criteria.

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

<criteria mcdaConcept="valueFunctions">
        <criterion>
                <criterionID>[...]</criterionID>
                <criterionFunction>
                        <points>
                                <point>
                                        <abscissa><real>[...]</real></abscissa>
                                        <ordinate><real>[...]</real></ordinate>
                                </point>
                        </points>
                </criterionFunction>
        </criterion>
</criteria>

messages

A list of messages generated by the algorithm.

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


Original xml description