edu.umass.cs.surveyman.qc.respondents

Class AbstractRespondent

java.lang.Object

edu.umass.cs.surveyman.qc.respondents.AbstractRespondent

Direct Known Subclasses:

LexicographicRespondent, NonRandomRespondent, RandomRespondent

public abstract class AbstractRespondent
extends Object

Base class for all respondents. Respondent constructors take the survey and set up all preferences.

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.logging.log4j.Logger	LOGGER
protected static MersenneRandom	rng

Constructor Summary

Constructors

Constructor and Description
AbstractRespondent()

Method Summary

Methods

Modifier and Type	Method and Description
abstract AbstractRespondent	copy() Returns a copy of this respondent type.
protected String	generateStringComponent(Question q) Generates a string for freetext questions.
protected int	getDenominator(Question q) Gets the size of the response space for a given question.
abstract SurveyResponse	getResponse() Method to obtain the simulated survey response for the survey that this respondent was instantiated with.

Methods inherited from class java.lang.Object

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

Field Detail

LOGGER

public static final org.apache.logging.log4j.Logger LOGGER

rng

protected static final MersenneRandom rng

Constructor Detail

AbstractRespondent

public AbstractRespondent()

Method Detail

getResponse

public abstract SurveyResponse getResponse()

Method to obtain the simulated survey response for the survey that this respondent was instantiated with.

Returns:

The respondent's answer to the survey.

getDenominator

protected int getDenominator(Question q)

Gets the size of the response space for a given question. For example, if the question is exclusive (i.e., a radio button question), this will return the number of possible options. If the question is not exclusive (i.e., a checkbox question), this will return 2^|number of options|.

Parameters:

q - The question whose sample space we wish to know.

Returns:

An integer corresponding to the size of the sample space.

Throws:

RuntimeException - Cannot be called on freetext questions.

generateStringComponent

protected String generateStringComponent(Question q)

Generates a string for freetext questions. If the input question's freetextPattern field is not null, it will generate a random regular expression. If the freetextPattern field is null, but the freetextDefault field is not, it will return the default string. Otherwise, it will return the string "DEFAULT".

Parameters:

q - The question whose string response we wish to generate.

Returns:

A string for this respondent's response.

copy

public abstract AbstractRespondent copy()
                                 throws SurveyException

Returns a copy of this respondent type. Use when running simulation. Otherwise, the entire pool of respondents will be the same object and quality control won't work.

Returns:

New respondent, based on the same policy as this respondent.

Throws:

SurveyException