Release Notes for SleepStats 4

4.3.19

07.20.2026

Bug Fixes/Improvements

ALL VERSIONS:

  • SleepStats now correctly points to User’s Documents folder when opening first file

4.3.18

07.20.2026

Bug Fixes/Improvements

ALL VERSIONS:

  • Fix support link
  • Fix bug in generating Percent Sleep Light/Dark plot
  • SleepStats will point to previously opened file location when opening a new file, except for the first file

4.3.17

05.27.2026

New Features:

PRO:

  • Implemented Percent 3-State over Sliding Interval Export for 3-state data

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fix issue in exports, causing a crash on data with duplicate channel labels
  • Fix issue in opening, causing a crash on data with an incomplete final data record
    • incomplete final data records can occur where Piezo-Sleep is not properly closed
  • Fix issue in non-interval exports, causing a crash in some systems after time-range is defined
    • This fix impacts the following exports:
      • Sleep-Wake Decision Statistic
      • Time Stamped Sleep-Wake Bouts
      • Breath Frequency
      • Time Stamped Wake-NREM-REM Bouts
  • Q-Bout threshold setting now properly applies for all channels
  • Renamed Percent Wake over Sliding Interval to Percent State over Sliding Interval
  • Fixed “No Stat Selected” warnings in Activity and Breath Rate Stat exports
  • Fixed potential issues when opening, saving, and exporting data
  • Add confirmation for when Time Stamped Wake-NREM-REM Bouts export is completed

4.3.16

11.24.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fixed issue when installing
    • Updates Matlab Runtime to R2025b

4.3.14

07.21.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fixed issues in Sleep/Wake bout export:
    • fix bug causing crash when there’s no REM data present
    • fix bug causing bout detections to be the same or similar between multiple channels in a file.

4.3.13

06.25.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fix issue causing a crash when opening some FeatVec(fb) files.

4.3.12

06.18.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fix issue causing a crash in exporting percent sleep per interval when there’s no REM data present.

4.3.11

06.13.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fix filtering when selecting a bin(fb) file to overlay in decision statistic plot when no bin(fb) is automatically found.
  • Fix bug in “Total Time” bout plots (in Sleep/Wake and 3-state) causing the counts to be scaled up by the number of channels in the recording file.

4.3.10

03.03.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fixed crash when reading files when system language is is not set to English.
    • Error occurs when reading headers in files produced in PiezoSleep 4.

4.3.9

Bug Fixes/Improvements:

ALL VERSIONS:

  • Changed bout exports to better handle NaNs from concatenated files with a time gap between files.
    • Now acts similar to Light-Dark bout exports, where any interval with NaN data is ignored in bout and mean computations.

4.3.8

02.07.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fixed bug introduced in 4.3.7 preventing environmental files from being opened
  • Added ability to resize the SleepStats 4 main window
  • Added a “Help” menu
    • Moved “About” pop-up from the File menu to the Help menu
    • Added a direct link to the technical support page under the new Help menu

4.3.7

01.24.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Fixed error: “Wrong version of interface.dll” after installations

4.3.6

01.10.2025

Bug Fixes/Improvements:

ALL VERSIONS:

  • Changed how channel labels are positioned in percent daily “state” bar charts.

PRO:

  • Fix bug where time gaps in REM data from concatenated files were being used as the selected state in bout computations

4.3.5

12.11.2024

Bug Fixes/Improvements:

PRO:

  • Fix issue causing issues in REM data displays for concatenated files
    • It will show no data for time gaps, same behavior as sleep/wake decision statistic
  • Fix REM plot empty when a new with rem data has been opened

4.3.4

10.02.2024

New Features:

ALL VERSIONS:

  • Added pop-up under File > About, that gives version information about SleepStats 4
  • Added option to reset the threshold
    • This allows the user to re-run the thresholding algorithm, overwriting their changes for ALL CHANNELS
    • This also allows the user to force the threshold algorithm to run on files shorter than 24hrs, it was previously set to 0
      • NOTE: The auto threshold algorithm performance will degrade on data with insufficient activity and inactivity.

Bug Fixes and Improvements:

