Finalise for release 6.1

General

Minimum version of MATLAB
- The minimum version of MATLAB required for running PsPM is MATLAB 7.1 or R14 Service Pack 3 (https://uk.mathworks.com/content/dam/mathworks/mathworks-dot-com/support/sysreq/files/SystemRequirements-Release14-ServicePack3_SupportedCompilers.pdf) (#20).
Entering PsPM
- Entering PsPM is now hybrid based on the version of MATLAB, namely through AppDesigner or Guide. PsPM will be entered through AppDesigner when supported and through Guide for older versions of MATLAB. To call PsPM, users should still use the command pspm in the Command Window of MATLAB, where the appropriate way of entering PsPM will be recognised automatically.
- Users can still use their preferred way to enter PsPM. To enter PsPM through AppDesigner, please type pspm_appdesigner. To enter PsPM through Guide, which is the classic entrance, please type pspm_guide.
- The AppDesigner version of PsPM UI is newly introduced by MATLAB and the encouraged way for launching PsPM, and it has no functionality difference than the Guide version of PsPM UI.
- Both AppDesigner and Guide are designed and tested for Windows, macOS (either Intel or Apple Silicon) and Linux. Issues of opening PsPM through either of the two UI systems are encouraged to be reported to PsPM developing group at GitHub.
Introducing pspm_options (#385, #426, #430)
- A new function pspm_options is introduced to PsPM for controlling the default and acceptable values of the struct options used by most PsPM functions. The default values of the fields in the struct options for various functions can be directly checked by searching in pspm_options.
- The default values in pspm_options have been checked and tested for PsPM. If preferred values are different from defaults, users can specify them when calling the corresponding PsPM functions, and the corresponding functions and pspm_options will always respect the users' specification with the highest priority. However, the user's specification needs to satisfy the condition set in pspm_options, and invalid values may be reported as errors.
UI Improvements (#488)
- The UI for the following features has been improved and tested
  - Launchpad (AppDesigner)
  - Launchpad (Guide)
  - Batch editor
  - Display data
  - Contrast manager
Help text
- The help text has been updated for all PsPM functions. Help text can be checked by right clicking the functions. An example of checking the help text of a PsPM function is shown below (#372, #419).
  Bug Fixes
UI
- A bug that used to make PsPM crash when Pupil size convert and Gaze convert in Data Preprocessing were selected has been fixed (#475).
- A bug that leads to error when PsPM is started offline has been fixed (#514).
- A bug that leads to incorrect x labels in pspm_rev_dcm has been fixed (#495).
pspm_convert_...
- A bug that leads PsPM to crash, which is caused by outdated UI calling for pspm_convert_... functions, has been fixed (#508).
pspm_get_eyelink
- A bug that causes issues when importing eye link data that is scanned at both left and right sides has been fixed (#479, #509).
pspm_glm
- A bug that incorrectly identifies the NaNs in the input data has been fixed (#499, #513).
pspm_sf
- A bug that has lead to incorrect input datafile assigning has been fixed (#370).
- A bug that leads PsPM crash when pspm_sf is analysing data with missing epochs has been fixed (#484).
- A bug that leads to error when pspm_sf analyses data where time unit is defined as marker has been fixed (#503).
pspm_split_sessions
- pspm_split_sessions now considers marker_chan_num when calling pspm_trim (#506).
  Improvements
channel (#470, #478, #497)
- We have generalised the channel related variables throughout PsPM, which are given as
  - chan/channel → channel
  - chans/channels → channels
  - channel_units/channels_units/chan_units/chans_units → channel_units
  - chan_combine → channel_combine
  - chan_action → channel_action
  - channels_header → channel_header
  - chantype → channeltype
import_eyelink
- Improved import_eyelink for adding some support for importing eyelink data converted by higher version of .EDF files. (#459 and #465)
pspm_con2
- pspm_con2 is now using pspm_overwrite (#422).
pspm_dcm and pspm_dcm_inv
- .flexevents and .fixevents are now fields of model instead of options (#458).
- pspm_dcm now uses pspm_get_timing to handle missing epochs (#499).
- Improved missing epoch support
  - The field .missing is now allocated from options to model (#491).
  - .missing_data is used to load missing epoch data that was loaded from dcm, as an optional field (#491).
- The index is changed so that the first event will not be excluded when at time 0 in session (#504).
pspm_extract_segments
- The first channel is always referred by marker_chan as default (#427).
pspm_glm
- The fallback for options.exclude_missing has been set for pspm_glm, which is not to exclude any missing epochs (#429).
- A bug that leads to incorrect missing epoch checking has been fixed (#338).
- Help text was updated (#467).
- marker_chan_num now refers to the first marker channel as default (#427).
- pspm_glm now uses pspm_get_timing to handle missing epochs (#499).
pspm_interp1
- pspm_interp1 now considers the data where no valid values are detected and interpolation is not possible, and warnings will be reported in this case (#500).
pspm_merge
- The default value is set to be [1,2], meaning the first channel will be merged as the default option (#427).
pspm_prepdata
- pspm_prepdata now uses interpolation to handle data with NaN. (#35, 434)
  - Data that begins and/or ends with NaN will be filled with the first/last non-NaN values in those positions.
pspm_sf
- pspm_sf now supports missing epochs (#457).
  - Now allow input with NaN that indicates missing epochs.
  - Missing epochs can be specified with options.missing or the automatic NaN detection.
  - Missing epochs will be verified with options.missingthresh.
  - When the missing epochs are longer than 2s, the result out will be converted to [].
  - The UI of SF analysis now allows using missing epochs from files or not to define any missing epochs.
- pspm_sf now uses pspm_get_timing to handle missing epochs (#499).
- marker_chan_num now refers to the first marker channel as default (#427).
pspm_sf_dcm
- pspm_sf_dcm now uses pspm_interp1 for interpolating data (#491).
pspm_text
- The Matlab file that stores the information of help text pspm_text.mat will be stored inside the source folder of PsPM and will be deleted when PsPM is quit (#450).
pspm_trim
- marker_chan_num now refers to the first marker channel as default (#427).
  Minor Adjustments
pspm_sf, pspm_glm and pspm_dcm (#490, #493)
- The option marker_chan_num_event is removed.
- In default, the first marker channel / event channel is always selected and no users' customisation is allowed.
- The last data channel / wave channel is always selected.