All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class guinea.logic.TAFCTest

java.lang.Object
   |
   +----guinea.logic.Test
           |
           +----guinea.logic.GenericTest
                   |
                   +----guinea.logic.GenericABCTest
                           |
                           +----guinea.logic.TAFCTest

public class TAFCTest
extends GenericABCTest
implements PropertyLoader
In an TAFC (Two alternatives forced choice) Test two samples are compared. Two samples are played altering some parameter until the subject can no longer hear the difference between the samples.

The test uses the procedures and terms described in

Levitt H. (1971) Transformed Up-Down Methods in Psychoacoustics

See Also:
TAFCRule

Variable Index

· answerName
The question ID used to log the answer.
· buttonControlName
The control ID of the button control used in TAFC test.
· buttonPressed
Did the subject press a button (indicates heard a difference, etc.) within given time between TAFC trials.
· initialLevel
Initial level for signal B at the start of test item's test procedure.
· logTrial
Whether to log the trials list of this item.
· maxRuns
The maximum number of runs for this TAFC test.
· pauseLength
Length of pause (in milliseconds) between TAFC trials.
· rule
The TAFC rule object for this test.
· ruleType
The rule type number.
· sampleB
The sample for signal B.
· sampleRef
The reference sample the sample B is compared with.
· stepSize
The step size of a step in a TAFC test.
· trialAnswerName
The question ID used to log the trial list (if trials logging is enabled via logTrial variable.

Constructor Index

· TAFCTest()
Construct a new TAFC test object.

Method Index

· controlPerformed(ControlEvent, SessionSubject)
Process control messages from the subject UI.
· endItem()
Add the result of the TAFC procedure to the subject.
· getRule(int)
Get a TAFC rule object.
· initItemSamples_base()
Initialize samples for this item.
· initTest()
Initialize the TAFC rule object for use in this test.
· propertyLoad(Properties, String)
Read parameters for this test from the properties.
· runSequence()
Run the TAFC procedure for this item.
· runSequence2()
Play the sample sequence.

Variables

· sampleB
 protected transient Sample sampleB
The sample for signal B. Sample B's level is controlled by the current TAFC rule.

· sampleRef
 protected transient Sample sampleRef
The reference sample the sample B is compared with.

· initialLevel
 protected Volume initialLevel
Initial level for signal B at the start of test item's test procedure. Default level is +0.0dB (1.0 linear).

· stepSize
 protected Volume stepSize
The step size of a step in a TAFC test. Default is 3.0dB.

· maxRuns
 protected int maxRuns
The maximum number of runs for this TAFC test.

· rule
 protected TAFCRule rule
The TAFC rule object for this test.

· ruleType
 protected int ruleType
The rule type number.

· buttonPressed
 protected boolean buttonPressed
Did the subject press a button (indicates heard a difference, etc.) within given time between TAFC trials.

· pauseLength
 protected long pauseLength
Length of pause (in milliseconds) between TAFC trials. Default is 2000ms (2 seconds).

· answerName
 protected String answerName
The question ID used to log the answer.

· logTrial
 protected boolean logTrial
Whether to log the trials list of this item. Default is false.

· trialAnswerName
 protected String trialAnswerName
The question ID used to log the trial list (if trials logging is enabled via logTrial variable.

· buttonControlName
 protected String buttonControlName
The control ID of the button control used in TAFC test.

Constructors

· TAFCTest
 public TAFCTest()
Construct a new TAFC test object.

Methods

· initTest
 public void initTest() throws Exception
Initialize the TAFC rule object for use in this test. It calls super-classes initTest() method to do default stuff. In addition it creates and initializes a TAFC rule object for the test.

Throws: Exception
an exception is thrown if player initialization fails for some reason.
Overrides:
initTest in class Test
· getRule
 protected TAFCRule getRule(int type)
Get a TAFC rule object.

Parameters:
type - Type of rule. Only rule 1 is currently implemented.
Returns:
A TAFC rule object.
See Also:
TAFCRule1
· runSequence
 protected void runSequence() throws InterruptedException
Run the TAFC procedure for this item. It plays the selected fixed sample sequence and waits for answer for a period. Then the TAFC rule is called to record the result. Then rule decides whether TAFC procedure should continue or finish.

Throws: InterruptedException
an exception is thrown if sequence was interrupted for some reason .
Overrides:
runSequence in class GenericTest
See Also:
rule, TAFCRule
· runSequence2
 protected void runSequence2() throws InterruptedException
Play the sample sequence. This is essentially the same as superclasses runSequence() method. It has some minor tuning for TAFC test.

Throws: InterruptedException
an exception is thrown if sequence was interrupted for some reason .
See Also:
runSequence
· initItemSamples_base
 protected void initItemSamples_base() throws Exception
Initialize samples for this item.

Throws: Exception
an exception is thrown if item samples initialization fails for some reason.
Overrides:
initItemSamples_base in class GenericABCTest
· endItem
 protected void endItem()
Add the result of the TAFC procedure to the subject. It is done this way because there is no actual UI components that could give this kind of answer directly. The answer is calculated based of a series of answers from the subject. Optionally, the procedure's trial list can also be logged.

Overrides:
endItem in class Test
· controlPerformed
 public void controlPerformed(ControlEvent e,
                              SessionSubject subj)
Process control messages from the subject UI.

Overrides:
controlPerformed in class GenericTest
· propertyLoad
 public void propertyLoad(Properties p,
                          String name) throws IllegalArgumentException
Read parameters for this test from the properties.

Parameters:
p - the properties.
name - the name of this object (not usually used)
Throws: IllegalArgumentException
thrown if parameters are wrong.
Overrides:
propertyLoad in class GenericABCTest

All Packages  Class Hierarchy  This Package  Previous  Next  Index