Getting Started#
This guide will help you get up and running with the course notebooks using JupyterLab, assuming you’ve already installed the necessary software as per our installation instructions.
Launching the Notebooks#
Follow these steps to start exploring the course content through interactive Jupyter notebooks:
Access the code: Ensure you’ve forked the GitHub repository to your local machine.
Navigate to the repository:
Windows Users
On Windows, open a Miniforge Prompt by searching for “miniforge” in the task bar.
Change to the directory where you cloned the repository by using
cd <drive:\path\to\dir>
. If you installed the GitHub client using their default settings you may runcd%userprofile%\Documents\GitHub\CoastalCodeBook
.
Unix-like Systems (Mac and Linux)
On Mac, search for terminal or iterm in Spotlight (command + space). On linux, the hotkey to open a terminal is “cntrl + shift + t”.
You can navigate the terminal using
cd
, which stands for “change directory”. So you would do something likecd ~/path/to/cloned/repository
Activate Your Environment: Activate your coastal environment with the command below. This environment contains all the packages you’ll need.
mamba activate coastal
Start JupyterLab: JupyterLab is an interactive development environment that allows you to work with notebooks and other files. Run the following command to open JupyterLab in your web browser:
jupyter lab
Open a Notebook: Within JupyterLab, navigate to the notebooks directory, and open a notebook, such as 1_coastal_classification.ipynb.
Select the Right Kernel: Before running the notebook, ensure the coastal environment is selected as the kernel. You can change this in the upper-right corner by selecting Python [conda env:coastal] from the kernel dropdown menu.
Interact with the Notebook: You’re now ready to execute the notebook cells and engage with the interactive coastal computational notebooks!
New to JupyterLab?#
If JupyterLab is new to you, or you’d like a refresher, consider browsing through this introductory guide. It provides a comprehensive overview of the JupyterLab interface and features.