v4.1.1

This is a hotfix release that fixes a few issues with 4.1.0 release.

Changes

• pspm_get_eyelink now uses the scaling factor from [@hayes:2015a]
  for area based arbitrary units to milimeters conversion.
• pspm_get_smi does not perform pixel to milimeters conversion for
  pupil data anymore. Pupil values are returned as is in pixel units.
• pspm_get_smi performs pixel to milimeters conversion for gaze data
  only if the stimulus resolution in pixels are given as an extra
  option.

Improvements

• pspm_get_viewpoint is now able to import blink and saccade
  channels from sample files as well. In order to enable this feature,
  event files must be stored asynchronously in the datafile. See
  ViewPoint EyeTracker section in this manual for further information.

v4.1.0

New Functions

• pspm_convert_pixel2unit: Allows to transfer gaze data from pixel
  to units. This facilitates the use of pspm_find_valid_fixations
  which needs data in unit values.
• pspm_compute_visual_angle: Computes visual angle from gaze data.
• pspm_convert_visangle2sps: Convert visual angles from Eyelink to
  Scanpath speed.
• pspm_bf_spsrf_box: SPSRF basis function with box car.
• pspm_bf_spsrf_gamma: SPSRF basis function with gamma function.

New Features

• pspm_extract_segments supports DCM files/structures.
• GLM for SPS.
• pspm_find_valid_fixations can now take a bitmap as input.
• A new way to trim data: Start and end times can be chosen according
  to marker name or value.
• A new function to import SMI iView X EyeTracker files into PsPM.
• A new function to import ViewPoint EyeTracker files into PsPM.

Changes

• pspm_find_valid_fixations now computes a circle around the
  fixation points when run in fixations mode.

Bugfixes

• Heart period response function (bf_hprf) coefficients are fixed
  according to the manual
• pspm_extract_segments bugfixes:
  • Fix bugs related to conditions appearing in different sessions.
• pspm_get_eyelink now imports markers between two recording
  sessions (previously these markers were "lost")
• pspm_compute_visual_angle: Fix bug in range computation.
• pspm_ecg2hb: Fix out of bounds error occurring for highly noisy
  data with many outliers.
• pspm_get_acq: Fix incorrect linear transformation during ACQ
  import.
• pspm_convert_unit: Fix incorrect transformations between metric
  units and inches.
• pspm_resp_pp: Fix out of bounds error during convolution in
  cushion mode.
• pspm_pp in 'simple_qa' mode now uses the default values specified
  in pspm_simple_qa.
• Various further bugfixes.

Improvements

• Blink and saccade channels can be imported with PsPM Eyelink import.
• GLM structure holds the missing data percentage of each condition
  after segment extraction. Further, the decision to exclude
  conditions can be made depending on the percentage of missing data.
• pspm_extract_segments now works both with GLM files and already
  loaded structures
• PsPM now checks if SPM is already in MATLAB path. If so, user is
  asked to remove it from path before initializing PsPM.
• pspm_load1 now returns statistics about conditions with high NaN
  ratios.
• pspm_extract_segments now is able to use data stored in GLM/DCM
  structures instead of relying the existence of original data files.
• Multiple new tests to validate the correctness of the functions.

v4.0.2

Bugfixes

• Fix error when calling 'Convert data' from GUI
• Fix taking square root if pupil data is recorded in AREA

v4.0.1

Bugfixes

• Fix not working options in Matlabbatch module 'Preprocess heart
  data'

v4.0.0

Change from scr_ to pspm_

The prefix scr_ has been exchanged with pspm_. This applies to all
functions contained in PsPM.

Updated toolboxes

