In Cytobank, Experiments can be grouped into Projects for organizational purposes, as well as for sharing access to Experiments among a group of people. Click the links to jump to the relevant section below.
- Creating and managing Projects
- Project roles: Members, Leaders, and Managers
- Adding and removing people from a Project
- Understanding Project access levels
- Adding or removing Experiments from a Project
Create a project by opening the Project menu visible at all times throughout Cytobank and selecting New:
(creating a new Project)
There are three ways to organize people within a Project: Members, Leaders, and Managers. Leaders and Members have no actual difference in their access permissions; they are only separated in case it is useful for organizational purposes. Both Leaders and Members cannot edit the Project or the Experiments within it (including any configurations such as gates, scales, compensations, Sample Tags, etc., and are bound by the access levels set for the Project. Leaders and Members are added to the project by Managers. Any person listed as a Manager in a Project is considered an administrator of the Project and has the ability to change the Project. Managers are not bound by the access levels of the Project and get full access to all Experiments within the project, whereas Leaders and Members are bound by Project permissions. A single user can be a member in a project but also be given full access to an Experiment within the Project. In this case, the full access permission takes precedent. See the next section for important notes about how each type of person in a Project is given access to the Experiments therein.
People can be added and removed intuitively while editing a project. To add someone, type their name into the text entry field. Note that only first and last names of the person's account are recognized; email address and username will not work. To remove someone, click the removal button to the right of their name.
(adding users to a project in different roles)
Members and Leaders can be added and removed from a Project to grant and revoke access to all the Experiments within that Project dynamically. This is not the case for Managers. Once a Manager is added to a Project or otherwise exposed to the Experiments within a Project while a Manager, they become a full access user on all the Experiments within that Project and will have to be removed from each Experiment individually if access needs to be revoked. Simply removing a Manager from a Project does not remove their full access to the Experiments within the project.
After electing to create a new Project there will be a page to enter basic information, including configuration options for access levels. These can also be changed at any time after creating the project.
(the new Project form)
Access levels are set for the Project and apply to all experiments within the Project. Every Project has its access levels broken down into two categories: Sharing Level and Cloning Level. Each category has multiple options.
Sharing Level defines the degree of access to Illustrations. It has the options of View Only and Illustrations. View Only makes it so members of the Project can only view previously saved Illustrations curated by users with full access to the Experiment(s). The Illustrations option gives Members the ability to create their own Illustrations.
Cloning level defines the level of access for members to the Experiment configurations and the raw data. Experiment configurations include gates, compensations, scale settings, etc. The Cloning Level category has three options: Disabled, Clone Files Only, and Full Clone. In Disabled mode, members cannot download raw data and cannot clone the experiment in any capacity. In Clone Files Only mode, members do not have access to the configurations of the Experiment but can download and clone the raw data. In Full Clone mode, members can clone the Experiment to gain access to all configurations of the Experiment, as well as the raw data.
Individual Experiments can be added or removed from a Project by navigating to the Experiment Summary page of an Experiment and clicking to edit it.
Experiments can be added and removed from a Project in bulk by visiting the management page of the Project and using the tool at the bottom:
(bulk addition and removal of Experiments from a Project)
Deleting a Project does not delete the Experiments within the Project.