ACUTA

Version:2.0
Provider:UTAR
SOAP service’s name:
 ACUTA-UTAR (see SOAP requests for details)

Description

Computes ACUTA method - analytic center for UTA - which provides a set of additive value functions that have a central position in the polyhedron of admissible value functions, given some preference information (preference relation).

Contact: Boris Leistedt (boris.leistedt@gmail.com)

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>
                <criterionID>[...]</criterionID>
        </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>
                <alternativeID>[...]</alternativeID>
        </alternative>
</alternatives>

performanceTable

Values of criteria for different alternatives. It must contains IDs of both criteria and alternatives previously described.

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

<performanceTable>
        <alternativePerformances>
                <alternativeID>[...]</alternativeID>
                <performance>
                        <criterionID>[...]</criterionID>
                        <value>
                        <real>[...]</real>
                </value>
                </performance>
        </alternativePerformances>
</performanceTable>

preferencesDirections

Optimization direction for the selected criteria (min or max).

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

<criteriaValues>
        <criterionValue>
                <criterionID>[...]</criterionID>
                <value>
                        <label>[...]</label>
                </value>
        </criterionValue>
</criteriaValues>

segments

Number of segments in each value function to be constructed by UTA.

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

<criteriaValues>
        <criterionValue>
                <criterionID>[...]</criterionID>
                <value>
                        <integer>[...]</integer>
                </value>
        </criterionValue>
</criteriaValues>

alternativesRanking (optional)

Ranking (preorder) of alternatives, corresponding to pariwize preference and indifference statements.

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

<alternativesValues>
        <alternativeValue>
                <alternativeID>[...]</alternativeID>
                <value>
                        <integer>[...]</integer>
                </value>
        </alternativeValue>
</alternativesValues>

alternativesPreferences (optional)

Asymmetric part of the preference relation, representing strict preference statements, under the form of paiwise comparisons of alternatives.

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

<alternativesComparisons>
        <pairs>
                <pair>
                        <initial>
                                <alternativeID>[...]</alternativeID>
                        </initial>
                        <terminal>
                                <alternativeID>[...]</alternativeID>
                        </terminal>
                </pair>
                [...]
        </pairs>
</alternativesComparisons>

alternativesIndifferences (optional)

Symmetric part of the preference relation, representing indifference statements, under the form of paiwise comparisons of alternatives.

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

<alternativesComparisons>
        <pairs>
                <pair>
                        <initial>
                                <alternativeID>[...]</alternativeID>
                        </initial>
                        <terminal>
                                <alternativeID>[...]</alternativeID>
                        </terminal>
                </pair>
                [...]
        </pairs>
</alternativesComparisons>

delta (optional)

Optional delta value for UTA - delta is the utility gap between two successive alternatives in the preference ranking.

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

<methodParameters>
        <parameter>
                <value>
                        <real>%1</real>
                </value>
        </parameter>
</methodParameters>

where:

  • %1 is a parameter named “delta”. This is a float, and the value should conform to the following constraint: Delta should be positive and small . More formally, the constraint is:

    %1 > 0  &&  %1 < 1
    

Outputs

valueFunctions

Constructed value functions for the selected criteria and the provided rankings, using ACUTA method.

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

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

message

Log message.

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

<methodMessages mcdaConcept="methodMessage">
        <logMessage>
                <text>[...]</text>
        </logMessage>
        <errorMessage>
                <text>[...]</text>
        </errorMessage>
</methodMessages>

Original xml description