Start JupyterLab in Galaxy

Join the private queue and resources for the course

The Training Infrastructure as a Service (TIaaS) of Galaxy Europe provides a private queue for your training in addition to the regular one, which should make your jobs run a bit faster. To make use of it, we have created a training group that is valid from 1st November until 21st November 2021. Outside this period, you can skip this step.

  • Open a new window/tab in your browser, login to https://usegalaxy.eu using the same username and password you have created for Galaxy Europe.

  • Go to the link sent by your instructors (it starts with https://usegalaxy.eu/join-training/ and then the group identifier of your training. Be aware that the link will only be effective from November 1st to November 21st 2021.

GTiaaS group

Start Galaxy Climate JupyterLab

Pangeo JupyterLab

  • Click Execute

Galaxy jupyterLab climate Tool

  • The tool will start running and will stay running permanently (during 2-3 weeks depending on the load)

Find your Galaxy instance

  • Click on the “User” menu at the top and go to “Active Interactive Tools” and locate the JupyterLab instance you started.

Open your instance (which you created in the previous step here). If you’ve closed it, you can open it again by going to live.usegalaxy.eu clicking “User”–>”Active Interactive Tools” and then clicking on the notebook.

drawing
  • Click on your JupyterLab instance (please note that it may take a few minutes before you can click on the link to your jupyterLab instance).

Pangeo JupyterLab

Warning

NOTE: Your JupyterLab instance will be active during 2-3 weeks depending on the load of the machines. However, if you are inactive or in case of hardware issues, it may be shutdown and you may loose your work. We strongly suggest to save very regularly your work to avoid any surprises! The best is to use git and github to save your jupyter notebooks and other programs. For data, make sure you learn how to save data in a shared folder (s3 object storage). The next section on How to work during the course will give you more practical information on how to save your codes and data.

Create new Jupyter notebooks

Create a notebook by clicking the `+`` button in the file browser and then selecting the pangeo kernel in the new Launcher tab:

Pangeo notebook

Start a new Terminal

You may need to execute commands from a Terminal (for instance to add new packages as shown below or to execute python scripts). To open a new terminal, click the + button in the file browser and select the terminal in the new Launcher tab:

JupyterLab Terminal

Customize your JupyterLab Galaxy instance (optional)

Your galaxy JupyterLab instance is now like your own computer for the next weeks.

Adding new packages (optional)

It already has quite a lot of packages installed, but if you want to install more, you can do this:

  • if you need to install a simple package, use pip or conda. pip will be must faster but sometimes can messed up your environment:

    pip install my-package
    

    or with conda:

    conda install -c conda-forge my-package
    

    where my-package is the package you wish to install.

  • if you need to install many packages and/or a conflict arose when trying to install a package, you can create a new conda environment and make it available from the JupyterLab (here we install python version 3.9, scipy, dask and h5netcdf):

    conda create --name myenv python=3.9 scipy dask h5netcdf
    conda activate myenv 
    ipython kernel install --name "myenv" --user
    

    myenv will appear as a new kernel (and you need to select it to use it in your jupyter notebook).

Adding in 3rd party extensions (optional)

Jupyter has some nice extensions which you might want to include. To add these, do:

  1. in the sidebar click on the puzzle icon

  2. enable third party extensions

  3. install the ones you need Many are already included though.

JupyterLab documentation

The JupyterLab documentation is quite exhaustive. You may want to focus first on the User guide section.