Instrument data on its own can hold a great deal of information, but can become even more useful when integrated with other data about the same participants or specimens. From an assay alone, you might learn a lot about how a blood marker changes over time--but being able to see that the trend is more pronounced for patients receiving a certain treatment could more directly lead to improved patient outcomes. LabKey Studies
offer a wide range of integration, analysis, and modeling tools for participants over time, and we can integrate assay data into that framework as well.
In this tutorial, now that we have finished performing quality control on our imported instrument data, we will copy it to a study which already contains (fictional) demographic data that aligns with our assay tutorial sample data.
Install the Demo Study
- Locate and remember the location of your LabKey demo study ("HIV Study").
- If you did not already install one, complete the instructions in this topic: Install the Sample Study
- By default it will be in a Tutorials project and named HIV Study.
Select Data to Copy
- Return to your "Assay Tutorial" folder if you navigated away.
- In the Assay Tutorial folder, click GenericAssay in the Assay List web part.
- Check the boxes for the Run1 and Run2 rows and click the Show Results link to see the combined set of results from two runs.
- Notice the filter reads "Run IS ONE OF (XX, XX)" listing the two run numbers.
- Since we only wish to copy a subset to our study, we can sort our results to find data of interest. Click the ParticipantID column and choose Sort Ascending.
- Select all rows for the first participant (249318596).
- Click the Copy To Study link.
- Using the dropdown, select the demo study you installed. For example, if you are using our tutorials and following naming suggestions, it would be "/Tutorials/HIV Study".
- Click Next.
- Notice that specimens have been matched based on ParticipantIDs and Dates in the demo study. checkmarks indicate valid specimen matches. If there were specimens without matching rows in the target study, you would see a instead, but can still copy the assay data into the study successfully.
- Click Copy To Study
- You will now see the dataset that has been copied to the demo study. It looks like the assay run results, with an additional AssayID column containing a link back to the source run for every row.
- Note: If there is a pre-existing dataset named "GenericAssay" in the study, the new on you copied will been renamed "GenericAssay1".
Organize the New Assay Data in Your Study
When the new dataset is copied to the study, it is "uncategorized". You can place this new dataset into the "Assays" category in the target study.
- You are now in the target study folder. You can reach the home page of the study by clicking the Overview tab.
- Select the Clinical and Assay Data tab.
- Click the Data Views (pencil) icon to enable editing metadata.
- Scroll down and click the pencil icon next to your new dataset in the Uncategorized section. It may be named GenericAssay1 now.
- From the Category pulldown, choose "Assays".
- Click Save.
- Click the Clinical and Assay Data tab (or the pencil icon for the data views web part) to exit edit mode.
- Notice that your copied instrument data now appears in the Assays section.
Integrate with Other Study Data
Now that the data has been copied to the study, we can integrate it with other data. Since we only copied data for a single participant, we won't make elaborate connections here, but we can create a simple combined grid by adding some columns of demographic data which were not available in our assay run upload process.
- Click the name of your newly copied dataset from the Assays section on the Clinical and Assay Data tab to open it. Notice that all values in the ParticipantID column are links, meaning they connect to more data via "lookup".
- Select (Grid Views) > Customize Grid.
- Click the next to Participant ID to expand columns available through that lookup reference.
- Place checkmarks next to Start Date and Treatment Group.
- Click Save.
- Save as the default, or name the new grid.
Originally, the ParticipantID column in the assay results was simply a value, but after copying to the study, the dataset column for ParticipantID provides links to a wealth of demographic and clinical information about that participant. Now we can show the treatment group alongside the instrument data results.
You have completed the General Purpose Assay Tutorial and learned about creating and using LabKey assay tools and integration. Next, you can try exploring some of the built in assay types listed in this topic: Assay Data