MPI-Rockstar Documentation

MPI-Rockstar is a massively parallel halo finder based on the Rockstar phase-space temporal halo finder code, which is one of the most extensively used halo finding codes. Compared to the original code, parallelized by a primitive socket communication library, we parallelized it in a hybrid way using MPI and OpenMP, which is suitable for analysis on the hybrid shared and distributed memory environments of modern supercomputers. This implementation can easily handle the analysis of more than a trillion particles on more than 100,000 parallel processes, enabling the production of a huge dataset for the next generation of cosmological surveys. As new functions to the original Rockstar code, MPI-Rockstar supports HDF5 as an output format and can output additional halo properties such as the inertia tensor.

Most of functions provided in the original Rockstar can be used in MPI-Rockstar as they are.

Contents:

• Get Started
  • Requirements and Dependencies
  • Compiling and Running
  • Test Dataset
  • Abolished Configuration options from the Original Rockstar
  • Performance Tips
• MPI-Rockstar - Autotools Build Guide
  • Requirements and Dependencies
  • File Layout
  • Build Instructions
    • Basic Build (out-of-tree build recommended)
    • Build with HDF5 Support
    • Adding optimization flags via CFLAGS / CXXFLAGS (set at configure time)
  • configure Options
    • New Compiling Options
    • HDF5 Options
    • Enabling Multiple Options at Once
  • make install
  • Generated Binaries and Libraries
  • Cleaning the Build
  • Troubleshooting
    • u_int undefined error (tirpc)
    • OpenMP not found
    • HDF5 not found
• More Complete Setup
  • Input
    • File Type
    • Gadget-2/3/4 and AREPO HDF5 Format
    • File Name, Number of Files
    • Sub-Directory for Input (if necessary)
  • Output
    • Halo Properties
    • File Format
    • Sub-Directory for Output (if necessary)
    • Output Threshold
    • Output Full Particle Information
  • Merger Trees
  • Host / Subhalo Relationships
  • Lightcones
• New Features to the Original Rockstar
• Options from the Original Rockstar
  • Commonly-Used Options
  • Rarely-used Options
  • Extending Rockstar
    • Adding More Configuration Parameters
    • Adding More Input Formats
    • Adding More Output Formats
    • Adding More Halo Properties
• Building as a Library and Python wrapper
  • Building as a Library
  • Python wrapper pympirockstar
    • Prerequisites
    • Installation
• Policy