Difference between revisions of "Gitlab Repository Matrix"

From biophysics
Jump to navigation Jump to search
(Created page with "%todo")
 
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
%todo
+
==Description==
 +
The Gitlab Repository Matrix contains matlab files for the Matrix program. This program can present several sentences of five words each to a subject with a headset and keep score of the subject recalling the correct words. The program can mix sentences with noise and also vocode the spoken words and/or noise. The program can present Dutch and German sentences. The program can also present objects on a second screen to the subject. It can use an eyetracker to record the pupil size of the subject and it can use an event recorder to synchronize the sound-, screen- and eyetracker-data.
 +
 
 +
==How to install the Matrix program==
 +
*Copy the repository to your computer in a directory
 +
*Open the directory with the matrixprogram in matlab
 +
*Make a directory 'C:\DATA\<your initials>\matrixtest\Results
 +
*Make a directory 'C:\DATA\<your initials>\matrixtest\Sounds
 +
*Copy the 'Sounds\NL' and/or 'Sounds\DE' or directory from \\mbcogro-srv.science.ru.nl\install\matrixtest
 +
*Open the file 'matrix_main.ini'
 +
*In the ini-file select the language under [global]
 +
*In the ini-file select the hardware you will use under [hardware]
 +
*You can customize the tasklist using the <loadfromfile> option under [tasklist] and specify the tasklist in a file named <Tasklist.ini>
 +
*In order to customize the trial you can edit the file <..\matrix\trialPlayer\matrixTrialPlayerClass.m>
 +
 
 +
==The ini file==
 +
 
 +
The inifile contains info about:
 +
*language
 +
*paths
 +
*filenames
 +
*hardware
 +
*tasklist
 +
 
 +
Use only: "strings", true or false or numerals. <br>
 +
Lines beginning with '%' will be ignored.
 +
Comments can be added after parameter by using brackets: (comments...)
 +
 
 +
Here is an example of an inifile:
 +
 
 +
<pre>
 +
 
 +
[global]
 +
language      = "NL" ("DE" or "NL")
 +
 
 +
[paths]
 +
settings      = "\settings" (settings is relative to the program home path)
 +
results      = "C:\DATA\RL\matrixtest\Results"
 +
sounds        = "C:\DATA\RL\matrixtest\Sounds"
 +
 
 +
[sounds]
 +
% all path are relative to the paths.sounds
 +
sentencesDir  = "\Sentences"
 +
wordsDir      = "\Words"
 +
testlistsDir  = "\Testlists"
 +
noiseDir      = "\Noise"
 +
 
 +
[DE]
 +
listbase      = "olsa"
 +
matrixfile    = "wordmatrixDE.txt"
 +
noisefile    = "olnoise.wav"
 +
nomspeechfile = "nomspeechDE.wav"
 +
picturefile  = "matrixpicDE.png"
 +
 
 +
[NL]
 +
listbase      = "nlmatrix"
 +
matrixfile    = "wordmatrixNL.txt"
 +
noisefile    = "dutchspeechnoise.wav"
 +
nomspeechfile = "nomspeechNL.wav"
 +
picturefile  = "matrixpicNL.png"
 +
 
 +
 
 +
[hardware]
 +
soundprocessor= true 
 +
lsl          = false
 +
pupil        = false
 +
screen        = false
 +
rz6DeviceID  = "TST" ("TST", "EEG", "PAT", "VST", "ARM" or "None")
 +
soundProcessorType = "RZ6"  ("RZ6", "soundcard", "dummy", .....)
 +
secondaryMonitorIndex = 1 (1 or 2)
 +
 
 +
[tasklist]
 +
loadfromfile = false
 +
filename    = "Tasklist.ini" (do not change)
 +
 
 +
</pre>

Latest revision as of 13:00, 30 January 2024

Description

The Gitlab Repository Matrix contains matlab files for the Matrix program. This program can present several sentences of five words each to a subject with a headset and keep score of the subject recalling the correct words. The program can mix sentences with noise and also vocode the spoken words and/or noise. The program can present Dutch and German sentences. The program can also present objects on a second screen to the subject. It can use an eyetracker to record the pupil size of the subject and it can use an event recorder to synchronize the sound-, screen- and eyetracker-data.

How to install the Matrix program

  • Copy the repository to your computer in a directory
  • Open the directory with the matrixprogram in matlab
  • Make a directory 'C:\DATA\<your initials>\matrixtest\Results
  • Make a directory 'C:\DATA\<your initials>\matrixtest\Sounds
  • Copy the 'Sounds\NL' and/or 'Sounds\DE' or directory from \\mbcogro-srv.science.ru.nl\install\matrixtest
  • Open the file 'matrix_main.ini'
  • In the ini-file select the language under [global]
  • In the ini-file select the hardware you will use under [hardware]
  • You can customize the tasklist using the <loadfromfile> option under [tasklist] and specify the tasklist in a file named <Tasklist.ini>
  • In order to customize the trial you can edit the file <..\matrix\trialPlayer\matrixTrialPlayerClass.m>

The ini file

The inifile contains info about:

  • language
  • paths
  • filenames
  • hardware
  • tasklist

Use only: "strings", true or false or numerals.
Lines beginning with '%' will be ignored. Comments can be added after parameter by using brackets: (comments...)

Here is an example of an inifile:


[global]
language      = "NL" ("DE" or "NL")

[paths]
settings      = "\settings" (settings is relative to the program home path)
results       = "C:\DATA\RL\matrixtest\Results"
sounds        = "C:\DATA\RL\matrixtest\Sounds"

[sounds]
% all path are relative to the paths.sounds
sentencesDir  = "\Sentences"
wordsDir      = "\Words"
testlistsDir  = "\Testlists"
noiseDir      = "\Noise"

[DE]
listbase      = "olsa"
matrixfile    = "wordmatrixDE.txt"
noisefile     = "olnoise.wav"
nomspeechfile = "nomspeechDE.wav"
picturefile   = "matrixpicDE.png"

[NL]
listbase      = "nlmatrix"
matrixfile    = "wordmatrixNL.txt"
noisefile     = "dutchspeechnoise.wav"
nomspeechfile = "nomspeechNL.wav"
picturefile   = "matrixpicNL.png"


[hardware]
soundprocessor= true   
lsl           = false
pupil         = false
screen        = false
rz6DeviceID   = "TST" ("TST", "EEG", "PAT", "VST", "ARM" or "None") 
soundProcessorType = "RZ6"  ("RZ6", "soundcard", "dummy", .....)
secondaryMonitorIndex = 1 (1 or 2)

[tasklist]
loadfromfile = false
filename     = "Tasklist.ini" (do not change)