folder import should be used if you are importing data that you previously downloaded from Flywheel, or if you are importing data that was shared from another Flywheel site. The
folder import command uses the folder structure to map your data to the Flywheel hierarchy. Below is the basic Flywheel hierarchy:
Follow these instructions to download and install the Flywheel CLI. If you cannot download the Flywheel CLI to your computer, you can upload smaller batches of files using your web browser.
Your data must be structured to match the Flywheel hierarchy structure. If your data does not follow that structure, see our other options for importing data.
Follow these steps to import your structured directory to Flywheel:
Open Terminal or Windows Command Prompt.
Note the location of the parent folder for your data.
Enter the import folder command:
fw import folder <Folder you are importing> <optional flag>
fw import folder ~/Desktop/MultiCenterStudy--group psychology
The Flywheel CLI displays the hierarchy of the data and if it will create a new container or use an existing container in Flywheel. There is also a scan summary.
Learn more about the optional flags for the import folder command.
Review the hierarchy and scan summary to make sure it matches what you expect.
Where are my files?
The Flywheel CLI takes the related DICOM files and groups them in to single a zip file with the extension
dicom.zip. In the scan summary, this is called a packfile. The Flywheel CLI imports the
dicom.zipfile to the Acquisitions tab.
Enter yes to begin importing.
The Flywheel CLI displays its import progress
Sign in to Flywheel to view your data.
Each level in the Flywheel hierarchy must be specified during import. This means you must either:
Have a folder for each container (Group, Project, Subject, Session, Acquisitions) OR
Manually configure the container using an optional flag. For example:
--project <project label>. For more information about the optional flags, see our reference guide.
The directory structure for projects that include metadata and analysis is different from the structure of the other download options. This means that if you plan to import the project back to Flywheel using the
import folder command, you will need to update the directory structure to match the requirements of that command.