Difference between revisions of "App/ontology"

From mx Help Wiki
Jump to: navigation, search
m
m (Configuration)
Line 106: Line 106:
 
=== Configuration ===
 
=== Configuration ===
  
You can use an ontology created in your own project, or one created in another project that you (the creator) are a member of.  If you want to use another project's click on 'settings' for your project, then 'edit'. At the bottom choose the project under 'Default Public Ontology'. This portion of the mx software is rapidly developing since Summer 2010 due to support in part, by the National Science Foundation under grant DBI 0850223.
+
You can use an ontology created in your own project, or one created in another project that you (the creator) are a member of.  If you want to use another project's click on 'settings' for your project, then 'edit'. At the bottom choose the project under 'Default Public Ontology'. This portion of the mx software is rapidly developing since Summer 2009 due to support in part, by the National Science Foundation under grant DBI 0850223.
  
 
=== In App usage ===
 
=== In App usage ===

Revision as of 12:28, 13 October 2009

Contents

Overview

Ontologies in mx consist of user definable terms, relationship types, and relationships among terms. Terms can be tagged. References can be tied directly to terms through definitions, or through tags. Images can be attached to terms using figures.

Welcome Screen

Error creating thumbnail: Unable to save thumbnail to destination


When you see this screen you are ready to begin! There are five tabs across the top:

  • Ontology - this is the default screen (the one you see here)
  • OTUs - the taxa to which morphological concepts apply
  • Refs - where are references, keywords, tags, and serials are added and edited
  • Images - images are uploaded here and can be tied to terms. We may be using Morphbank for this function, though we can discuss it further.
  • Tags - the master list of tags for your perusal.

There are also links on the right for adding a term, listing all the terms and viewing the latest edits (check under "more options," where you will also find options to dump the ontology as an OBO flat file).


Search for Term

Error creating thumbnail: Unable to save thumbnail to destination



Before you enter a term you should see if it is already in the database. As you type into the search box the terms will automatically appear. If you see what you are looking for click that term and the press 'Show.' The results in the drop down include: name of term, 2. internal mx id, 2. xref (if applied), 3. term curator and year.

Add a Term

Error creating thumbnail: Unable to save thumbnail to destination


Adding terms is also fairly easy:

  1. Keystroke the word(s) (all lowercase unless a capital is warranted, e.g., for proper names like Waterston's organ)
  2. Add a definition in genus-differentia format that starts with a capital letter and ends with a period.
  3. Add OBO dbxref if from another ontology at OBO Foundary.
  4. Tie the term to the reference from which the definition was copied verbatim or from which the concept was derived. Curators are added to the references so they appear in the search (see example image)
  5. Tie it to the highest taxon for which this term applies
  6. Choose the language if not English.



Batch Upload

Error creating thumbnail: Unable to save thumbnail to destination



You can also batch load a list of terms you have in simple text.


Add a Relationship

Error creating thumbnail: Unable to save thumbnail to destination


Once the term is added you'll need to add its relationship(s) to other terms. Previously added relationships will appear at the bottom of the page.



Add Tags

Error creating thumbnail: Unable to save thumbnail to destination


Adding a tag (App/tag) is an easy way to comment on a particular term or to add alternative definitions and spellings (e.g., the plural spelling). There are a number of keywords already in the database: e.g., 'alternative definition' (for different verbal descriptions of the same concept - NOT entirely different definitions, which should have their own entries), 'plural' for plural spellings that are obvious, 'remove' (terms you think should go into other ontologies), 'comment.' Simply click the 'Tag' link under 'functions' on the left. The light red overlay will appear and you can tie a keyword, a reference, page numbers, and your comments to this term.

Mark Up Your Definitions

Error creating thumbnail: Unable to save thumbnail to destination


The 'markup definition' link highlights and links to terms in the definition that are already in the ontology

Manage the Ontology

Error creating thumbnail: Unable to save thumbnail to destination



Navigate and Create within a Tree

Error creating thumbnail: Unable to save thumbnail to destination



Filter by Tags

Error creating thumbnail: Unable to save thumbnail to destination



Filter by Personally Edited

Error creating thumbnail: Unable to save thumbnail to destination



Extract Terms from a Block of Text

Error creating thumbnail: Unable to save thumbnail to destination



Use

General information

There is some information on how the ontology is being used here at the Hymenoptera Anatomical Ontology wiki. A public example of the ontology in use can be found here. Since

Configuration

You can use an ontology created in your own project, or one created in another project that you (the creator) are a member of. If you want to use another project's click on 'settings' for your project, then 'edit'. At the bottom choose the project under 'Default Public Ontology'. This portion of the mx software is rapidly developing since Summer 2009 due to support in part, by the National Science Foundation under grant DBI 0850223.

In App usage

Aside from the ontology tab there are various places the ontology can be applied or used in your project. Character descriptions can be marked-up after doing character->show, and clicking on the 'markup description'.

API

A undocumented API exists for remote queries against the database (see the search action in the public controller in the source code), we're hoping to improve this and make it public soon.

Personal tools