This panel allows users to view and edit the taxonomy into which recordings
are classified. Taxonomies are organized hierarchically into a tree based structures.
The categories that make up taxonomies consist of three types:
- Root Categories: The broadest categories at the root of the tree.
- Parent Categories: Categories with children (may also be root categories).
These categories have beige bullet points to their left in the Hierarchal
- Leaf Categories: Categories with no children. These categories have
blue bullet points to their left in the Hierarchal View.
The topmost category gives the location on disk of the file holding this structure,
if any. Parent categories may be expanded by clicking on the handles to the
left of their bullet points.
Categories may have any number of children. A given category can be the child
of more than one parent.
The currently loaded taxonomy can be seen in one of two views. The first, called
the Hierarchical View, allows users to see a hierarchal tree reflecting
the relationships of broad categories going down to narrower categories. The
Hierarchical View can be seen in Figure 1 below.
The second view, called the Ancestry View, allows users to see the
taxonomy in the form of a list of leaf categories. Children of leaf categories
represent a list of all ancestors of the given category. All of the combined
ancestors of each leaf category are listed together, even if the leaf appears
in different places in the structure. The taxonomy is not editable in this view.
The Ancestry View can be seen in Figure 2 below.
Both of the trees in the above two views are sorted alphabetically.
The names of categories may be edited in the Hierarchical View by
clicking on them once and typing in changes. The <enter> or <return>
key must be pressed to register the changes.
- Display Hierarchy: Switches from the Hierarchical View
to the Ancestry View.
- Display Ancestry: Switches from the Ancestry View to the
- New Taxonomy: Deletes the current taxonomy and creates a new empty
- Load Taxonomy: Loads a taxonomy contained in a taxonomy_file
XML file on disk into memory and displays it. Allows the user to choose the
file using a file chooser dialog box.
- Save Taxonomy: Saves the currently displayed taxonomy into a taxonomy_file
XML file on disk. If a path is given in the File holding musical taxonomy
field of the Configure
File Locations Dialog Box, then automatically saves the file to that path,
overwriting any existing file. If this field is blank, then allows the user
to choose the file location using a file chooser dialog box.
- Save Taxonomy As: Saves the currently displayed taxonomy into a
taxonomy_file XML file on disk. Allows the user to choose the file
location using a file chooser dialog box.
- Add New Sibling Category: Adds a new category at a child of the
same parent as the currently selected parent.
- Add New Child: Adds a new category at a child of the currently
- Delete Branch: Deletes the currently selected category and all
of its children.
Displays the number of root categories in total in the Hierarchical View
and the number of leaf categories in the Ancestry View.
- Under the current version of the software, the classification will not work
if root categories are also leaf categories. This will be updated in a future
version. A flat taxonomy can be simulated in the current version by making
all categories the children of a single leaf category.
- No changes should be made to the taxonomy once classifiers have been trained.
- Changes made to the taxonomy could have an impact on any model categories
of recordings that are loaded in the Recordings
Panel. The user should ensure that any model categories of loaded recordings
are updated in order to match the new taxonomy.
Figure 1: Hierarchal View of taxonomy.
Figure 2: Ancestry View of taxonomy.