JupyterLab is a powerful interactive environment for working with code, notebooks, and data. If this is your first time here, don’t worry — here’s a quick guide to help you get started:

🗂️ File Browser (Left Panel)

On the left, you’ll see a file browser with folders and files.
📁 Double-click folders to open them.
📄 Click a file to open it in a tab.
🖱️ Right-click files for options like rename, preview, or delete.

📑 Tabs (Top Bar)

Every file you open shows up as a tab across the top.
You can switch between files, close them, or rearrange them.
It’s like a browser but for code and documents!

📄 What Are These Files?

In your folder, you'll see these notebooks to help you get started. Open them by right-click and selecting "Open With → Notebook":

✅ `mofem_spack_create_view`

Create a spack view (a set of linked software packages) based on your selected MoFEM environment. Run this notebook before running any mofem simulation.

✅ `python_env_create_custom`

Create your own Python environment with the packages you choose. Most of the packages should be preinstalled in the default python kernel, use this if you want anything more.

✅ `mofem_install_from_source`

If you want full control: install MoFEM from source. You can choose build types, branches, and dependencies. Intended for developers or installing modules not included in the default installation.

🧪 Notebooks (`.ipynb`)

Click to open, run code, and see results instantly
Use Shift + Enter to run a cell
Use the top menu to restart, stop, or export

🛠️ Launching New Tools

Click the “+” Launcher button (or File → New Launcher)
From there, start:
- New notebooks
- Consoles
- Terminals
- Markdown or text files

📜 Auto-scrolling outputs in JupyterLab

Depending on the JupyterLab version, automatic scrolling of long cell outputs may not be enabled.
Here are two easy ways to keep your notebooks tidy:

Right-click method
Right-click on the cell output → Enable Scrolling for Outputs
Quick style injection
Add and run the snippet below in a notebook cell to set a maximum height and enable scrolling:

from IPython.display import HTML

HTML("<style>.jp-OutputArea-output{max-height:300px;overflow:auto;}</style>")

🙋 Need Help?

This environment is built to help you explore, simulate, and develop. You're free to run code, install packages, or just poke around.

Enjoy and have fun! 🎉