The Phenotype Set data type represents experimental data about an organism’s ability to grow on a specific media condition, recorded as either growth or no growth.
A Phenotype Set can be uploaded from a TSV (tab-separated values) file with a .tsv or .tab file extension, or from Excel spreadsheet with a .xls extension. The spreadsheet needs to have exactly these five columns:
For this example, we will use the Shewanella_oneidensis_MR-1 Genome from the Example data tab. To add the Genome to your Narrative, find the Data Panel along the left side of the screen and click the Add Data (or red “+”) button. This will open the Data Browser slideout. Select the Example tab at the top of the slideout, and search for “Shewanella_oneidensis_MR-1” genome. Mouse over the Genome name and click the blue Add button.
The S. oneidensis Genome object should appear in your Data Panel.
To download an example phenotype set data table, right-click here and choose “Save as”.
Now open the new Import tab in the Data Slideout and drag the example phenotype set file that you just downloaded into your Staging area (go here if you need instructions on doing that).
Now the phenotype set is in your Staging area–it’s time to import it into your Narrative as a KBase Phenotype Set data object. Open the pulldown menu to the right of the filename in your Staging Area and select “Phenotype Set”:
Now click the import icon (up arrow) to the right of “Phenotype Set”. The data slideout will close and an app called “Import TSV File as Phenotype Set From Staging Area” will be added to your Narrative.
Notice that the name of the Phenotype TSV file is already filled in, as is a suggested name for the Phenotype Set data object that will be created by the import (you can change that if you like).
At this point, the corresponding Genome hasn’t been linked to the phenotype set. To add the name of the Genome, click on the dropdown in the app to select the Shewanella_oneidensis_MR-1 genome that you added to your Narrative earlier. Then click the green Run button to start the import. When the import is finished, your Data Panel will update to show the new Phenotype Set object, and a report will appear in the import app cell.
In the example above, we used a Genome that was in the Example data. You can also import your own Genome data from a file (go here for more information).
The Genome import can handle gzipped (.gz) input files. However, .zip files require special handling and .Z files are not yet supported by the importers (we are working on adding that). You can upload a zip file to your Staging Area, but it is recommended that you use the “uncompress” button to its left (the one with the diagonal arrows) to unzip it before trying to import it.