the Gene Ontology

  • Open menus
  • Home
  • FAQ
  • Downloads
  • Ontologies
  • Annotations
  • Database
  • Mappings to GO
  • Teaching Resources
  • Other files
  • FTP and CVS downloads
  • Tools
  • Browsers
  • Microarray tools
  • Annotation tools
  • Other tools
  • Submit New Tools
  • Documentation
  • Introduction
  • Annotation Guide
  • Evidence Code Guide
  • Component Ontology
  • Function Ontology
  • Process Ontology
  • File Format Guide
  • GO Database Guide
  • GO Slim Guide
  • Meeting minutes
  • Editorial Style Guide
  • About GO
  • GO Consortium
  • Publications
  • Citation Policy
  • Mailing lists
  • Interest Groups
  • GO People
  • Funding
  • Acknowledgements
  • Newsletter
  • Projects
  • Cardiovascular
  • Immunology
  • Reference Genomes
  • Contact GO
  • Site Map

GO Annotation File Format Guide

The Gene Ontology Consortium represents annotation data using a tab-delimited format, where each line represents a single link between a gene product (protein, gene, transcript, etc.) and a GO term with a certain evidence code and the reference to support the link. This page documents the format of these files. For more general information on annotation, please see the GO annotation guide.

  • Annotation File Fields
  • Definitions and requirements for field contents
  • Annotation File Format Quality Control Script
  • Errors Checked
  • Taxon IDs
  • Script command line options

Annotation File Fields

The flat file format comprises 15 tab-delimited fields; red text denotes required fields. See also the annotation fields page, with a table showing the columns in order and example annotations.

Fields in the annotation file
Column Content Required? Example
1 DB required SGD
2 DB_Object_ID required S000000296
3 DB_Object_Symbol required PHO3
4 Qualifier optional NOT
5 GO ID required GO:0003993
6 DB:Reference (|DB:Reference) required SGD_REF:S000047763|PMID:2676709
7 Evidence code required IMP
8 With (or) From optional GO:0000346
9 Aspect required F
10 DB_Object_Name optional acid phosphatase
11 DB_Object_Synonym (|Synonym) optional YBR092C
12 DB_Object_Type required gene
13 taxon(|taxon) required taxon:4932
14 Date required 20010118
15 Assigned_by required SGD

Definitions and requirements for field contents

DB
refers to the database from which the identifier in DB_Object_ID (column 2) is drawn. This is not necessarily the group submitting the file. If a UniProt ID is in column 2 then column 1 should be just UniProt.
must be one of the values from the set of GO database cross-references
this field is mandatory, cardinality 1
DB_Object_ID
a unique identifier in DB for the item being annotated
this field is mandatory, cardinality 1
The entry in the DB_Object_ID field of the association file is the identifier for the database object, which may or may not correspond exactly to what is described in a paper. For example, a paper describing a protein may support annotations to the gene encoding the protein (gene ID in DB_Object_ID field) or annotations to a protein object (protein ID in DB_Object_ID field).
DB_Object_Symbol
a (unique and valid) symbol to which DB_Object_ID is matched
can use ORF name for otherwise unnamed gene or protein
if gene products are annotated, can use gene product symbol if available, or many gene product annotation entries can share a gene symbol
this field is mandatory, cardinality 1
The DB_Object_Symbol field should be a symbol that means something to a biologist, wherever possible (a gene symbol, for example). It is not an ID or an accession number (the second column, DB_Object_ID, provides the unique identifier), although IDs can be used in DB_Object_Symbol if there is no more biologically meaningful symbol available (e.g., when an unnamed gene is annotated).
Qualifier
flags that modify the interpretation of an annotation
one (or more) of NOT, contributes_to, colocalizes_with
this field is not mandatory; cardinality 0, 1, >1; for cardinality >1 use a pipe to separate entries (e.g. NOT|contributes_to)
See also the documentation on qualifiers in the GO annotation guide
GO ID
the GO identifier for the term attributed to the DB_Object_ID
this field is mandatory, cardinality 1
DB:Reference
one or more unique identifiers for a single source cited as an authority for the attribution of the GO ID to the DB_Object_ID. This may be a literature reference or a database record. The syntax is DB:accession_number.
Note that only one reference can be cited on a single line in the gene association file. If a reference has identifiers in more than one database, multiple identifiers for that reference can be included on a single line. For example, if the reference is a published paper that has a PubMed ID, we strongly recommend that the PubMed ID be included, as well as an identifier within a model organism database. Note that if the model organism database has an identifier for the reference, that identifier should always be included, even if a PubMed ID is also used.
this field is mandatory, cardinality 1, >1; for cardinality >1 use a pipe to separate entries (e.g. SGD_REF:S000047763|PMID:2676709).
Evidence Code
see the GO evidence code guide for the list of valid evidence codes for GO annotations
this field is mandatory, cardinality 1
With (or) From
one of:
  • DB:gene_symbol
  • DB:gene_symbol[allele_symbol]
  • DB:gene_id
  • DB:protein_name
  • DB:sequence_id
  • GO:GO_id

