Skip to content

Flywheel Core 19.3

November 2024

19.3.0

FEATURES

Bulk Import/Upload

  • When uploading folders for Import, the browser now processes multiple files simultaneously, resulting in faster uploads.

External Storages

  • The External Storage creation dialog has been redesigned for easier use and to provide more guidance.
  • When using Azure Blob Storage, External Storages can use pre-configured Azure Workload Identities for authorization as an alternative to user-provided credentials (e.g., access keys).
    • This option is exposed via the "Use connector's pre-configured" credentials flag and is equivalent to the "AWS IAM Role" authorization feature -- but now available in Azure.
    • This feature is only available for Flywheel Core sites that are hosted in Azure.

Jupyter Workspace

  • By default, Jupyter Notebooks has a convenience feature which provides notebook users access to use External Storage credentials to access Storage. This feature flag gives sites the ability to configure Jupyter so that External Storage credentials are not made available for notebook users.

Viewer

  • The V3 viewer is now available to all users as a secondary viewer! Capabilities are currently limited to basic viewer functionalities as well as new features being added with this release (see below). The V2 viewer remains the default viewer while we continue to develop the V3 viewer by adding important features and provide a better experience to our users. Give it a try and give us your feedback!

  • New in the V3 viewer with this release:

    • New advanced layouts with multiplanar reconstruction (MPR) and 3D rendering.
    • New per-viewport controls for window level presets, colormaps and 3D rendering presets.
    • Support for 2D annotations, measurements and ROIs:
      • Annotations, measurements and ROIS can be saved to Flywheel Core as DICOM Structured Reports or exported as csv files.
      • Enhanced flexibility for label configuration: required or optional, free-text and/or from a custom pre-defined list.
      • Measurements and ROIs values can be hidden to allow users to focus on their images.
    • Read-only support for multi-label segmentation files overlay (DICOM SEG and DICOM RTSTRUCT).

New Granular File Upload Permissions

  • This release introduces two new project permissions to increase the granular control over who may bulk import data to projects, vs upload/create single files.
    • Single File Upload/Create: Controls the ability to directly add Project/Subject/Session/Acquisition attachments. Applies to the Web UI, flywheel-sdk, CLI (upload and cp commands), Extension Applications, etc.
    • Bulk File Upload: Controls th ability to use bulk import methods. Applies to the Web UI (Project Import), CLI (ingest and import commands) and custom applications using the Flywheel xfer api.
  • Existing Project Roles are not changed when upgrading to this release.
  • The two new permissions effectively split the pre-existing File Upload/Create permission, which will continue to be supported until Flywheel version 21.0 for backwards compatibility.
  • Flywheel Python SDK Impact:
    • Updating the Flywheel Python SDK to 19.3.0 is required only if both; your SDK application interacts with project roles, and your Flywheel site chooses to enable the new permissions in a custom role.
    • For any SDK applications that interact with project roles, it is recommended to update to Flywheel Python SDK to 19.3.0, to ensure future compatibility.
    • Future Flywheel API changes that add new fields or values are unlikely to break existing SDK applications utilizing flywheel-sdk 19.3.0.
  • A future major release of Flywheel (21.0) will remove support for the "File Upload/Create" permission. What to expect with that release:
    • Project Roles that have "File Upload/Create" permission enabled will be updated automatically to have both "Single File Upload/Create" and "Bulk File Upload" enabled.
    • flywheel-sdk and other client applications that solely depend on the "File Upload/Create" permission will need to be updated to depend on the new permissions.
      • It is recommended to update such applications after receiving the 19.3.0 release to avoid this future disruption.
  • See the article on User Roles and Permissions for more information on these and other available project permissions.

FIXES

Bulk Import

  • Fixed an issue with Bulk Export when monitoring the progress via the new (BETA) CLI where the progress summary would display incorrect numbers if files were detected but excluded from the export by filtering rules.

Viewer

  • Fixed an issue where analyses output files were not showing in the V3 Viewer.
  • Fixed an issue where the V2 viewer was not handling ultra-sound series containing multiple 3D multi-frame images correctly.

Compute

  • Resolves the issue where gears were failing on Azure sites. The OS version of the compute image for Azure sites was not compatible with latest compute container environment. The OS version was reverted to resolve the issue.
  • Resolved issue where GPU compute was not using the correct AMI, and so GPUs were not available in the compute.
  • Resolved issue on a site where a job status was not updated as failed when it was stopped due to encountering lack of core response.
  • Improve reliability of obtaining the job vm image from repositories that may not be reliable themselves. This particularly impacts large gears.
  • Improve memory usage for compute event management to improve reliability of reaping orphaned jobs.
  • Resolved issue on Azure where gear output files of 0 bytes were failing to upload to Flywheel.

Gear Rules

  • Resolved an issue where a user was unable to disable gear rule after update to new Flywheel version.
  • Resolved an issue with a site where Gear Rules for dcm2niix gear didn't auto-update version even though auto-update was enabled.

Jobs Log

  • Fixed the issue with truncated dialog box for selecting columns on the Jobs log.
  • Now able to filter gear jobs using priority on jobs log page.

Smart Copy

  • Resolved issue where the "Copy In Progress" status on the project was not displaying
  • Resolved issue where the Project Stats on the destination project would not be visible at the start of the Smart Copy.

Project Catalog

  • Resolved issue where projects could not be filtered by Adult and Senior age categories.

19.3.1

FIXES

Viewer

  • Enable V3 viewer by default on all sites as a secondary viewer.

Data Views

  • Resolved issue with data view downloads failing with error "File not Available on Site".

Jupyter Workspace

  • Resolved issue with JupyterLab Server downloads with error "File not Available on Site".

19.3.2

FIXES

Reader Tasks

  • Fixed an issue with Reader Tasks where the "Assigned by me" and "Created by me" tabs show the full list of tasks (the same as the "All tasks" tab) instead of a filtered view.

Viewer (V3)

  • Fixed an issue where refreshing the V3 Viewer after saving changes to a file would cause the older version to be displayed instead of the latest version.
  • Fixed several 3D rendering issues in the V3 Viewer affecting regions-of-interest (RTSTRUCT) and empty volumes.

Viewer Protocols

  • Fixed an issue where changes to a Viewer Protocol made via the Core Web App within Project Settings could not be saved.

19.3.3

FIXES

Bulk Import

  • Fixed a rare issue causing Bulk Import to stall and never complete in limited circumstances due to a race condition.