External Data Assets for the holodeck Gravitational Wave Simulation Suite

Description This repository hosts the external binary data assets and cosmological simulation catalogs required by holodeck, a python package for simulating supermassive black hole binaries and calculating their nanohertz gravitational wave signals. To optimize repository size and improve installation efficiency, large binary files (including HDF5 simulation catalogs, NumPy arrays, and pickled torque matrices) have been offloaded from the main source tree. The holodeck package utilizes the pooch data-retrieval framework to automatically fetch, verify, and cache these assets on-demand from this Zenodo record. Included Files This dataset contains a structured set of files including: illustris/: Subsampled galaxy and supermassive black hole merger trees derived from the Illustris and IllustrisTNG cosmological hydrodynamic simulations (e.g., illustris-galaxy-mergers_L75n1820FP...hdf5) cbd_torques/: Pre-calculated circumbinary disk torque matrices used for binary eccentricity and semi-major axis evolution calculations (Siwek et al. 2023). preferential_accretion/: Mass-binned accretion data tables for eccentric binary systems (Siwek et al. 2022). observational_2mass_...npz: Galaxy catalogs afrom 2MASS. How to Use These files are managed automatically by the internal holodeck.data_manager sub-module. Users do not need to download these files manually. If a specific function or simulation population requires an asset, `holodeck` will seamlessly download the file, verify its cryptographic SHA256 checksum against its internal registry, and cache it locally in the user's hidden operating system cache directory (holodeck/data/). To manually override the download cache directory, users can set the HOLODECK_DATA_DIR environment variable in their terminal configuration.