this field is not mandatory overall, but is required for some evidence codes (see below and the evidence documentation for details); cardinality 0, 1, >1; for cardinality >1 use a pipe to separate entries (e.g. CGSC:pabA|CGSC:pabB)

Note: This field is used to hold an additional identifier for annotations using certain evidence codes (IC, IEA, IGI, IPI, ISS). For example, it can identify another gene product to which the annotated gene product is similar (ISS) or interacts with (IPI). More information on the meaning of with or from column entries is available in the evidence documentation entries for the relevant codes.

Cardinality = 0 is not recommended, but is permitted because cases can be found in literature where no database identifier can be found (e.g. physical interaction or sequence similarity to a protein, but no ID provided). Cardinality = 0 is not allowed for ISS annotations made after October 1, 2006. Annotations where evidence is IGI, IPI, or ISS and with cardinality = 0 should link to an explanation of why there is no entry in with. Cardinality may be >1 for any of the evidence codes that use with; for IPI and IGI cardinality >1 has a special meaning (see evidence documentation for more information). For cardinality >1 use a pipe to separate entries (e.g. FB:FBgn1111111|FB:FBgn2222222).

Note that a gene ID may be used in the with column for a IPI annotation, or for an ISS annotation based on amino acid sequence or protein structure similarity, if the database does not have identifiers for individual gene products. A gene ID may also be used if the cited reference provides enough information to determine which gene ID should be used, but not enough to establish which protein ID is correct.

'GO:GO_id' is used only when the evidence code is IC, and refers to the GO term(s) used as the basis of a curator inference. In these cases the entry in the 'DB:Reference' column will be that used to assign the GO term(s) from which the inference is made. This field is mandatory for evidence code IC.

The ID is usually an identifier for an individual entry in a database (such as a sequence ID, gene ID, GO ID, etc.). Identifiers from the Center for Biological Sequence Analysis (CBS), however, represent tools used to find homology or sequence similarity; these identifiers can be used in the with column for ISS annotations.

The with column may not be used with the evidence codes IDA, TAS, NAS, or ND.

Aspect
one of P (biological process), F (molecular function) or C (cellular component)
this field is mandatory; cardinality 1
DB_Object_Name
name of gene or gene product
this field is not mandatory, cardinality 0, 1 [white space allowed]
Synonym
Gene_symbol [or other text]
Note that we strongly recommend that gene synonyms are included in the gene association file, as this aids the searching of GO.
this field is not mandatory, cardinality 0, 1, >1 [white space allowed]; for cardinality >1 use a pipe to separate entries (e.g. YFL039C|ABY1|END7|actin gene)
DB_Object_Type
what kind of thing is being annotated
one of gene (SO:0000704), transcript (SO:0000673), protein (SO:0000358), protein_structure, complex
this field is mandatory, cardinality 1
The object type (gene, transcript, protein, protein_structure, or complex) listed in the DB_Object_Type field must match the database entry identified by DB_Object_ID. Note that DB_Object_Type refers to the database entry (i.e. does it represent a gene, protein, etc.); this column does not reflect anything about the GO term or the evidence on which the annotation is based. For example, if your database entry represents a gene, then 'gene' goes in the DB_Object_Type column, even if the annotation is to a component term relevant to the localization of a protein product of the gene. The text entered in the DB_Object_Name and DB_Object_Symbol can refer to the same database entry (recommended), or to a "broader" entity. For example, several alternative transcripts from one gene may be annotated separately, each with a unique transcript DB_Object_ID, but list the same gene symbol in the DB_Object_Symbol column.
Taxon
taxonomic identifier(s)
For cardinality 1, the ID of the species encoding the gene product.
For cardinality 2, to be used only in conjunction with terms that have the term 'interaction between organisms' as an ancestor. The first taxon id should be that of the organism encoding the gene or gene product, and the taxon id after the pipe should be that of the other organism in the interaction.
this field is mandatory, cardinality 1, 2; for cardinality 2 use a pipe to separate entries (e.g. taxon:1|taxon:1000)
Date
Date on which the annotation was made; format is YYYYMMDD
this field is mandatory, cardinality 1
Assigned_by
The database which made the annotation
one of the values from the set of GO database cross-references
Used for tracking the source of an individual annotation.
Default value is value entered in column 1 (DB).
Value will differ from column 1 for any that is made by one database and incorporated into another.
this field is mandatory, cardinality 1

