Skip to content

Flywheel Core 20.2

20.2.0

DEPRECATIONS

Analysis Inputs Filename API

  • Identifying an analysis input file by the combination of the analysis id plus the file name is ambiguous. This is due to analyses supporting multiple input files referencing multiple different files with the same name.
  • Those APIs are deprecated, and scheduled to be removed with Flywheel version 22.0.0 (January 2026)
  • More details on the deprecation and affected APIs can be found in the deprecation notice.

FEATURES

Bulk Transfer (Export & Import)

Metadata Support for Export & Import
  • Metadata describing a file and its parent containers can be included in when exporting files out of Flywheel via Bulk Export, and this same metadata can be brought back into Flywheel along with the files via Bulk Import.
Improved Ease-of-Use
  • Easier to create filter rules
    • All known filterable fields are presented for selection as well as any known values for the selected field.
    • The type-ahead search for filterable fields is more flexible and allows searching on any phrase in the field name.
    • Spaces can be used between keywords when searching for fields to use.
  • Added a "Show Job Details" item in the menu for each job listed in the Bulk Export jobs list page.
  • Minor design updates for the Bulk Import job details dialog.
  • Minor language revision to the progress bar on the Bulk Export and Bulk Import job details dialogs.

CLI (New)

  • Broader platform support for installing the new (BETA) CLI for minimal Linux distributions like Alpine.

New File Types

  • Three new file types attribute values are available for use. If a file type is not specified while adding files, the new file types will be automatically applied with these filename extension matching rules:
    • "accelerometer": [".cwa"]
    • "Aperio SVS": [".svs"]
    • "audio": [".wav", ".mp3", ".flac", ".m4a", ".ogg", ".aiff", ".aac"]
  • More information on all of the available file type attribute values is available here

SDK Usage Report

  • Introducing a new Usage Report method get_daily_usage_range_report() that supports a date range query.

SDK Custom Info Cleanup

  • Introducing new flywheel-sdk functions for site-wide cleanup of custom info fields. This is helpful when a Flywheel site has exceeded the 15k limit for indexed search fields.
  • Great care should be taken before using these, as it affects data site-wide.
  • These are available only to Site Admin users.
    • fw.get_mapped_fields() will return a data structure showing all fields indexed for Search.
      • You can also pass a partial path to it to show fields mapped under that path, e.g. fw.get_mapped_fields(path="file.info")
    • fw.cleanup_info("acquisitions", "foo.bar") will remove the custom field info.foo.bar from all acquisition documents site-wide, for example.

Auto-Tiered Storage

  • Cloud hosted customers currently using single tier storage will be switched over to their Cloud Service Provider's version of Auto-Tiered Storage. This will occur automatically during your next maintenance window or upgrade.
  • Data will transparently transition from warmer to colder (less expensive) storage based upon its last accessed time. The data will remain visible and accessible to end users at all times.
  • There is as small transfer fee associated with this change, however cloud cost reductions should materialize in subsequent months.

FIXES

Bulk Transfer (Export & Import)

  • Fixed a minor issue with the Bulk Import and Bulk Export jobs list pages where the menu for a list item would remain open even after selecting something else outside of the menu.
  • Fixed an issue with the new (BETA) CLI where Bulk Import and Bulk Export jobs configured to override the "prefix" for an External Storage backed by object storage would still display the original "prefix" value and not the override.
Bulk Export
  • Fixed an issue with Bulk Export where only the default destination path could be used when starting an export job from the web app.
  • Fixed an issue with Bulk Export and Bulk Import where jobs could become stuck in the "cancelling" state in rare cases where the cancellation request is received when the job is in the "finalization" step.
  • Fixed an issue with Bulk Export where some failed files would be mistakenly reported as cancelled.
  • Fixed an issue with the Bulk Export jobs list page where selecting an "Error" chip would open the new export job dialog.
  • Fixed an issue with Bulk Export where some jobs would be flagged as "failed" even though all files were exported successfully.
  • Fixed an issue where Bulk Export jobs could not be cancelled via the new (BETA) CLI.
  • Fixed a minor issue with the Bulk Export job list page where the selected in the filter would not be fully displayed when filtering on multiple statuses.
Bulk Import
  • Fixed an issue with Bulk Import where long-running uploads from a local computer via the Web App could fail if the user is otherwise inactive in Flywheel for at least 1 hour while the upload is still in progress.
  • Fixed an issue with Bulk Import where users needed the admin Project Role to upload data. The read-write Project Role should be sufficient.
  • Improved the description text used in the "Add data" dialog for Bulk Import to remove ambiguity and provide clear confirmation whether de-ID will be performed or not.

CLI (Legacy)

  • Fixed an issue with fw ingest in the legacy CLI where large files (roughly 6 GB or larger) could not be uploaded to Flywheel.

Core Data

  • Resolved issue where On-Premise hosted Flywheel sites configured to purge deleted data could fail to do so.
  • Resolved issue where an error experienced while moving a session could later cause the deletion of that session to not fully delete all the data within that session.
  • Resolved issue where loading the Project List or Jobs Log in the Flywheel Web UI to take longer than 10 seconds.

Data Views

  • Resolved issue with Data Views failing after an upgrade impacting a particular site.

De-Identification

  • Fixed an issue with de-identification when uploading data via a web browser where the remove-private-tags: true option (remove all private DICOM tags) was not applied.
  • Fixed an issue with de-identification when uploading data via a web browser where the replace-with: '' option (replace field with empty string) was not applied.
  • Fixed an issue with de-identification where de-ID profiles referencing DICOM tags using "repeater groups" (e.g., (60xx,3000) or (60xx,4000)) would not pass validation.
  • Fixed an issue with de-identification where de-ID profiles referencing some newer DICOM tags would not pass validation.
  • Fixed an issue with de-identification where de-ID profiles referencing private DICOM tags by PrivateCreator (name) value would not pass validation if their PrivateCreator (name) value contained a comma.

External Storages

  • When an External Storage fails its status check, a more detailed error message is available in the Web App to assist with troubleshooting.

Gears and Compute

  • Fixed an issue with Docker registry utilization for sites using a Persistent Volume Claim (PVC), which was causing gear uploads to fail.
  • Resolved an issue causing an intermittent but frequent failure of compute upload for cases where small files are uploaded.

Jupyter

  • The Jupyter Lab Project configuration has moved to a new Integrations section of Project Settings.

SDK

  • Resolved an issue where files.iter_find() only returns the number of files from "limit" parameter, rather than iterating through all matching files.
  • Resolved an issue where analysis.replace_file_classification() failed to update the file's classification.
  • Resolved an issue where an Advanced Search using 3 or more OR search terms in a group will result in a search error.

Smart Copy

  • Resolved an issue that could cause multi-hour Smart Copy operations to fail.

Viewer

  • Resolved an issue where the total area calculation for annotations with the same label did not include areas from Contour ROIs.

Web App

  • Fixed an issue where the Flywheel application would become unresponsive if left open for a long period of time.

20.2.1

FIXES

Viewer

V3 Viewer
  • Fixed issue in viewer backend logging.

20.2.2

FIXES

Gears and Compute
  • Resolved an issue with gear initialization on AWS that caused repeated failures of certain gear runs, predominantly GPU gears.

20.2.3

FIXES

Gears and Compute
  • Resolved an issue with the communication between individual gear compute resources and the compute monitoring system that was causing premature shutdown of gear resources leading to random gear failures.