# Intro to JupyterLab

[JupyterLab](https://jupyterlab.readthedocs.io) will be our primary method for
interacting with the computer. JupyterLab contains a complete environment for
interactive scientific computing which runs in your web browser. Jupyter is an
open source python project that was started by scientists like yourselves who
wanted a more effective way to interact with their computers.

JupyterLab has excellent documentation. Rather than repeat that documentation
here, we point you to their docs. The following pages are particularly relevant:

- [The JupyterLab Interface](https://jupyterlab.readthedocs.io/en/stable/user/interface.html)
- [Working with Files](https://jupyterlab.readthedocs.io/en/stable/user/files.html)
- [The Text Editor](https://jupyterlab.readthedocs.io/en/stable/user/file_editor.html)
- [Notebooks](https://jupyterlab.readthedocs.io/en/stable/user/notebook.html)
- [Terminals](https://jupyterlab.readthedocs.io/en/stable/user/terminal.html)
- [Managing Kernels and Terminals](https://jupyterlab.readthedocs.io/en/stable/user/running.html)

You will gain experience and familiarity with JupyterLab over the course of the
semester as we use it in our weekly lectures and assignments.

## Markdown

Throughout the course, we will write rich text documents using Markdown.
Here are some useful references on Markdown syntax.

- [Official Markdown Documentation](https://daringfireball.net/projects/markdown/)
- [Markdown Guide / Basic Syntax](https://www.markdownguide.org/basic-syntax) -
  A more user-friendly syntax guide.

## Our Course JupyterHub

[JupyterHub](https://jupyter.org/hub) is multi-user Jupyter environment designed for companies, classrooms and research labs.

We have a jupyterhub for the course in which you should do all of your assignments and take your notes. You should have received an email from Dr. Gus Correa, Systems programmer and Administrator at LDEO (Prof. Westervelt's home institution within Columbia University). The physical server is called "chopin" and lives at LDEO.

You can login to the JupyterHub running on chopin, with your username and password (provided by email to you), by pointing your laptop browser to [https://chopin.ldeo.columbia.edu:8441/jupyterhub/]

Everyone is given a home directory has a quota of 10GB, and your work directory /data9/CLMT5053G/work/your_username has a quota of 50GB. Code can go in the home directories, which are backed up, but large datasets should go in the work directory.

Please remember to actively log out of the jupyterhub when you are done using it. It is not enough to simply close the browser or close your laptop screen.