PrometheePreferenceReinforcedPreference

Provider:PUT
Version:1.0.0

Description

Computes aggregated preference indices with reinforced preference effect

This module is an extended version of ‘PrometheePreference’ - it brings the concept of ‘reinforced_preference’, which boils down to the new threshold of the same name and a new input file where the ‘reinforcement factors’ are defined (one for each criterion where ‘reinforced_preference’ threshold is present).

  • Web page: https://github.com/Yamadads/PrometheeDiviz
  • Reference: Bernard Roy and Roman Slowinski; Handling effects of reinforced preference and counter-veto in credibility of outranking; European Journal of Operational Research 188(1):185?190; 2008; doi:10.1016/j.ejor.2007.04.005

Inputs

(For outputs, see below)

criteria

Description:

Criteria to consider.

alternatives

Description:

Alternatives to consider.

XMCDA related:

  • Tag: alternatives

performance table

Description:

The performance of alternatives.

XMCDA related:

  • Tag: performanceTable

profiles performance table

Optional: yes, enabled by default

Description:

The performance of profiles (boundary or central).

XMCDA related:

  • Tag: performanceTable

criteria scales

Description:

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

XMCDA related:

  • Tag: criteriaScales

criteria thresholds

Description:

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.

XMCDA related:

  • Tag: criteriaThresholds

weights

Description:

Weights of criteria to consider.

XMCDA related:

  • Tag: criteriaValues

generalised criteria

Optional: yes, enabled by default

Description:

ID number of predefined preference function specified for each criterion.

XMCDA related:

  • Tag: criteriaValues

reinforcement factors

Description:

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

XMCDA related:

  • Tag: criteriaValues

categories profiles

Optional: yes, enabled by default

Description:

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

XMCDA related:

  • Tag: categoriesProfiles

method parameters

Description:

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.

GUI information:

  • Parameter values can be defined via the GUI or the XMCDA file, by default via GUI.
  • Name: comparison with
    • Type: drop-down list
    • Possible values:
      • alternatives vs alternatives (XMCDA label : alternatives) (default)
      • alternatives vs boundary profiles (XMCDA label : boundary_profiles)
      • alternatives vs central (characteristic) profiles (XMCDA label : central_profiles)
  • Name: generalised criterion
    • Type: drop-down list
    • Possible values:
      • Each criterion needs its own function (XMCDA label : specified) (default)
      • Usual Criterion (XMCDA label : usual)
      • U-Shape Criterion, needs indifference threshold specified in criterion. (XMCDA label : u-shap)
      • V-Shape Criterion, needs threshold of strict preference specified in criterion. (XMCDA label : v-shape)
      • Level Criterion, needs both indifference and strict preference thresholds specified in criterion. (XMCDA label : level)
      • V-Shape with Indifference Criterion, needs both indifference and strict preference thresholds specified in criterion. (XMCDA label : v-shape-ind)

XMCDA related:

  • Tag: programParameters

  • Code:

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

Outputs

preferences

Description:

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.

XMCDA related:

  • Tag: alternativesMatrix

partial preferences

Description:

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

XMCDA related:

  • Tag: alternativesMatrix

messages

Description:

Messages or errors generated by this module.

XMCDA related:

  • Tag: programExecutionResult

For further technical details on the web service underlying this program, have a look at its documentation here.