OpenGeoscience/geonotebook

Name: geonotebook

Owner: OpenGeoscience

Description: A Jupyter notebook extension for geospatial visualization and analysis

Created: 2016-07-26 19:48:45.0

Updated: 2018-01-16 11:33:48.0

Pushed: 2017-10-30 17:53:33.0

Homepage:

Size: 14859

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

GeoNotebook

GeoNotebook is an application that provides client/server environment with interactive visualization and analysis capabilities using Jupyter, GeoJS and other open source tools. Jointly developed by Kitware and NASA Ames.

Documentation for GeoNotebook can be found at http://geonotebook.readthedocs.io.

Screenshots

Checkout some additional screenshots

Installation

System Prerequisites

For default tile serving

• GDAL >= 2.1.0
• mapnik >= 3.1.0
• python-mapnik >= 0.1

Clone the repo:

clone https://github.com/OpenGeoscience/geonotebook.git
eonotebook

Make a virtualenv, install jupyter[notebook], install geonotebook

rtualenv -a . geonotebook

mpy must be fully installed before rasterio
install -r prerequirements.txt

install -r requirements.txt

install .

able both the notebook and server extensions
ter serverextension enable --sys-prefix --py geonotebook
ter nbextension enable --sys-prefix --py geonotebook

Note The serverextension and nbextension commands accept flags that configure how and where the extensions are installed. See jupyter serverextension --help for more information.

Installing geonotebook for development

When developing geonotebook, it is often helpful to install packages as a reference to the checked out repository rather than copying them to the system site-packages. A “development install” will allow you to make live changes to python or javascript without reinstalling the package.

stall the geonotebook python package as "editable"
install -e .

stall the notebook extension as a symlink
ter nbextension install --sys-prefix --symlink --py geonotebook

able the extension
ter serverextension enable --sys-prefix --py geonotebook
ter nbextension enable --sys-prefix --py geonotebook

art the javascript builder
s
run watch

Run the notebook:

otebooks/
ter notebook

Configure the notebook:

Geonotebook relies on a configuration for several of its options. The system will merge configuration files in the following precedence:

• /etc/geonotebook.ini
• /usr/etc/geonotebook.ini
• /usr/local/etc/geonotebook.ini

• . /home/user/.virtual_environments/geonotebook/etc/geonotebook.inig)
  

• ~/.geonotebook.ini
• any path specified in the `GEONOTEBOOK_INI` environment variable.

The default configuration is installed in `sys.prefix`/etc/geonotebook.ini

Run the tests

om the source root
install -r requirements-dev.txt


tionally only run tests on python 2.7
x -e py27

Docker Container

System requirements for running the notebook can sometimes prove burdensome to install. To ease these issues we have included a docker container that will run the notebook inside a containerized process.

Vagrant Machine

Additionally there is a Vagrantfile for standing up an instance of Geonotebook within a virtual machine, further instructions can be found here.

Tile Server

By default geonotebook provides its own tile server based on Mapnik and GDAL as a Jupyter Notebook server extension. Assuming system pre-requisites are available this should not need to be configured. Alternately geonotebook may be configured to use a pre-existing Geoserver for serving tiles. A built in geoserver implementation is available as a virtual machine in devops/geoserver/.

Use geoserver for tile serving

First provision the geoserver

evops/geoserver/
ant up

Second change the `vis_serverconfiguration to ``geoserver` in the[default]`` section of your configuration. Then include a `[geoserver]` section with the pertinent configuration. E.g.:

ault]
server=geoserver



server]
name = admin
word = geoserver
= http://127.0.0.1:8080/geoserver