Algorithms can write results as categorical columns such as in clustering tasks (integers represent a cluster) or data cleaning tasks (pass, which is labeled as 1, or fail, which is labeled as 0). Categorical filters can take data stored as categorical columns and convert them to filters, allowing them to be used in your workflow.
1. Add a Gating Task
Click Add new child task and select Gating from the task selector. The Gating task should be added downstream of a clustering task or a data cleaning task.
Note that your Workflow might look slightly different, if you are using Compact View.
2. Add Categorical Filters
Click on Categorical Filters.
3. Select Features to Base Categorical Filters on
Select Unique Values.
Select the Feature you would want to create a categorical filter. In this example, the results from the FlowSOM clustering is used as the Feature.
Type in a Filter Name Prefix.
Click Submit.
Your Gating Tree should now have your categorical filters. Once you have saved the task, these filters will now be available for downstream tasks.
Click Save Task.
Useful Tip: Use the Categorical Filters for Downstream Tasks
Categorical Filters can be used in downstream tasks.
In the image above, we have created a Figure task downstream of a gating task that identifies metaclusters through Categorical Filters. We have used the Categorical Filters to create a Scatterplot (Overlay) plot that has the identified clusters overlaid on an opt-SNE dimension reduction plot.
Useful Tip: Previous Filters Created from Gating Tasks in the Same Workflow Pipeline are Still Available Downstream
The image above is showing a workflow with 2 gating tasks labeled as: Gating (Clean-Up) and Gating (Identify Metaclusters). The image also shows the filters that are created in each gating task.
We have now added a Subsampling task below the Gating (Identify Metaclusters) task. Inside the Subsampling task, you can see that the filters from both gating tasks are present.