From e1fa0b1f90cbf553cbac0e8625d23804df0d81b0 Mon Sep 17 00:00:00 2001 From: Kozo Nishida Date: Thu, 20 Jul 2017 23:04:42 +0900 Subject: [PATCH] Create Dockerfile and Update README.md --- Dockerfile | 8 ++++++++ README.md | 14 ++++++++++++++ 2 files changed, 22 insertions(+) create mode 100644 Dockerfile diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..3f40f18 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,8 @@ +FROM jupyter/minimal-notebook + +ADD . /home/jovyan/work +WORKDIR /home/jovyan/work + +USER $NB_USER +RUN conda install -y pandas widgetsnbextension protobuf && \ + jupyter nbextension install facets-dist/ --user diff --git a/README.md b/README.md index 3a58366..deaba4a 100644 --- a/README.md +++ b/README.md @@ -56,6 +56,20 @@ To enable use of these visualizations in Jupyter notebooks: Note: When visualizing a large amount of data, as is done in the [Dive demo Jupyter notebook](./facets_dive/Dive_demo.ipynb), you will need to start the notebook server with an increased IOPub data rate. This can be done with the command ```jupyter notebook --NotebookApp.iopub_data_rate_limit=10000000```. +### Usage in Jupyter Notebooks with Docker + +Pre-built docker image for Facets is available. +You can try Facets in the jupyter notebook software without the above installation. + +To use Facets in the jupyter notebook software with Docker: +1. Install Docker and Chrome. +2. Run + ``` + docker run -d -p 8888:8888 kozo2/facets start-notebook.sh --NotebookApp.token='' --NotebookApp.iopub_data_rate_limit=10000000 + ``` +3. Open [http://localhost:8888](http://localhost:8888) with Chrome. You should see the jupyter notebook software in the Chrome tab. +4. Open `facets_overview/Overview_demo.ipynb` or `facets_dive/Dive_demo.ipynb` with the jupyter notebook software. + ## Building the Visualizations If you make code changes to the visualization and would like to rebuild them for use in Jupyter notebooks, follow these directions: