org.activemath.studentmodel2.data
Class Evidence

java.lang.Object
  org.activemath.studentmodel2.data.Evidence

Direct Known Subclasses:

EvidenceCombination

public class Evidence
extends Object

This class contains evidence in the sense of an exercise result (or part of it) for a given node in the knowledge base (mBase).
It contains information about:

• the userId of the user, who did the exercise
• the concept for which this is an evidence
• the competency this is an evidence for
• the achievement within this evidence (achievement in an exercise)
• the exerciseId of the exercise
• the competency-level of the exercise (1..4)
• the difficulty of the exercise (1..5)
• the eventId of the event
• the confidence value, the user has specified in [0,100] or -1 if not given
• a timestamp of the event
• the duration of the step
• the distance of propagation
• 0 means it's direct evidence,
• a value > 0 means it is indirect evidence

See Also:

EvidenceContainer

Field Summary

protected EvidenceData

evidenceData

Constructor Summary

Evidence()
Default constructor (empty)

Evidence(Evidence evidence, int new_distance)
Copies everything from the given evidence, but allows to set a new distance value

Evidence(ExerciseResult exResult, CognitiveProcess cognitiveProcess, String conceptId)
Constructor

Evidence(ExerciseResult exResult, CognitiveProcess cognitiveProcess, String conceptId, int distance)
Constructor

Method Summary

double	getAchievement()
CognitiveProcess	getCognitiveProcess()
CompetencyLevel	getCompetencyLevel()
String	getConceptId()
int	getConfidence()
EvidenceData	getData()
Difficulty	getDifficulty()
int	getDistance() Distance in the mBase graph to the originating concept
long	getEventId()
String	getExerciseId()
double	getIRTdifficulty()
String	getKey() Creates a key consisting of: userId "+" competencyID "+" conceptId "+" eventId
long	getStepDuration()
long	getTimestamp()
String	getUserId()
double	getWeight()
boolean	isDirectEvidence()
void	setCognitiveProcess(CognitiveProcess cognitiveProcess) Sets the cognitive process
void	setWeight(double weight)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

evidenceData

protected EvidenceData evidenceData

Constructor Detail

Evidence

public Evidence()

Default constructor (empty)

Evidence

public Evidence(Evidence evidence,
                int new_distance)

Copies everything from the given evidence, but allows to set a new distance value

Parameters:

evidence -

new_distance -

Evidence

public Evidence(ExerciseResult exResult,
                CognitiveProcess cognitiveProcess,
                String conceptId)

Constructor

Parameters:

exResult - an exercise result containing information about the outcome of an exercise done by a learner

cognitiveProcess - the competency the exercise result is for

conceptId - the corresponding concept id

distance - The distance to the originating concept

Evidence

public Evidence(ExerciseResult exResult,
                CognitiveProcess cognitiveProcess,
                String conceptId,
                int distance)

Constructor

Parameters:

exResult - an exercise result containing information about the outcome of an exercise done by a learner

cognitiveProcess - the competency the exercise result is for

conceptId - the corresponding concept id

distance - The distance to the originating concept

Method Detail

getData

public EvidenceData getData()

Returns:

A structure that contains all the data of the evidence (except weight and distance)

getAchievement

public double getAchievement()

Returns:

the achievement

getCognitiveProcess

public CognitiveProcess getCognitiveProcess()

Returns:

the cognitiveProcess

setCognitiveProcess

public void setCognitiveProcess(CognitiveProcess cognitiveProcess)

Sets the cognitive process

Parameters:

cognitiveProcess -

getCompetencyLevel

public CompetencyLevel getCompetencyLevel()

Returns:

the competencyLevel

getConceptId

public String getConceptId()

Returns:

the conceptId

getDifficulty

public Difficulty getDifficulty()

Returns:

the difficulty

getEventId

public long getEventId()

Returns:

the eventId

getExerciseId

public String getExerciseId()

Returns:

the exerciseId

getTimestamp

public long getTimestamp()

Returns:

the timestamp

getUserId

public String getUserId()

Returns:

the userId

getKey

public String getKey()

Creates a key consisting of:
userId "+" competencyID "+" conceptId "+" eventId

getDistance

public int getDistance()

Distance in the mBase graph to the originating concept

Returns:

0, direct evidence; <0 down propagation; >0 up propagation

isDirectEvidence

public boolean isDirectEvidence()

Returns:

Whether this evidence is a direct evidence

getIRTdifficulty

public double getIRTdifficulty()

Returns:

the IRTdifficulty (item value of an exercise)

getWeight

public double getWeight()

Returns:

the weight

setWeight

public void setWeight(double weight)

Parameters:

weight - the weight to set

getConfidence

public int getConfidence()

Returns:

Confidence value [0,100] or -1

getStepDuration

public long getStepDuration()

Returns:

Step-Duration, -1 if unknown

toString

public String toString()

Overrides:

toString in class Object