v0.0.7

UPDATE:

There still seems to be a problem with the tools we're using to build the Windows installers. If RespiRate doesn't work properly for you and you don't have python 3 installed, please use the 0.0.5 release, which should work properly.

If you do have python 3 installed, version 0.0.7 (this release) should work properly. Please see the instructions under Advanced below.

Changes and improvements

Code cleanup.
Build environment has been fixed so bundled exe installation files should now install and run properly.

Installation

At the current time, only Windows Vista and better are supported.
Download RespiRate_x32.exe for Windows 32-bit.
Download RespiRate_x64.exe for Windows 64-bit.

If you're not sure which version of Windows you have, check using this guide.

After downloading, double-click the .exe and follow the prompt to install.

Advanced: If you have a python 3.5 (or higher) interpreter available, you can also download and run the source code for this release. See the "Advanced" topic in our instructions for more details.

Instructions for use

https://github.com/MDA-Courtyard/RespiRate#using-respirate

0.0.7 (12/20/2017)

• Code cleanup and style improvements with flake8 linter.
• Removed unused import 're' from RespiRate.py
• (Bundled .exe files) Downgrade to Python 3.5 and PyInstaller 3.2.1 to build
  .exe files since PyInstaller 3.6 currently has some problems with Qt programs -
  see pyinstaller/pyinstaller#2659

v0.0.6

Installation

At the current time, only Windows Vista and better are supported.
Download RespiRate_x32.exe for Windows 32-bit.
Download RespiRate_x64.exe for Windows 64-bit.

If you're not sure which version you have, check using this guide.

After downloading, double-click the .exe and follow the prompt to install.

Advanced: If you have a python 3.6 interpreter available, you could also download and run the source code for this release. See the "Advanced" topic in our instructions for more details.

Instructions for use

https://github.com/MDA-Courtyard/RespiRate#using-respirate

Changes and improvements

When generating a csv file from the xls output spreadsheet, a generic (and often incorrect) message about potential file overwrites has been refined and corrected.

The output xls spreadsheet is now more friendly to R and related technologies.

When run from source, the best respiratory rate for each mouse is returned to the console.

CHANGELOG

• Correct notification when generating a csv file from an existing xls file.
• Code cleanup.
• The spreadsheet header is cleaner. Multiple words are joined with an
  underscore for easier indexing.
• Best respiratory rate for each mouse is returned to the console (when running
  from source.)

v0.0.5

Installation

At the current time, only Windows Vista and better are supported.
Download RespiRate_x32.exe for Windows 32-bit.
Download RespiRate_x64.exe for Windows 64-bit.

If you're not sure which version you have, check using this guide.

After downloading, double-click the .exe and follow the prompt to install.

Advanced: If you have a python 3.6 interpreter available, you could also download and run the source code for this release. See the "Advanced" topic in our instructions for more details.

Instructions for use

https://github.com/MDA-Courtyard/RespiRate#using-respirate

Changes and improvements

We now offer a built-in tool to convert the output spreadsheet to a csv file for easier data analysis with other popular technologies, such as R. The existing spreadsheet isn't changed in any way, but all data is copied to a new csv.

The internal checks for correct file types were improved, along with some associated bugs.

Using the Tab key now moves the cursor more logically, from the Mouse ID field to Start time to Length of measurement.

07/09/2017 Re-upload Windows installers due to faulty build.

CHANGELOG

• Bugfix: stop the internal timer when opening a new file. This prevents a
  crash when loading a non-video file, after having already loaded a video.
• Make sure loaded file is a video when 'Contour' is pressed.
• Better, more logical handling of 'Tab' key.
• Bugfix: don't attempt to play a video if one is not loaded.
• Add notification that when declining to create a new spreadsheet (if needed),
  the data was not exported even if the user previously selected 'Yes'.
• Add option to easily convert the output1.xls spreadsheet to csv file.

v0.0.4

Installation

At the current time, only Windows Vista and better are supported.
Download RespiRate_x32.exe for Windows 32-bit.
Download RespiRate_x64.exe for Windows 64-bit.

If you're not sure which version you have, check using this guide.

After downloading, double-click the .exe and follow the prompt to install.

Advanced: If you have a python 3.6 interpreter available, you could also download and run the source code for this release. See the "Advanced" topic in our instructions for more details.

Instructions for use

https://github.com/MDA-Courtyard/RespiRate#using-respirate

Changes and improvements

• When opening a video, RespiRate now remembers the last video location and opens the file dialog there.
• The titlebar shows the name and path of the video.
• Our error checks are more robust.
• Detection and notification when a non-video file is selected has been greatly improved.

Changelog

• Open file dialog for selecting videos in the same location as the last run,
  rather than in the present working directory. For the first run, the
  behavior is unchanged.
• Remove unnecessary code from binary installer
• Better handling of sys.exit()
• Show current video name and location in titlebar: i.e. "RespiRate - sample.mp4"
• Bugfix: allow mouse ID to be a non-integer (previously exited with error)
• The error check functionality has been promoted to a class so we can call
  certain aspects as needed.
• Greatly improved detection and rejection of non-video files
• Disable 'Select Start Time' button if a video is not loaded

v0.0.3

Our third release! This release fixes bugs and improves the usability of RespiRate.

Installation

At the current time, only Windows Vista and better are supported.
Download RespiRate_x32.exe for Windows 32-bit.
Download RespiRate_x64.exe for Windows 64-bit.

If you're not sure which version you have, check the instructions here.

After downloading, double-click the .exe and follow the prompt to install.

Advanced: If you have a python 3.6 interpreter available, you could also download and run the source code for this release.

Instructions for use

https://github.com/MDA-Courtyard/RespiRate#using-respirate

Changes and improvements

In order to prevent an error when at the last usable frame in a video, RespiRate previously looped back to the beginning of the video immediately upon loading the last usable frame, without playing the frame. This has been changed so that it does not loop back until after that last usable frame has been displayed.

When running through a video, if a graph for the same mouse had already been displayed and not closed, RespiRate would append newer graphs to the same figure. This made the graph difficult to read, so we now check and close previously any existing graphs, if they're for the same mouse.

All RespiRate windows, with the exception of the OpenCV windows, are provided by Qt5. The OpenCV windows still use their native UI provider.

When loading the spreadsheet from File -> Open Spreadsheet, the main RespiRate windows will no longer be unresponsive for a few seconds.

Changelog

0.0.3 (05.25.2017)

• Don't restart video when current frame is also the last (useable) frame.
• Overwrite existing graph(s) instead of appending - prevents formatting errors
• All user input windows are provided by Qt5.
• Automatically close contour window when user clicks 'Cancel' instead of
  providing the mouse ID, instead of requiring the user to close it.
• Fix condition where an image file is loaded and not rejected like other
  non-video files
• Call system commands through QProcess instead of subprocess - keeps main
  window from freezing while commands are executed

v0.0.2

0.0.2 (05.18.2017)

• Show hyperlinks in dialog windows instead of plain text
• Move all functions in notifiCat from Tkinter to Qt
• Fix OpenCV Error when video is at final frame
• Don't crash on index error
• Better handling of exceptions
• add 'noself' option to notifiCat when modules have no QApplication (not currently used)

v0.0.1

Hello world!

This is our first release of RespiRate, an easy-to-use tool for measuring the respiratory rate of lab mice. See here for a full list of features and instructions, and here for our licensing terms.

RespiRate runs on any Windows computer with Vista or better and does not require any specialized hardware or the installation of any additional software.

RespiRate_x64 is the installer for 64-bit computers, and RespiRate_x32 is for 32-bit computers.