public class InformationTable2PCTConverter
extends java.lang.Object
null
), then conversion to the differences of evaluations
is performed instead.Modifier and Type | Field | Description |
---|---|---|
static boolean |
allLearningObjectsAreReferenceObjects |
Tells if all objects available in the learning information table, even if not involved in any pairwise comparison or in a given reference ranking,
should be considered as reference objects.
Meaningful only when superviseConversionToPCT flag is set to true .Initialized with DEFAULT_ALL_LEARNING_OBJECTS_ARE_REFERENCE_OBJECTS . |
static double |
comprehensiveNotWeakPreferenceGrade |
Grade of comprehensive preference relation assigned in conversion methods which use ranking of examples,
when first example from pair is comprehensively not weakly preferred to second example from pair (first example does
not surpass second one = x S^c y).
This value has to be smaller than comprehensiveWeakPreferenceGrade . |
static java.lang.String |
comprehensivePreferenceRelationAttributeName |
Name set for decision attribute in PCT resulting from conversion.
|
static double |
comprehensiveWeakPreferenceGrade |
Grade of comprehensive preference relation assigned in conversion methods which use ranking of examples,
when first example from pair is comprehensively weakly preferred to second example from pair (first example surpasses
second one = x S y).
This grade is also used in conversion methods which use pairwise comparisons - it is assigned to each pair of the same objects. |
static boolean |
decisionIsPairField |
Tells if created PCT's decision criterion should store pairs of simple field decision class labels.
|
static boolean |
DEFAULT_ALL_LEARNING_OBJECTS_ARE_REFERENCE_OBJECTS |
Default value of
allLearningObjectsAreReferenceObjects . |
static int |
EVALUATIONS_DIFFERENCE |
Possible mode of transformation to PCT for active condition cardinal criteria
|
static java.lang.String |
pairOfExamplesNumbersAttributeName |
Name set for description attribute in PCT resulting from conversion.
|
static int |
PREFERENCE_INTENSITY_DEGREE |
Possible mode of transformation to PCT for active condition cardinal criteria
|
static java.lang.String |
prefixForEvaluationsDifferenceAttributeName |
Prefix for names of those criteria in PCT resulting from conversion whose values are differences of evaluations
|
static java.lang.String |
prefixForPairAttributeName |
Prefix for names of those criteria in PCT resulting from conversion whose values are pairs
|
static java.lang.String |
prefixForPreferenceDegreeAttributeName |
Prefix for names of those criteria in PCT resulting from conversion whose values are degrees of the intensity of preference
|
static boolean |
superviseConversionToPCT |
Tells if the conversion of information table to a PCT should be supervised.
|
static boolean |
throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation |
Tells if an exception should be thrown if a pair of objects (a,b) is assigned by the DM to non-outranking relation while it should be assigned to outranking relation since a D b (in particular a = b).
Initialized with true .Meaningful only when superviseConversionToPCT flag is set to true . |
Modifier and Type | Method | Description |
---|---|---|
static MemoryContainer |
convert(MemoryContainer informationTable) |
Returns
convert(informationTable, null) (null for parameter of type EvaluationDifference2PreferenceIntensityDegree ). |
static MemoryContainer |
convert(MemoryContainer informationTable,
int[] rankingOfExamples) |
Returns
convert(informationTable, rankingOfExamples, null) . |
static MemoryContainer |
convert(MemoryContainer informationTable,
int[] rankingOfExamples,
EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree) |
Constructs PCT from given information table, for pairs of examples resulting from given ranking (examples' numbers starts from zero)
and for given information (if present) about how to convert differences of evaluations on condition cardinal criteria
from given information table to the degrees of the intensity of preference, which will be stored in PCT.
Takes into account superviseConversionToPCT , throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation ,
and Settings.getTypeOfFamilyOfCriteria() .For example, if superviseConversionToPCT == false , for ranking of examples equal to 1, 0, 3 (these are examples' numbers) resulting PCT will consist of nine rows,
created for pairs (in that order): (1,1), (1,0), (1,3); (0,1), (0,0), (0,3); (3,1), (3,0), (3,3).Grade of comprehensive preference of first example from pair over second example will be automatically set to comprehensiveWeakPreferenceGrade for pairs, for which preference occurs
and to comprehensiveNotWeakPreferenceGrade for pairs, for which not preference occurs. |
static MemoryContainer |
convert(MemoryContainer informationTable,
EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree) |
Constructs PCT from given information table, for all possible pairs of examples
and for given information (if present) about how to convert differences of evaluations on condition cardinal criteria
from given information table to the degrees of the intensity of preference, which will be stored in PCT.
|
static MemoryContainer |
convert(MemoryContainer informationTable,
PairOfIndices[] pairsOfExamplesNumbers,
java.lang.Double[] preferenceRelations) |
Converts an information table to a PCT given sample evaluations of pairs of examples from
informationTable . |
static MemoryContainer |
convert(MemoryContainer informationTable,
SimpleRanking simpleRanking,
boolean considerIndifferentObjects) |
Returns
convert(informationTable, simpleRanking, null) . |
static MemoryContainer |
convert(MemoryContainer informationTable,
SimpleRanking simpleRanking,
EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree,
boolean considerIndifferentObjects) |
Constructs PCT from given information table, for pairs of examples resulting from given simple ranking
(examples' numbers start from zero)
and for given information (if present) about how to convert differences of evaluations on condition cardinal criteria
from given information table to the degrees of the intensity of preference, which will be stored in PCT.
|
static MemoryContainer |
convert(MemoryContainer informationTable,
PairField[] pairsOfExamplesNumbers,
boolean createDecisionCriterion) |
Returns
convert(informationTable, pairsOfExamplesNumbers, null, createDecisionCriterion, EVALUATIONS_DIFFERENCE) . |
static MemoryContainer |
convert(MemoryContainer informationTable,
PairField[] pairsOfExamplesNumbers,
EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree,
boolean createDecisionCriterion) |
If
evaluationDifference2PreferenceIntensityDegree is equal to null ,
returns convert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, EVALUATIONS_DIFFERENCE) ,
else returns convert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, PREFERENCE_INTENSITY_DEGREE) . |
static MemoryContainer |
convertWithPairDecision(MemoryContainer informationTable,
EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree) |
Constructs PCT from given information table, for all possible pairs of examples
and for given information (if present) about how to convert differences of evaluations on condition cardinal criteria
from given information table to the degrees of the intensity of preference, which will be stored in PCT.
|
static int |
getLatestNumberOfUnexpectedAssignmentsToNonOutrankingRelation() |
Gets the number of unexpected assignments to non-outranking relation that have been found and corrected during latest supervised conversion to a learning PCT.
|
public static java.lang.String pairOfExamplesNumbersAttributeName
public static java.lang.String prefixForPreferenceDegreeAttributeName
public static java.lang.String prefixForEvaluationsDifferenceAttributeName
public static java.lang.String prefixForPairAttributeName
public static java.lang.String comprehensivePreferenceRelationAttributeName
public static final double comprehensiveWeakPreferenceGrade
public static final double comprehensiveNotWeakPreferenceGrade
comprehensiveWeakPreferenceGrade
.public static final int PREFERENCE_INTENSITY_DEGREE
public static final int EVALUATIONS_DIFFERENCE
public static boolean superviseConversionToPCT
Settings.getTypeOfFamilyOfCriteria()
and on the type of input preference information (reference ranking or pairwise comparisons).true
.public static boolean decisionIsPairField
public static boolean throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation
true
.superviseConversionToPCT
flag is set to true
.public static final boolean DEFAULT_ALL_LEARNING_OBJECTS_ARE_REFERENCE_OBJECTS
allLearningObjectsAreReferenceObjects
.public static boolean allLearningObjectsAreReferenceObjects
superviseConversionToPCT
flag is set to true
.DEFAULT_ALL_LEARNING_OBJECTS_ARE_REFERENCE_OBJECTS
.public static MemoryContainer convert(MemoryContainer informationTable, PairOfIndices[] pairsOfExamplesNumbers, java.lang.Double[] preferenceRelations)
informationTable
.
Wraps convert(MemoryContainer, ArrayList, EvaluationDifference2PreferenceIntensityDegree, ArrayList)
.informationTable
- - information table with examples being comparedpairsOfExamplesNumbers
- - pairs of compared examplespreferenceRelations
- - preference relations given by a decision maker for specific pairs of examples (preferenceRelations[i]
defines the comprehensive preference relation for objects indicated by pairsOfExamplesNumbers[i]
), valid values are
InformationTable2PCTConverter.comprehensiveWeakPreferenceGrade
for outranking relation S
and InformationTable2PCTConverter.comprehensiveNotWeakPreferenceGrade
for non-outranking relation S^cconvert(MemoryContainer, ArrayList, EvaluationDifference2PreferenceIntensityDegree, ArrayList)
public static MemoryContainer convert(MemoryContainer informationTable, PairField[] pairsOfExamplesNumbers, boolean createDecisionCriterion)
convert(informationTable, pairsOfExamplesNumbers, null, createDecisionCriterion, EVALUATIONS_DIFFERENCE)
.
See convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
method for details.informationTable
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodpairsOfExamplesNumbers
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodcreateDecisionCriterion
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodconvert(informationTable, pairsOfExamplesNumbers, null, createDecisionCriterion, EVALUATIONS_DIFFERENCE)
public static MemoryContainer convert(MemoryContainer informationTable, PairField[] pairsOfExamplesNumbers, EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree, boolean createDecisionCriterion)
evaluationDifference2PreferenceIntensityDegree
is equal to null
,
returns convert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, EVALUATIONS_DIFFERENCE)
,
else returns convert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, PREFERENCE_INTENSITY_DEGREE)
.
See convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
method for details.informationTable
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodpairsOfExamplesNumbers
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodevaluationDifference2PreferenceIntensityDegree
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodcreateDecisionCriterion
- see convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean, int)
methodconvert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, EVALUATIONS_DIFFERENCE)
if evaluationDifference2PreferenceIntensityDegree
is equal to null
,
convert(informationTable, pairsOfExamplesNumbers, evaluationDifference2PreferenceIntensityDegree, createDecisionCriterion, PREFERENCE_INTENSITY_DEGREE)
otherwisepublic static MemoryContainer convert(MemoryContainer informationTable, EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree)
PairField
(first one, with zero index),
with inner type CardinalField
. It is used to store ordered pair of numbers of examples for which
given row of PCT was created.MemoryContainersDescriptions
class. When creating MemoryContainerDescription
object
for new (returned) memory container, information about how to convert ordinal values to cardinal values
and information about how to convert differences of evaluations on condition cardinal criteria to the
degrees of the intensity of preference are set to null
. Evaluation space is set to
MemoryContainerDescription.PARETO
and container type is set to MemoryContainerDescription.PCT
.
Quantities of added minimal values for particular cardinal gain criteria in Lorenz evaluation space are set to null
because Pareto evaluation space is used.AttributesMeaningsDescriptions.OTHER
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE
AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE
AttributesMeaningsDescriptions.PAIR_OF_VALUES
convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method;createDecisionCriterion
is automatically set to false
.convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method.informationTable
- information table which is a basis for PCT creationevaluationDifference2PreferenceIntensityDegree
- information about how to convert differences of evaluations
on condition cardinal criteria from given information table to the degrees of the intensity of preference,
which will be stored in PCT; should be null
if differences of evaluations are usedpublic static MemoryContainer convertWithPairDecision(MemoryContainer informationTable, EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree)
PairField
(first one, with zero index),
with inner type CardinalField
. It is used to store ordered pair of numbers of examples for which
given row of PCT was created.MemoryContainersDescriptions
class. When creating MemoryContainerDescription
object
for new (returned) memory container, information about how to convert ordinal values to cardinal values
and information about how to convert differences of evaluations on condition cardinal criteria to the
degrees of the intensity of preference are set to null
. Evaluation space is set to
MemoryContainerDescription.PARETO
and container type is set to MemoryContainerDescription.PCT
.
Quantities of added minimal values for particular cardinal gain criteria in Lorenz evaluation space are set to null
because Pareto evaluation space is used.AttributesMeaningsDescriptions.OTHER
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE
AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE
AttributesMeaningsDescriptions.PAIR_OF_VALUES
AttributesMeaningsDescriptions.PAIR_OF_VALUES.
convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method;
createDecisionCriterion
is automatically set to true
.convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method.informationTable
- information table which is a basis for PCT creationevaluationDifference2PreferenceIntensityDegree
- information about how to convert differences of evaluations on
condition cardinal criteria from given information table to
the degrees of the intensity of preference, which will be
stored in PCT; should be null
if differences of
evaluations are usedpublic static MemoryContainer convert(MemoryContainer informationTable)
convert(informationTable, null)
(null
for parameter of type EvaluationDifference2PreferenceIntensityDegree
).
See convert(MemoryContainer, EvaluationDifference2PreferenceIntensityDegree)
method for details.informationTable
- see convert(MemoryContainer, EvaluationDifference2PreferenceIntensityDegree)
methodconvert(informationTable, null)
(null
for parameter of type EvaluationDifference2PreferenceIntensityDegree
)public static MemoryContainer convert(MemoryContainer informationTable, int[] rankingOfExamples, EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree)
superviseConversionToPCT
, throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation
,
and Settings.getTypeOfFamilyOfCriteria()
.superviseConversionToPCT == false
, for ranking of examples equal to 1, 0, 3 (these are examples' numbers) resulting PCT will consist of nine rows,
created for pairs (in that order): (1,1), (1,0), (1,3); (0,1), (0,0), (0,3); (3,1), (3,0), (3,3).comprehensiveWeakPreferenceGrade
for pairs, for which preference occurs
and to comprehensiveNotWeakPreferenceGrade
for pairs, for which not preference occurs.
Preference also occurs for pairs of the same objects - e.g. for pair (1,1).PairField
(first one, with zero index),
with inner type CardinalField
. It is used to store ordered pair of numbers of examples for which
given row of PCT was created. Resulting PCT gets also one extra decision attribute of type FloatField
(last one), with gain preference, which is used to store grades of comprehensive preference relation
of first example from pair over second one.MemoryContainersDescriptions
class. When creating MemoryContainerDescription
object
for new (returned) memory container, information about how to convert ordinal values to cardinal values
and information about how to convert differences of evaluations on condition cardinal criteria to the
degrees of the intensity of preference are set to null
. Evaluation space is set to
MemoryContainerDescription.PARETO
and container type is set to MemoryContainerDescription.PCT
.
Quantities of added minimal values for particular cardinal gain criteria in Lorenz evaluation space are set to null
because Pareto evaluation space is used.AttributesMeaningsDescriptions.OTHER
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE
AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE
AttributesMeaningsDescriptions.PAIR_OF_VALUES
AttributesMeaningsDescriptions.VALUE
convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method;createDecisionCriterion
is automatically set to true
.convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method.informationTable
- information table which is a basis for PCT creationrankingOfExamples
- ranking of examples.
If number of example x has lower index than number of example y, it means that x surpasses y (x S y) and not y surpasses x (y Sc x).
If number of example x has greater index than number of example y, it means that y surpasses x (y S x) and not x surpasses y (x Sc y).evaluationDifference2PreferenceIntensityDegree
- information about how to convert differences of evaluations
on each condition cardinal criterion from given information table to the degrees of the intensity of preference,
which will be stored in PCT; should be null
if differences of evaluations are usedInvalidValueException
- when length of the ranking of examples is less than oneInvalidValueException
- when throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation
flag is set to true
and a dominating object is lower in the given ranking than the dominated objectpublic static MemoryContainer convert(MemoryContainer informationTable, SimpleRanking simpleRanking, EvaluationDifference2PreferenceIntensityDegree evaluationDifference2PreferenceIntensityDegree, boolean considerIndifferentObjects)
superviseConversionToPCT
and throwExceptionOnUnexpectedAssignmentToNonOutrankingRelation
,
and Settings.getTypeOfFamilyOfCriteria()
.superviseConversionToPCT == false
and considerIndifferentObjects == true
, for ranking of examples equal to:comprehensiveWeakPreferenceGrade
for pairs, for which preference occurs
and to comprehensiveNotWeakPreferenceGrade
for pairs, for which not preference occurs.
Preference also occurs for pairs of the same objects - e.g. for pair (1,1).PairField
(first one, with zero index),
with inner type CardinalField
. It is used to store ordered pair of numbers of examples for which
given row of PCT was created. Resulting PCT gets also one extra decision attribute of type FloatField
(last one), with gain preference, which is used to store grades of comprehensive preference relation
of first example from pair over second one.MemoryContainersDescriptions
class. When creating MemoryContainerDescription
object
for new (returned) memory container, information about how to convert ordinal values to cardinal values
and information about how to convert differences of evaluations on condition cardinal criteria to the
degrees of the intensity of preference are set to null
. Evaluation space is set to
MemoryContainerDescription.PARETO
and container type is set to MemoryContainerDescription.PCT
.
Quantities of added minimal values for particular cardinal gain criteria in Lorenz evaluation space are set to null
because Pareto evaluation space is used.AttributesMeaningsDescriptions.OTHER
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE
AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE
AttributesMeaningsDescriptions.PAIR_OF_VALUES
AttributesMeaningsDescriptions.VALUE
convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method;createDecisionCriterion
is automatically set to true
.convert(MemoryContainer, PairField[], EvaluationDifference2PreferenceIntensityDegree, boolean)
method.informationTable
- information table which is a basis for PCT creationsimpleRanking
- ranking of examples being a complete preorderevaluationDifference2PreferenceIntensityDegree
- information about how to convert differences of evaluations
on each condition cardinal criterion from given information table to the degrees of the intensity of preference,
which will be stored in PCT; should be null
if differences of evaluations are usedconsiderIndifferentObjects
- tells if for any two different objects x and y sharing the same rank in the given ranking in the resulting PCT there should be put two pairs: (x,y) in S and (y,x) SInvalidValueException
- when given ranking does not contain at least one examplepublic static MemoryContainer convert(MemoryContainer informationTable, int[] rankingOfExamples)
convert(informationTable, rankingOfExamples, null)
.
See convert(MemoryContainer, int[], EvaluationDifference2PreferenceIntensityDegree)
method for details.informationTable
- see convert(MemoryContainer, int[], EvaluationDifference2PreferenceIntensityDegree)
methodrankingOfExamples
- see convert(MemoryContainer, int[], EvaluationDifference2PreferenceIntensityDegree)
methodconvert(informationTable, rankingOfExamples, null)
public static MemoryContainer convert(MemoryContainer informationTable, SimpleRanking simpleRanking, boolean considerIndifferentObjects)
convert(informationTable, simpleRanking, null)
.
See convert(MemoryContainer, SimpleRanking, EvaluationDifference2PreferenceIntensityDegree)
method for details.informationTable
- see convert(MemoryContainer, SimpleRanking, EvaluationDifference2PreferenceIntensityDegree)
methodsimpleRanking
- see convert(MemoryContainer, SimpleRanking, EvaluationDifference2PreferenceIntensityDegree)
methodconsiderIndifferentObjects
- see convert(MemoryContainer, SimpleRanking, EvaluationDifference2PreferenceIntensityDegree)
methodconvert(informationTable, simpleRanking, null)
public static int getLatestNumberOfUnexpectedAssignmentsToNonOutrankingRelation()