flywheel-connect
A 3D Slicer Extension to view, select, and download images from a Flywheel instance to 3D Slicer and storing Slicer outputs back to Flywheel.
Flywheel is a comprehensive data management solutions for life sciences and imaging research. More details at https://flywheel.io/.
The Flywheel Connect 3D Slicer Extension is now in the 3D Slicer Extension Catalog and available through the 3D Slicer Extensions Manager for direct installation.
Usage Instructions
-
Install 3D Slicer and the Flywheel extension as described here.
-
Navigate to flywheel-connect under the Modules drop-down box.
-
To access the Flywheel container hierarchy first enter your Flywheel api-key and press "connect". If you have logged in with the Flywheel CLI (Command-Line-Interface), the cached Flywheel api-key can be used without entering a new one.
-
Navigate to the desired Acquisition in the Container Hierarchy Tree for a particular project.
-
By clicking on a file or files in the "Files" of a container, they can be loaded into 3D Slicer if they are images or models of the 3D Slicer Supported Data Formats. Compressed archives of DICOMs are also supported, if they are labeled as such in Flywheel.
-
By clicking on a container, slicer-derived files can be uploaded to Flywheel as
- Files under a selected container
- Files for a new Analysis object under a selected container.
File Management
Files will be cached to the flywheelIO/ directory of the users home directory. This is default and can be changed. If caching files is not desired, uncheck "Cache Images". This will delete all files in the cache between downloads.
Interface Overview
The interface is shown below. Notable areas are commented on:
- A) The API-Key can be entered here. Or the cached API-Key will be used from a previous
fw login {API-KEY}command. When connecting to a Flywheel instance all data will be cleared from 3D Slicer to prevent invalid data references between Flywheel instances. If there is no previously cached login--or the supplied API-Key is invalid--an error dialog is displayed. - B) Default disk cache.
- C) If unchecked, the cache will be cleared between downloads.
- D) Select Box for Groups. This will "cascade" selections for the first project, if it exists.
- E) Select Box for Projects. The selected project will clear and repopulate the tree. If no project exists, the tree is not enabled.
- F) Analyses objects are not automatically cached. Double-clicking will load all Analysis.
- G) Files that are cached will have a green "badge". Right-clicking on selected files will enable them to be cached. Some downloads are large.
- H) Load all selected files. Files that are Slicer-supported data formats (Images and Models) will be loaded. This will only be enabled if files are selected.
- I) Upload derived files to Flywheel Analysis or Container files. This will only be enabled if a single valid Flywheel Container is selected.
- H) If checked, indicates that derived files should be uploaded to Flywheel as Analysis output under the selected Container.
1 Nov 25, 2021
32 Nov 16, 2022
4 Mar 19, 2022
67 Jan 1, 2023
0 Mar 27, 2022
106 Dec 22, 2022
12 Nov 2, 2022
4 Dec 6, 2021
253 Jan 5, 2023
2 Jan 02, 2022
1 Feb 03, 2022
80 Jan 04, 2023
3 Sep 30, 2022
121 Nov 15, 2022
36 Nov 10, 2022
4 Mar 08, 2022
6.2k Jan 01, 2023
10 Nov 04, 2022
3 Sep 15, 2022
1 Nov 03, 2021
0 Aug 03, 2021
15 Dec 14, 2022
1 Jan 10, 2022
17 Jul 17, 2022
7.6k Dec 30, 2022
2 Dec 23, 2021
10 Mar 28, 2022
2 Sep 03, 2022
96 Dec 15, 2022