How do I use tags?

Tags are one of the most flexible analysis tools in Progenesis, allowing you to attach a label to a selection of features. You can then show or hide features using a filter that's based on a selection of their tags.

In this article:

• An example
• Creating new tags
• Applying and removing tags
• Renaming and deleting tags
• Filtering your features

An example

For example, you could very quickly find features whose expression is increasing significantly by doing the following:

1. Create a tag called "Significant" for all features that have a low p-value
2. Create a tag called "High fold change" for all features that have a Fold value greater than 2
3. Create a tag called "Up-regulated" for all features that have their highest values in a Treated condition
4. Combine these tags in a filter, so that only features that have all three of the tags are shown

Creating new tags

There are two ways to create new tags for your features:

• Create tags for the selected features
• Create tags for features having particular values

Creating a tag for the selected features

To create a tag for the selected features, first select the features to which you want to apply the tag. Features can be selected in the list at the left of the screen.

To select a range of features, you can click the feature at the start of the range, then hold down the Shift key and click the feature at the end of the range. To select or deselect an individual feature, hold down the Ctrl key and click on it in the list.

Next, right-click on any of the selected features in the list. The tag menu will appear; from this, select the New Tag… option. The following window appears:

Enter the name that you want to give the tag. If you'd like it to have a different colour, click the coloured button to the left of the name. When happy, click OK. The tag is created and each of the selected features is given that tag. If any features already had a tag, the new tag is applied in addition to the existing tags.

Creating tags for features having particular values

Using the QuickTags feature, certain types of tag can be created without first having to select features. For example, you can quickly tag all features with a p-value of less than 0.05.

To use QuickTags, right-click anywhere in the list of features. In the tag menu, open the Quick Tags sub-menu and select one of the options in it. As before, the Create New Tag window will appear. Enter a name for the new tag and, optionally, choose a colour, then click OK. This time, the new tag will be applied to all features that meet the criterion selected in the Quick Tags menu.

Note: if your feature measurements change, this tag will not be recalculated. That is, all features that were assigned the tag when it was first created will continue to have that tag, regardless of their new measurements.

Applying and removing tags

To give an existing tag to a feature (or set of features), simply select the relevant features in the list, then either:

• right-click on any of the selected features, or
• click the arrow in the Tag column header

Either method will display the tag menu. From that, simply select the tag you wish to apply or remove.

Renaming and deleting tags

If you need to rename a tag, or you want to delete a tag that you no longer need in your experiment, this can be done easily. Click on the arrow in the Tag column header and select Edit tags from the menu. The Edit Tags window appears:

To rename a tag, highlight it and click Rename tag to show the Rename Tag window.

To delete a tag, highlight it and click Delete tag. Note that this will remove the tag from all features, not just the selected features.

Filtering your features

While labelling your features with tags is a helpful way to organize your data, filtering based on those tags is the more powerful analysis tool. By creating a filter, you can quickly reduce the amount of data you are viewing, enabling you to concentrate on the features of real interest.

To create a filter, click the Create button in the filter panel shown above each feature list. The Create a filter window appears:

In this window, you can build a filter showing:

• features that have all of the tags in a given set
• features that have at least one of the tags in a given set
• features that have none of the tags in a given set
• or any combination of the above options

For example, imagine you have defined two tags: one for features that have a p-value of less than 0.05; and one for features that have a fold change of 2 or more. The Create a filter window would initially look as it does above. To show only the features that have both of the tags, click and drag each tag in the Available tags list to the top list on the right. When the done, the dialog looks like this:

Only features that have both of these tags will be shown when you click OK. All other features will be hidden. Any tags left in the Available tags list will not affect the filter.

Here are some further examples of tag combinations you could use to filter your features:

To show this…	…you could set up this filter (click to expand)
Features that are at least 2-fold up-regulated in the Control group and have an Anova p-value of less than 0.05
Features with a power of at least 0.8 and p-value less than 0.05, except those with a q-value above 0.01
Features that have either a low p-value (less than 0.05) or a fold change greater than 2
Features that have no tags assigned to them
Features that have any of the tags assigned to them

Finally, to return to showing all features, just click the Clear the filter button and click OK.