ALL VERSIONS:

  • Exports that generate files for individual channels checks for unique channel labels to avoid overwriting channels with identical channel labels
  • Bout Stat exports (Sleep/Wake and 3-state) now correctly respect the selected bout computation method
  • improved exports, linear time axis should now correctly show more precision

PRO:

  • Export 3-state over sliding interval now correctly implemented
  • added linear time to export, all other similar exports already had this.

4.3.3

05.03.2024

Bug Fixes and Improvements:

ALL VERSIONS:

  • Fixed another issue with how sleep/wake over sliding interval works on files that were concatenated

4.3.2

05.02.2024

Bug Fixes and Improvements:

ALL VERSIONS:

  • Fixed how the sleep/wake over sliding interval works on files that were concatenated
  • Fixed issues with the sleep/wake over sliding interval
    • Time stamps were incorrect, (iterated by the interval as minutes instead of hours as intended)
    • Fixed crash in export

4.3.1

03.14.2024

Bug Fixes and Improvements:

ALL VERSIONS:

  • Fixed possible crash when analyzing files shorter than 24 hours.
  • Fixed issue causing the error message “Feature Vector File Empty” when recording was an exact multiple of 24 hours long.

4.3.0

02.09.2024

Bug Fixes and Improvements:

ALL VERSIONS:

  • Fixed inconsistency of rat sleep-wake decision algorithm
    • A custom high-noise noise algorithm was used by mistake, decision statistics and threshold setting now consistent with 2.28r  

4.2.2

02.05.2024

Bug Fixes and Improvements:

ALL VERSIONS:

  • Fixed issue causing changes to not be saved properly
  • Application confirms saving settings before closing or when opening a new file

4.2.1.1

08.11.2023

Bug Fixes and Improvements:

PRO:

  • Fixed issue causing 3-state median bout export to only export when 10th percentile export is selected in the option menu.

4.2.1

07.19.2023

Bug Fixes and Improvements:

ALL VERSIONS:

  • Environmental Sensor
    • Fixed issue causing multiple environmental sensors to be read in incorrectly, all sensors were being assigned the data from the first sensor.

4.2.0

07.14.2023

NEW FEATURES:

ALL VERSIONS:

  • Environmental Sensor
    • New option to assign environmental sensors to PiezoSleep recorded channels within the File Menu
      • After sensors have been assigned, the assigned sensor will be the default option for the Environmental Sensor Overlay in the Sleep/Wake Decision Statistic Plot.
  • Closing the application brings up a confirmation window where the user can choose to save or discard edited parameters, or to cancel exiting to prevent accidental app closure.
  • New Export: “Number of Bouts per User Defined Interval”
    • Exports a count of sleep or wake bouts per interval for the times selected by the user.
  • Sleep-Wake Decision Statistic Export now exports the sleep/wake threshold for each channel.

Bug Fixes and Improvements:

ALL VERSIONS:

  • New MATLAB runtime improves GUI application performance
    • Plots run smoother
    • Application loads faster
  • Updated Environmental Sensor Exports
    • Exported time stamps are now in hours from the start of the recording for “Environmental Sensor Data”
    • Fixed crash when exporting Environmental Sensor Stats
  • Changed name of Circadian Cycle in Hours to Light & Dark Period Length in Hours for clarity
  • Increased the precision on the time column in CSV exports

PRO:

  • Adjusted REM data read to deal with corrupted samples at the end of feature vector files that occur when a recording is unexpectedly stopped (power loss, PC restart, etc.)
  • Environmental Sensor
    • New option to assign environmental sensors to PiezoSleep recorded channels within the File Menu
      • Allows channels to utilize separate Environmental Sensors when using the “ Use Light Sensor Times” setting in Light/Dark Onset Times.

4.1.5.1

03.01.223

Big Fixes/Improvements

PRO:

  • Adjusted how the “Use Light Sensor Data” for Light/Dark Onset Times handles Thresholds for light and dark.

4.1.5

02.17.2023

Bug Fixes/Improvements

