PrometheePreferenceReinforcedPreference

criteria

Criteria to consider.

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

alternatives

Alternatives to consider.

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

performance_table

The performance of alternatives.

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

profiles_performance_table (optional)

The performance of profiles (boundary or central).

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

criteria_scales

Preference direction (min or max) specified for each criterion.

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

criteria_thresholds

Preference, indifference and sigma thresholds for criteria (as constants as well as linear functions). Gaussian function needs inflection point (sigma), rest of functions need preference or indifference thresholds.

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

weights

Weights of criteria to consider.

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

generalised_criteria (optional)

ID number of predefined preference function specified for each criterion.

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

reinforcement_factors

Definitions of so-called ‘reinforcement factors’, one per each criterion for which ‘reinforcement threshold’ has been defined. For more regarding these concepts see the paper from ‘Reference’ section.

This input is mandatory, if you don’t need the concept of reinforced preference please use ‘PrometheePreference’.

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

categories_profiles (optional)

Definitions of central or boundary profiles connected with classes (categories)

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

method_parameters

First parameter specifies the type of elements provided for comparison.

Choosing ‘boundary_profiles’ or ‘central_profiles’ requires providing inputs ‘classes_profiles’ and ‘profiles_performance_table’ as well (which are optional by default).

Second parameter specifies the type of function used for comparison of each criterion. Choosing ‘specified’ requires providing inputs “generalised_criterion” which is optional by default. Choosing some of numbers sets same function for all criteria.

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

<programParameters>
        <parameter id="comparison_with" name="comparison_with">
                <values>
                        <value>
                                <label>%1</label>
                        </value>
                </values>
        </parameter>
        <parameter id="criterion" name="generalised_criterion">
                <values>
                        <value>
                                <label>%2</label>
                        </value>
                </values>
        </parameter>
        </programParameters>

where:

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

  • alternatives: alternatives vs alternatives
  • boundary_profiles: alternatives vs boundary profiles
  • central_profiles: alternatives vs central (characteristic) profiles

  The default value is item0.

• %2 is a parameter named “generalised criterion”. It can have the following values:

  • specified: Each criterion needs its own function
  • usual: Usual Criterion
  • u-shap: U-Shape Criterion, needs indifference threshold specified in criterion.
  • v-shape: V-Shape Criterion, needs threshold of strict preference specified in criterion.
  • level: Level Criterion, needs both indifference and strict preference thresholds specified in criterion.
  • v-shape-ind: V-Shape with Indifference Criterion, needs both indifference and strict preference thresholds specified in criterion.

  The default value is item0.

preferences

Aggregated preference matrix computed from the given data. This matrix aggregates partial preference indices from all criteria into single preference index per pair of alternatives or alternatives/profiles.

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

partial_preferences

Preference matrix computed from the given data. This matrix contains partial preference indices for all criteria and all pairs of alternatives or alternatives/profiles.

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