Welcome to the yt quickstart!

In this brief tutorial, we'll go over how to load up data, analyze things, inspect your data, and make some visualizations.

Our documentation page can provide information on a variety of the commands that are used here, both in narrative documentation as well as recipes for specific functionality in our cookbook. The documentation exists at If you encounter problems, look for help here:

Acquiring the datasets for this tutorial

If you are executing these tutorials interactively, you need some sample datasets on which to run the code. You can download these datasets at, or you can use the built-in yt sample data loader (using pooch under the hood) to automatically download the data for you.

The datasets necessary for each lesson are noted next to the corresponding tutorial, and by default it will use the pooch-based dataset downloader. If you would like to supply your own paths, you can choose to do so.

Using the Automatic Downloader

For the purposes of this tutorial, or whenever you want to use sample data, you can use the load_sample command to utilize the pooch auto-downloader. For instance:

ds = yt.load_sample("IsolatedGalaxy")

Using manual loading

The way you will most frequently interact with yt is using the standard load command. This accepts a path and optional arguments. For instance:

ds = yt.load("IsolatedGalaxy/galaxy0030/galaxy0030")

would load the IsolatedGalaxy dataset by supplying the full path to the parameter file.

What's Next?

The Notebooks are meant to be explored in this order:

  1. Introduction (this file!)
  2. Data Inspection (IsolatedGalaxy dataset)
  3. Simple Visualization (enzo_tiny_cosmology & Enzo_64 datasets)
  4. Data Objects and Time Series (IsolatedGalaxy dataset)
  5. Derived Fields and Profiles (IsolatedGalaxy dataset)
  6. Volume Rendering (IsolatedGalaxy dataset)

(1)_Introduction.ipynb; 1)_Introduction_evaluated.ipynb; 1)