Difference between revisions of "BioPortal FAQ"
m (fixed the bad link, I hope)
Revision as of 17:59, 26 February 2019
Frequently Asked Questions (FAQ)
- 1 General
- 2 Ontology Content
- 3 NCBO Products
- 4 Details
- 4.1 Ontology Metadata
- 4.2 OBO Format
- 4.3 Using Protege with OBO ontologies
- 4.4 OBD
Advancing biology and medicine with tools and methodologies for the structured organization of knowledge.
What is NCBO?
The National Center for Biomedical Ontology (http://www.bioontology.org) is a consortium of leading biologists, clinicians, informaticians, and ontologists who develop innovative technology and methods that allow scientists to create, disseminate, and manage biomedical information and knowledge in machine-processable form. Our vision is that all biomedical knowledge and data are disseminated on the Internet using ontologies, such that the knowledge and data are semantically interoperable and useful for furthering biomedical science and clinical care. The Center’s software and technologies include BioPortal, Phenote+, the NCBO Resource Index, and the NCBO Annotator. Partner technologies include LexGrid, Protege, and Jambalaya. The Center collaborates with biomedical researchers conducting Driving Biological Projects (DBPs) to enable their research and to stimulate technology development in the Center. The Center is undertaking outreach and educational activities to train the future generation of researchers in using biomedical ontologies and the Center’s sfotware to enhance scientific discovery.
What is an ontology?
An ontology is a formal representation of a set of concepts/nodes within a domain and the relationships between those concepts. It is used to reason about the properties of that domain, and may be used to define the domain.
Where are the ontologies?
Ontologies are available from BioPortal at http://bioportal.bioontology.org.
How do I submit an ontology?
The current protocol is:
1) Go to BioPortal at http://bioportal.bioontology.org
2) If you haven't already, click on the "Register" link in the top right hand corner.
3) After you have registered as a user, "Sign In" as that user.
4) Click on the "Browse" tab (or click on the following link: http://bioportal.bioontology.org)
5) Click on the "Submit Ontology" button and follow the instructions.
How do I cite BioPortal?
Noy NF, Shah NH, Whetzel PL, Dai B, Dorf M, Griffith N, Jonquet C, Rubin DL, Storey MA, Chute CG, Musen MA. BioPortal: ontologies and integrated data resources at the click of a mouse. Nucleic Acids Res. 2009 Jul 1;37(Web Server issue):W170-3. Epub 2009 May 29. PubMed PMID: 19483092; PubMed Central PMCID: PMC2703982.
How do I go about building an ontology?
There are a plethora of tools for building ontologies. Below are two preferred tools for building OWL and OBO ontologies:
1) Protege (http://protege.stanford.edu/) - OWL ontologies
2) OBOEdit (http://oboedit.org/) - OBO ontologies
What is the OBO Foundry?
A collaborative experiment, involving a group of OBO ontology developers who have agreed in advance to the adoption of a growing set of principles specifying best practices in ontology development. These principles are designed to foster interoperability of ontologies within the broader OBO framework, and also to ensure a gradual improvement of quality and formal rigor in ontologies, in ways designed to meet the increasing needs of data and information integration in the biomedical domain. See http://obofoundry.org/
What is BioPortal?
A Web-based application for searching, sharing, visualizing, and analyzing a large repository of biomedical ontologies, terminologies, and ontology-based annotations. BioPortal is available at: http://bioportal.bioontology.org/. All content of BioPortal is also accessible via RESTful web services. To learn more about how to use NCBO technology in your software see the page Using NCBO Technology In Your Project
BioPortal allows for mappings between terms, bulk export of mappings, visualization of terms and relationships within ontologies, notes, and navigation of multiple ontologies through tabbed browsing. To see a demo of BioPortal, please visit http://www.bioontology.org/BioPortal.
What is the NCBO Resource Index?
A set of ontology-based annotations of biomedical data. These annotations have been generated automatically via the NCBO Resource Index workflow. The annotations can be accessed from BioPortal, either from from the All Resources tab to search for term annotations or from the Resource Index tab to browse annotations for an individual term. This tool enables researchers to search for biomedical resources associated (or annotated) with specific ontology terms.
What is the NCBO Annotator?
The NCBO Annotator is a text annotation tool that uses mgrep, developed by the University of Michigan, as the entity recognizer and the entire library of BioPortal ontologies as the dictionary of terms. This tool can be accessed from BioPortal and also via programmatic access directly to the Web service.
I have a lot of data to analyze. How can I use the API to access BioPortal products efficiently?
This Annotator Optimizing and Troubleshooting page has many tips that apply to many API requests, not just the NCBO Annotator.
What is Phenote?
A Java client application for manual creation and storage of biomedical annotations (starting with phenotype annotations) using terms from multiple ontologies.
What is Open Biomedical Data?
A database of manually generated biomedical annotations (starting with phenotype annotations) summarizing key attributes such as anatomy, phenotype, and genetic features. The annotations are currently loaded directly from a Phenote file, which contains the manually created annotations.
incomplete is-a paths
Many OBO ontologies are currently incomplete with respect to all classes/terms having an is-a parent. Many tools (including OBO-Edit and AmiGO) deliberately allow the conflation of relations when presenting the ontology as a DAG or a tree to the user. However, other tools (including Protege and SWOOP) do not. This means that some OBO ontologies can look unusual when viewed with these other tools (lots of classes appear at the root level).
This is currently being addressed by the maintainers of OBO ontologies. An effort is underway to complete the is-a parentage in the GO cellular component ontology (biological process will be more difficult). The Plant Ontology Consortium are completing the is-a parentage in the plant anatomical structure ontology.
Until this work is complete, some OBO ontologies may look unusual when viewed in conventional ontology browsing and editing tools. With some of these tools, there may be some configurations which allow other relations to be conflated with the is-a relation when presenting the ontology as a DAG or tree view.
One option is to automatically create an is-a parent to the ontology root for every non-root class/term which lacks any is-a parents. Note that this may create inconsistencies in the ontology if the genuine is-a parent is somewhere deeper in the ontology hierarchy; nevertheless this step may be necessary before presenting some OBO ontologies to tools such as reasoners.
Ontology metadata represented in BioPortal uses the Ontology Metadata Vocabulary (OMV) format to store all ontology meta data. Please see the following web site for more information on the format (http://omv.ontoware.org/). To view in BioPortal, see BioPortal Metadata and to read more about how OMV is used in BioPortal see BioPortal Metadata Requirements
Questions about the OBO text and xml formats
What is OBO Format?
Is OBO Format different from the old GO format?
Yes. The old dag-edit format (i.e. the one in which indentation was used to denote the GO hierarchy) is STRONGLY deprecated.
Where can I find the spec?
You can find details on the 1.0 spec on the GO home page http://www.geneontology.org/GO.format.shtml#oboflat
This spec is somewhat underspecified
The 1.2 spec is in preparation, and will be released to coincide with the first production OBO-Edit release sometime early in 2006
You can find a preliminary version of the spec here: HTML -- http://www.godatabase.org/dev/doc/obo_format_spec.html PDF -- http://www.godatabase.org/dev/doc/obo_format_spec.pdf Ascii text -- http://www.godatabase.org/dev/doc/obo_format_spec.txt
Why not use XML?
There is also an obo-xml format. See
Currently only available as DTD. Relax-NG and XSD coming soon.
Is there a UML model?
Yes, there is a UML translation of the obo format in progress, produced by Harold Solbrig of Mayo clinic; see:
What tools support Obo-Format?
The following are *ontology* tools that support the OBO format. There are many other tools for the analysis of gene ontology data which also happen to read the OBO format - see http://www.geneontology.org/GO.tools.shtml for a list
- (naturally!). You should use this rather than DAG-Edit (DAG-Edit still supports obo-1.0 format), as DAG-Edit is deprecated as of 2006.
- developed by Stuart Aitken as part of http://www.xspan.org. COBRA is a java ontology editor/viewer for aligning ontologies
Using Protege with OBO ontologies
You have two options here - use the Protege OBO plugin, or convert to a format which Protege understands.
The OBO plugin was developed at the University of Washington, and is no longer supported.
You can convert any obo-format file to OWL and use Protege-OWL (but not Protege-classic); see the next entry.
Note that when you look at many of the OBO ontologies in Protege (classic or Protege-OWL) you will see that there are large amounts of classes apparently at the root level. This is because OBO ontologies have historically not been complete with respect to all classes having a superclass (is-a parent). This is currently being addressed. See the FAQ entry on this subject.
Can I convert Obo-format to OWL?
Yes. There are multiple ways to convert ontologies between OWL and OBO format.
- Using the owl-api
- Using Protege 4
- Protege 4 uses the owl-api which is able to open both OWL and OBO format ontologies.
- Using the xslts included in go-perl.
- Download and install: http://search.cpan.org/~cmungall/go-perl/
- Then run the script
- go2owl myontology.obo. This functionality will soon be available from oboedit
- For more details on the mapping, see: http://www.fruitfly.org/~cjm/obol/doc/mapping-obo-to-owl.html
OK, but can I just download OBO ontologies as OWL without doing the conversion myself?
You can, at least for some OBO ontologies. This is an experimental service, and will eventually be subsumed into the services provided by NCBO:
Can I convert Obo-format files to Protege-classic?
Not yet. In theory it should not be hard to provide an XSL for this. The reverse transformation may be more difficult.
What is OBD?
OBD is a database for storing data typed using OBO ontologies
Where is it?
Is there a demo?
See the above URL for now