×

back About Label Trees

Learn what label trees are and how you can manage them.

A label tree is a collection of labels that may be flat or in a tree-like structure. This can be a taxonomy, a custom classification scheme or something entirely different. Label trees can be attached to multiple projects. If a label tree is attached to a project, all labels of the label tree are available to be attached to annotations or images in this project.

A label is some kind of semantic category like a habitat classification, a morphotype or taxon for an organism.

Every user is allowed to create label trees. To create a label tree, click on the button on the dashboard (or here). When you successfully created a label tree you will be redirected to the label tree overview. The overview shows you a list of all labels, projects and users that are associated with the label tree as well as several controls to modify the label tree.

Visibility

A label tree can be either public or private. Public label trees are available to be attached to any project and can be viewed by any user. Private label trees, however, can only be attached to specifically "authorized" projects. If a label tree is private, it is only visible for members of the label tree or for members of any project to which the label tree is attached.

The visibility of a label tree can be set when it is created. It can also be changed later by label tree admins. To do this, click on the button. This will activate a select element where you can choose a new visibility. Finally, click to apply the change.

Members

The labels of a label tree can only be modified by label tree members. Each member has one of two roles: admin or editor. To modify label tree members you must be admin for the label tree. Click on the button of the members panel to modify members. Enter a username and choose a role to add a new member. Choose a new user role for existing members to modify them. Click the × button to remove a member.

A label tree editor can view the label tree even if it is private. Also, they can create and modify labels of the tree.

In addition to everything that an editor can do, admins can add or modify label tree members, add or remove authorized projects, edit the label tree name, description and visibility or delete the entire label tree.

BIIGLE administrators can create label trees without members. These are special "global" label trees. Global label trees are attached to all new projects by default.

Projects

A label tree can be attached to one or more projects. The label tree overview shows a list of all projects to which the label tree is attached and where you are a member of. Note that this list might not show you all projects that use the label tree, even if you are admin of the label tree.

If a label tree is private only authorized projects may attach it. Label tree admins can control which projects are authorized and which aren't. To add an authorized project, click on the button of the authorized projects panel, enter the project name and hit enter. You can only authorize a project where you are a member of. Click the × button to remove authorization of a project. If a label tree is attached to a project of which the authorization is removed, the label tree will be automatically detached as well.

Modify a label tree

Label trees have a name and short description text so users can identify them. You already learned how to change the label tree visibility. The name and description are modified in the same way. Click to make the name and description editable. Click once you are finished or to reset your changes.

As a label tree admin you cannot modify yourself as a label tree member in the members panel. If you want to have another role in the label tree, ask another admin to change it. If you want to leave the label tree, click the button. Note that you can only leave a label tree if it has at least one other admin to manage it.

Finally, label tree admins can delete a label tree with a click on the button. This will detach all projects from the label tree and attempt to delete all labels. If a label is still attached to an annotation or an image, it (and therefore its label tree) cannot be deleted.

To learn more on how to create, modify or delete labels of a label tree, continue here.