How do I run a gear on multiple sessions or acquisitions at the same time in Flywheel?
Executing a gear on multiple datasets at once is done by completing a "Batch Run Gears" action. When viewing data on the Project Dashboard, you can select entire sessions or specific acquisitions within a session for which you want to run a gear.
Under the Actions menu, select the Batch Run Gears option. A modal then asks you to select the gear type and then you can select from the gear you want from the list of those available on your site. You then are able to choose the version of the gear and set any configuration options available for that gear.
After pressing the Run Gear button, you are then notified how many jobs of that gear you are starting based on the datasets you selected. Selecting 'Confirm' pushes these jobs into your site's job queue and their progress will appear on the provenance tab.
How is the number of jobs queued determined?
If a batch run is completed on an entire session for a gear, it will successfully queue jobs for acquisitions that have the correct number of expected inputs. For example, if the gear expects 1 nifti file as an input, it needs to be able to determine the one file to use.
If there are zero of the expected files, it won't queue a job. If there are multiple possible files, it will return a failure saying it can't determine which one to run.