Experiments Overview
The Experiments page lets you connect samples with an experiment, and the data resulting from that experiment.
Navigate to the "Experiments" page from the landing-page navigation box.
Clicking "Experiments" brings you to a listing of the experiments in the system.
Clicking a particular experiment brings you to a detailed view.
The
Overview sub-tab shows the start date, end date, and the sample used in the experiment.
The
Assays sub-tab shows the assay data for the samples that have been included in the experiment.
There is a tab for each type of assay run on the samples.
Any additional assay data added for these samples will show up here.
The
Files sub-tab lets you attach files to the experiment. For example, you might attach published articles, applicable SOPs, external datasets or analysis or image files to provide context and/or analysis of what occurred in the experiment.
Create a New Experiment
Experiments can be created from the Samples grid using the
Add to Experiment button, which becomes enabled once you select a number of samples.
After selecting the desired sample and clicking
Add to Experiment, click the
New Experiment tab. Enter a name and description for the experiment. If you do not supply a name, one will be generated using the default naming pattern LB-${genId}. (Administrators can change this naming pattern by updating the entry for the "_default" type in the labbook.LabBookExperimentType table.)
Clicking "Create Experiment" navigates you back to the Samples grid with a notification about the newly created sample.
Clicking the
View Experiment link in this notification bar brings you to the details page for the experiment, showing the name, description, start date, end date and creation/modification info as well as the grid of samples.
Add Samples to an Existing Experiment
If you have an existing experiment, you can add samples to it as follows.
From the Samples grid, select the samples you want to add, and click
Add to Experiment.
In the dialog box, click the
Select Existing Experiment tab, and using the dropdown menu, select the target experiment.
Click
Add to Experiment.
You are navigated back to the Samples grid, with a banner notification about the additional samples.
Remove Samples from an Experiment
You can remove samples from an experiment as follows.
- Navigate to the Experiment page, and click the Experiment you wish to modifiy.
- From the grid of samples currently in the Experiment, select the one or more sample you wish to remove.
- Click the Manage dropdown menu and select Remove from Experiment.
- A banner notification will appear describing the number of samples removed.
Edit or Delete an Experiment
From the details page for an experiment, you can edit the name, description, start date and end date, as well delete the experiment.
Click the edit icon next to the item you wish to change.
To delete an entire experiment, click the
Delete button in the upper right.
When you delete the experiment, you will be shown a confirmation dialog
If you confirm the deletion, you will be taken to the Experiments grid page where a success message will be displayed.
If the deletion fails, you will stay on the Details page and an error banner will be shown there.
Experiment Administration
Administrators can control the main Experiments grid view by modifying the query labbook.LabBookExperiment. To find that query: in the query browser, navigate to labbook.LabBookExperiment, then click
View Data. Select
(Grid views) > Customize Grid. Select which fields you wish to display by placing checkmarks next to them in the
Available Fields panel. Save the grid view as the default view (and share it with all users).
Administrators can access the tables in the labbook schema through the usual LabKey APIs for inserting and updating data, as well as the LabKey Query Browser UI.
