Learn what projects are and how to manage them.
Projects are used to associate a group of users with a group of image or video collections (called volumes) and label collections (called label trees). What a project represents is entirely up to you. This may be all members and data of a certain expedition or cruise, the members and data of a certain research group or something entirely different.
Every user is allowed to create projects. To create a project, click on the button on the dashboard (or here). When you successfully created a project you will be redirected to the project overview. The overview shows you tabs for lists of all volumes, label trees and members that are associated with the project as well as several controls to modify the project.
Each project is only visible to project members. Each member has one of four roles: admin, expert, editor or guest. To modify project members you must be admin in the project. Click on the tab of the project overview to modify members. Enter a username in the input field on the top right, choose a role and click to add a new member to the project. Hover the mouse over a member in the list to choose a new user role using the dropdown list or click the button to remove a member from the roject. You cannot modify or remove yourself as a member of the project. Instead, ask another project admin to do this.
A guest is not allowed to modify anything in project. They can see all volumes, label trees and members that belong to the project. But they cannot modify anything related to the project and particularly cannot create or modify annotations in the volumes that belong to the project. A guest is able to access all label trees that are attached to the project, even if a label tree is private and the guest is no member of the tree.
In addition to everything that a guest can do, editors can create and modify annotations, annotation labels and image/video labels. They cannot delete annotation labels or image/video labels that were created by other users. However, they can modify the position and/or shape of an annotation that was created by another user. Editors should be the default choice for new project members.
An expert can do everything that an editor can do. In addition to that, they can modify or delete annotations or image/video labels of other users as well. Choose this role if a user should be able to "supervise" or correct other editors but should not be a full project admin.
A project admin has no restrictions in what they can do. They can create and modify annotations, annotation labels and image/video labels, including those of other users. Also, they can add or modify project members, attach or detach label trees and manage volumes. Finally, project admins are able to edit the project name and description or delete the entire project.
There can be one or more label trees attached to each project. Only the labels of these label trees will be available when annotations, annotation labels or image/video labels are created in the project.
Project admins can attach or detach label trees. To do this, click on the tab of the project overview, enter the name of a label tree in the input field on the right and hit enter to attach it. You can only attach public label trees or those that authorized the project to attach them. Hover the mouse over a label tree in the list and click the button to detach a label tree from the project.
You can also create a label tree and attach it to the project at the same time. Do this with a click on the button of the label trees tab. This is useful to create a new label tree specifically for the current project.
A volume is a collection of images or videos that belong together (like a directory in a file system). Each project can have one or more volumes attached to it. Unlike label trees, volumes always belong to at least one project. If a volume belongs to no project any more, it will be deleted.
Project admins can create or delete volumes. To create a volume, click the button of the volumes tab in the project overview. A new volume will be automatically attached to the project it was created for. Volumes can be shared between projects, too. You can attach existing volumes of any project where you are also admin. To do this, enter the name of the volume you want to attach in the input field on the top right of the volumes tab and hit enter. Hover the mouse over a volume thumbnail and click the button to detach or delete a volume. A volume is deleted only if this is the last project that it is attached to (there will be an additional request for confirmation in this case). Be careful when doing this since deleting a volume deletes all annotations and cannot be undone!
If a project has lots of volumes, filtering the volumes can help to find a particular volume. To filter the volumes in the project overview, type part of the name of the volume in the input field on the top left of the volumes tab. The volumes list will update as you type. You can also show only image volumes or video volumes with a click on the and buttons, respectively.
Up to three projects can be pinned to your dashboard. Pinned projects are always shown at the top of the dashboard, before recently created or joined projects. To pin a project, open the dropdown menu at the top of the project overview and click . To unpin a pinned project, click in the dropdown menu.
Projects have a name and short description so users can identify them. Project admins can edit these fields in the project overview. Open the dropdown menu and click to make the name and description editable. Click once you are finished or to reset your changes.
If you want to leave the project, open the dropdown menu and click . If you are a project admin, note that you can only leave a project if it has at least one other admin to manage it.
Finally, project admins can delete a project with a click on in the dropdown menu. This will detach all label trees and volumes from the project. All volumes that are not attached to another project will be deleted. Be very careful when you want to delete a project since you can destroy lots of annotations with a single action!