Context
Among the different services WEkEO offers for all users, the JupyterHub is a development multi-users platform designed to create, run and share Python codes and scripts for data analysis, in virtual Jupyter environments.
Multiple tutorial notebooks are available in the public
folder of the JupyterHub, accessible to all WEkEO users, for free. The only requirement is a WEkEO account.
π‘ WEkEO Pro Tip: you will find all the available WEkEO notebooks in our Jupyter Catalogue!
β οΈ Your data located on the WEkEO JupyterHub will be removed if you stay inactive during 5 months. You simply need to login and do some work to reset the counter. After 2 months of inactivity, you will receive an email informing you that your data will be archived for 3 months. You need to contact us during this period for the recovery of the backup.
Accessing the WEkEO JupyterHub
A few simple steps allow to access the JupyterHub:
Sign in to your WEkEO account to reach your dashboard MyWEkEO:
β
βFrom MyWEkEO, click on Open next to WEKEO Workspace:
βClick on Sign in with OAuth 2.0:
Enter the verification code sent to your email address:
βChoose the computing resources and click on Start to launch the server:
β
And that's it!
You are now on your JupyterHub workspace! π
β οΈ Under your home directory, up to 20 GB of storage are available.
What is available in the WEkEO JupyterHub?
Computing resources
Depending on the selected Server Option (last step of previous section) you have different computing resources at your disposal.
π To learn more, we invite you to check the following article:
Conda environments
As you can see in previous section Computing resources, various conda environments are made available for all users on the WEkEO JupyterHub.
Your Jupyter instance is initialized with default conda
environments, that are reset after each session restart, so all other locations unlisted below are not persisted.
π However, you can create custom environment that will be preserved:
π‘WEkEO Pro Tip: all the most used Python packages are already installed in the wekeolab
environment, including the hda
package!
Filesystems
On the WEkEO JupyterHub, several filesystems are mounted in different locations:
Public folder
Accessibility: public
Location:
/home/jovyan/public
Description: a read-only filesystem that contains code examples, where you can find notebooks demonstrating how to download data from WEkEO or corresponding to the training sessions on Atmosphere, Climate, Land and Marine applications
β οΈ To be able to modify and save a notebook from the public
folder, first you need to copy/paste it into your working directory:
Manually: right click on the notebook, click on Copy, go to your own working directory and right click>Paste
Command Line Interface: run this command in a terminal:
cp public/wekeo4oceans/learn-olci/1_OLCI_introductory/1_1b_OLCI_data_access_HDA.ipynb <OUTPUT_DIR>
where
<OUTPUT_DIR>
is the target directory.
Old files folder
Accessibility: private
Location:
/home/jovyan/old_files
Description: a read-only filesystem that contains the files you may had before the migration on June 14th, 2022
β
Personal filesystem
Accessibility: private
Location:
/home/jovyan
Description: a filesystem that contains your persistent folders and files.
π‘ WEkEO Pro Tip: you can your own folder by right-clicking on the empty space in the file explorer, then New Folder:
β
Summary table
Path | Performance | Persisted | Read-Only |
| Slower | Yes | Yes |
| Slower | Yes | Yes |
| Fast | Yes | No |
What's next?
These articles might be of interest for you:
Additional resources can be found in our Help Center. Should you require further assistance or wish to provide feedback, feel free to contact us through a chat session available in the bottom right corner of the page.