In a method of adjustment experiment the subject adjusts one or more stimulus parameters in real time, typically to match their threshold for the task.
An adjustment experiment is the interaction of target elements and adjuster elements. Any adjuster element can adjust any target element(s).
You can allow the subject to adjust one or more numeric properties of an element when it is running. You can only allow the subject to adjust properties that are adjustable. Which properties are adjustable depends on the element type—see the top of the property list in its documentation. If you need to make other properties adjustable, you can edit the element type code—see Element type programming manual.
Initial value for an adjusted property is just the value you set for the property when you make the experiment (or its default value if you don't set one).
You need a separate adjuster element to run at the same time. The adjuster receives input from the subject and adjusts the target element based on it. There are various adjuster element types allowing for different methods, e.g. key press, mouse click & drag, etc. Adjustments are always numeric (not necessarily scalar). Often there are type-specific adjuster properties where you specify how input translates to adjustments (e.g. Left key → +10), and you can assign different inputs to adjustments in different directions and/or magnitudes. All adjuster elements have property adjust where you specify the target(s) it adjusts and other options for how it applies adjustments—see below.
All adjusters are also response handlers and have the properties and functionality all response handlers have. Generally the subject makes many adjustments (e.g. with arrow keys), then inputs that they are done adjusting (e.g. with the Space key). The “done adjusting” input is the response, not the adjustments. The value recorded in the adjuster’s record property response is the adjusted property value(s) of target element(s) running at the time. If you set an adjuster to record multiple responses, it just means the subject makes adjustments, responds done, makes more adjustments, responds done again, etc.—each response adds to the record as usual.
All response handler elements
translateResponse
scoreResponse
correctResponse
scoreResponseForStaircase
maxNumResponses
recordDefaultResponse
registerTrigger
autoResponse
autoResponseLatency
All elements
start
end
startBuffer
endBuffer
syncExperiment
preload
vary
staircase
All objects
info
report
Default: adjuster doesn't adjust any elements
Note you will get an error during the experiment if the subject adjusts a property to a value that is impossible for it (e.g. a negative value for a property that must be positive). You need to set the adjuster parameters so this can’t happen.
No default
A string pointing to another element object and input property. Specify the element by its variable name and possibly index, and the property using dot notation. You can also let the subject adjust part of a property by including further indexes/field names. Target must be numeric (not necessarily scalar). e.g.
<cdsm>"mask.size"<cdsm>
<cdsm>"masks(2).size"<cdsm>
<cdsm>"masks(1).size(2)"<cdsm>
(In the visual method you can specify a name/index for an object in its object heading, default = object type name. In the coding method it's just the variable name you use in the experiment script.)
For a visual element property that you set in units other than deg using <cdm>{val, <cdm><cdsm>"unit"<cdsm><cdm>}<cdm> form, just target the numeric part of the property here, e.g. <cdsm>"pictures(2).height{1}"<cdsm>.
Default: set target = current value + adjustment
You can set setExpr to a string that is any MATLAB expression for PsychBench to evaluate to set the target. The expression must reference variables val and delta which will contain current target value and adjustment. val and delta are always numeric (not necessarily scalar).
e.g.
Target must be an integer (and adjustments might not be)
→ <cdsm>"round(val+delta)"<cdsm>
If you need multiple lines of code, the string can be the name of a script that makes a variable ans containing value to set.
Default: no minimum/maximum target value
You can use these fields to set minimum and/or maximum values which the subject cannot adjust past. min/max can be single numbers to apply to all numbers in target, or numeric arrays with size = size of target.
Here the subject is able to adjust number of dots in a linearDotMask element. Initial value = 500. Minimum value = 0. Adjustments are made by key press with a keyAdjuster element: left arrow = −10, right arrow = +10. space = record a response. Both elements end when the adjuster records a response (done adjusting).
mask = linearDotMaskObject;
mask.numDots = 500;
mask.start.t = 0;
mask.end.response = true;
mask.report = <cdsm>"numDots"<cdsm>;
adjuster = keyAdjusterObject;
adjuster.deltas = {
<cdsm>"left"<cdsm> -10
<cdsm>"right"<cdsm> +10
};
adjuster.responseKeyName = <cdsm>"space"<cdsm>;
adjuster.adjust.what = <cdsm>"mask.numDots"<cdsm>;
adjuster.adjust.min = 0;
adjuster.start.t = 0;
<cdcm>% By default keyAdjuster ends on its own when it records a response<cdcm>
PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.
All response handler elements
response
responseScore
responseTime
responseLatency
d_responseTime
numResponses
All elements
startTime
endTime
duration
n_startFrame
n_endFrame
startLatencyBufferable
endLatencyBufferable
trigger
triggerTime
d_triggerTime
numTriggers
syncTime