Note that several fields contain database cross-reference (dbxrefs) in the format dbname:dbaccession. The fields are: GO ID (where dbname is always GO), DB:Reference, With, Taxon (where dbname is always taxon). For GO IDs, do not repeat the 'GO:' prefix (i.e. always use GO:0000000, not GO:GO:0000000)

Back to top

Annotation File Format Quality Control Script

This script is provided as a quality control check in an effort to validate the format and to partially check the data provided within the gene association files. This script is used on all gene association files before they are loaded into the GO database. The results of this filtering step are reported back to the submitting group.

This script is intended to be generic and to enforce the standards defined by the GO Consortium. Use this script to validate your gene association file before committing it to the archive. The checks provided define the minimum standard format for the repository. Suggestions are welcome for enhancements to this process. The Perl script is available from the GO CVS archive, and can be downloaded from the GO FTP site.

Submitted gene association files are committed to the GO CVS repository into the gene association file submissions directory. The checking and filtering script is run nightly on any newly deposited files by the GO Database staff at Stanford. The output of the script is placed in the gene association file directory and subsequently used to load the GO Database.

Errors Checked

The input file is checked for the following types of errors. If a row of the gene association file is found to contain an error it is removed from the final output file.

The script checks each line for the correct number of columns, the cardinality of the columns, looks for leading or trailing whitespace and does a number of specific checks for data in particular columns.

These specific checks include use of the defined terms for Qualifier, Evidence, Aspect, and DB Object type columns. The DB:Reference, Taxon and GO ID columns are checked for minimal form. The Date is also verified to match the YYYYMMDD format.

Column 1, and all database abbreviations used within the gene association file is checked to see that the abbreviation (case insensitive) is defined within the GO database cross-references.

The GO IDs mentioned in the file are checked, using the current gene_ontology.obo file. Rows with obsolete GO IDs are removed, as well as any row containing an invalid GO ID.

All IEA annotations that are over one year old are removed. This filtering step is completed using the date of annotation stated in column 14. Obviously, the validity of the information in the date column is thus very important.

Taxon IDs

A major component to the filtering is the requirement that particular taxon IDs can only be included within the association files provided by specific projects. For example, the taxon ID for Mus musculus (taxon:10090) is limited to the file provided by the Mouse Genome Informatics project. The GO consortium has defined a set of authoritative groups for the major model organisms in the table below.

