incf-nidash / nidm-api

A restful api and client for NIDM
http://nidm-api.readthedocs.org/
BSD 3-Clause "New" or "Revised" License
0 stars 3 forks source link

nidm-api

documentation

This is an application to query and visualize nidm data structures, including workflow, experiment, and results. This repo contains a python module that can serve as a standalone application to work with nidm-queries.

Functions will be provided to do the following:

Installation

  pip install git+git://github.com/incf-nidash/nidm-api.git

Quick Start

To start the server:

  nidm

See all valid queries at localhost:8088. To see a single query:

  localhost:8088/api/7950f524-90e8-4d54-ad6d-7b22af2e895d

Do a query:

  http://localhost:8088/api/query/7950f524-90e8-4d54-ad6d-7b22af2e895d?ttl=https://rawgithub.com/incf-nidash/nidm-api/master/example/nidm.ttl

Documentation

Please see getting started for how to run a local REST API, a server REST API, or use the module functions in your application to perform queries on NIDM results, workflow, and experiment data structures. We will be providing complete documentation at readthedocs

Organization

The main python module contains scripts that are organized by the associated NIDM data structure, and you should follow the following convention:

Quick Answers

How do I use this as a REST API?

You have several options. By installing the nidm-api you will have a command line tool to immediately serve a localhost version of the REST API. You could easily run this executable on a server to provide it to a larger group of people. We will also (likely) find a place to serve this officially.

How do I integrate queries into my application?

While this API is an executable, it is also a collection of functions organized around the different NIDM objects. You can easily import the same functions to perform the queries into your applications to use them without needing to get them via the REST API.