sciserver/SciScript-Python

Name: SciScript-Python

Owner: sciserver

Description: Python libraries for SciScript, Jupyter Notebooks

Created: 2016-02-02 15:49:07.0

Updated: 2017-09-11 15:36:16.0

Pushed: 2018-01-18 19:27:16.0

Homepage:

Size: 258

Language: Python

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

SciScript-Python

Python libraries for Jupyter Notebooks

This python package provides functions for quick access of SciServer APIs (web services) and tools. SciServer provides a new online framework for data-intensive scientifc computing in the cloud, where the motto is to bring the computation close where the data is stored, and allow seamless access and sharing of big data sets within the scientific community.

Some SciServer tools you can access with this package:

Maintainer: Manuchehr Taghizadeh-Popp.

Authors: Gerard Lemson, Manuchehr Taghizadeh-Popp.

1) Cloning the code locally:

1.1.- Run git clone http://github.com/sciserver/SciScript-Python.git

2) Setting configuration parameters:

2.1.- Open ./py2/SciServer/Config.py and ./py3/SciServer/Config.py, and edit the API URLs and parameters to match those of the SciServer tools and installation, according to the instructions and descriptions found therein.

3) Installation:

There are 2 possibilities: automatic or manual installation.

a) Automatic Installation and Update:

3.a.1.- Run python ShowSciServerTags.py in order to see the version tags that label each SciServer release containing new SciScript code.

3.a.2.- To install or update, run python Install.py tag, where tag is the version tag of the SciServer release containing the SciScript version you want to install or update to (see previous step). If tag is not specified, then the latest version will be installed.

b) Manual Installation:

3.b.1.- To install python 2 code, run python setup.py install while in the ./py2 directory.

3.b.2.- To install python 3 code, run python3 setup.py install while in the ./py3 directory.

4) Creating HTML documentation:

4.1.- Run make html while in the ./docs_sphinx/ directory. The html files will be created in ./docs_sphinx/_build/

5) Unit Tests:

5.1.- Open ./Tests/UnitTests.py and edit the Authentication_loginName and Authentication_loginPassword parameters in order to run the Tests under the credentials of a (test) user.

5.2.- Run python UnitTests.py while in the ./Tests directory in order to run the unit tests for the SciScript-Python modules. Be sure all that all tests end with an OK status.

6) Examples.

6.1.- In the directory ./Examples you can find python scripts or Jupyter notebooks that will run sample code using SciScript-Python modules and methods.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.