Skip to content

Commit

Permalink
fix lov lookup endpoint
Browse files Browse the repository at this point in the history
  • Loading branch information
aksanoble committed Jan 25, 2022
1 parent c7fe0b5 commit 0d65247
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 24 deletions.
4 changes: 2 additions & 2 deletions OntologySearch.gs
Original file line number Diff line number Diff line change
Expand Up @@ -134,15 +134,15 @@ function searchLOV(term) {
var restriction = findRestrictionForCurrentColumn("LOV");
var vocabularies = getLinkedOpenVocabularies();

var url = "http://lov.okfn.org/dataset/lov/api/v2/search?q=" + term;
var url = "https://lov.linkeddata.es/dataset/lov/api/v2/search?q=" + term;
var vocabShortname;
var vocabURI;
if (restriction.source) {
vocabShortname = restriction.ontologyId.replace(/\s/g, ""); //string trim
if (vocabularies[vocabShortname]) {
vocabURI = vocabularies[vocabShortname].uri;
if (vocabURI)
url = "http://lov.okfn.org/dataset/lov/api/v2/search?q=" + term + "&voc=" + vocabURI;
url = "https://lov.linkeddata.es/dataset/lov/api/v2/search?q=" + term + "&voc=" + vocabURI;
} else {
url = "";
}
Expand Down
33 changes: 12 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,8 @@

Version 4: [![DOI](https://zenodo.org/badge/DOI/10/5281/zenodo.5227312.svg)](https://doi.org/10.5281/zenodo.5227312)


Version 3: [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.221457.svg)](https://doi.org/10.5281/zenodo.221457)


Version 2: <a href="https://doi.org/10.5281/zenodo.11085"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.11085.svg" alt="DOI"></a>
<br/>
<br/>
Expand All @@ -18,6 +16,7 @@ OntoMaton facilitates ontology search and tagging functionalities within Google
<br/>

### Read the Publication...

Access the Open Access <a href="http://bioinformatics.oxfordjournals.org">Bioinformatics</a> article on OntoMaton [here](http://dx.doi.org/10.1093/bioinformatics/bts718).

<i>Eamonn Maguire, Alejandra González-Beltrán, Patricia L. Whetzel, Susanna-Assunta Sansone, and Philippe Rocca-Serra
Expand All @@ -28,22 +27,21 @@ Please, note that at the time of the publication, OntoMaton was powered by the <

- we upgraded the code to [Google Add-ons for Docs and Sheets](http://googledrive.blogspot.it/2014/03/add-ons.html), which [deprecated the Apps Script applications and the Script Gallery](http://googleappsdeveloper.blogspot.co.uk/2014/06/deprecating-script-gallery-in-old.html), used in the original OntoMaton version
- we upgraded to the new BioPortal API for searching ontology terms and annotator services (see BioPortal 4.0 release notes), as the old API was deprecated in 2014
- we extended the ontology search functionality to support REST services from the <a href="http://lov.okfn.org/">Linked Open Vocabularies</a> and the <a href="https://www.ebi.ac.uk/ols/">EBI Ontology Lookup Service</a>, thus now allowing ontology term searches over three separate services.

For more information, see [our blog posts on OntoMaton](https://isatools.wordpress.com/?s=ontomaton).
- we extended the ontology search functionality to support REST services from the <a href="https://lov.linkeddata.es/">Linked Open Vocabularies</a> and the <a href="https://www.ebi.ac.uk/ols/">EBI Ontology Lookup Service</a>, thus now allowing ontology term searches over three separate services.

For more information, see [our blog posts on OntoMaton](https://isatools.wordpress.com/?s=ontomaton).

### Installation

With the new add on infrastructure, installation is very easy.
With the new add on infrastructure, installation is very easy.

1. Click on the 'Add-ons' menu item in your Google Spreadsheet:

<div align="center">
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig1.png" width="500">
</div>

2. Click on 'Get add-ons...' and then search for 'OntoMaton':
2. Click on 'Get add-ons...' and then search for 'OntoMaton':

<div align="center">
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig2.png?" height="200">
Expand All @@ -67,8 +65,7 @@ Here you can click on the image and read more about OntoMaton:
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig5.png" width="500">
</div>


4. You'll then have the OntoMaton app installed.
4. You'll then have the OntoMaton app installed.

<div align="center">
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig6.png" width="500">
Expand All @@ -82,32 +79,30 @@ You can access it through the 'Add On' menu option.

### Ontology Search

From OntoMaton, you can search three different services within one tool: the [NCBO Bioportal](http://bioportal.bioontology.org/), [Linked Open Vocabularies](http://lov.okfn.org) and [EBI Ontology Lookup Service](https://www.ebi.ac.uk/ols/), and insert the terms in your Google Spreadsheet directly. Full term provenance is recorded for you and later downstream analysis.
From OntoMaton, you can search three different services within one tool: the [NCBO Bioportal](http://bioportal.bioontology.org/), [Linked Open Vocabularies](https://lov.linkeddata.es) and [EBI Ontology Lookup Service](https://www.ebi.ac.uk/ols/), and insert the terms in your Google Spreadsheet directly. Full term provenance is recorded for you and later downstream analysis.

<div align="center">
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig8.png" width="700">
</div>

### Ontology Tagging

With OntoMaton, you can select a number of spreadsheet cells and then 'tag' them. This means that OntoMaton will take the terms in the cells and send them to BioPortal's Annotator service. The results will come back as a list of the free text terms, showing for each all matches in BioPortal.
With OntoMaton, you can select a number of spreadsheet cells and then 'tag' them. This means that OntoMaton will take the terms in the cells and send them to BioPortal's Annotator service. The results will come back as a list of the free text terms, showing for each all matches in BioPortal.

<div align="center">
<img src="https://isatools.files.wordpress.com/2014/04/screen-shot-2014-04-16-at-18-55-27.png?h=500"/>
</div>

### Configuring OntoMaton - Settings


<div align="center">
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig9.png" width="500">
</div>

From the settings screen, you can configure:

* How terms should be inserted in to the spreadsheet when not in 'ISA mode' (where the next columns aren't named 'Term Source REF' or 'Term Source Accession'). The two options are as either as a hyperlink to the term in Bioportal/OLS/LOV or as a term name with the hyperlink in parentheses.
* Restrictions, which specify for zero or more columns (with a name in the first cell), restrictions that should be placed on the search space per each of the ontology lookup services we use (Bioportal/OLS/LOV) E.g. the column 'Label' is restricted to terms from the Chemincal Entities of Biomedical Interest ontology (ChEBI). Please, note that for instance if a column has a restriction over the BioPortal service, the restiction will not have an effect if searching terms with OLS.

- How terms should be inserted in to the spreadsheet when not in 'ISA mode' (where the next columns aren't named 'Term Source REF' or 'Term Source Accession'). The two options are as either as a hyperlink to the term in Bioportal/OLS/LOV or as a term name with the hyperlink in parentheses.
- Restrictions, which specify for zero or more columns (with a name in the first cell), restrictions that should be placed on the search space per each of the ontology lookup services we use (Bioportal/OLS/LOV) E.g. the column 'Label' is restricted to terms from the Chemincal Entities of Biomedical Interest ontology (ChEBI). Please, note that for instance if a column has a restriction over the BioPortal service, the restiction will not have an effect if searching terms with OLS.

### Restricting OntoMaton's search space

Expand All @@ -119,19 +114,17 @@ From the settings screen, you can configure:
<img src="https://github.com/ISA-tools/OntoMaton/blob/master/figures/ontomaton-fig13.png" width="600">
</div>


When you add a restriction using the 'Settings' panel for the first time, a 'Restrictions' sheet will be added automatically. This sheet will have the following column headers:
```Column Name | Ontology | Branch | Version | Ontology Name | Service```. Then you may define for a particular column header in your spreadsheet what ontology should be searched (or list of ontologies) over what service (BioPortal, OLS or LOV). A restriction will only apply if using the corresponding service for search.
`Column Name | Ontology | Branch | Version | Ontology Name | Service`. Then you may define for a particular column header in your spreadsheet what ontology should be searched (or list of ontologies) over what service (BioPortal, OLS or LOV). A restriction will only apply if using the corresponding service for search.

Additionally, within one ontology restriction, for BioPortal searches, you can restrict to a particular branch of an ontology, providing a way to further restrict the search space.

An example of a google spreadsheet with such functionality can be viewed here: https://docs.google.com/spreadsheet/ccc?key=0Al5WvYyk0zzmdDNLeEcxWHZJX042dS0taXJPNXpJMHc


### Video Tutorial

Access the video tutorial showing how to install and use OntoMaton (version 1) [here](http://www.youtube.com/watch?v=Qs0nxGBfQac&feature=player_embedded).

### Templates

Templates can be found through accessing them on the google templates site. OntoMaton templates are [here](https://drive.google.com/templates?type=spreadsheets&q=ontomaton).
Expand All @@ -149,5 +142,3 @@ This work is licensed through a [CPAL license](http://isatab.sf.net/licenses/Ont
### Merchandise

Fancy an OntoMaton t-shirt? We haven't got any to give away...yet! But...you can buy one of these rather snazzy t-shirts from [Spreadshirts](http://antarctic-design.spreadshirt.co.uk/men-s-classic-t-shirt-A22910590/customize/color/2) for just £15!


2 changes: 1 addition & 1 deletion Settings.gs
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,7 @@ function getBioPortalOntologies() {

function getLinkedOpenVocabularies(){

var vocabsURL = "http://lov.okfn.org/dataset/lov/api/v2/vocabulary/list";
var vocabsURL = "https://lov.linkeddata.es/dataset/lov/api/v2/vocabulary/list";
var cache = CacheService.getPrivateCache();

if (cache.get("lov_fragments") == null) {
Expand Down

0 comments on commit 0d65247

Please sign in to comment.