Update Cell Annotations
The Update Cell Annotations tool takes one Cell Annotations () element as input and outputs a new Cell Annotations () element containing updated categories and/or annotations.The tool can be found in the Toolbox here:
Toolbox | Single Cell Analysis () | Utility Tools () | Update Cell Annotations ()
In the first wizard step `Update categories', the following options can be adjusted:
- Remove categories. The selected categories are removed.
- Remove all empty categories. Categories without any cell annotations are removed. Categories are also removed if empty after removal of cell annotations (see below).
- Rename categories. One or more categories are renamed. The Add button can be used to add additional categories to be renamed. Note that multiple categories cannot be renamed to the same name.
- Rename all categories. All categories are renamed according to the given pattern. This can be used for both prepending and appending to the name. E.g., if set to `MyPrefix {categoryName} MySuffix', a category `MyCategory' will be renamed to `MyPrefix MyCategory MySuffix'. This is done after the changes specified by Rename categories.
In the next wizard step `Update annotations', annotations containing text can be updated. Boolean (yes/no) and numeric annotations cannot be updated. The following options can be adjusted:
- Update annotations for. The updates can be applied to:
- No categories. Skip updating cell annotations.
- All categories. Update the cell annotations for all categories.
- Selected category. Update the cell annotations only for the category selected in Update annotations for category.
- Remove annotations. The selected annotations are removed.
- Change annotations. One or more annotations are changed. The Add button can be used to add additional annotations to be changed. Note that a annotation may be changed to an existing annotation and multiple annotations may be changed to the same annotation.
The options above can be mixed and matched to obtain the desired output. For example, a category can be first renamed and then the annotations it contains can be updated.
The Update Cell Annotations tool can also be started from the different views of the Cell Annotations () element, with dialogs automatically filled in with relevant selections:
- From the annotations table view ():
- annotations can be removed or changed from the right-click menu. Multiple rows can be selected before using the right-click menu.
- A category can be removed or renamed using the Remove and Rename buttons from the Side Panel.
- From the cell-level view (), the category over which the mouse hovers can be removed or renamed from the right-click menu.