Not only do Gears reduce data management time by performing routine tasks, but you can also configure them to run automatically, so you do not have to think about it. For example, say you want all DICOM data converted to NIfTI format in a project. You can create a Gear rule to classify all DICOM data run the dcm2niix: DICOM to NIfTI conversion Gear each time a DICOM file is added to a project.
Learn more about how to create a Gear rule as well as how to standardize rules across your site using a Gear Rule Template.
A good first step for Gear Rules is to make sure your data is properly classified.
Correctly classifying data and extracting metadata greatly increases the value of raw data and allows you to do more with it inside Flywheel.
Create a simple project gear rule to automatically classify DICOM files:
Click Projects in the left navigation menu.
Select the options menu , and choose Gear Rules.
Click Add New Rule.
Enter a name for the rule
Under If the data matches ALL of the following criteria, Select file type from the list.
Enter dicom for the file type.
Click Select Gear.
Choose SciTran: MR Classifier.
Select a version of the Gear to run. In most cases you should use the latest version.
Disable Always use the latest gear version.
When this is enabled, Flywheel automatically updates the gear when a newer version is published. However, updating the gear version may have unintended consequences for provenance and may change how the gear works.
Modify the Gear configuration if necessary.
Click Save Changes.
Click Save on the Gear rule.
Now each time a DICOM is uploaded to the project, the Gear will automatically run and classify the data. Once the data is classified as DICOM, you can set up another Gear Rule to run the
dcm2niix: DICOM to NIfTI conversionGear. A Gear rule for converting DICOM to NIfTI typically looks like this:
Site admins can use Gear Rule Templates to define the default set of Gear rules for new projects. Project administrators can override or modify these default Gear rules within the project's management page.
Select Gear Rule Template from the left navigation menu.
Click Add New Rule.
Create a Gear Rule using the same method described above in Using Gears.
Now, any new projects created will include the Gear Rule. Changes to the Gear Rule Templates do not affect existing projects, only projects created after a change is made. Project administrators can override or modify these default Gear rules within the project's management page. Multiple Gear Rules can be defined on a project and will apply only to data within that project.
One setting you and project admins should be aware of is the Gear version. By default Gear templates use the latest version of the the gear. However, you may want to standardize on a gear version. If this is the case, make sure to choose a specific gear version to run in the gear template.