Advanced Annotation Search

From Protege Wiki
Revision as of 17:52, July 17, 2012 by Mark Helenurm (talk | contribs) (Basic Syntax)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Advanced Annotation Search

by Mark Helenurm

Screenshot

Type View
Author(s) Mark Helenurm
Last Update July 17, 2012
License not available
Homepage not available
For Application
Topic(s)
Affiliation

A search function to find entities based on annotation data.

Versions & Compatibility

This section lists available versions of Advanced Annotation Search.

VersionCompatible withDependencies
Advanced Annotation Search 1.0.1

If you click on the button below to add a new version of Advanced Annotation Search, you will be asked to define a page title for the new version. Please adhere to the naming convention of Advanced Annotation Search X.X.X when you define the new page!


Usage Guide

Basic Syntax

Expressions you type in the text field are broken down into "terms". A term is either a single word, or an item in between quotation marks (""). For a basic search, you can type a single term into the box (e.g. "dorsal fin" or puppies). For a more complex expression, you use groups of three terms (ingeniously called triples), which are broken down into the annotation type, the operator, and the search term. For example, if you want all entities that have comment annotations that contain the term "dermal bone", you would search: comment contains "dermal bone". If you want to search for an even more complex expression (for example, you know the comment annotation contains the phrase "phenoscape" and the age annotation is greater than 19), you break the two search terms up with a logical operator (and, or, exclusiveor). So in this example, your search string would be: comment contains phenoscape and age > 19.

Operators

Operation Operator Symbols (what you type in the search box) Domain
Contains contains, ~ Strings
Doesn't Contain doesntcontain, !~ Strings
Equals equals, isequalto, =, == Strings, Numbers
Doesn't Equal doesntequal, != Strings, Numbers
Greater Than greaterthan, > Numbers
Less Than lessthan, < Numbers
Greater Than or Equal to greaterthanorequalto, gequalto, gequal, >= Numbers
Less Than or Equal to lessthanorequalto, lequalto, lequal, <= Numbers

Logical Operators

Logical Operation Operator Symbols
Groupers (, )
And and, &, &&
Exclusive Or exclusiveor, ^
Or or, |, ||

(order of operations corresponds to table position)

Examples

Single-Term Expressions

"dermal bone is absent"


puppies


"im in here somewhere"


Two-Term Expressions

comment contains "dermal bone ain't here" or comment contains "dorsal fin is present"


age >= 49 and age <= 70


comment !~ "confused" or comment ~ "i cnat spel wright"


Three or More-Term Expressions

(label contains "yes i'm here" || comment contains "yes i'm here") & age < 50


(comment ~ "dermal bone" ^ comment ~ "dorsal fin") && age > 30 && yeardiscovered == 1990