public class MemoryContainersDescriptions
extends java.lang.Object
Modifier and Type | Method | Description |
---|---|---|
static boolean |
containsDescription(MemoryContainer memoryContainer) |
Checks if description of given memory container is stored.
|
static void |
createAndStoreBasicDescription(MemoryContainer memoryContainer,
int memoryContainerType,
int evaluationSpaceUsed) |
Automatically creates and stores description (object of type
MemoryContainerDescription )
for given memory container.Assumes that: - information about how to convert ordinal values to cardinal values is not set (equal to null ),- information about how to convert differences of evaluations on conditional cardinal criteria to the degrees of the intensity of preference is not set (equal to null ).Additionally assumes that: a) in case of information table: - if Lorenz evaluation space is used, attribute is active, conditional, cardinal and has gain preference type assigned then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SUM_OF_MIN_VALUES ,- if attribute is active, conditional or decision and of type SimpleField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.VALUE
(whatever evaluation space is used),- if attribute is active, conditional and of type PairField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.PAIR_OF_VALUES
(whatever evaluation space is used),- if Pareto evaluation space is used and attribute is active, conditional and of type SimilarityField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SIMILARITY ,- if none of two above conditions is fulfilled, then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.OTHER .b) in case of PCT: - if attribute is active conditional cardinal criterion then: if Lorenz evaluation space is used and criterion is of type GAIN, then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SUM_OF_MIN_PREFERENCE_INTENSITY_DEGREES ;
otherwise (for Pareto evaluation space) description of the meaning of such attribute is resolved to
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE or AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE ,
depending on criterion's preference type, type of criterion's initial value and, eventually, criterion's name,- if attribute is active, conditional and of type PairField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.PAIR_OF_VALUES
(whatever evaluation space is used),- if Pareto evaluation space is used and attribute is active, conditional and of type SimilarityField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SIMILARITY ,- if attribute is active decision gain criterion of type FloatField ,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.VALUE ,- if none of two above conditions is fulfilled, then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.OTHER . |
static MemoryContainerDescription |
retrieveDescription(MemoryContainer memoryContainer) |
Retrieves description for given memory container.
|
static void |
storeDescription(MemoryContainer memoryContainer,
MemoryContainerDescription memoryContainerDescription) |
Stores or replaces description for given memory container.
|
public static void storeDescription(MemoryContainer memoryContainer, MemoryContainerDescription memoryContainerDescription)
memoryContainer
- memory container for which description should be storedmemoryContainerDescription
- description to store for given memory containerjava.lang.NullPointerException
- when given memory container or its description is null
InvalidValueException
- when memory container contains no attributes or no examples,
when quantity of attributes' meanings descriptions stored in memory container description object
is different than quantity of attributes in given memory container
or when any description of the meaning of an attribute stored in memory container description object
is not set yet or invalid in the context of corresponding attribute from given memory containerpublic static MemoryContainerDescription retrieveDescription(MemoryContainer memoryContainer)
memoryContainer
- reference to memory container whose description should be retrievedjava.lang.NullPointerException
- when memory container is null
ValueNotFoundException
- when description for given memory container is not storedpublic static boolean containsDescription(MemoryContainer memoryContainer)
memoryContainer
- reference to memory container for which check is performedtrue
if description of given memory container is stored,
false
otherwisejava.lang.NullPointerException
- if given memory container is null
public static void createAndStoreBasicDescription(MemoryContainer memoryContainer, int memoryContainerType, int evaluationSpaceUsed)
MemoryContainerDescription
)
for given memory container.null
),null
).AttributesMeaningsDescriptions.SUM_OF_MIN_VALUES
,SimpleField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.VALUE
(whatever evaluation space is used),PairField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.PAIR_OF_VALUES
(whatever evaluation space is used),SimilarityField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SIMILARITY
,AttributesMeaningsDescriptions.OTHER
.AttributesMeaningsDescriptions.SUM_OF_MIN_PREFERENCE_INTENSITY_DEGREES
;
otherwise (for Pareto evaluation space) description of the meaning of such attribute is resolved to
AttributesMeaningsDescriptions.PREFERENCE_INTENSITY_DEGREE
or AttributesMeaningsDescriptions.EVALUATIONS_DIFFERENCE
,
depending on criterion's preference type, type of criterion's initial value and, eventually, criterion's name,PairField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.PAIR_OF_VALUES
(whatever evaluation space is used),SimilarityField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SIMILARITY
,FloatField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.VALUE
,AttributesMeaningsDescriptions.OTHER
.
c) in case of similarity table and Pareto evaluation space:SimilarityField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.SIMILARITY
,SimpleField
,
then description of the meaning of such attribute is set to AttributesMeaningsDescriptions.VALUE
,AttributesMeaningsDescriptions.OTHER
.memoryContainer
- reference to memory container for which basic description should be created and storedmemoryContainerType
- type of given memory container. Should be MemoryContainerDescription.INFORMATION_TABLE
,
MemoryContainerDescription.PCT
or MemoryContainerDescription.SIMILARITY_TABLE
.evaluationSpaceUsed
- Evaluation space in which evaluations from given memory container are defined.
Should be MemoryContainerDescription.PARETO
or MemoryContainerDescription.LORENZ
.java.lang.NullPointerException
- when memory container is null
InvalidValueException
- when memory container contains no attributes or no examples,
when memory container type is none of MemoryContainerDescription.INFORMATION_TABLE
,
MemoryContainerDescription.PCT
and MemoryContainerDescription.SIMILARITY_TABLE
,
when evaluation space used is none of MemoryContainerDescription.PARETO
and MemoryContainerDescription.LORENZ
or when any attribute is unexpected for given memory container type and evaluation space