Skip to main content

Python and C/C++ code to read halo catalogs and other Abacus N-body data products

Project description


Abacus Logo

Documentation Status PyPI Tests

abacusutils is a package for reading and manipulating data products from the Abacus N-body project. In particular, these utilities are intended for use with the AbacusSummit suite of simulations. We provide multiple interfaces: primarily Python 3, but also C/C++ [coming soon!] and language-agnostic interfaces like Unix pipes.

These interfaces are documented here:

Press the GitHub "Watch" button in the top right and select "Custom->Releases" to be notified about bug fixes and new features! This package is still in early stages, and bugs are likely to be identified and squashed, and new performance opportunities identified.


The Python abacusutils package is hosted on PyPI and can be installed by installing "abacusutils":

pip install abacusutils

The Unix pipe interface (pipe_asdf) is also installed as part of the pip install. Note that our custom ASDF fork is no longer required as of abacusutils 1.0.0.

The C/C++ code (coming soon!) can be downloaded directly by cloning this repository:

git clone

or by downloading a zip archive of the repository:



abacusutils has multiple interfaces, summarized here and at

Specific examples of how to use abacusutils to work with AbacusSummit data will soon be given at the AbacusSummit website:


The abacusutils PyPI package contains a Python package called abacusnbody. This is the name to import (not abacusutils, which is just the name of the PyPI package). For example, to import the compaso_halo_catalog module, use


Unix Pipes

The pipe_asdf Python script reads columns from ASDF files and pipes them to stdout. For example:

    $ pipe_asdf halo_info_000.asdf -f N -f x_com | ./client

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

abacusutils-1.3.0.tar.gz (7.6 MB view hashes)

Uploaded source

Built Distribution

abacusutils-1.3.0-py3-none-any.whl (1.2 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page