ALL VERSIONS:

  • Environmental Sensor:
    • Now properly handles having multiple sensors
      • Decision Stat Plot: there is an additional drop-down menu to select which environmental sensor is overlaid.
      • Exporting Environmental Sensor Stats will export for all environmental sensors with the selected data.
      • Exporting Environmental Sensor Data exports for each environmental sensor selected in the options panel with the selected data.

PRO:

  • Environmental Sensor:
    • Can now adjust Threshold for light and dark, as well as the minimum length for a light or dark onset period.
    • The automatic light and dark detection will use whichever environmental sensor is selected for the Sleep/Wake Decision Statistic overlay.
  • Adjusted 3-state Bout Histogram plot and exports to correctly select the active state in SleepStats.
  • Activity Exports and Actogram
    • Exports “0” instead of “NaN” to intervals without any activity.
    • Removed normalization method from export header, no normalization is used in this export.
    • Fixed issue where plotting the actogram would cause a crash on very short files.
    • Fixed bug in activity stats export causing stats to be calculated incorrectly.

4.1.4

01.19.2023

Bug Fixes/Improvements

All VERSIONS:

  • Fixed issue causing the CSV export menu to not have all options when opening a new file after a file had been opened.

BASE:

  • Fixed issue causing a crash on startup.

PRO:

  • Updated 3-State bout detection algorithm to be more robust.
  • CSV Export Drop-Down Menu now correctly removes all REM options when opening files with no REM data.

4.1.3

01.04.2023

Bug Fixes/Improvements

  • Adjusted minimum light level in lux from 15 to 50 when using the environmental sensor to detect day and night periods.
  • Adjusted alignment of Decision Statistic with superimposed sensor data.

4.1.2

12.30.2022

Bug Fixes/Improvements

ALL VERSIONS:

  • Added ability to set bounds on breath-rate estimation export
  • Added dialog that warns users when exporting large amounts of breath-rate estimation and decision statistic data (threshold for this warning is more than 24hrs of data).

BASE UPDATES:

  • Fixed an issue where the Activity – ClockLabs export would appear in Base versions, the option would not be able to export anything as Activity files are not opened.

4.1.1

12.14.2022

Bug Fixes/Improvements

  • Fixed an issue where the last interval of a few exports wasn’t being exported when the interval endpoint was the same as the export end time.

4.1.0

11.07.2022

New Features:

  • Added Segmented Wake-nREM-REM Bout Stats exports. (Same as Segmented Bout Stats, but for 3-state statistics; Renamed Segmented Bout Stats to Segmented Sleep-Wake Bout Stats for clarity).
  • Added ability to change Bout Normalization and Bout Computation Methods within the export options panel for Segmented Bout Stat Exports.

Bug Fixes/Improvements:

  • Fixed window size/position, and adjusted positions of components accordingly.

4.0.1

10.17.2022

Bug Fixes/Improvements:

  • Fixed an issue causing a crash when exporting Segmented Bout Stats.
  • Fixed the header for the histogram output of the Segmented Bout Stats export.

4.0.0

10.14.2022

NEW RELEASE:

  • Now uses a GUI based interface, with easily accessible parameters, tabbed plots, and many new plots and exports.
    • Allows Users to quickly switch between different plots/channels, without having to go back and forth in previous menu based SleepStats versions.
    • Added ability to change the circadian cycle for non 24 hour day/night cycles.
  • Combines the functionality of both the rat and mouse versions of SleepStats 2.x8, as well as adding compatibility with future versions of PiezoSleep.
  • Allows for data collected from an environmental sensor to be overlaid on the plots, and the light data can be used to determine light and dark onset times automatically.
    • Also allows for export of environmental sensor data and statistics.
  • New or updated exports:
    • Sleep-Wake decision statistic export.
    • Percent sleep or wake segmented by light and dark
    • Time stamped sleep bouts.
    • Breath frequency, and Breath-Rate stats.

PRO FEATURES:

  • Activity data overlay on decision statistic plot, as well as an actogram and activity exports, including a formatted export for use in ClockLabs.
  • REM-like behavior plots and exports. Similar plots to the sleep/wake decision statistic, with the inclusion of REM-like behavior detections.