# Adding annotations to a gene list

* [Associating a spreadsheet with an annotation file](#associating-a-spreadsheet-with-an-annotation-file)
* [Adding annotations to a spreadsheet](#adding-annotations-to-a-spreadsheet)

There are many useful visualizations, annotations, and biological interpretation tools that can operate on a gene list. In order for these features work with an imported list, an annotation file must be associated with the gene list. Additionally, many operations that work with a list of significant genes (like GO- or Pathway-Enrichment) require comparison against a background of “non-significant” genes. The quickest way to accomplish both is to use the background of “all genes” for that organism provided by an annotation source like RefSeq, Ensembl, etc. in .pannot (Partek annotation), .gff, .gtf, .bed, tab- or comma-delimited format. If the file is not already in a tab-separated or comma delimited format, you may import, modify, and save the file in the proper file format.

## Associating a spreadsheet with an annotation file

* Select **File** from the main toolbar
* Select **Genomic Database** under **Import** (Figure 1)

![Figure 1. Importing an annotation file](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-e4ed27c3431cec41a1c38a226d3e312ff2196e1c%2F2017-07-21%2010_22_50-Partek%20Genomics%20Suite%20-%201%20\(Gene%20List.txt\).png?alt=media)

* Select the annotation file; in this example, we select a .pannot file downloaded from Partek distributed library file repository – *hg19\_refseq\_14\_01\_03\_v2.pannot*
* Delete or rearrange the columns as necessary; we have placed the column with identifiers (should be unique ID) that correspond to our gene list first
* Select **File** then **Save As Text File...** to save the annotation file; we have named it *Annotation File* (Figure 2)

![Figure 2. Modified annotation file](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-c48f20780562dc30d56da88817b1e75d59b3f77d%2F2017-07-21%2010_27_39-Partek%20Genomics%20Suite%20-%202%20\(Annotation%20File.txt\).png?alt=media)

* Select (![](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-677c0247409ddb56a8e45cac06f6c21a9086ed15%2Fimage2017-7-14%2013_5_59.png?alt=media)) to close the annotation file

Now we can add the annotation file to our imported gene list.

* Right click *1 (gene\_list.txt)* in the spreadsheet tree
* Select **Properties** from the pop-up menu

This brings up the *Configure Genomic Properties* dialog (Figure 3).

![Figure 3. Selecting an annotation file using the Configure Genomic Properties dialog](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-19e31afcf7ba9564d9fac17b07f5853012c068f8%2F2017-08-14%2010_53_29-Configure%20Genomic%20Properties%20of%201.png?alt=media)

* Select **Browse** under *Annotation File*
* Choose the annotation file; we have chosen *Annotation File.txt*

If this is the first time you have used an annotation, the *Configure Annotation* dialog will launch. This is used to choose the columns with the chromosome number and position information for each feature. Our example annotation file has chromosome, start, and stop in separate columns.

* Select the proper column configuration options (Figure 4)

![Figure 4. Assigning columns for chromosome and genomic positions in the annotation file](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-5045a3493ce02e459f59425f85524257e569db84%2F2017-07-18%2013_28_00-Configure%20Annotation.png?alt=media)

* Select **Close** to return to the *Configure Genomic Properties* dialog
* Select **Set Column:** to open the *Choose column with gene symbols or microRNA names* dialog (Figure 5)

![Figure 5. Choosing the column in the annotation file with gene symbols or microRNA names](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-36779e1a3a3f433ecb2d09c16192ab663c1b3a88%2F2017-07-21%2010_30_03-Choose%20column%20containing%20gene%20symbol_microRNA%20name.png?alt=media)

* Select the appropriate column; here the default choice of **1. Symbol** is appropriate
* Select **OK** to return to the *Configure Genomic Properties* dialog
* Select the appropriate species and genome build options; we have selected **Homo sapiens** and **hg19** (Figure 6)

![Figure 6. The gene list is now fully configured with an annotation file and reference genome selected](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-1109b58d3b595af25417b740469ad7861599a856%2F2017-08-14%2010_55_27-Configure%20Genomic%20Properties%20of%201.png?alt=media)

* Select **OK**
* Select (![](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-0ab6c0750bffb9763676535d1cb057a3d2db0c45%2Fsave%20icon.png?alt=media)) to save the spreadsheet

The annotation file has been associated with the spreadsheet and additional tasks can now be performed on the data, e.g. since the annotation has genomic location, you can draw chromosome view on this data.

## Adding annotations to a spreadsheet

### Inserting annotations from an annotation file

If an annotation file has been associated with a spreadsheet, annotations from the file can be added as columns in the spreadsheet when each identifier is on a row.

* Right click on a column header
* Select **Insert Annotation**
* Select columns to add from *Column* Configuration; we have selected **Chromosome**, **Start**, and **Stop** (Figure 7)
* Select **OK**

![Figure 7. Adding an annotation column from the annotation file](https://1384254481-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJVEESmJAPppJ3ijFq5aR%2Fuploads%2Fgit-blob-f50411fbb3ac02d8e0a78de7e202a4336e52202b%2F2017-07-14%2010_42_25-Add%20Rows_Columns%20to%20Spreadsheet.png?alt=media)

## Additional Assistance

If you need additional assistance, please visit [our support page](http://www.partek.com/support) to submit a help ticket or find phone numbers for regional support.
