Skip to content

Organization, Searching and Sharing

CellEngine's homepage shows all experiments and folders to which you have access. From there, you can create new experiments and folders, as well as share and organize existing ones using tags and additional folders.

▶️ Video tutorial available

Folders

Creating a new folder

Howto

  1. Select the folder in which you wish to create a new folder.
  2. Click New Folder at the bottom of the sidebar. inbox sidebar
  3. Type a name for the folder and click OK.

Tip

You can also right-click on an experiment or folder in the inbox to rename, duplicate, share, delete, or move it.

Tags

Tags can be added to your experiments to help with organization. Tags are displayed next to your experiment's name and in the experiment summary page. CellEngine saves tags you’ve used before to make it easier to maintain consistent labeling.

Adding and removing tags

Tags can be added to or removed from multiple experiments in the same folder. To tag from a folder:

Howto

  1. Navigate to the folder with the experiments that you want to tag.
  2. Check the box beside each experiment to be tagged.
  3. Click on Tag in the toolbar above the experiments. Existing tags will be shown in a dropdown with checkboxes. The checkbox will be unchecked, checked, or indeterminate to indicate whether the tag is applied to none, all, or some of the selected experiments.
  4. Search tags by typing in the Search box. To add/remove all the tags in the filtered list, click on tag all select all matching.
  5. To add or remove existing tags, check the boxes next to them.
  6. To make a new tag, click on Create New. Type in the tag name, then click on Create. The new tag will automatically be applied to all the experiments selected.

To add or remove a tag from within an experiment, follow these steps:

Howto

  1. Go to the experiment summary. Tags lists the current tags for the experiment.
  2. To remove a tag, click the X on the tag.
  3. To add a tag, click on Start typing. Existing tags will be shown in a drop-down list. Click on a tag to add it, or type a new tag name and press enter.

Filtering Experiments

  • If you have many experiments in a folder, it can be helpful to narrow your search.
  • To filter by name and tags, click on filter icon Filter on this column in the Name column. In the search box, type to filter experiments by name and tags.
  • To filter by tags only, click on tag icon Match tags. Choose a tag from the list or type to narrow down the tag list.
  • You can also filter by researcher. In the Primary Researcher column, click on filter icon Filter on this column. Type the researcher’s name in the Search text box to narrow the list.

Sharing

By default, experiments are only visible to you. You can share with other users following the steps below. See Access Management for additional information.

Permissions are inherited from folders. For example, if you grant another user the “Basic read/write” role on a folder, that user will be able to view and modify all experiments and sub-folders in that folder.

FAQ: How do I share all of my experiments with my coworkers?

Create a folder (perhaps called your company, department or lab's name) and share it with all of your coworkers. Then, move existing experiments into, and create all future experiments in, that folder.

To ensure that all experiments are created in this folder and are thus accessible to your coworkers, domain administrators can require that experiments and folders are created in an existing folder using CellEngine domain settings. Contact support@cellengine.com for more information.

Sharing with specific users

Howto

  1. Within an experiment, click the share button in the left sidebar; or, from the inbox, right-click on an experiment or folder and click share from the context menu. A dialog will open.
  2. Enter the user with whom to share:
    • If you have previously shared an experiment/folder with a user, if they have previously shared an experiment/folder with you, or if they are in your domain, then enter part of their name and select them from the autocomplete.
    • Otherwise, enter the user's full email address.
  3. Select the access level. A brief description of each level is provided in the table below and shown when you hover over the options in the sharing dialog.
  4. Optional: Write a message to the new users, for example explaining why you are sharing the experiment with them.
  5. Click update.
Role Description
Limited read-only Can view experiment, but not save a copy or download files. Can view folder.
Read-only Can view and save a copy of experiment and download files. If a user wants to modify the experiment, they will have to save their own copy first.
Basic read/write Can modify experiment or folder, but not delete it or share it. This is the suggested role to provide to other users if you want them to have read/write access.
Full read/write Can modify, delete and share experiment or folder. This is the default role assigned to you when you create a new experiment or folder.

Un-sharing with a user

Howto

  1. Within an experiment, click the share button in the left sidebar; or, from the inbox, right-click on an experiment or folder and click share from the context menu. A dialog will open.
  2. Click the remove button next to the user whom you wish to remove.
  3. Click update.

Searching

The search field at the top of the inbox defaults to searching experiment names, paths and tags. You can search specific fields and experiment comments using combinations of these search operators:

What you can search Example
The name, path and tags splenocytes mouse (all terms, any order)
"mouse splenocytes" (exact phrase)
Only in the name name:(splenocytes mouse) (all terms, any order)
name:splenocytes name:mouse (all terms, any order)
name:"mouse splenocytes" (exact phrase)
Only in the path path:(validation cohort1) (all terms, any order)
path:validation path:cohort1 (all terms, any order)
path:"validation cohort1" (exact folder name)
Only in tags tag:(splenocytes mouse) (all terms, any order, across all tags)
tag:splenocytes tag:mouse (all terms, any order, across all tags)
tag:"mouse splenocytes" (exact phrase in one tag)
In comments comments:(splenocytes mouse) (all terms, any order)
comments:splenocytes comments:mouse (all terms, any order)
comments:"mouse splenocytes" (exact phrase)

Additionally, you can search the folder hierarchy using these search operators:

What you can search Example
Name of folder folder:"My Folder" (exact name)
Name of ancestor folder(s) path:"Parent folder name" (exact name)