Setting Up a CMB Environment on Fornax

What is Fornax?

NASA's Fornax Initiative provides a cloud-based JupyterLab environment called the Fornax Science Console, where users can perform data analysis next to NASA astrophysics archival data from HEASARC, IRSA, and MAST. This page describes how to set up CMB-specific tools and notebooks within the Fornax Science Console. If you do not yet have a Fornax account, please refer to the Fornax Quick Start Guide before proceeding.

Setting Up the CMB Environment

Cloning the Repository

Before setting up the CMB environment, you will need to clone the LAMBDA Fornax CMB GitHub repository. This repository contains the CMB environment YAML file and Jupyter notebooks. To clone the repository, open a terminal in the Fornax Science Console and run the following command:

Opening a terminal in the Fornax Science Console Image

git clone --recurse-submodules https://github.com/nasa-lambda/fornax-cmb.git

The CMB Environment YAML File

The CMB environment is defined by the cmb.yaml file located in the root of the cloned repository. This file specifies all of the Python packages and dependencies needed to run the CMB notebooks.


The CMB Environment YAML File

The CMB environment is defined by the cmb.yaml file located in the root of the cloned repository. This file specifies all of the Python packages and dependencies needed to run the CMB notebooks.


Installing the Environment

To install the CMB environment, navigate to the cloned repository and run the following command:

Navigating to the repository in the Fornax Science Console Image

setup-conda-env --user cmb.yaml

The user option can be left out if you don't want the environment to persist between sessions Note: The installation may take a few minutes to complete.

Adding the CMB Environment as a Jupyter Kernel

After installing the CMB environment, you will need to add it as a Jupyter kernel so that it can be selected when running the CMB notebooks. To do this, first activate the CMB environment:

micromamba activate cmb

The run the following command to install the kernel

python -m ipykernel install --user --name cmb

The CMB kernel should now be available as a kernel option in JupyerLab. The screenshot below shows where to select the CMB kernel when opening a notebook.

Selecting the CMB kernel in JupyerLab Image

CMB Jupyter Notebooks

The LAMBDA Fornax CMB repository includes several Jupyter notebooks for working with CMB data and tools. The notebooks are organized into the following categories:


CMB S4 Summer School

These notebooks are from the CMB-S4 Summer School held online in August 2021. They are included as a submodule from the CMBAnalysis_SummerSchool repository.


pixell Tutorials

These notebooks provide tutorials for working with pixell, a library for loading, manipulating, and analyzing maps stored in rectangular pixelization.


Likelihood Notebooks

These notebooks provide example code for evaluating the likelihoods for a couple of CMB experiments, including ACTPol and BICEP1.


CMB

These notebooks demonstrate the Python bindings for CAMB, a cosmological code for calculating CMB power spectra


A service of the HEASARC and of the Astrophysics Science Division at NASA/GSFC

HEASARC Director: Dr. Andrew F. Ptak

LAMBDA Director: Dr. Thomas M. Essinger-Hileman

NASA Official: Dr. Thomas M. Essinger-Hileman

Web Curator: Mr. Michael R. Greason