randomPerformanceTable

Version:1.0
Provider:PyXMCDA
SOAP service’s name:
 randomPerformanceTable-PyXMCDA (see SOAP requests for details)

Description

This service generate a random performance table from inputs. Any scale type can be used and the service have different minimum requirements:

  • Quantitative scales need at least the ‘minimum’ and ‘maximum’ values to be set
  • Qualitative scales need at least the valued labels set
  • Nominal scales need at least the labels set

Distributions can be defined per criterion for the quantitative scales in the criteriaDistributions input. Default is a uniform distribution between scale minimum and maximum bounds. To set another distribution, user needs to add a criterionValues with following identified values:

  • Uniform distribution: value ‘uniform’ with id ‘distribution’, numerical values with id ‘min’ and ‘max’ to override scale boundaries (optional)
  • Normal distribution: value ‘normal’ with id ‘distribution’, numerical values with id ‘mu’ and ‘std’ for average and standard value, numerical values with id ‘min’ and ‘max’ to override scale boundaries (optional)

N.B: ‘min’ and ‘max’ values will be ignored if they are outside of the scale limits.

Other types of scales use a uniform random sampler to choose labels (distributions inputs for these scales are ignored).

Example of normal distribution (with optional min/max values):

<criterionValues>
    <criterionID>g1</criterionID>
    <values>
        <value id="distribution">
            <label>normal</label>
        </value>
        <value id="mu">
            <real>25000</real>
        </value>
        <value id="std">
            <real>5000</real>
        </value>
        <value id="min">
            <real>0</real>
        </value>
        <value id="max">
            <real>40000</real>
        </value>
    </values>
</criterionValues>

Example of uniform distribution (with optional min/max values):

<criterionValues>
<criterionID>g2</criterionID>
    <values>
        <value id="distribution">
            <label>uniform</label>
        </value>
        <value id="min">
            <real>5</real>
        </value>
        <value id="max">
            <real>15</real>
        </value>
    </values>
</criterionValues>

Contact: Nicolas Duminy (nicolas.duminy@telecom-bretagne.eu)

Web page: https://gitlab.com/nduminy/ws-pyxmcda

Inputs

(For outputs, see below)

alternatives

The alternatives (active field disregarded for this service).

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

criteriaScales

The criteria scales.

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

criteriaDistributions (optional)

The distributions to use for each criterion.

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

parameters (optional)

Parameters of the method

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

<programParameters>
    <programParameter id="seed" name="Seed">
        <values>
            <value>
                <integer>%1</integer>
            </value>
        </values>
    </programParameter>
</programParameters>

where:

  • %1 is a parameter named “Seed”. This is a int. The default value is 0.

Outputs

performanceTable

The performance table.

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

messages

Status messages.

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

Original xml description