diff --git a/content/guides/running_applications/Jupyter.md b/content/guides/running_applications/Jupyter.md new file mode 100644 index 0000000000000000000000000000000000000000..e45e855dbfc6750acef4d99cf8476d608cae23f9 --- /dev/null +++ b/content/guides/running_applications/Jupyter.md @@ -0,0 +1,53 @@ ++++ +title = "Jupyter Notebooks on Crane" +description = "How to access and use a Jupyter Notebook" +weight = 20 ++++ + +- [Connecting to Crane] (#connecting-to-crane) +- [Running Code] (#running-code) +- [Opening a Terminal] (#opening-a-terminal) +- [Using Custom Packages] (#using-custom-packages) + +## Connecting to Crane +----------------------- + Jupyter defines it's notebooks ("Jupyter Notebooks") as + an open-source web application that allows you to create and share documents that contain live code, + equations, visualizations and narrative text. Uses include: data cleaning and transformation, numerical simulation, + statistical modeling, data visualization, machine learning, and much more. + +1. To open a Jupyter notebook, [Sign in](https://crane.unl.edu) to crane.unl.edu using your hcc credentials (NOT your + UNL credentials). +{{< figure src="/images/jupyterLogin.png" >}} + +2. Select your prefferred authentication method. + +{{< figure src="/images/jupyterPush.png" >}} + +## Running Code + +1. Select the "New" dropdown menu and select the file type you want to create. + +{{< figure src="/images/jupyterNew.png" >}} +2. A new tab will open, where you can enter your code. Run your code by selecting the "play" icon. + +{{< figure src="/images/jupyterCode.png">}} + +## Opening a Terminal + +1. From your user home page, select "terminal" from the "New" drop-down menu. +{{< figure src="/images/jupyterTerminal.png">}} +2. A terminal opens in a new tab. You can enter [Linux commands] ({{< relref "basic_linux_commands" >}}) + at the prompt. +{{< figure src="/images/jupyterTerminal2.png">}} + +## Using Custom Packages + +Many popular `python` and `R` packages are already installed and available within Jupyter Notebooks. +However, it is possible to install custom packages to be used in notebooks by creating a custom Anaconda +Environment. Detailed information on how to create such an environment can be found at + [Using an Anaconda Environment in a Jupyter Notebook on Crane]({{< relref "using_anaconda_package_manager/#using-an-anaconda-environment-in-a-jupyter-notebook-on-crane" >}}). + +--- + + diff --git a/static/images/jupyterCode.png b/static/images/jupyterCode.png new file mode 100644 index 0000000000000000000000000000000000000000..179a122a60a2b78b534f1f269736f33aa67364a8 Binary files /dev/null and b/static/images/jupyterCode.png differ diff --git a/static/images/jupyterLogin.png b/static/images/jupyterLogin.png new file mode 100644 index 0000000000000000000000000000000000000000..152c6ece92a5006f86c95f039ce42413fb967550 Binary files /dev/null and b/static/images/jupyterLogin.png differ diff --git a/static/images/jupyterNew.png b/static/images/jupyterNew.png new file mode 100644 index 0000000000000000000000000000000000000000..9ccdf386c75ebcc96c380cb427d6e5d6ab342b35 Binary files /dev/null and b/static/images/jupyterNew.png differ diff --git a/static/images/jupyterPush.png b/static/images/jupyterPush.png new file mode 100644 index 0000000000000000000000000000000000000000..535163cf7f82182ba6aaa4a50663a577e4e24397 Binary files /dev/null and b/static/images/jupyterPush.png differ diff --git a/static/images/jupyterTerminal.png b/static/images/jupyterTerminal.png new file mode 100644 index 0000000000000000000000000000000000000000..14110c9ea2b6e08fbd82749025498ba8114fae0c Binary files /dev/null and b/static/images/jupyterTerminal.png differ diff --git a/static/images/jupyterTerminal2.png b/static/images/jupyterTerminal2.png new file mode 100644 index 0000000000000000000000000000000000000000..94038581ea8fcd6532fca51aadde12b5b7bb2e8f Binary files /dev/null and b/static/images/jupyterTerminal2.png differ