Sharing some data from a project

Sometimes you only want to share a small subset of the data in one of your projects with another user. You can share out smaller sets of samples from a project by creating a new project in IRIDA, copying some samples to it, then adding new members to that project.

You must have the role of Manager on the project to copy samples to another project.

Create a new project

You can create a new project by clicking on the “Projects” menu at the top of the dashboard and selecting “Create New Project”:

Create new project dashboard location.

When you create a new project, you’ll need to provide a project name, and can optionally provide a project organism, a free-form project description, and a link to another web site that has more inforamtion about the project:

Create new project form.

A project name must be at least 5 characters long, and must not contain any of the following characters: ? ( ) [ ] / \ = + < > : ; " , * ^ | &

If you choose to set a project organism, click on the “Select an Organism” drop-down menu and begin typing the name of the organism. For example, if you wanted to specify a project organism of “Salmonella enterica”, you would begin to type “Sal” and the menu would allow you to choose from a set of well-defined organism names:

Project organism entry.

The organism names are derived from the NCBI taxonomy database.

To enable automated assemblies for the project, check the “Automatically assemble data uploaded to project” box. This setting will perform an assembly on all sequence files uploaded to this project. For more information about automated assemblies see the samples documentation.

When you’ve finished entering the details for your new project, click on the “Create Project” button. You will be redirected to the projects list.

IRIDA will automatically generate a numeric project identifier for your project. The project identifier is used by external tools for uploading sequencing data to IRIDA. The project identifier can be found in the “Project Details” panel, or in the projects list.

Creating a project from cart

You can create a project with samples already added to the project by using the cart. To use this feature, you must first add some samples to the cart. Once the samples are added you can click the arrow next to Select a Pipeline, and click Create Project from Samples. This will bring you to the create project page.

Create project cart

Continue creating the project details as described above, but note the checkbox Add samples in cart to project. If this checkbox is enabled any samples in the cart will be automatically added to this project. If there are any samples which you cannot add to the project, a warning will be displayed below.

Create project cart warning

Once the new project is created return to the project that you would like to copy samples from.

Copy Samples

Samples may be shared between projects. A sample that is shared into multiple projects is effectively linked between those projects – the files contained within the sample are not physically duplicated, and any sample metadata changes in one project are reproduced in the sample for all projects.

You must be a project Manager on both the project that you are sharing the sample from, and the project that you are sharing the sample to.

Start by selecting the samples that you want to share with another project. When you’ve selected the samples that you want to share, click on the “Samples” button just above the samples list, and select “Share”:

Share samples button.

In the dialog that appears you will be presented with a list of the samples that are going to be shared, and an option to choose the project that the samples should be shared to:

Copy samples dialog.

When you click on the drop-down box to select a project, you can either visually find the project that you want, or you can filter the projects by their name by typing into the text field.

After selecting the project to share samples to, you may select whether users on the new project should have modification access to those samples. If users on the new project should not be able to modify the samples, uncheck the Allow modification access to samples in the new project box. If you have selected samples that are non-modifiable in your current project you will be unable to give modification access to any of the samples you have selected.

Locked Sample.

Once you’ve selected the project that you want to share the samples to, click on the “Share Samples” button.

Adding a Project Member

Once the samples are copied over to the new project, the last step is to add all users to this project that need access to this data.

Project details members tab.

To add an individual project member, click on the “Add Member” button:

Add project member button.

You can use the dialog that appears to select a user account, and choose the Project Role that the new member should have:

Add project member dialog.

Remember: a project collaborator has read-only permissions, and a project manager is allowed to modify project details.

Once you’ve selected the user and role to add to the project, click on the “OK” button.