Query outputs can be downloaded or transferred via Globus and opened with the OpenCosmo toolkit for further analysis.

Gravity-Only Simulation Queries

Gravity-only data products comprise dark matter halo catalogs with associated radial profiles and, for high-mass clusters, member particles. The available queries reduce these catalogs, in individual snapshots or on the lightcone, to the halos of interest and return the associated data.

Full-sky lightcone maps in HEALPix format, suitable for weak-lensing and related analyses, are also available. The map query returns maps over a chosen redshift range at a selectable output resolution.

Halo Lightcone Query (Gravity-Only)

Retrieves and filters halos from HACC gravity-only simulation lightcones within a chosen redshift range, with optional halo density profiles and member particles.

Supported simulations: Frontier-E (Gravity Only)

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Minimum Redshift (number): Minimum redshift.

  • Maximum redshift (number): Maximum redshift.

  • Limit (integer): Limit the number of halos returned (maximum 100 when particles are included). Default: 100000.

Schema rules:

  • When Include Particles is true, Limit has a maximum of 100.

Halo Query (Gravity-Only)

Retrieves and filters halos from HACC gravity-only simulation snapshots, with optional halo density profiles and member particles. For a sample of well-measured SOD halos, set minimum bounds c200c > 0 and M200c > 1.34e11; spherical-overdensity measurements are not guaranteed for low-mass FOF halos.

Supported simulations: Frontier-E (Gravity Only), SCIDAC 128 SG5 (Gravity Only), Last Journey, Discovery LCDM, Discovery w0wa

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Redshift (integer): Redshift slice to select halos from.

  • Limit (integer): Limit the number of halos returned. Default: 100000.

Schema rules:

  • When Include Particles (SOD) is true, Limit has a maximum of 100.

  • When Include Particles (FOF) is true, Limit has a maximum of 100.

Halo-Particles Query (Gravity)

Retrieves the properties and dark matter particles of halos selected by ID from HACC gravity-only simulations. Particle data is only available for high-mass halos (log10(M) > 13.5).

Supported simulations: Frontier-E (Gravity Only), SCIDAC 128 SG5 (Gravity Only)

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Redshift Slice (integer): Redshift slice to select halos from.

  • Halo IDs (array): List of halo tag IDs to retrieve particles for.

Map Query (Gravity-Only)

Retrieves full-sky lightcone maps in HEALPix format from HACC gravity-only simulations. Available map types include per-step density maps, stacked density shells, and CMB lensing maps, with selectable output resolution.

Supported simulations: Frontier-E (Gravity Only)

Required inputs:

  • Simulation (string): The simulation to select the maps from.

  • Map type (string): The type of map to retrieve.

  • Output Resolution (integer): Nside resolution for output map. Number of pixels scales like nside*nside.

Schema rules:

  • An additional schema rule applies; clients must enforce the schema below.

    {
      "if": {
        "properties": {
          "map_type": {
            "const": "density_slices"
          }
        },
        "required": [
          "map_type"
        ]
      },
      "then": {
        "properties": {
          "upper_slice": {
            "type": "string"
          }
        },
        "required": [
          "upper_slice"
        ]
      }
    }
    
  • An additional schema rule applies; clients must enforce the schema below.

    {
      "if": {
        "properties": {
          "map_type": {
            "const": "density"
          }
        },
        "required": [
          "map_type"
        ]
      },
      "then": {
        "properties": {
          "z_high": {
            "type": "number"
          },
          "z_low": {
            "type": "number"
          }
        },
        "required": [
          "z_low",
          "z_high"
        ]
      }
    }
    

Hydrodynamic Simulation Queries

Hydrodynamic simulation data includes halos, galaxies, and the dark matter, gas, star, and black hole particles associated with them. The available queries filter halo and galaxy catalogs and retrieve particle data from simulation snapshots and lightcones.

Galaxy Query

Retrieves and filters galaxies from HACC hydrodynamic simulation snapshots, with optional filters on galaxy properties and optional inclusion of host-halo information.

Supported simulations: Frontier-E, SCIDAC 128 SG5

Required inputs:

  • Simulation (string): The simulation to select the galaxies from.

  • Step (integer): Redshift slice to select galaxies from.

  • Limit (integer): Limit the number of galaxies returned. Default: 1000.

Halo Lightcone Query (Hydro)

Retrieves and filters halos from HACC hydrodynamic simulation lightcones within a chosen redshift range, with optional halo density profiles, member particles, and member galaxies.

Supported simulations: Frontier-E

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Minimum Redshift (number): Minimum redshift.

  • Maximum redshift (number): Maximum redshift.

  • Limit (integer): Limit the number of halos returned (maximum 100 when particles are included). Default: 100000.

Schema rules:

  • When Include Particles is true, Limit has a maximum of 100.

Halo Query (Hydro)

