Drifting Grating Stimulus¶
A drifting grating stimulus
Spatial frequency (cycles per degree)
Drift speed (degrees per second)
Direction of drift (degrees)
Starting phase (degrees)
This parameter is relevant only when the stimulus is live queued and the values of starting_phase,
spatial_frequency, and/or speed are changed while the stimulus is
playing. Most notably, if the parameter’s value is
NO, then changes
to speed will cause a discontinuous jump in phase. If the value is
YES, then changes to speed will be smooth, with no phase jump.
YES, the grating will function as a mask (similar to a Mask Stimulus). When used as part of a layer, “high”
regions of the grating (where the value is close to one) will allow
stimuli beneath it in the layer to show through, while “low” regions
(where the value is near zero) will partially or fully erase such
stimuli, exposing any stimuli beneath the layer.
Note: For compatibility with existing experiments, the value of this
parameter can also be one of
gaussian, in which case it specifies the type of mask to apply to
the grating. However, this usage is deprecated, and new experiments
should use a Mask Stimulus instead.
YES, all grating values are inverted, e.g. high values become low, and low values become high
The color of the stimulus, expressed as a comma-separated list of red, green, and blue components. Each component may be described by any valid expression, but the expression must result in a value between 0 and 1 (inclusive).
Controls the transparency of the stimulus.
1.0 is fully opaque, while
0.0 is fully tranparent.
Horizontal size (degrees).
Vertical size (degrees).
Horizontal center position (degrees)
Vertical center position (degrees)
Controls when the stimulus is loaded. If
no, the stimulus is loaded at experiment load time. If
yes, the stimulus is loaded the first time it is queued. If
explicit, the stimulus must be loaded explictly with Load Stimulus.
YES, the stimulus will start playing automatically (as if by an implicit Play Dynamic Stimulus action) after it has been queued and Update Stimulus Display has been invoked. It will also stop playing automatically (as if by an implicit Stop Dynamic Stimulus action) after it has been dequeued and Update Stimulus Display is invoked.
Standard deviation of Gaussian mask.
The Gaussian mask is computed on a 2x2 square, centered at the origin, using the equation:
exp(-1.0 * (dist - mean) * (dist - mean) / (2.0 * std_dev * std_dev))
dist is distance from the center. The mask is then stretched
to cover a rectangle of x_size by y_size degrees. If the x and y
sizes are equal, then the mask is scaled by size/2 in both directions,
so std_dev has units of size/2 degrees.
Mean of Gaussian mask.
This value determines the radial offset of the Gaussian peak from the center of the grating. If non-zero, the peak will be a circle, rather than a point, and luminance will decrease both inside and outside the circle, producing a toroidal stimulus.
YES, the Gaussian mask includes a multiplicative normalization term (
NO, this term is omitted.