A Jupyter Notebook server extension which crawls a thredds catalog
Project description
# jupyterlab_thredds
[![Build Status](https://travis-ci.org/eWaterCycle/jupyterlab_thredds.svg?branch=master)](https://travis-ci.org/eWaterCycle/jupyterlab_thredds) [![SonarCloud Quality](https://sonarcloud.io/api/project_badges/measure?project=jupyterlab_thredds&metric=alert_status)](https://sonarcloud.io/dashboard?id=jupyterlab_thredds) [![SonarCloud Coverage](https://sonarcloud.io/api/project_badges/measure?project=jupyterlab_thredds&metric=coverage)](https://sonarcloud.io/component_measures?id=jupyterlab_thredds&metric=coverage) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1241007.svg)](https://doi.org/10.5281/zenodo.1241007)
JupyterLab dataset browser for [THREDDS catalog](https://www.unidata.ucar.edu/software/thredds/v4.6/tds/catalog/index.html)
Can inject [iris](http://scitools.org.uk/iris/docs/latest/index.html)/[xarray](https://xarray.pydata.org)/[leaflet](https://github.com/jupyter-widgets/ipyleaflet) code cells into a Python notebook of a selected dataset to further process/visualize the dataset.
![screenshot](https://github.com/eWaterCycle/jupyterlab_thredds/blob/master/jupyterlab_thredds.gif “Screenshot”)
## Prerequisites
JupyterLab, pip install jupyterlab
ipywidgets, jupyter labextension install @jupyter-widgets/jupyterlab-manager, requirement for ipyleaflet
ipyleaflet, jupyter labextension install jupyter-leaflet, to load a WMS layer
[iris](http://scitools.org.uk/iris/docs/latest/index.html), conda install -c conda-forge iris
## Installation
`bash pip install jupyterlab_thredds jupyter labextension install @ewatercycle/jupyterlab_thredds `
## Usage
Start Jupyter lab with jupyter lab
In Jupyter lab open a notebook
Open the THREDDS tab on the left side.
Fill the catalog url
Press search button
Select how you would like to open the dataset, by default it uses [iris](http://scitools.org.uk/iris/docs/latest/index.html) Python package.
Press a dataset to insert code into a notebook
## Development
For a development install (requires npm version 4 or later), do the following in the repository directory:
`bash npm install npm run build jupyter labextension link . python setup.py develop jupyter serverextension enable --sys-prefix jupyterlab_thredds `
To rebuild the package and the JupyterLab app:
`bash npm run build jupyter lab build `
Watch mode `bash # shell 1 npm run watch # shell 2 jupyter lab --ip=0.0.0.0 --no-browser --watch `
## Release
To make a new release perform the following steps: 1. Update version in package.json and jupyterlab_thredds/version.py 2. Make sure tests pass by running npm test and pytest 3. Publish lab extension to npmjs with npm run build and npm publish –access=public 4. Publish server extension to pypi with python setup.py sdist bdist_wheel and twine upload dist/*
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for jupyterlab_thredds-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6d390d3c55d651f7355694b214ab6b7f7a0e641a53615f59872a01ee62c9aec7 |
|
MD5 | 83d0e11fb8c8be13078304e755436691 |
|
BLAKE2b-256 | dde34757a186c379e0cadb4a66d5f94ee360382d6c2f211a3f8821f55cfcc77d |