Matlabbatch (https://git.code.sf.net/p/matlabbatch/code-git) and the
VBA toolbox (https://github.com/MBB-team/VBA-toolbox) were updated to
the latest available versions (08.11.2016). The updated VBA version
fully supports newer Matlab versions and warning messages in Matlab 2014
and newer do not appear anymore (during PsPM startup). In terms of
predictive validity, we noted that there was no consistent benefit of
the old or new version of this code

Subsessions in DCM models

Until now, long periods of NaN values (which are just disregarded) could
cause problems for inversion of DCMs. These periods are now split
(according to threshold value) into subsessions. The subsessions will be
evaluated independently, while at the end the results will be stacked
together. Therefore the output-format will not change and should be
compatible with earlier releases.

Import

New import function for Labchart files

The new import function allows direct import of raw labchart files
without exporting them to a suitable format (as was required to date).
The function is only available on Windows systems.

General linear modeling (GLM)

New modalities

• Startle eyeblink for EMG (SEB)

Pupil Models

• Blink channels were removed. Periods during blinks and saccades are
  set to NaN already in the import function. This applies to all
  channels of the respective eye. Accordingly, blink validation
  functionality was removed in the function
  pspm_find_valid_fixations. If needed, blinks and saccades can be
  imported as custom channels using channel ids 7-10 (two eyes) or 4-5
  (one eye), while blinks and left eye come first.
• Importing pupil channels now allows direct specification of a
  transfer function to convert arbitrary units to mm.
• Importing of eyes which have not been recorded creates channels
  containing NaN values, so that the same import batches can be used
  for groups of subjects, even if one eye is missing in some of them.
• Sessions in eyelink files (caused by interruption of recording) will
  be concatenated according to the timing variable.
• In pspm_find_valid_fixations
  • the use of software aspect ratio was replaced by resolution.
    This allows to correctly map the gaze coordinates to the shapes
    mapped by the stimulus software.
  • gaze coordinates can be plotted in order to verify the
    validation settings.
  • interpolation option was removed and should now be used
    independently.

Minor changes & Bugfixes

• Version-Check bug during startup is now fixed.
• Markerinfos will now according to marker channels be converted to an
  event-based format.
• The data editor (pspm_data_editor) now allows to specify an output
  file using the command line.
• pspm_split_sessions additionally allows to specify marker ids at
  which the file should split.
• Artefact correction was extended with a further function (Simple SCR
  quality correction).
• Convert pupil data becomes convert data and currently only allows
  area to diameter conversion (arbitrary units to mm is integrated in
  the import function)

v3.1.2

Release version 3.1.2

v3.1.1

Release version 3.1.1

v3.1.0

General linear modelling (GLM)

New modalities

For the first time in PsPM, we introduce models for data types other
than SCR:

• GLM for evoked HPR
• GLM for fear-conditioned HPR
• GLM for evoked RA
• GLM for fear-conditioned RA
• GLM for evoked RFR
• GLM for evoked RP
• GLM for fear-conditioned PS

Tools & Data preprocessing

Tools are split up into Tools & Data preprocessing. The content of each
section is listed below.

Tools

• Display data
• Rename file
• Split sessions
• Artefact removal
• Downsample data
• Interpolate missing data
• Extract segments
• Segment mean

Data preprocessing

• Preprocess heart data
• Preprocess respiration data
• Prepare illuminance GLM
• Find valid fixations
• Convert pupil data
• Find startle sound onsets

Data preparation

Import

Support for Philips Scanphyslog files and for bioread-converted
AcqKnowledge files has been added to the import function.

v3.0.2

GLM

Problem with multiple sessions in Design matrix fixed.

v3.0.1

Import

New data types were implemented

• DATAQ Windaq (no ActiveX needed)
• European Data Format (EDF)

Tools

'Preprocess respiration traces' replaces 'Convert Respiration to
Respiration Period'. It supports conversions into the following
datatypes:

• Respiration preriod (old funtionality)
• Respiration amplitude
• Respiration line length
• Respiration time stamp

First level contrast

Z-score parameter estimates

The function pspm_con1 now supports z-scoring trial-by-trial parameter
estimates. If selected, all parameter estimates for the same event type,
across all trials, will be z-scored before computing the contrast. This
option is currently only available for non-linear models.

Review first level model

Next to the regressors on the x- and y-axes, orthogonality plots newly
display regressor names along the y-axes.