Release Notes

Version 1.1 (Feb. 2022)


Data Loading System
  • New interface for loading provides greater flexibility with less clicks.
  • You can now load multiple, multi-page TIFF files.
  • ROIVert can now work with a subset of files in a folder.
  • Improvement in loading performance, up to 3x speed in test.
  • The new loading screen displays TIFF metadata.
  • Simply drag/drop files from Finder/Explorer.
Chart Shape/Zoom
  • You can now adjust the height of charts (Ctrl or ⌘ with Mouse Scroll).
  • You can now zoom in on a region of the x-axis (Ctrl or ⌘ with Mouse Drag).
Multi-platform Support
  • ROIVert is now available for MacOS and Linux.
  • New icons for MacOS dark mode.
Bug Fixes
  • Display of df/f min/max projections sometimes resulted in errant pixels.
  • Dead pixels (all values exactly zero) could result in trace not showing up.
  • Exporting charts as jpeg was not silently failing.
  • Inability to have an ROI with a corner at pixel (0, 0).
Testing System
  • ROIVert is now backed by about 170 tests.
  • A new testing system wrapping Qt allows targeted test execution.
  • ROIVert achieves approximately 95% code coverage.

Version 1.0 (Sept. 2021)

(Changes wrt. Prototype)
ROIVert 1.0 for Windows | ROIVert 1.0 for MacOS
Our First Release
  • We're very excited about the first (beta) release of ROIVert!
  • The release adds several features over the prototype. We focused on making ROIVert easier to use and polishing the interface.
  • ROIVert is more portable, sharable, extensible.
  • ROIVert has no GPL dependencies and is being released under the (very permissive) MIT License.
New Charting System
  • The new charting system removes dependencies on external libraries.
  • The new system is tailored to ROIVert's needs, it's fast and flexible.
  • We added a new ridgeline chart. A new 'image' type chart is almost ready and should be coming in the next release.
  • Various controls for chart aesthetics have been added, including fonts, colors, and fill.
  • New normalization controls and y-axis matching have been added.
Tooltips and Translation
  • Tool tips have been added throughout the system.
  • Most of ROIVert's text now supports translation, we just need a translator (volunteers welcome!).
ROI Styling
  • ROIs (and their corresponding charts) are multi-color by default.
  • Colors are drawn from a palette which tries to make adjacent colors distinct.
  • Colors are adjustable.
  • Selection is indicated with new 'selecters' for ROIs and a thicker line in charts.
  • ROIs can have a semi-transparent fill.
ROI Editing
  • ROIs are editable.
  • Edits show up immediately on mouse-up in the chart window.
  • Multiple ROIs can be selected at once (for deleting, or changing the color).
Performance/Timing
  • ROIVert is faster and leaner.
  • The approach to timing frame display has been completely reworked, the video's framerate now more closely matches the requested speed.
Multi-page Tiff Files
  • ROIVert now supports loading of multi-page Tiff files.
  • Multipage Tiffs don't support detailed loading progress, but load more quickly.
Settings Storage
  • ROIVert's settings are now stored across sessions.
  • You can disable this for any of ROIVert's tools.
  • Tools also now include a reset button.
New Polygon ROI Mechanic
  • Polygonal ROIs are now closed by clicking on the vertex where they were started.
  • The new interface is easier to use, and the vertex editing feature works particularly well with polygons.
Many minor changes
  • The delta's representing delta-f have been replaced by 'd'. This felt friendlier.
  • Contrast display representation has been reworked for polish.
  • More colormaps including a really nice blue-ish one.
  • The export format for ROIs has been moved from xml to json. Note that old exported files from the prototype are not compatible, but a converter can be written if this is important.
  • Added a df/f toggle button to the Image Settings window in the Projection section.
  • Various cleanup of layouts in dockable windows.
  • A button to reset the window layout (this was previously hiding in a shortcut).
  • Initial window layout is resolution dependent.
Known issues
  • Clicking just outside of an ROI can cause it to be selected (within a pixel or two). This is only noticeable when very zoomed in.
  • Artifacts can temporarily appear when one of the little selection boxes for an ROI touches the border on the edge of the image. These artifacts will be cleaned up when adding/editing the ROI is completed.
  • Precision issues with chart tick labels: you may occassionally see a poor approximation in a chart tick label, e.g. 1E-4 instead of 0.
  • Multi-page Tiff Files:
    • At the beginning of the load process for multi-page Tiff files the progress bar won't move. However multipage Tiff files load far faster than their multi-file equivalents.
    • Multi-page Tiff files must be loaded into memory in their entirety before downsampling time/space. This means downsampling will have little effect on load-time performance.
    • Multi-page loading with temporal downsampling may produce one additional/fewer frame than multi-file loading with the same dataset.