The tutorial examples are installed with Ascent to the subdirectory
examples/ascent/tutorial/. Below are several options for using pre-built Ascent installs and links to info about building Ascent. If you have access to Docker, the easiest way to test the waters is via the
alpinedav/ascent Docker image.
Tutorial Cloud Option¶
For in person tutorials (at Supercomputing, the ECP Annual Meeting, etc), we provide HTTP access to several instances of our Ascent Docker image running the jupyter notebook server. We hand out IP addresses and login info to attendees during these events.
If you have Docker installed you can obtain a Docker image with a ready-to-use ascent install from Docker Hub. This image also includes a Jupyter install to support running Ascent’s tutorial notebooks.
To directly start the Jupyter Notebook server and run the tutorial notebooks, run:
docker run -p 8888:8888 -t -i alpinedav/ascent-jupyter
-p is used to forward ports between the container and your host machine, we use these ports to allow web servers on the container to serve data to the host.)
This image automatically launches a Jupyter Notebook server on port 8888. Assuming you forwarded port 8888 from the Docker container to your host machine, you should be able to connect to the notebook server using http://localhost:8888. The current password for the notebook server is:
To start the base image and explore the install and tutorial examples with bash, run:
docker run -p 8888:8888 -t -i alpinedav/ascent
You will now be at a bash prompt in you container.
To add the proper paths to Python and MPI to your environment, run:
The ascent source code is at
/ascent/src/, and the install is at
The tutorial examples are at
/ascent/install/examples/ascent/tutorial/ and the tutorial notebooks are at
You can also launch the a Jupyter Notebook server from this image using the following:
The url (http://localhost:8888) and password (
learn) are the same as above.
Build and Install¶
To build and install Ascent yourself see Quick Start.