/******************************************************************************* * This file is part of SWIFT. * Copyright (c) 2017 Matthieu Schaller (matthieu.schaller@durham.ac.uk) * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published * by the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with this program. If not, see . * ******************************************************************************/ #ifndef SWIFT_COLIBRE_TABLES_H #define SWIFT_COLIBRE_TABLES_H /** * @file src/cooling/CHIMES/colibre_tables.h * @brief COLIBRE cooling tables */ /* Config parameters. */ #include /* Some standard headers. */ #include #include /* Local includes. */ #include "./chimes/src/chimes_proto.h" #include "align.h" #include "chemistry_struct.h" #include "error.h" #include "inline.h" #define colibre_table_path_name_length 500 #define colibre_table_filebase_length 30 /** * @brief struct containing cooling tables */ struct colibre_cooling_tables { /*! Filepath to the directory containing the HDF5 cooling tables */ char cooling_table_path[colibre_table_path_name_length]; /* Filebase of the split HDF5 cooling tables */ char cooling_table_filebase[colibre_table_filebase_length]; /* array of all cooling processes (temperature) */ float *Tcooling; /* Reduced array of cooling processes (temperature) */ float *Tcooling_reduced; /* array of all heating processes (temperature) */ float *Theating; /* Reduced array of heating processes (temperature) */ float *Theating_reduced; /* array of all electron abundances (temperature) */ float *Telectron_fraction; /*! Number of redshifts */ int number_of_redshifts; /*! Redshift bins */ float *Redshifts; /*! Hydrogen number density bins */ float *nH; /*! Temperature bins */ float *Temp; /*! Metallicity bins */ float *Metallicity; /*! Abundance ratios for each metallicity bin and for each included element */ float *LogAbundances; float *Abundances; float *Abundances_inv; /*! Atomic masses for all included elements */ float *atomicmass; float *atomicmass_inv; /*! Mass fractions of all included elements */ float *LogMassFractions; float *MassFractions; /*! Index for solar metallicity in the metallicity dimension */ int indxZsol; /*! Solar metallicity (metal mass fraction) */ float *Zsol; /*! Inverse of solar metallicity (metal mass fraction) */ float *Zsol_inv; /*! Ca over Si abundance divided by the solar ratio for these elements */ float Ca_over_Si_ratio_in_solar; /*! S over Si abundance divided by the solar ratio for these elements */ float S_over_Si_ratio_in_solar; /*! Logarithm base 10 of the Boltzmann constant in CGS (for quick access) */ double log10_kB_cgs; /*! Internal energy conversion from internal units to CGS (for quick access) * */ double internal_energy_to_cgs; /*! Internal energy conversion from CGS to internal units (for quick access) * */ double internal_energy_from_cgs; /*! Pressure conversion from internal units to CGS (for quick access) */ double pressure_to_cgs; /*! Number density conversion from internal units to CGS (for quick access) */ double number_density_to_cgs; /*! Number density conversion from CGS to internal units (for quick access) */ double number_density_from_cgs; /*! Minimal internal energy in cgs allowed for the gas particles */ double umin_cgs; /*! Inverse of proton mass in cgs (for quick access) */ double inv_proton_mass_cgs; /*! Proton mass in cgs (for quick access) */ double proton_mass_cgs; /*! Density conversion from internal units to CGS (for quick access) */ double density_to_cgs; /*! Density conversion from CGS to internal units (for quick access) */ double density_from_cgs; /* array of equilibrium temperatures */ float *logTeq; /* array of mean particle masses at equilibrium temperatures */ float *meanpartmass_Teq; /* array of pressures at equilibrium temperatures */ float *logPeq; /*! Index of the current redshift along the redshift index of the tables */ int z_index; /*! Distance between the current redshift and table[z_index] */ float dz; /*! Index of the previous tables along the redshift index of the tables */ int previous_z_index; }; /*! Number of different bins along the temperature axis of the tables */ #define colibre_cooling_N_temperature 86 /*! Number of redshift bins loaded at any given point in time */ #define colibre_cooling_N_loaded_redshifts 2 /*! Number of different bins along the density axis of the tables */ #define colibre_cooling_N_density 71 /*! Number of different bins along the metallicity axis of the tables */ #define colibre_cooling_N_metallicity 11 /*! Number of different cooling channels in the tables */ #define colibre_cooling_N_cooltypes 22 /*! Number of different heating channels in the tables */ #define colibre_cooling_N_heattypes 24 /*! Number of different electron fractions (each element - other atoms * + tot prim + tot metal + tot) in the tables */ #define colibre_cooling_N_electrontypes 14 /*! Number of different elements in the tables */ #define colibre_cooling_N_elementtypes 12 /*! Number of different cooling channels in the reduced tables */ #define colibre_reduced_cooling_N_cooltypes 11 /*! Number of different heating channels in the reduced tables */ #define colibre_reduced_cooling_N_heattypes 10 /*! Number of different elements in the reduced tables */ #define colibre_reduced_cooling_N_elementtypes 9 /** * @brief Subgrid properties to calculate */ enum colibre_subgrid_properties { colibre_compute_subgrid_density, colibre_compute_subgrid_temperature, }; /** * @brief Elements present in the tables */ enum colibre_cooling_element { element_H, element_He, element_C, element_N, element_O, element_Ne, element_Mg, element_Si, element_S, element_Ca, element_Fe, element_OA }; /** * @brief Hydrogen species */ enum colibre_hydrogen_species { neutral, ionized, molecular }; /** * @brief Cooling channels beyond the metal lines */ enum colibre_cooling_channels { cooltype_H2 = element_OA + 1, cooltype_molecules, cooltype_HD, cooltype_NetFFH, cooltype_NetFFM, cooltype_eeBrems, cooltype_Compton, cooltype_Dust }; /** * @brief Cooling channels in the reduced tables */ enum colibre_reduced_cooling_channels { reduced_cooltype_C, reduced_cooltype_N, reduced_cooltype_O, reduced_cooltype_Ne, reduced_cooltype_Mg, reduced_cooltype_Si, reduced_cooltype_S, reduced_cooltype_Ca, reduced_cooltype_Fe, reduced_cooltype_eeBrems, reduced_cooltype_other }; /** * @brief Heating channels beyond the metal lines */ enum colibre_heating_channels { heattype_H2 = element_OA + 1, heattype_COdiss, heattype_CosmicRay, heattype_UTA, heattype_line, heattype_Hlin, heattype_ChaT, heattype_HFF, heattype_Compton, heattype_Dust }; /** * @brief Heating channels in the reduced tables */ enum colibre_reduced_heating_channels { reduced_heattype_C, reduced_heattype_N, reduced_heattype_O, reduced_heattype_Ne, reduced_heattype_Mg, reduced_heattype_Si, reduced_heattype_S, reduced_heattype_Ca, reduced_heattype_Fe, reduced_heattype_other }; void get_cooling_redshifts(struct colibre_cooling_tables *table); void read_cooling_header( const char *fname, struct colibre_cooling_tables *table /*, struct dustevo_props *dp */); void allocate_cooling_tables(struct colibre_cooling_tables *table); void get_cooling_table(struct colibre_cooling_tables *table, const int low_z_index, const int high_z_index, float *log_depletion_fractions, int do_dust_pairing); /** * @brief Returns the 1d index of element with 2d indices x,y * from a flattened 2d array in row major order * * @param x, y Indices of element of interest * @param Nx, Ny Sizes of array dimensions */ __attribute__((always_inline)) INLINE int cooling_row_major_index_2d( const int x, const int y, const int Nx, const int Ny) { #ifdef SWIFT_DEBUG_CHECKS assert(x < Nx); assert(y < Ny); #endif return x * Ny + y; } /** * @brief Returns the 1d index of element with 3d indices x,y,z * from a flattened 3d array in row major order * * @param x, y, z Indices of element of interest * @param Nx, Ny, Nz Sizes of array dimensions */ __attribute__((always_inline)) INLINE int cooling_row_major_index_3d( const int x, const int y, const int z, const int Nx, const int Ny, const int Nz) { #ifdef SWIFT_DEBUG_CHECKS assert(x < Nx); assert(y < Ny); assert(z < Nz); #endif return x * Ny * Nz + y * Nz + z; } /** * @brief Returns the 1d index of element with 4d indices x,y,z,w * from a flattened 4d array in row major order * * @param x, y, z, w Indices of element of interest * @param Nx, Ny, Nz, Nw Sizes of array dimensions */ __attribute__((always_inline)) INLINE int cooling_row_major_index_4d( const int x, const int y, const int z, const int w, const int Nx, const int Ny, const int Nz, const int Nw) { #ifdef SWIFT_DEBUG_CHECKS assert(x < Nx); assert(y < Ny); assert(z < Nz); assert(w < Nw); #endif return x * Ny * Nz * Nw + y * Nz * Nw + z * Nw + w; } /** * @brief Returns the 1d index of element with 5d indices x,y,z,w * from a flattened 5d array in row major order * * @param x, y, z, v, w Indices of element of interest * @param Nx, Ny, Nz, Nv, Nw Sizes of array dimensions */ __attribute__((always_inline)) INLINE int cooling_row_major_index_5d( const int x, const int y, const int z, const int w, const int v, const int Nx, const int Ny, const int Nz, const int Nw, const int Nv) { #ifdef SWIFT_DEBUG_CHECKS assert(x < Nx); assert(y < Ny); assert(z < Nz); assert(w < Nw); assert(v < Nv); #endif return x * Ny * Nz * Nw * Nv + y * Nz * Nw * Nv + z * Nw * Nv + w * Nv + v; } /** * @brief Finds the index of a value in a table and compute delta to nearest * element. * * This function assumes the table is monotonically increasing with a constant * difference between adjacent values. * * The returned difference is expressed in units of the table separation. This * means dx = (x - table[i]) / (table[i+1] - table[i]). It is always between * 0 and 1. * * We use a small epsilon of 1e-4 to avoid out-of-range accesses due to * rounding errors. * * @param table The table to search in. * @param size The number of elements in the table. * @param x The value to search for. * @param i (return) The index in the table of the element. * @param *dx (return) The difference between x and table[i] */ __attribute__((always_inline)) INLINE void cooling_get_index_1d( const float *restrict table, const int size, const float x, int *i, float *restrict dx) { /* Small epsilon to avoid rounding issues leading to out-of-bound * access when using the indices later to read data from the tables. */ const float epsilon = 1e-4f; /* Indicate that the whole array is aligned on boundaries */ swift_align_information(float, table, SWIFT_STRUCT_ALIGNMENT); /* Distance between elements in the array */ /* Do not use first or last entry, might be an extra bin with uneven spacing */ const float delta = (size - 3) / (table[size - 2] - table[1]); /* Check for an extra entry at the beginning (e.g. metallicity) */ int istart = 0; int iend = size - 1; if (fabsf(table[1] - table[0]) > delta + epsilon) { istart = 1; } if (fabsf(table[size - 1] - table[size - 2]) > delta + epsilon) { iend = size - 2; } /*extra array at the beginning */ if (x < table[istart] + epsilon) { /* We are before the first element */ *i = 0; *dx = 0.f; } else if (x < table[iend] - epsilon) { *i = (x - table[1]) * delta + 1; *dx = (x - table[*i]) * delta; } else { /* We are after the last element */ *i = iend - 1; *dx = 1.f; } #ifdef SWIFT_DEBUG_CHECKS if (*dx < -0.001f || *dx > 1.001f) error("Invalid distance found dx=%e", *dx); #endif } /** * @brief Interpolate a flattened 3D table at a given position. * * This function uses linear interpolation along each axis. It also * assumes that the table is aligned on SWIFT_STRUCT_ALIGNMENT. * * @param table The 3D table to interpolate. * @param xi, yi, zi Indices of element of interest. * @param Nx, Ny, Nz Sizes of array dimensions. * @param dx, dy, dz Distance between the point and the index in units of * the grid spacing. */ __attribute__((always_inline)) INLINE float interpolation_3d( const float *table, const int xi, const int yi, const int zi, const float dx, const float dy, const float dz, const int Nx, const int Ny, const int Nz) { #ifdef SWIFT_DEBUG_CHECKS if (dx < -0.001f || dx > 1.001f) error("Invalid dx=%e", dx); if (dy < -0.001f || dy > 1.001f) error("Invalid dy=%e", dy); if (dz < -0.001f || dz > 1.001f) error("Invalid dz=%e", dz); #endif const float tx = 1.f - dx; const float ty = 1.f - dy; const float tz = 1.f - dz; /* Indicate that the whole array is aligned on page boundaries */ swift_align_information(float, table, SWIFT_STRUCT_ALIGNMENT); /* Linear interpolation along each axis. We read the table 2^3=8 times */ float result = tx * ty * tz * table[cooling_row_major_index_3d(xi + 0, yi + 0, zi + 0, Nx, Ny, Nz)]; result += tx * ty * dz * table[cooling_row_major_index_3d(xi + 0, yi + 0, zi + 1, Nx, Ny, Nz)]; result += tx * dy * tz * table[cooling_row_major_index_3d(xi + 0, yi + 1, zi + 0, Nx, Ny, Nz)]; result += dx * ty * tz * table[cooling_row_major_index_3d(xi + 1, yi + 0, zi + 0, Nx, Ny, Nz)]; result += tx * dy * dz * table[cooling_row_major_index_3d(xi + 0, yi + 1, zi + 1, Nx, Ny, Nz)]; result += dx * ty * dz * table[cooling_row_major_index_3d(xi + 1, yi + 0, zi + 1, Nx, Ny, Nz)]; result += dx * dy * tz * table[cooling_row_major_index_3d(xi + 1, yi + 1, zi + 0, Nx, Ny, Nz)]; result += dx * dy * dz * table[cooling_row_major_index_3d(xi + 1, yi + 1, zi + 1, Nx, Ny, Nz)]; return result; } /** * @brief Interpolate a flattened 3D table at a given position but avoid the * z-dimension. * * This function uses linear interpolation along each axis. * We look at the zi coordoniate but do not interpolate around it. We just * interpolate the remaining 2 dimensions. * The function also assumes that the table is aligned on * SWIFT_STRUCT_ALIGNMENT. * * @param table The 3D table to interpolate. * @param xi, yi, zi Indices of element of interest. * @param Nx, Ny, Nz Sizes of array dimensions. * @param dx, dy, dz Distance between the point and the index in units of * the grid spacing. */ __attribute__((always_inline)) INLINE float interpolation_3d_no_z( const float *table, const int xi, const int yi, const int zi, const float dx, const float dy, const float dz, const int Nx, const int Ny, const int Nz) { #ifdef SWIFT_DEBUG_CHECKS if (dx < -0.001f || dx > 1.001f) error("Invalid dx=%e", dx); if (dy < -0.001f || dy > 1.001f) error("Invalid dy=%e", dy); if (dz != 0.f) error("Attempting to interpolate along z!"); #endif const float tx = 1.f - dx; const float ty = 1.f - dy; const float tz = 1.f; /* Indicate that the whole array is aligned on page boundaries */ swift_align_information(float, table, SWIFT_STRUCT_ALIGNMENT); /* Linear interpolation along each axis. We read the table 2^2=4 times */ /* Note that we intentionally kept the table access along the axis where */ /* we do not interpolate as comments in the code to allow readers to */ /* understand what is going on. */ float result = tx * ty * tz * table[cooling_row_major_index_3d(xi + 0, yi + 0, zi + 0, Nx, Ny, Nz)]; /* result += tx * ty * dz * table[row_major_index_3d(xi + 0, yi + 0, zi + 1, Nx, Ny, Nz)]; */ result += tx * dy * tz * table[cooling_row_major_index_3d(xi + 0, yi + 1, zi + 0, Nx, Ny, Nz)]; result += dx * ty * tz * table[cooling_row_major_index_3d(xi + 1, yi + 0, zi + 0, Nx, Ny, Nz)]; /* result += tx * dy * dz * table[cooling_row_major_index_3d(xi + 0, yi + 1, zi + 1, Nx, Ny, Nz)]; */ /* result += dx * ty * dz * table[cooling_row_major_index_3d(xi + 1, yi + 0, zi + 1, Nx, Ny, Nz)]; */ result += dx * dy * tz * table[cooling_row_major_index_3d(xi + 1, yi + 1, zi + 0, Nx, Ny, Nz)]; /* result += dx * dy * dz * table[cooling_row_major_index_3d(xi + 1, yi + 1, zi + 1, Nx, Ny, Nz)]; */ return result; } /** * @brief Interpolates a 5 dimensional array in the 2nd, 3rd and 4th dimensions, * with the 1st dimension fixed, and adds the individual contributions from the * 5th dimension according to their weights. * * @param table The table to interpolate * @param weights The weights for summing up the individual contributions * @param istart, iend Start and stop index for 5th dimension * @param xi, yi, zi, wi Indices of table element * @param dx, dy, dz, dw Distance between the point and the index in units of * the grid spacing. * @param Nx, Ny, Nz, Nw, Nv Sizes of array dimensions */ __attribute__((always_inline)) INLINE float interpolation3d_fix_x_plus_summation(const float *table, const float *weights, const int istart, const int iend, const int xi, const int yi, const int zi, const int wi, const float dy, const float dz, const float dw, const int Nx, const int Ny, const int Nz, const int Nw, const int Nv) { const float ty = 1.f - dy; const float tz = 1.f - dz; const float tw = 1.f - dw; float result; float result_global = 0.; for (int i = istart; i <= iend; i++) { if (weights[i] > 0.0) { /* Linear interpolation along each axis. We read the table 2^3=8 times */ result = ty * tz * tw * table[cooling_row_major_index_5d(xi, yi, zi, wi, i, Nx, Ny, Nz, Nw, Nv)]; result += ty * tz * dw * table[cooling_row_major_index_5d(xi, yi, zi, wi + 1, i, Nx, Ny, Nz, Nw, Nv)]; result += ty * dz * tw * table[cooling_row_major_index_5d(xi, yi, zi + 1, wi, i, Nx, Ny, Nz, Nw, Nv)]; result += ty * dz * dw * table[cooling_row_major_index_5d(xi, yi, zi + 1, wi + 1, i, Nx, Ny, Nz, Nw, Nv)]; result += dy * tz * tw * table[cooling_row_major_index_5d(xi, yi + 1, zi, wi, i, Nx, Ny, Nz, Nw, Nv)]; result += dy * tz * dw * table[cooling_row_major_index_5d(xi, yi + 1, zi, wi + 1, i, Nx, Ny, Nz, Nw, Nv)]; result += dy * dz * tw * table[cooling_row_major_index_5d(xi, yi + 1, zi + 1, wi, i, Nx, Ny, Nz, Nw, Nv)]; result += dy * dz * dw * table[cooling_row_major_index_5d(xi, yi + 1, zi + 1, wi + 1, i, Nx, Ny, Nz, Nw, Nv)]; result_global += weights[i] * exp10f(result); } } return result_global; } /** * @brief Returns the element index of the particle-carried chemistry field * corresponding to a given cooling element. */ __attribute__((always_inline)) INLINE int element_from_table_to_code( const enum colibre_cooling_element i) { #ifdef SWIFT_DEBUG_CHECKS if ((i >= colibre_cooling_N_elementtypes) || (i < 0)) error("Outside range of elements in cooling tables"); #endif switch (i) { case element_H: return chemistry_element_H; case element_He: return chemistry_element_He; case element_C: return chemistry_element_C; case element_N: return chemistry_element_N; case element_O: return chemistry_element_O; case element_Ne: return chemistry_element_Ne; case element_Mg: return chemistry_element_Mg; case element_Si: return chemistry_element_Si; /* S and Ca are not tracked individually; their abundance is * assumed to be the same as Si (with respect to solar) */ case element_S: return chemistry_element_Si; case element_Ca: return chemistry_element_Si; case element_Fe: return chemistry_element_Fe; /* other elements, if used, scale with metallicity */ case element_OA: return -1; } return -1; } struct global_hybrid_data_struct { struct colibre_cooling_tables *table; float Zsol; }; struct gas_hybrid_data_struct { float abundance_ratio[colibre_cooling_N_elementtypes]; }; ChimesFloat colibre_metal_cooling_rate_temperature( struct gasVariables *myGasVars, const struct globalVariables *myGlobalVars); void chimes_allocate_gas_hybrid_data(struct gasVariables *myGasVars); void chimes_free_gas_hybrid_data(struct gasVariables *myGasVars); #endif