diff --git a/_data/docs.yml b/_data/docs.yml index 777e5375..e8445867 100644 --- a/_data/docs.yml +++ b/_data/docs.yml @@ -26,5 +26,6 @@ - downloads - download-ontology - download-go-annotations + - download-go-cams - archives - deprecated-products-and-formats diff --git a/_docs/download-go-annotations.md b/_docs/download-go-annotations.md index 5319345b..cbce8ae3 100644 --- a/_docs/download-go-annotations.md +++ b/_docs/download-go-annotations.md @@ -5,10 +5,21 @@ redirect_from: /page/download-go-annotations --- # Download annotations -## GO annotation files + +## GO annotation formats + Released monthly + Taxon-specific -+ Available in [GAF format](/docs/go-annotation-file-gaf-format-2.1/) and [GPAD](/docs/gene-product-association-data-gpad-format/) + [GPI](/docs/gene-product-information-gpi-format/) files; all accessible from [http://current.geneontology.org/annotations/](http://current.geneontology.org/annotations/){:target="blank"} -+ Any errors or omissions in annotations should be reported by writing to the [GO helpdesk](http://help.geneontology.org/){:target="blank"} ++ Available formats: + + [GAF format](/docs/go-annotation-file-gaf-format-2.1/) + + [GPAD](/docs/gene-product-association-data-gpad-format/) + [GPI](/docs/gene-product-information-gpi-format/) + +## GO annotation download links +GAF files by species can be browsed and obtained from the [GAF download page](http://current.geneontology.org/products/pages/downloads.html) + +GAF, GPAD and GPI files are also available from the [/annotations/](http://current.geneontology.org/annotations/index.html){:target="blank"} of the current release on [http://current.geneontology.org](http://current.geneontology.org){:target="blank"} + +## Programmatic access to GO annotations +As for any resource in GO, GO annotations are accessible through the DOI-versioned release stored in [Zenodo](https://doi.org/10.5281/zenodo.1205159){:target="blank"} and can be retrieved using BDBag. Read more about [programmatic access](/docs/tools-guide/#programmatic-download-bdbag). -### Download annotations in GAF format (by species): [GO GAF files](http://current.geneontology.org/products/pages/downloads.html) +## Error or omission ? +Any errors or omissions in annotations should be reported by writing to the [GO helpdesk](http://help.geneontology.org/){:target="blank"} \ No newline at end of file diff --git a/_docs/download-go-cams.md b/_docs/download-go-cams.md new file mode 100644 index 00000000..8b4e5334 --- /dev/null +++ b/_docs/download-go-cams.md @@ -0,0 +1,30 @@ +--- +title: Download GO-CAMs +permalink: /docs/download-go-cams/ +--- + +# Download Causal Activity Models + +## GO-CAM formats ++ Released monthly ++ Taxon-specific ++ Available formats: + + [RDF Turtle (TTL)](https://www.w3.org/TR/turtle/){:target="blank"} + + [BlazeGraph Journal (JNL)](https://www.blazegraph.com/){:target="blank"} + + [Simple Interaction Format (SIF)](http://manual.cytoscape.org/en/stable/Supported_Network_File_Formats.html#sif-format){:target="blank"} + +## GO-CAM download links ++ [GO-CAM TTLs](https://s3.amazonaws.com/geneontology-public/gocam/GO-CAMs.ttl.zip) ++ [GO-CAM JNL](http://current.geneontology.org/products/blazegraph/blazegraph-production.jnl.gz) ++ [GO-CAM SIFs](https://s3.amazonaws.com/geneontology-public/gocam/GO-CAMs.sif.zip) + +**Note**: for use of SIFs in [Cytoscape](https://cytoscape.org/){:target="blank"}, we also provide a [gocam-styles.xml](https://s3.amazonaws.com/geneontology-public/gocam/gocam-styles.xml). Read more in the [GO-CAM documentation](docs/gocam-overview/#visualization-in-cytoscape) + +## Download GO-CAM by species +By browsing the [/products/ttl/](http://current.geneontology.org/products/ttl/index.html){:target="blank"} of the current release on [http://current.geneontology.org](http://current.geneontology.org){:target="blank"}. + +## Programmatic access to GO-CAMs +As for any resource in GO, GO-CAMs are accessible through the DOI-versioned release stored in [Zenodo](https://doi.org/10.5281/zenodo.1205159){:target="blank"} and can be retrieved using BDBag. Read more about [programmatic access](/docs/tools-guide/#programmatic-download-bdbag). + +## Error or omission ? +Any errors or omissions in annotations should be reported by writing to the [GO helpdesk](http://help.geneontology.org/){:target="blank"} diff --git a/_docs/gocam-overview.md b/_docs/gocam-overview.md new file mode 100644 index 00000000..4199544b --- /dev/null +++ b/_docs/gocam-overview.md @@ -0,0 +1,73 @@ +--- +title: GO-CAM overview +permalink: /docs/gocam-overview/ +--- + +# Introduction to GO-CAMs + +## What is a standard GO annotation ? + +A standard GO annotation is a gene product associated to a GO term, using an [evidence code](/docs/guide-go-evidence-codes/) and a supporting reference (a primary research article, for example). The GO term may come from any of the three aspects of the GO: [Molecular Function (MF)](http://geneontology.org/page/molecular-function-ontology-guidelines), [Biological Process (BP)](http://www.geneontology.org/page/biological-process-ontology-guidelines), or [Cellular Component (CC)](http://geneontology.org/page/cellular-component-ontology-guidelines). Gene products can correspond to proteins, complexes, or non-coding RNAs, and must be represented by a stable identifier. Gene identifiers may serve as representative of one or more gene products. The following is an illustration of a GO annotation: + +
+ +
+ +## What is a GO-CAM model ? + +A GO-CAM model is a combination of standard GO annotations to produce a network of annotations ("model"), that is a more complete model of biological function than the separate annotations. For example, a GO-CAM can represent how the activities of different gene products work together in a pathway or “biological program.” GO-CAM models can connect different pieces of information about the function of a gene product (joining together different annotations for the same gene product), and/or can connect functions of different gene products together by specifying how the activity of one gene product can affect the activity of another gene product. All connections in a GO-CAM model are made using clearly defined semantic relations from the [Relations Ontology](http://www.obofoundry.org/ontology/ro.html){:target="blank"}. + +## Relating annotations for the same gene product, from different aspects of GO + +One major difference between standard annotations and GO-CAM models is that the former does not have explicit relations between the gene product being annotated and the GO term. In GO-CAM models, using defined, semantic relations allows us to capture how a gene product’s molecular function relates to other aspects of GO. Specifically, in GO-CAM a gene product’s activity occurs_in a specific cellular component, meaning that gene product is active in that cellular component (the meaning of a standard GO cellular component annotation). In GO-CAM a gene product’s activity is executed as part_of a larger biological process (biological program) which is the meaning of a standard GO biological process annotation. In turn, a biological process can be nested inside an even larger biological process. + +## Linking different molecular activities + +Once the GO-CAM unit has been created (MF + BP + CC), these different units can be linked to each other (via the molecular activity) to represent a Causal Activity Model. Most of the causal relations are directly ([positively](http://www.ontobee.org/ontology/RO?iri=http://purl.obolibrary.org/obo/RO_0002629){:target="blank"} / [negatively](http://www.ontobee.org/ontology/RO?iri=http://purl.obolibrary.org/obo/RO_0002630){:target="blank"}) regulates and [directly provides input for](http://www.ontobee.org/ontology/RO?iri=http://purl.obolibrary.org/obo/RO_0002413){:target="blank"}, but there are other relations of greater and lesser specificity, depending on what is known. *Regulates* denotes the control of a downstream activity. *Provides input for* indicates there is no control, but an upstream function creates a molecular entity that is the target of the downstream function, such as in a metabolic pathway. + + +## Incomplete GO-CAMs + +The knowledge of biology is constantly evolving, therefore many models are incomplete, and details may be added as more information becomes available. + +## Noctual Platform to Curate GO-CAMs + +To learn more about our curation process, please visit the documentation of the [Noctua Curation Platform](http://wiki.geneontology.org/index.php/Noctua){:target="blank"}. + +## Converting GO-CAMs to standard GO annotations + +GO-CAMs can be “decomposed” into the standard GO annotations (connecting a gene product to a single GO term) that they are constructed from. This is accomplished in two ways. The first way is to simply take the GO terms that are connected to a gene product via a defined chain of relations. Specifically, for molecular function annotations, the decomposition starts with the MF (the activity, which is central), and follows the enabled_by edge to the gene product (or complex). For cellular component, it starts with the MF and then traces through enabled_by to get the gene product, and from MF through occurs_in to get the cellular component; biological process is similar except that it traces from MF through part_of to get the biological process (and more than one part_of if the process is nested inside a larger process). The second way is to apply logical reasoning to infer additional GO terms that are not explicitly in the model, but can be inferred from logical definitions (“equivalence axioms”) in the ontology. For instance, if a protein binding activity is enabled by a gene product, and that activity has a directly_regulates relationship to a protein kinase activity, the reasoner can infer that the protein binding activity also meets the definition of the GO term protein kinase activator activity, and that standard annotation will also be made. + +### Software + +Code handling the export of standard GO annotations from a GO-CAM model is provided by the open source [Minerva software](https://github.com/geneontology/minerva/){:target="blank"}, which is the data handling backend for Noctua. This code extracts an initial set of proposed standard GO annotations from a model, and then applies filters ensuring that appropriate metadata, such as an [ECO evidence code](http://www.evidenceontology.org/){:target="blank"}, is obtained for each annotation. + +### Converting GO-CAMs to Simple Interaction Format (SIF) + +The GO-CAM format allows representation of details that may be of little interest for certain applications. To enable the simple reuse and visualization of GO-CAMs, we provide two SIF exports that can easily be loaded for instance in [Cytoscape](https://cytoscape.org/){:target="blank"}. + +#### go-cam-complete-sif + +All molecular functions, biological processes and cellular components as well as their relationships are included in this export. This version essentially contains all the biological facts described in the GO-CAM but does not include any meta-data (e.g. describing evidence, xrefs, contributors, etc.). + +#### go-cam-activity-sif + +This export highlights the causal relationships between molecular functions (activities) and the genes carrying out these functions. In essence, they represent a protein-protein interaction network highlighting the positive and negative regulation relationships between activities. + +#### Visualization in Cytoscape + +We provide a Cytoscape styling to visualize GO-CAMs: [gocam-styles.xml](https://s3.amazonaws.com/geneontology-public/gocam/gocam-styles.xml). To import this style in Cytoscape: File > Import > Styles from File and select the gocam-styles.xml you downloaded. In the left Control Panel, select the “Style” tab and in the list, select the “GO-CAMs” style. From now on, any GO-CAM imported from a SIF file will be displayed using our recommended styling. To load a GO-CAM SIF export, select in the menu: + +> File > Import > Network from File + +Example of a GO-CAM rendered by cytoscape using the [gocam-styles.xml](https://s3.amazonaws.com/geneontology-public/gocam/gocam-styles.xml): + ++ +
+ + +#### Software +GitHub repository to create the SIF exports: [https://github.com/geneontology/gocam-sif-pyexport](https://github.com/geneontology/gocam-sif-pyexport){:target="blank"}. + +You can use this SIF export program with alternate parameters to create variations of the SIF exports from the Turtle files of GO-CAMs available on [GitHub](https://github.com/geneontology/noctua-models/tree/master/models){:target="blank"}. diff --git a/_sass/custom/_layout.scss b/_sass/custom/_layout.scss index 513de028..575803a4 100644 --- a/_sass/custom/_layout.scss +++ b/_sass/custom/_layout.scss @@ -459,7 +459,7 @@ $gutter-horizontal: 6rem; .card { position: relative; - min-height: 420px; + padding: 10px; &__picture { background-size: cover; @@ -475,6 +475,8 @@ $gutter-horizontal: 6rem; &:hover { cursor: pointer; + border: 2px solid rgba(0, 0, 120, 0.2); + border-bottom: none; } &__dna--red { @@ -483,7 +485,7 @@ $gutter-horizontal: 6rem; background-position: center; } - &__dna--blue { + &__gocam { background-image: linear-gradient(to right bottom, rgba(0, 68, 255, 0.1), rgba(0, 0, 0, 0.1)), url(../assets/NEDD4-noctua.png); background-blend-mode: hard-light; } @@ -492,27 +494,36 @@ $gutter-horizontal: 6rem; background-image: linear-gradient(to right bottom, #11a92a, #000000), url(../assets/gene.jpeg); } + &__standard-annotation { + background-image: linear-gradient(to right bottom, rgba(0, 0, 0, 0), rgba(0, 0, 0, 0.1)), url(../assets/standard-go-annotation.png); + background-blend-mode: normal; + background-position: center; + background-size: contain; + background-repeat: no-repeat; + background-position-y: inherit; + } + } &__heading { - font-size: 2.8rem; + font-size: 2.5rem; font-weight: 300; text-transform: uppercase; text-align: right; color: rgb(255, 255, 255); position: absolute; top: 9rem; - right: 3rem; + right: 2.5rem; background-image: linear-gradient(to right bottom, rgba(0, 23, 79, 1), rgba(43, 65, 138, 0.25)); border-radius: 15px; padding: 5px 12px; } &__container { - min-height: 400px; + min-height: 470px; padding: 10px; - margin: 10px 5px; + margin: 10px 0px; box-shadow: rgba(0, 0, 0, 0.15) 0px 1.5rem 4rem; border-radius: 3px !important; background-color: rgb(255, 255, 255) !important; @@ -533,7 +544,7 @@ $gutter-horizontal: 6rem; &__bottom { position: absolute; - bottom: 20px; + bottom: 24px; text-align: end; right: 35px; } diff --git a/assets/GO-CAM-SIF-cytoscape-d.png b/assets/GO-CAM-SIF-cytoscape-d.png new file mode 100644 index 00000000..fa4e350c Binary files /dev/null and b/assets/GO-CAM-SIF-cytoscape-d.png differ diff --git a/assets/standard-go-annotation.png b/assets/standard-go-annotation.png new file mode 100644 index 00000000..125661dd Binary files /dev/null and b/assets/standard-go-annotation.png differ diff --git a/index.html b/index.html index 82070153..3483875c 100644 --- a/index.html +++ b/index.html @@ -315,10 +315,16 @@Statements, based on specific, traceable scientific evidence, asserting that a specific gene product is a real exemplar of @@ -372,10 +378,39 @@
+ GO Causal Activity Model (GO-CAM) provides a structured framework to link standard GO annotations into a more complete model of a biological system. +
+ + +Tools to curate, browse, search, visualize and download both the ontology and annotations. Bioinformatic Guides (Notebooks) and simple API access to integrate GO into your research.