diff --git a/docs/_includes/themes/zeppelin/_navigation.html b/docs/_includes/themes/zeppelin/_navigation.html index 68252efa8f1..a1796e70517 100644 --- a/docs/_includes/themes/zeppelin/_navigation.html +++ b/docs/_includes/themes/zeppelin/_navigation.html @@ -142,6 +142,7 @@
  • Hive
  • Ignite
  • Java
  • +
  • Jupyter
  • Kotlin
  • Kylin
  • Lens
  • diff --git a/docs/assets/themes/zeppelin/img/docs-img/ipython_kernel.png b/docs/assets/themes/zeppelin/img/docs-img/ipython_kernel.png new file mode 100644 index 00000000000..eefe97e3612 Binary files /dev/null and b/docs/assets/themes/zeppelin/img/docs-img/ipython_kernel.png differ diff --git a/docs/assets/themes/zeppelin/img/docs-img/ir_kernel.png b/docs/assets/themes/zeppelin/img/docs-img/ir_kernel.png new file mode 100644 index 00000000000..a1bf5ec188c Binary files /dev/null and b/docs/assets/themes/zeppelin/img/docs-img/ir_kernel.png differ diff --git a/docs/assets/themes/zeppelin/img/docs-img/julia_kernel.png b/docs/assets/themes/zeppelin/img/docs-img/julia_kernel.png new file mode 100644 index 00000000000..5c075dc28f0 Binary files /dev/null and b/docs/assets/themes/zeppelin/img/docs-img/julia_kernel.png differ diff --git a/docs/interpreter/jupyter.md b/docs/interpreter/jupyter.md new file mode 100644 index 00000000000..89586e6bf00 --- /dev/null +++ b/docs/interpreter/jupyter.md @@ -0,0 +1,134 @@ +--- +layout: page +title: "Jupyter Interpreter for Apache Zeppelin" +description: "Project Jupyter exists to develop open-source software, open-standards, and services for interactive computing across dozens of programming languages." +group: interpreter +--- + +{% include JB/setup %} + +# Jupyter Interpreter for Apache Zeppelin + +
    + +## Overview + +Project [Jupyter](https://jupyter.org/) exists to develop open-source software, open-standards, and services for interactive computing across dozens of programming languages. +Zeppelin's Jupyter interpreter is a bridge/adapter between Zeppelin interpreter and Jupyter kernel. You can use any of jupyter kernel as long as you installed the necessary dependencies. + +## Configuration + +To run any Jupyter kernel in Zeppelin you first need to install the following prerequisite: + +* pip install jupyter-client +* pip install grpcio +* pip install protobuf + +Then you need install the jupyter kernel you want to use. In the following sections, we will talk about how to use the following 3 jupyter kernels in Zeppelin: + +* ipython +* ir +* julia + +## Jupyter Python kernel + +In order to use Jupyter Python kernel in Zeppelin, you need to install `ipykernel` first. + +```bash + +pip install ipykernel +``` + +Then you can run python code in Jupyter interpreter like following. + +```python + +%jupyter(kernel=python) + +%matplotlib inline +import matplotlib.pyplot as plt +plt.plot([1, 2, 3]) +``` + + + +## Jupyter R kernel + +In order to use [IRKernel](https://github.com/IRkernel/IRkernel), you need to first install `IRkernel` package in R. + +```r +install.packages('IRkernel') +IRkernel::installspec() # to register the kernel in the current R installation +``` + +Then you can run r code in Jupyter interpreter like following. + +```r +%jupyter(kernel=ir) + +library(ggplot2) +ggplot(mpg, aes(x = displ, y = hwy)) + + geom_point() +``` + + + + +## Jupyter Julia kernel + +In order to use Julia in Zeppelin, you first need to install [IJulia](https://github.com/JuliaLang/IJulia.jl) first + +```julia +using Pkg +Pkg.add("IJulia") + +``` + +Then you can run julia code in Jupyter interpreter like following. + +```julia + +%jupyter(kernel=julia-1.3) + +using Pkg +Pkg.add("Plots") +using Plots +plotly() # Choose the Plotly.jl backend for web interactivity +plot(rand(5,5),linewidth=2,title="My Plot") +Pkg.add("PyPlot") # Install a different backend +pyplot() # Switch to using the PyPlot.jl backend +plot(rand(5,5),linewidth=2,title="My Plot") +``` + + + + +## Use any other kernel + +For any other jupyter kernel, you can follow the below steps to use it in Zeppelin. + +1. Install the specified jupyter kernel. you can find all the available jupyter kernels [here](https://github.com/jupyter/jupyter/wiki/Jupyter-kernels) +2. Find its kernel name by run the following command + ```bash + jupyter kernelspec list + ``` +3. Run the kernel as following + +```python + +%jupyter(kernel=kernel_name) + +code +``` \ No newline at end of file