Differences between revisions 6 and 7
Revision 6 as of 2010-01-18 22:56:53
Size: 3560
Editor: p5B2EEB5B
Comment:
Revision 7 as of 2010-02-12 13:44:38
Size: 3636
Editor: hih-kn-2301-01
Comment:
Deletions are marked like this. Additions are marked like this.
Line 12: Line 12:

== System Requirements ==

You need Matlab R2009b to run nrec_analyse.

manual for the nrec_analyse Matlab project

1. What is nrec_analyse?

nrec_analyse is a Matlab project to read and analyse nrec data that has been stored into hdf5-files.

2. System Requirements

You need Matlab R2009b to run nrec_analyse.

3. What do the columns of the TrialList Matrix mean?

In the columns the following values are stored trial by trial:

  1. Trial number starting with 1 (Matlab-style).
  2. Number of samples in the eyeposition data matrices EyeX, EyeY.
  3. Pool number as specified by the parameters in the description file for the given paradigm type (see below).
  4. 1 if valid, else 0. Trials usually are invalid in case of a fixation failure or a missing or invalid answer.
  5. Level value of the currently active strategy. 0 if no strategy is used.
  6. 1 if the given answer was correct, 0 otherwise.
  7. The value of the given answer. Usually 2, 4, 8 or 16 in case of 4 available answer buttons.
  8. The time at which the answer was given relative to trial starttime.
  9. Starttime relative to starttime of first trial.
  10. Stoptime relative to starttime of first trial.
  11. and following can be specified by the numberOfExtraColumns and nameOfExtraColumnN parameters in the description file for the given paradigm type (see below).

4. How can i define the pool number that is stored into the TrialList matrix that contains the information for each of the trials?

  • Find the textfile in the nrec_analyse directory that has the same name as your paradigm (e.g. "Saccades.txt").
  • Open one of your data files using the hdfread tool.

  • Find out where the parameters you want to read are stored below one of the trials.
  • In the paradigm description text file you have located before, you can add values for telling nrec_analyse, to read these parameters from the hdf5-file and use them to calculate a pool number:
    • nameOfParameterGroup: Name of the group below the trialN-group where the parameters are stored.
    • numberOfParameters: How many parameters you want to use to calculate the pool number.
    • nameOfParameter1, nameOfParameter2, ...: path of the parameters below the parameter group specified by nameOfParameterGroup.
    • poolExpression: Matlab-evaluateable expression used to calculate the pool number. Use the variables p1, p2, ... for the parameters specified before. Examples:
      • "p1 + 10 * p2;" sets first parameter as second digit of the pool number and second one as first.
      • "(p1 == 17) * 6 + (p1 < 17) * 5 + (p1 > 17) * 7" sets pool number to be 5, 6 or 7 if p1 is smaller, equal or greater than 17 respectively.

5. How can i configure it to read certain values into the TrialList matrix that contains the information for each of the trials?

  • Find the textfile in the nrec_analyse directory that has the same name as your paradigm (e.g. "Saccades.txt").
  • Open one of your data files using the hdfread tool.

  • Find out where the parameters you want to read are stored below one of the trials.
  • In the paradigm description text file you have located before, you can add values for telling nrec_analyse to read these parameters from the hdf5-file and store it in columns 11, 12, ... of the TrialList matrix:

    • numberOfExtraColumns: How many parameters you want to read in.
    • nameOfExtraColumn1, nameOfExtraColumn2, ...: full path of the parameter below the trial group.

nrec: NrecAnalyse (last edited 2017-07-21 09:47:37 by FriedemannBunjes)