The purpose of this repository is to provide instructions as to how one can get started running PDAL within a Jupyter notebook.

$ cd notebooks/data
$ git submodule init
$ git submodule update

$ docker pull chambbj/learning-pdal

Not necessary if you have pulled the image from Docker Hub. Perhaps useful if you've made changes to the Dockerfile.

$ docker build -t learning-pdal .

By default, the notebooks folder in this repository will be accessible within Jupyter, and one can work through all of the tutorials in this manner.

$ docker run -t --name learning-pdal -p 8888:8888 chambbj/learning-pdal

If you would like to modify and save any changes to your notebooks, you'll need to mount a volume, mapping a local path to the container.

$ docker run -t --name learning-pdal -v $(pwd)/notebooks/:/notebooks -p 8888:8888 chambbj/learning-pdal

In both instances, we expose port 8888. Jupyter is accessible at http://localhost:8888. A token will also be generated when Jupyter first starts, and this will be required for subsequent access.