Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

RESTful Web Services

OpenCGA implements a comprehensive and well-designed REST web service API, this consists of more than 200 endpoints that allow to query and fully operate all web services to allow querying and operating data in OpenCGA. You can get more info at RESTful Web Services page.

We have implemented three different ways to query and operate OpenCGA using through the REST web service services API:

  • REST Client Libs: four different client libraries have been developed: Java, Python, R and Javascript. This allows a easy integration in any bioinformatic pipeline.implemented to ease the use of REST web services, This allows bioinformaticians to easily integrate OpenCGA in any pipeline. The four libraries are equally functional and fully maintained, these are Java, Python (available at PyPI), R and JavaScript
  • Command Line: users and administrators can use opencga.sh command line to query and operate OpenCGA. 
  • IVA Web Application: an interactive web application called IVA has been developed to query and visualisation OpenCGA data.

OpenCGA Demo

We have deployed a public demo installation to facilitate the testing and development for all users. We have loaded and indexed and annotated 5 five different datasets organised in 3 projects and 5 studies, these cover the most typical data use cases today such as multi-sample VCF, family data exomes and genomes; or somatic callscancer somatic data. All documentation examples and tutorials use this demo installation.

Connecting to demo installation

OpenCGA demo REST URL is available at:

Code Block
http://bioinfo.hpc.cam.ac.uk/opencga-prod/ 

you can check REST API and documentation at http://bioinfo.hpc.cam.ac.uk/opencga-prod/webservices/.

We have created a read-only user called demouser with password demouser. This user is As in most OpenCGA installations where normal users are not the owner owners of the data but , demouser has been given VIEW access to all demo user data in all studies, this is a very common configuration in OpenCGA installations OpenCGA  where the owner of the data grant access to other users. In this demo installation the owner of the data is demo user, while demouser user is the public  user created to query data.

Indexed Data

This demo consists of three projects and five studies. These represents different assembly assemblies and type of data types such as multi sample VCF, aggregated VCF or family genome or exome. The data is organised in 3 projects and 5 studies. You can find some useful information in this table:


GRCh38 Somatic
Project ID and  NameStudy ID and - NameVCF File TypeSamplesVariants

population

Population Studies GRCh38

1000g - 1000 Genomes Project Phase phase 3

Name


WGS Multi sample2,50482,587,763

uk10k
- UK10K
Project


WGS Aggregated10,00046,624,127

family

Family Studies GRCh37

platinum 

Platinum

corpasome - Corpas FamilyWES Family Multi sample34

8300,456,984711

corpasome platinum - Corpas FamilyIllumina Platinum


GWS Family Multi sample417

300,711

12,263,246

cancer

Cancer Studies GRCh37

rams_cml - RAMS_CML

Chronic Myeloid Leukemia - Russian Academy of Medical Sciences

Somatic11121,384

Example



Table of Contents:

Table of Contents
indent20px