GRASS GIS Jupyter notebooks: Difference between revisions

From GRASS-Wiki
Jump to navigation Jump to search
m (remove dupe)
(added instructions how to run grass from jupyter)
Line 2: Line 2:


You can even change the code and explore your modified script(s).
You can even change the code and explore your modified script(s).
== How to run GRASS GIS from Jupyter notebook ==
Running GRASS from Jupyter notebook requires that Jupyter notebook is installed on your system, and that you set up the [https://grass.osgeo.org/grass72/manuals/variables.html environment variables] for using GRASS. For example you can create a script called grass_jupyter.sh that contains the following lines:
<source lang="bash">
# directory where GRASS lives
export GISBASE=/usr/local/grass-7.3.svn # Change this path to reflect your own
# generate GISRC
# Defines the system wide value while in a GRASS session
MYGISDBASE=$HOME/grassdata # Change this path to reflect your own
MYLOC=MyLoc # Change this location name to reflect your own
MYMAPSET=PERMANENT
# Set the global grassrc file to individual file name
MYGISRC="$HOME/.grassrc.$$"
echo "GISDBASE: $MYGISDBASE" > "$MYGISRC"
echo "LOCATION_NAME: $MYLOC" >> "$MYGISRC"
echo "MAPSET: $MYMAPSET" >> "$MYGISRC"
echo "GRASS_GUI: text" >> "$MYGISRC"
# path to GRASS settings file
export GISRC=$MYGISRC
export LD_LIBRARY_PATH=$GISBASE/lib:$LD_LIBRARY_PATH
export PYTHONPATH=$GISBASE/etc/python:$PYTHONPATH
export PATH=$GISBASE/bin:$GISBASE/scripts:$PATH
# start the notebook in the notebook folder
cd $HOME/notebooks # change this path to reflect your own path to notebooks folder
nohup jupyter notebook --ip=0.0.0.0 --port=8888 --debug &
</source>
Add this line in your .bashrc file
<source lang="bash">
alias grass_notebook='sh grass_jupyter.sh'
</source>
From terminal, in your home directory:
<source lang="bash">
source .bashrc
</source>
Now you can start your notebook typing in the terminal:
<source lang="bash">
grass_notebook
</source>


=== List of selected GRASS GIS Jupyter notebooks ===
=== List of selected GRASS GIS Jupyter notebooks ===

Revision as of 09:33, 24 October 2017

A Jupyter Notebook is a web application that allows you to create and share documents that contain scripts and code, equations, visualizations and explanatory text, combined.

You can even change the code and explore your modified script(s).

How to run GRASS GIS from Jupyter notebook

Running GRASS from Jupyter notebook requires that Jupyter notebook is installed on your system, and that you set up the environment variables for using GRASS. For example you can create a script called grass_jupyter.sh that contains the following lines:

# directory where GRASS lives
export GISBASE=/usr/local/grass-7.3.svn # Change this path to reflect your own

# generate GISRC
# Defines the system wide value while in a GRASS session
MYGISDBASE=$HOME/grassdata # Change this path to reflect your own 
MYLOC=MyLoc # Change this location name to reflect your own 
MYMAPSET=PERMANENT

# Set the global grassrc file to individual file name
MYGISRC="$HOME/.grassrc.$$"

echo "GISDBASE: $MYGISDBASE" > "$MYGISRC"
echo "LOCATION_NAME: $MYLOC" >> "$MYGISRC"
echo "MAPSET: $MYMAPSET" >> "$MYGISRC"
echo "GRASS_GUI: text" >> "$MYGISRC"

# path to GRASS settings file
export GISRC=$MYGISRC

export LD_LIBRARY_PATH=$GISBASE/lib:$LD_LIBRARY_PATH
export PYTHONPATH=$GISBASE/etc/python:$PYTHONPATH
export PATH=$GISBASE/bin:$GISBASE/scripts:$PATH

# start the notebook in the notebook folder
cd $HOME/notebooks # change this path to reflect your own path to notebooks folder

nohup jupyter notebook --ip=0.0.0.0 --port=8888 --debug &

Add this line in your .bashrc file

alias grass_notebook='sh grass_jupyter.sh'

From terminal, in your home directory:

source .bashrc

Now you can start your notebook typing in the terminal:

grass_notebook

List of selected GRASS GIS Jupyter notebooks

(please expand!)

See also