tangos

Tangos is a system for building and querying databases summarising the results of numerical galaxy simulations.

Learn more in the following categories:

View the Project on GitHub

Tangos Tutorial – Gadget+AHF

Initial set up

This tutorial imports a gadget-run simulation with an AHF halo catalogue and its associated merger tree information.

Make sure you have followed the initial set up instructions.

Then download the raw simulation data required for this tutorial. You need two files:

required for this tutorial.

Unpack both tar files either in your home folder or the folder that you pointed the TANGOS_SIMULATION_FOLDER environment variable to.

For most Linux or macOS systems, the following typed at your bash command line will download the required data and unpack it in the correct location:

cd $TANGOS_SIMULATION_FOLDER
curl https://zenodo.org/record/5155467/files/tutorial_gadget.tar.gz?download=1 | tar -xz
curl https://zenodo.org/record/5155467/files/tutorial_gadget_ahf.tar.gz?download=1 | tar -xz

Import the simulation

At the unix command line type:

tangos add tutorial_gadget_ahf --min-particles 100

The process should take about a minute on a standard modern computer, during which you’ll see a bunch of log messages scroll up the screen.

Let’s pick this command apart

Note that all tangos command-line tools provide help. For example tangos --help will show you all subcommands, and tangos add --help will tell you more about the possible options for adding a simulation.

At this point, the database knows about the existence of timesteps and their halos and groups in our simulation, but nothing about the properties of those halos or groups. We need to add more information before the database is useful.

If you want to speed up this process, it can be MPI parallelised since version 1.8.

Import AHF’s properties

At the unix command line type:

tangos import-properties Mvir Rvir Xc Yc Zc --for tutorial_gadget_ahf

The process should take about a minute on a standard modern computer, during which you’ll see a bunch of log messages scroll up the screen.

The example command line lists a few properties, Mvir, Rvir, Xc, Yc and Zc to import from the AHF AHF_halos files. The added directive --for tutorial_gadget_ahf specifies which simulation you want to apply this operation to. It’s not strictly necessary to add this if you only have one simulation in your database.

Import the merger trees

The merger trees can be imported from the AHF AHF_mtree files. Further information on how to create or handle the merger tree files with the codes from the AHF toolbox see AHF’s documentation. To import the merger trees type

tangos import-ahf-trees --for tutorial_gadget_ahf

Note that you can also use the built-in tree builder, as described in other tutorials such as the SubFind example. But compared to the default implementation, ahf trees has the significant runtime advantages.

Importing the merger tree should take a minute or so, and again you’ll see a log scroll up the screen while it happens.

Add some more interesting properties

Let’s finally do some science. We’ll add dark matter density profiles; from your shell type:

tangos write dm_density_profile --with-prerequisites --include-only="NDM()>5000" --type=halo --for tutorial_gadget_ahf

If you want to speed up this process, it can be MPI parallelised.

Here,

Explore what’s possible

Now that you have a minimal functioning tangos database, proceed to the data exploration tutorial.