expyfun.stimuli.CRMPreload#
- class expyfun.stimuli.CRMPreload(fs, ref_rms=0.01, ramp_dur=0.01, stereo=False, path=None)[source]#
Store the CRM corpus in memory for fast access.
- Parameters:
- fsfloat
The sampling rate of the corpus to load. You must have run
prepare_corpus
for that sampling rate first.- ref_rmsfloat
The baseline RMS value to normalize the stimuli. Default is 0.01. Normalization is done at the corpus level, not at the sentence or talker.
- ramp_durfloat
The duration (in seconds) of the onset-offset ramps. Use 0 for no ramp.
- stereobool
Whether to return the data as stereo or not.
- pathstr
The location of the stimulus directory. Defaults to the data directory where the raw CRM originals are stored.
Methods
sentence
(sex, talker_num, callsign, color, ...)Get a specific sentence from the pre-loaded data.
- sentence(sex, talker_num, callsign, color, number)[source]#
Get a specific sentence from the pre-loaded data.
- Parameters:
- sexstr | int
The sex of the talker
- talker_numstr | int
The zero-indexed talker number. Note that, obviously, male 2 is a different talker than female 2.
- callsignstr | int
The callsign of the sentence.
- colorstr | int
The color of the sentence.
- numberstr | int
The number of the sentence. Note that due to zero-indexing, a value of
'3'
will cause the talker to say “three”, while a value of3
will cause the talker to say “four” (see Notes below for more information).
- Returns:
- sentencearray
The requested sentence data.
See also
Notes
Use
expyfun.stimuli.crm_info()
to see allowable values.When getting a CRM sentence, you can use the full word (e.g., ‘male’, ‘green’), the first letter of that word (‘m’, ‘g’), or the index of that word in the list of options (0, 3). It should be noted that the index of
'1'
is 0, so care must be taken if using indices for the number argument.