Retrieves and filters halos from HACC hydrodynamic simulation snapshots, with optional halo density profiles, member particles, and member galaxies.

Supported simulations: Frontier-E, SCIDAC 128 SG5

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Step (integer): Redshift slice to select halos from.

  • Limit (integer): Limit the number of halos returned (per simulation). Default: 1000.

Schema rules:

  • When Include Particles is true, Limit has a maximum of 100.

Halo-Particles Query (Hydro)

Retrieves the properties and particles (dark matter, gas, stars, and black holes) of halos selected by ID from HACC hydrodynamic simulations.

Supported simulations: Frontier-E, SCIDAC 128 SG5

Required inputs:

  • Simulation (string): The simulation to select the halos from.

  • Redshift (integer): Redshift slice to select halos from.

  • Halo IDs (array): List of halo tag IDs to retrieve particles for.

Synthetic Galaxy Catalog Queries

Synthetic galaxy catalog data currently consists of in-development Diffsky mocks generated from Last Journey halo mass-assembly histories. The available query filters catalogs by redshift and galaxy properties and returns the selected galaxies.

Diffsky Synthetic Galaxy Query

Retrieves and filters catalogs of synthetic galaxies produced with Diffsky, with selections on redshift and galaxy properties.

Supported simulations: Diffsky

Required inputs:

  • Simulation (string): The synthetic galaxy simulation to query.

  • Calibration (string): The calibration dataset.

  • Redshift lower bound (number): Only include galaxies with redshifts above this value. Default: 0.05.

  • Redshift upper bound (number): Only include galaxies with redshifts below this value. Default: 0.2.

  • Limit (integer): Limit the number of galaxies returned. Default: 100000.

  • Include Synthetic Cores (boolean): Include low-mass synthetic cores (if available for the given calibration). Default: false.

Visualization

Visualization tasks select simulation structures and generate ready-to-view scientific previews alongside reusable query outputs.

Visualize Halo

Selects a halo from a hydrodynamic HACC simulation and generates particle-projection previews plus a reusable Parquet result.

Supported simulations: Frontier-E, SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Hydrodynamic simulation containing the halo catalog and particles.

  • Step (integer): Simulation step containing the halo to visualize.

  • Halo Selection (string): Method used to select one halo. Default: Random massive halo. Options: Random massive halo, High-offset merger candidate, Gas-rich massive halo, Star-rich massive halo, X-ray-luminous massive halo, Select by halo ID.

Schema rules:

  • An additional schema rule applies; clients must enforce the schema below.

    {
      "else": {
        "not": {
          "required": [
            "tag"
          ]
        }
      },
      "if": {
        "properties": {
          "halo_type": {
            "const": "custom"
          }
        },
        "required": [
          "halo_type"
        ]
      },
      "then": {
        "required": [
          "tag"
        ]
      }
    }
    

Prepackaged Analysis

The portal provides a number of prepackaged analysis modules from the HAvoCC framework (HACC Analysis and Validation to Observational Constraints Code) that run with customizable parameters. Each module produces a figure, in many cases with comparisons to published simulation and observational results, and in most cases the plotted values can also be returned as tabulated data. Details of each analysis (mass bins, axis ranges, etc.) are set through parameters in the input form. A finished analysis provides a downloadable zip archive containing the plots and tabulated data.

Precise definitions of the computed quantities, binning conventions, and available comparison datasets are given in the HAvoCC module documentation.

Black Hole Mass - Stellar Mass Relation

Calculates the black hole mass - stellar mass relation (MBH vs. Mstar).

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

Cluster Profiles

Calculates stacked radial cluster profiles of density (dark matter, gas, stellar, and total), electron density, entropy, metallicity, pressure, temperature, and YSZ, with radii normalized by R500c.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

Concentration-Mass Relation

Calculates the concentration-mass relation (c200c vs. M200c), with optional filtering of unrelaxed halos.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

Galaxy Stellar Mass Function

Calculates the galaxy stellar mass function.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

Halo Mass Function

Calculates the halo mass function for a given halo mass range and definition (e.g. M200c, M500c).

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

M500 Mass Scalings

Calculates MGas, MStar, MGas,2500c, and mass fractions versus M500c scaling relations.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

Stellar Mass - Halo Mass Relation

Calculates central-galaxy stellar mass versus halo mass (Mstar-Mhalo and Mstar/Mhalo vs. Mhalo relations).

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

X-ray - M500 Scalings

Calculates LX, TX, and YX versus M500 and MGas,500 scaling relations; LX and TX are computed both with and without the core excised.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.

YSZ - M500 Scalings

Calculates YSZ versus M500 and MGas,500 scaling relations, including YSZ integrated out to 5R500 versus M500.

Supported simulations: SCIDAC 128 SG5

Required inputs:

  • Simulation (string): Choose the simulation from which to select the halo.

  • Step (integer): Analysis Step of the simulation.