Release 7.1

[4gwe]

Status: Checking PRs listed below and updating the release documentation.
Last updated on: 09.09.2026

To check

• PR New fear-conditioned SCR pipeline #880

• PR Refactor pspm_pipeline_fc_scr API and improve usability #897

• PR Pspm tam fix #929

  • A new standard pipeline for fear-conditioned skin conductance response (SCR) analysis has been introduced. (PR New fear-conditioned SCR pipeline #880, Refactor pspm_pipeline_fc_scr API and improve usability #897)

• PR Fix pspm_convert_ppg2hb HeartPy handling and extend test coverage #925

Checked PRs

• PR App designer for review #755

• PR 660 pspm import bids #790 fixes PSPM Import BIDS #660

• PR Update pspm_installer #826

• PR fix help text in pspm_get_timing #832

• PR 821 helptext standardization #833 fixes Standardize helptext formatting #821

• PR 821 helptext standardization #834 fixes Standardize helptext formatting #821

• PR end; --> end #835

• PR 822 pspm pupil pp unit check #836 fixes Add unit check for pupil data in pspm_pupil_pp #822

• PR 804 pspm display #838 fixes pspm_display issue #804

• PR Add delimiter selection and show all files(fileselector) to the Batch… #850

• PR epochs edgecase fix in pspm_logical2epochs and more test #853

• PR correct variable name in pspm_scr_pp output #855

• PR Fix bioread acknowledge import #864

• PR replace nan-functions (copy) #870

• PR generalise pspm_pull_zenodo to work with all PsPM data sets #871

• PR clipping_window_size and clipping_step_size in seconds in pspm_scr_pp #872

• PR FIX: improve output path and store metadata [#873] #877 fixes Improve derivation of output directory for BIDS import #873

• PR FIX: ensure .range field is populated [#874] #878 fixes Fix field in header for physio data #874

• PR FIX: use omitnan [#875] #879 fixes Change nanmedian in rawDataFilter.m #875

• PR pspm_load_data converts single data to double #883

• PR 869 pspm get smr empty channels #884 fixes Empty channels removed during pspm_get_smr #869

• PR 839 pspm review figure fix #885 fixes Skin Conductance Response Function Plot #839

• PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890

• PR iterate over x [#889] #891 fixes Incorrect detection of mismatch between screen distance unit and gaze data #889

• PR nanmean -> mean( ,'omitnan') #893

• PR allows custom input options #895

• PR assign outputs to varargout [#898] #899 fixes Warning when closing pspm_data_editor #898

• PR Non-linear model defaults #900

• PR Major overhaul bids importer #901

• PR fix and update to pspm_remove_epochs plus test #902

• PR Updated documentation  #907

• PR Support segmented AcqKnowledge imports #910 fixes Support for importing exported segments from Biopac AcqKnowledge (*.mat) #848

• PR Warning for undetermined trials  #911

• PR Function ref update #913

• PR pspm_pupil_correct_eyelink correction #915

• PR Fix DCM #917

• PR Fixes the HP reward-conditioning GLM configuration and runner #909 #918 fixes Possible issue in pspm_cfg_run_glm_hp_rew #909

• PR General bug fixes #920

• PR Typo corrections in function help text #921

Website

• PR Update Links #827
• PR Update 2024-01-02-learn.md #830
• PR updated PsPM_installer download link #831
• PR Update Open Data and News pages #906
• PR Update references on website #908
• PR Update publication details for Guerrero-Hreins et al. #912
• PR Update website reference documentation #914
• PR pspm_pupil_correct_eyelink correction #916
• PR docs: fix typos in website documentation #922

---

General

• The help text in PsPM has been standardised, reviewed and corrected. (PR fix help text in pspm_get_timing #832, 821 helptext standardization #833, 821 helptext standardization #834, Updated documentation  #907, Function ref update #913, pspm_pupil_correct_eyelink correction #915, Typo corrections in function help text #921)
• The PsPM manual has been updated. (PR 869 pspm get smr empty channels #884, Updated documentation  #907)
• The PsPM website and online documentation have been updated. (PR Update Links #827, Update 2024-01-02-learn.md #830, updated PsPM_installer download link #831, Update Open Data and News pages #906, Update references on website #908, Update publication details for Guerrero-Hreins et al. #912, Update website reference documentation #914, pspm_pupil_correct_eyelink correction #916, docs: fix typos in website documentation #922)

GUI

• The review GUI has been updated and prevents duplicate model loading. (PR App designer for review #755)
• Long channel descriptions in pspm_display are displayed on multiple lines. (PR 804 pspm display #838)
• Text-file import in the batch interface now supports delimiter selection and files with arbitrary extensions. (PR Add delimiter selection and show all files(fileselector) to the Batch… #850)
• The DCM review figure layout and labelling have been improved. (PR 839 pspm review figure fix #885)

New Features

• A new BIDS importer has been introduced and substantially expanded to import BIDS-formatted datasets into PsPM. (PR 660 pspm import bids #790, Major overhaul bids importer #901)

Improvements (needs to be checked again)

• pspm_pupil_pp

  • Pupil data in supported non-mm units are automatically converted to millimetres before preprocessing. (PR 822 pspm pupil pp unit check #836)

• pspm_scr_pp

  • Clipping window and step-size options are now specified in seconds. (PR clipping_window_size and clipping_step_size in seconds in pspm_scr_pp #872)

• pspm_pull_zenodo

  • Dataset download handling has been generalised. (PR generalise pspm_pull_zenodo to work with all PsPM data sets #871)

• pspm_load_data

  • Non-event channel data are automatically converted to double precision when loaded. (PR pspm_load_data converts single data to double #883)

• Pupil correction

  • pspm_pupil_correct now accepts a PsPM file or data structure and loads the required pupil and gaze channels internally. (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)
  • pspm_pupil_correct_eyelink now checks that gaze data are provided in millimetres and otherwise instructs the user to convert them with pspm_convert_gaze. (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)

• Cardiac preprocessing

  • Direct ECG-to-heart-period conversion has been added as an option to the batch interface. (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)

• pspm_ledalab

  • Custom Ledalab optimisation, export and additional input arguments can now be specified. (PR allows custom input options #895)

• pspm_get_acqmat

  • The AcqKnowledge import function now supports segmented MAT files with non-zero recording offsets. (PR Support segmented AcqKnowledge imports #910)

• DCM

  • Flexible-response dispersion constraints are now specified as a maximum standard deviation in seconds; the default of 0.3 s fixes the dispersion at 0.3 s. (PR Non-linear model defaults #900)
  • Warnings now identify trials that could not be estimated and indicate when NaN values are omitted from condition-level statistics. (PR Warning for undetermined trials  #911)

• NaN handling

  • Legacy NaN-handling functions have been replaced with MATLAB's omitnan syntax. (PR replace nan-functions (copy) #870, FIX: use omitnan [#875] #879, nanmean -> mean( ,'omitnan') #893)

Bug fixes

• BIDS importer

  • Fixed output-path and metadata handling. (PR FIX: improve output path and store metadata [#873] #877)
  • Fixed the gaze-channel range header field. (PR FIX: ensure .range field is populated [#874] #878)

• pspm_logical2epochs

  • Fixed handling of epochs extending to the final sample of a logical vector. (PR epochs edgecase fix in pspm_logical2epochs and more test #853)

• pspm_scr_pp

  • Fixed the variable name stored in missing-epoch output files. (PR correct variable name in pspm_scr_pp output #855)
  • Fixed the clipping-filter logic. (PR clipping_window_size and clipping_step_size in seconds in pspm_scr_pp #872)

• AcqKnowledge import

  • Fixed Python/bioread import handling and sampling-rate processing. (PR Fix bioread acknowledge import #864, General bug fixes #920)

• pspm_get_smr

  • Fixed import of empty SMR channels so that they are retained instead of removed. (PR 869 pspm get smr empty channels #884)

• pspm_find_valid_fixations

  • Fixed gaze-channel unit detection and the suggested gaze-conversion function. (PR iterate over x [#889] #891)

• pspm_data_editor

  • Fixed output assignment from the data editor. (PR assign outputs to varargout [#898] #899)

• pspm_remove_epochs

  • Fixed the function return value and improved warning handling. (PR fix and update to pspm_remove_epochs plus test #902)

• Pupil and gaze processing

  • pspm_convert_au2unit: Corrected area-based pupil-size conversion and output handling. (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)
  • pspm_convert_gaze: Fixed gaze-channel unit matching and y-axis range handling. (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)

• GLM

  • Fixed the HP reward-conditioning GLM configuration and runner. (PR Fixes the HP reward-conditioning GLM configuration and runner #909 #918)
  • Fixed several GLM batch-runner issues. (PR General bug fixes #920)

• DCM

  • Fixed prior estimation for constrained response dispersion in pspm_dcm_inv. (PR Fix DCM #917)

• Import

  • Fixed several batch and import issues, including SMI sample/event-file handling. (PR General bug fixes #920)

New test functions

• pspm_import_bids_test (PR 660 pspm import bids #790)
• pspm_convert_pixel2unit_core_test (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)
• pspm_convert_ppg2hb_test (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)
• pspm_emg_pp_test (PR Updates to pspm_pupil_correct_eyelink and pspm_pupil_correct #890)
• pspm_remove_epochs_test (PR fix and update to pspm_remove_epochs plus test #902)