The interactive prompt offers a number of excellent opportunities for exploration of data. While there are challenges for repeatability, and some operations will be more challenging to operate in parallel, interactive prompts can be exceptionally useful for debugging, exploring, and tweaking plots.
You can start up an empty shell, with a handful of useful yt utilities (such as tab-completion and pre-imported modules) by executing:
The other option, which is shorthand for “iyt plus dataset loading” is to use
the command-line tool (see Command-Line Usage) with the
and to specify a dataset. For instance:
yt load cosmoSim_coolhdf5_chk_0026
yt load DD0030/DD0030
This will spawn
iyt, but the dataset given on the command line will
already be in the namespace as
ds. With interactive mode, you can use the
pylab module to interactively plot.
yt command-line tool allows you to access some of yt’s basic
functionality without opening a python interpreter. The tools is a collection of
subcommands. These can quickly making plots of slices and projections through a
dataset, updating yt’s codebase, print basic statistics about a dataset, launch
an IPython notebook session, and more. To get a quick list of what is
available, just type:
This will print the list of available subcommands,
help Print help message bugreport Report a bug in yt hub Interact with the yt Hub instinfo Get some information about the yt installation version Get some information about the yt installation load Load a single dataset into an IPython instance mapserver Serve a plot in a GMaps-style interface pastebin Post a script to an anonymous pastebin pastebin_grab Print an online pastebin to STDOUT for local use. upload_notebook Upload an IPython Notebook to the yt Hub. plot Create a set of images rpdb Connect to a currently running (on localhost) rpd session. Commands run with --rpdb will trigger an rpdb session with any uncaught exceptions. notebook Start the Jupyter Notebook locally. stats Print stats and max/min value of a given field (if requested), for one or more datasets (default field is density) update Update the yt installation to the most recent version delete_image Delete image from imgur.com. upload_image Upload an image to imgur.com. Must be PNG. upload Upload a file to yt's curldrop. config Get and set configuration values for yt search Attempt to find outputs that yt can recognize in directories. download Download a file from http://yt-project.org/data and save it to a particular location. Files can be saved to the locations provided by the "test_data_dir" or "supp_data_dir" configuration entries, or any valid path to a location on disk.
To execute any such function, simply run:
Finally, to identify the options associated with any of these subcommand, run:
yt <subcommand> -h
Plotting from the command line¶
First, we’ll discuss plotting from the command line, then we will give a brief
summary of the functionality provided by each command line subcommand. This
example uses the
DD0010/moving7_0010 dataset distributed in the yt
First let’s see what our options are for plotting:
$ yt plot --help
There are many! We can choose whether we want a slice (default) or a
-p), the field, the colormap, the center of the image, the
width and unit of width of the image, the limits, the weighting field for
projections, and on and on. By default the plotting command will execute the
same thing along all three axes, so keep that in mind if it takes three times
as long as you’d like! The center of a slice defaults to the center of
the domain, so let’s just give that a shot and see what it looks like:
$ yt plot DD0010/moving7_0010
Well, that looks pretty bad! What has happened here is that the center of the domain only has some minor shifts in density, so the plot is essentially incomprehensible. Let’s try it again, but instead of slicing, let’s project. This is a line integral through the domain, and for the density field this becomes a column density:
$ yt plot -p DD0010/moving7_0010
Now that looks much better! Note that all three axes’ projections appear
nearly indistinguishable, because of how the two spheres are located in the
domain. We could center our domain on one of the spheres and take a slice, as
well. Now let’s see what the domain looks like with grids overlaid, using the
$ yt plot --show-grids -p DD0010/moving7_0010
We can now see all the grids in the field of view. If you want to
annotate your plot with a scale bar, you can use the
$ yt plot --show-scale-bar -p DD0010/moving7_0010
Command-line subcommand summary¶
Help lists all of the various command-line options in yt.
Encountering a bug in your own code can be a big hassle, but it can be exponentially worse to find it in someone else’s. That’s why we tried to make it as easy as possible for users to report bugs they find in yt. After you go through the necessary channels to make sure you’re not just making a mistake (see What to do if you run into problems), you can submit bug reports using this nice utility.
instinfo and version¶
This gives information about where your yt installation is, what version and changeset you’re using and more.
This will start the iyt interactive environment with your specified dataset already loaded. See Interactive Prompt for more details.
Ever wanted to interact with your data using the google maps interface? Now you can by using the yt mapserver. See Mapserver - A Google-Maps-like Interface to your Data for more details.
pastebin and pastebin_grab¶
The pastebin is an online location where
you can anonymously post code snippets and error messages to share with
other users in a quick, informal way. It is often useful for debugging
code or co-developing. By running the
pastebin subcommand with a
text file, you send the contents of that file to an anonymous pastebin;
yt pastebin my_script.py
By running the
pastebin_grab subcommand with a pastebin number
(e.g. 1768), it will grab the contents of that pastebin
(e.g. the website http://paste.yt-project.org/show/1768 ) and send it to
STDOUT for local use. See Pastebin for more information.
yt pastebin_grab 1768
Upload a file to a public curldrop instance. Curldrop is a simple web application that allows you to upload and download files straight from your Terminal with an http client like e.g. curl. It was initially developed by Kevin Kennell and later forked and adjusted for yt’s needs. After a successful upload you will receive a url that can be used to share the data with other people.
yt upload my_file.tar.gz
This command generates one or many simple plots for a single dataset.
By specifying the axis, center, width, etc. (run
yt help plot for
details), you can create slices and projections easily at the
This command will accept the filename of a
.ipynb file (generated from an
IPython notebook session) and upload it to the yt hub where others will be able to view it, and
download it. This is an easy method for recording a sequence of commands,
their output, narrative information, and then sharing that with others. These
notebooks will be viewable online, and the appropriate URLs will be returned on
the command line.
Connect to a currently running (on localhost) rpd session.
Launches an IPython notebook server and prints out instructions on how to open an ssh tunnel to connect to the notebook server with a web browser. This is most useful when you want to run an IPython notebook using CPUs on a remote host.
This subcommand provides you with some basic statistics on a given dataset.
It provides you with the number of grids and cells in each level, the time
of the dataset, the resolution, and the maximum density in a variety of units.
It is tantamount to performing the
print_stats() inside of yt.
This subcommand updates the yt installation to the most recent version for
your repository (e.g. stable, 2.0, development, etc.). Adding the
flag will update the dependencies as well.
Images are often worth a thousand words, so when you’re trying to
share a piece of code that generates an image, or you’re trying to
debug image-generation scripts, it can be useful to send your
co-authors a link to the image. This subcommand makes such sharing
a breeze. By specifying the image to share,
uploads it anonymously to the website imgur.com and
provides you with a link to share with your collaborators. Note that the
image must be in the PNG format in order to use this function.
yt hub command-line tool allows to interact with the yt hub. The following subcommands are currently available:
register Register a user on the yt Hub: http://hub.yt/ start Start the Jupyter Notebook on the yt Hub.
This subcommand starts an interactive process of creating an account on the yt hub. Please note that the yt Hub also supports multiple OAuth providers such as Google, Bitbucket and GitHub for authentication. See Obtaining an API key for more information.
This subcommand launches the Jupyter Notebook on the yt Hub
with a chosen Hub folder mounted to the
/data directory inside the notebook.
If no path is given all the example yt datasets are mounted by default. The appropriate URL
allowing to access the Notebook will be returned on the commandline.
$ yt hub start $ yt hub start /user/xarthisius/Public
This subcommand downloads a file from https://yt-project.org/data. Using
one can download a file to:
"test_data_dir": Save the file to the location specified in the
"test_data_dir"configuration entry for test data.
"supp_data_dir": Save the file to the location specified in the
"supp_data_dir"configuration entry for supplemental data.
Any valid path to a location on disk, e.g.
$ yt download apec_emissivity_v2.h5 supp_data_dir
$ yt download GasSloshing.tar.gz test_data_dir
$ yt download ZeldovichPancake.tar.gz /Users/jzuhone/workspace
If the configuration values
"supp_data_dir" have not
been set by the user, an error will be thrown.
yt config command-line tool allows you to modify and access yt’s
configuration without manually locating and opening the config file in an editor.
To get a quick list of available commands, just type:
yt config -h
This will print the list of available subcommands:
get get a config value set set a config value rm remove a config option list show the config content migrate migrate old config file
Since the yt version 3.3.2, the previous location of the configuration file
$HOME/.yt/config) has been deprecated in favor of a location adhering to the
XDG Base Directory Specification.
$XDG_HOME_CONFIG/yt/ytrc). In order to perform an automatic migration of
the old config, you are encouraged to run:
yt config migrate
that will copy your current config file to the new location and store a backup
Listing current content of the config file:
$ yt config list [yt] loglevel = 50
Obtaining a single config value by name:
$ yt config get yt loglevel 50
Changing a single config value:
$ yt config set yt loglevel 10
Removing a single config entry:
$ yt config rm yt loglevel