Authoritative GO consortium groups for model organisms
Project nameGenus speciesCommon nameTaxon ID
Candida Genome Database (CGD)Candida albicanstaxon:5476
dictyBase (ddb)Dictyostelium sp., Dictyostelium discoideumtaxon:5782, taxon:44689, taxon:352472, taxon:366501
FlyBase (FB)Drosophila melanogasterfruit flytaxon:7227
GeneDB_LmajorLeishmania majortaxon:5664
GeneDB_PfalciparumPlasmodium falciparummalaria parasitetaxon:5833
GeneDB_SpombeSchizosaccharomyces pombefission yeasttaxon:4896
GeneDB_TbruceiTrypanosoma brucei TREU927taxon:185431
GeneDB_tsetseGlossina morsitans morsitanstaxon:37546
goa_chickenGallus galluschickentaxon:9031, taxon:208524, taxon:208525, taxon:208526, taxon:400035
goa_cowBos tauruscowtaxon:9913, taxon:297284, taxon:30523
goa_humanHomo sapienshumantaxon:9606
gramene_oryzaOryza alta, Oryza australiensis, Oryza barthii, Oryza brachyantha, Oryza coarctata, Oryza eichingeri, Oryza glaberrima, Oryza glumipatula, Oryza grandiglumis, Oryza granulata, Oryza latifolia, Oryza longiglumis, Oryza longistaminata, Oryza malampuzhaensis, Oryza meridionalis, Oryza meyeriana, Oryza minuta, Oryza nivara, Oryza officinalis, Oryza punctata, Oryza rhizomatis, Oryza ridleyi, Oryza rufipogon, Oryza sativa, Oryza sativa (indica cultivar-group), Oryza sativa (japonica cultivar-group), Oryza schlechteri, Oryza sp. IRGC 81916, Oryza sp. IRGC 105360, Panicum sp.rice, African rice, panicgrassestaxon:4528, taxon:4529, taxon:4530, taxon:4532, taxon:4533, taxon:4534, taxon:4535, taxon:4536, taxon:4537, taxon:4538, taxon:4539, taxon:29689, taxon:29690, taxon:39946, taxon:39947, taxon:40148, taxon:40149, taxon:52545, taxon:63629, taxon:65489, taxon:65491, taxon:77588, taxon:83307, taxon:83308, taxon:83309, taxon:110450, taxon:110451, taxon:127571, taxon:364099, taxon:364100
PAMGO_AtumefaciensAgrobacterium tumefacienstaxon:176299
Mouse Genome Informatics (MGI)Mus musculushouse mousetaxon:10090
Rat Genome Database (RGD)Rattus norvegicusNorway rattaxon:10116
Saccharomyces Genome Database (SGD)Saccharomyces cerevisiaebaker's yeast, brewer's yeast, also called budding yeasttaxon:4932, taxon:41870, taxon:285006, taxon:307796
The Arabidopsis Information Resource (TAIR)Arabidopsis thalianathale cresstaxon:3702
tigr_AphagocytophilumAnaplasma phagocytophilum HZtaxon:212042
tigr_BanthracisBacillus anthracis str. Amestaxon:198094
tigr_CburnetiiCoxiella burnetii RSA 493taxon:227377
tigr_ChydrogenoformansCarboxydothermus hydrogenoformans Z-2901taxon:246194
tigr_CjejuniCampylobacter jejuni RM1221taxon:195099
tigr_CperfringensClostridium perfringens ATCC 13124taxon:195103
tigr_CpsychrerythraeaColwellia psychrerythraea 34Htaxon:167879
tigr_DethenogenesDehalococcoides ethenogenes 195taxon:243164
tigr_EchaffeensisEhrlichia chaffeensis Arkansastaxon:205920
tigr_GsulfurreducensGeobacter sulfurreducens PCAtaxon:243231
tigr_HneptuniumHyphomonas neptunium ATCC 15444taxon:228405
tigr_LmonocytogenesListeria monocytogenes str. 4b F2365taxon:265669
tigr_McapsulatusMethylococcus capsulatus str. Bathtaxon:243233
tigr_NsennetsuNeorickettsia sennetsu Miyayamataxon:222891
tigr_PfluorescensPseudomonas fluorescens Pf-5taxon:220664
tigr_PsyringaePseudomonas syringae pv. tomato str. DC3000taxon:223283
tigr_Psyringae_phaseolicolaPseudomonas syringae pv. phaseolicola 1448Ataxon:264730
tigr_SoneidensisShewanella oneidensis MR-1taxon:211586
tigr_SpomeroyiSilicibacter pomeroyi DSS-3taxon:246200
tigr_Tbrucei_chr2Trypanosoma bruceitaxon:5691
tigr_VcholeraeVibrio cholerae O1 biovar eltortaxon:686
Wormbase (WB)Caenorhabditis eleganstaxon:6239
Zebrafish Information Network (ZFIN)Danio reriotaxon:7955

Script command line options

Usage help for the script is available with the -h option. The script is designed to be run from the go/gene-associations/submission directory within a GO CVS sandbox. By default the script needs the go/doc/GO.xrf_abbs and go/ontology/gene_ontology_edit.obo files. The input gene association file is read from STDIN by default, or from the specified file defined with the -i option.

Usage

A. check a file for any errors, obsolete GO IDs or old IEA annotations

filter-gene-association.pl -i gene_association.sgd.gz

B. filter any problems and output the validated lines, including headers

filter-gene-association.pl -i gene_association.fb.gz -w > filtered-output

C. check file without the taxid checking on, and write the bad lines to STDOUT

filter-gene-association.pl -i gene_association.fb.gz -p nocheck -e > bad-lines

System requirements

The script is written using basic Perl and should be portable to most systems. It has been tested on MacOSX with Perl 5.8.1 and Solaris with Perl 5.6.1 and greater.

Submitted by Mike Cherry, 2005-10-19

Back to top


Open Biomedical Ontologies logo

Last modified Tuesday, 01-Apr-2008 13:10:11 PDT
Cite GO • Terms of use • GO helpdesk
Copyright © 1999-Friday, 08-Aug-2008 14:33:31 PDT the Gene Ontology