ElectreDiscordance

Version:0.2.0
Provider:PUT
SOAP service’s name:
 ElectreDiscordance-PUT (see SOAP requests for details)

Description

ElectreDiscordance - computes partial (i.e. per-criterion) discordance matrix using procedure which is common to the most methods from the Electre family.

The key feature of this module is its flexibility in terms of the types of elements allowed to compare, i.e. alternatives vs alternatives, alternatives vs boundary profiles and alternatives vs central (characteristic) profiles.

It also brings two new concepts: a ‘counter-veto’ threshold (cv) and ‘pre-veto’ threshold (pv) such as: cv >= v >= pv >= p (where ‘v’ is ‘veto’ threshold, and ‘p’ is ‘preference’ threshold).

Web page: http://github.com/xor-xor/electre_diviz

Inputs

(For outputs, see below)

criteria

Criteria to consider, possibly with preference, veto, pre-veto and counter-veto thresholds. Each criterion must have a preference direction specified (min or max). It is worth mentioning that this module allows to define thresholds as constants as well as linear functions.

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


classes_profiles (optional)

Definitions of profiles (boundary or central) which should be used for classes (categories) representation.

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


method_parameters

A set of parameters provided to tune up the module’s operation.

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

<methodParameters>
  <parameter name="comparison_with">
    <value>
      <label>%1</label>
    </value>
  </parameter>
  <parameter name="use_pre_veto">
    <value>
      <boolean>%2</boolean>
    </value>
  </parameter>
</methodParameters>

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 “use_pre_veto”. This is a boolean. The default value is false.


Outputs

discordance

Partial (i.e. per-criterion) discordance indices computed from the given data.

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


counter_veto_crossed

This input contains information regarding the number of criteria per pair of the alternatives/profiles on which the ‘counter-veto’ threshold has been crossed. Please note that this output will be created even if ‘counter-veto’ threshold has not been defined - in such case, all the values will be set to ‘false’.

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


messages

Messages or errors generated by this module.

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


Original xml description