Field Names and Descriptions
COLT aims to have short but intuitive names for its internal fields. This page provides a list of internal fields along with brief descriptions, units, and notes that might be helpful to remember for users or developers. Many fields are optional and only allocated when necessary and most can be used wih the projections module.
Gas Fields
n_cells– Number of cells \(n_\text{cells}\). In general, gas fields are arrays with this many elements.r– Position coordinates \((x,y,z)\). Each geometry may interpret this differently. [Units: cm]V– Cell volume \(V\). [Units: cm^3]v– Bulk velocity \((v_x,v_y,v_z)\). [Units: cm/s]dvdr– Bulk velocity gradient \(\text{d}v/\text{d}r\). [Units: 1/s]v0– Velocity extrapolation \(v_0 = v - r \nabla v\). [Units: cm/s]rho– Gas density \(\rho\). [Units: g/cm^3]T– Temperature \(T\). [Units: K]e_int– Internal energy \(e_\text{int}\). [Units: cm^2/s^2]n_H– Hydrogen number density \(n_\text{H}\). [Units: cm^-3]n_He– Helium number density \(n_\text{He}\). [Units: cm^-3]n_C– Carbon number density \(n_\text{C}\). [Units: cm^-3]n_N– Nitrogen number density \(n_\text{N}\). [Units: cm^-3]n_O– Oxygen number density \(n_\text{O}\). [Units: cm^-3]n_Ne– Neon number density \(n_\text{Ne}\). [Units: cm^-3]n_Mg– Magnesium number density \(n_\text{Mg}\). [Units: cm^-3]n_Si– Silicon number density \(n_\text{Si}\). [Units: cm^-3]n_S– Sulfer number density \(n_\text{S}\). [Units: cm^-3]n_Fe– Iron number density \(n_\text{Fe}\). [Units: cm^-3]n_upperandn_lower– Number density of the upper and lower transitions of a two-level atom \(n_\text{upper}\) and \(n_\text{lower}\). [Units: cm^-3]x_HIandx_HII– Hydrogen ionization fractions for neutral and ionized gas (\(x_\text{HI} = n_\text{HI} / n_\text{H}\)). There are also ionized fractions for metal number densities under the convention that each is normalized to unity for the given species, e.g. for helium (\(x_\text{HeI} = n_\text{HeI} / n_\text{He}\)) [Units: mass fraction]x_H2– Molecular hydrogen mass fraction (\(x_\text{H_2} = n_\text{H_2} / n_\text{H}\)). [Units: cm^-3]x_e– Electron abundance relative to hydrogen (\(x_e = n_e / n_\text{H}\)). [Units: cm^-3]G_ion– Total photoheating rate \(\Gamma_\text{ion}\). [Units: erg/s]SFR– Star formation rate. [Units: Msun/yr]T_dust– Dust temperature \(T_\text{dust}\). [Units: K]v2– Velocity squared \(v^2\). [Units: cm^2/^2]v2_LOS– Line-of-sght velocity squared \(v_\text{LOS}^2\). [Units: cm^2/s^2]v_LOS– Line-of-sght velocity \(v_\text{LOS}\). [Units: cm/s]v_x– Velocity in the camera x-axis direction \(v_x\). [Units: cm/s]v_y– Velocity in the camera y-axis direction \(v_y\). [Units: cm/s]B– Magnetic field \(B\). [Units: Gauss]B2– Magnetic field squared \(B^2\). [Units: Gauss^2]B_LOS– Line-of-sight magnetic field \(B_\text{LOS}\). [Units: Gauss]B_x– Magnetic field in the camera x-axis direction \(B_x\). [Units: cm/s]B_y– Magnetic field in the camera y-axis direction \(B_y\). [Units: cm/s]X– Mass fraction of hydrogen \(X = \rho_\text{H} / \rho\). [Units: mass fraction]Y– Mass fraction of helium \(Y = \rho_\text{He} / \rho\). [Units: mass fraction]Z– Gas metallicity \(Z = \rho_Z / \rho\). [Units: mass fraction]Z_C– Carbon metallicity \(Z_\text{C} = \rho_\text{C} / \rho\). [Units: mass fraction]Z_N– Nitrogen metallicity \(Z_\text{N} = \rho_\text{N} / \rho\). [Units: mass fraction]Z_O– Oxygen metallicity \(Z_\text{O} = \rho_\text{O} / \rho\). [Units: mass fraction]Z_Ne– Neon metallicity \(Z_\text{Ne} = \rho_\text{Ne} / \rho\). [Units: mass fraction]Z_Mg– Magnesium metallicity \(Z_\text{Mg} = \rho_\text{Mg} / \rho\). [Units: mass fraction]Z_Si– Silicon metallicity \(Z_\text{Si} = \rho_\text{Si} / \rho\). [Units: mass fraction]Z_S– Sulfer metallicity \(Z_\text{S} = \rho_\text{S} / \rho\). [Units: mass fraction]Z_Fe– Iron metallicity \(Z_\text{Fe} = \rho_\text{Fe} / \rho\). [Units: mass fraction]D– Dust-to-gas ratio \(\mathcal{D} = \rho_\text{dust} / \rho\). [Units: mass fraction]D_S– Silicate dust-to-gas ratio \(\mathcal{D}_\text{Si} = \rho_\text{dust,Si} / \rho\). [Units: mass fraction]D_PAH– PAH dust-to-gas ratio \(\mathcal{D}_\text{PAH} = \rho_\text{dust,PAH} / \rho\). [Units: mass fraction]k_e– Absorption coefficient of electrons \(k_e\). [Units: 1/cm]k_0– Absorption coefficient of primary line \(k_0\). [Units: 1/cm]kp_0– Absorption coefficient of doublet line \(k'_0\). [Units: 1/cm]k_dust– Absorption coefficient of dust \(k_\text{dust}\). [Units: 1/cm]k_dust_scat_G– Scattering coefficient of graphite dust \(k_\text{dust,G}^\text{scat}\). [Units: 1/cm]k_dust_scat_S– Scattering coefficient of silicate dust \(k_\text{dust,S}^\text{scat}\). [Units: 1/cm]k_dust_scat_PAH– Scattering coefficient of PAH dust \(k_\text{dust,PAH}^\text{scat}\). [Units: 1/cm]rho_dust– Dust density \(\rho_\text{dust}\). [Units: g/cm^3]rho_dust_G– Graphite dust density \(\rho_\text{dust,G}\). [Units: g/cm^3]rho_dust_S– Silicate dust density \(\rho_\text{dust,S}\). [Units: g/cm^3]rho_dust_PAH– PAH dust density \(\rho_\text{dust,PAH}\). [Units: g/cm^3]a– Damping parameter for the Voigt function \(a\). [Units: None]atau– Nonlocal estimate of \(a\tau_0\) for each cell. [Units: None]j_line– Primary line emissivity \(j\). [Units: erg/s/cm^3]jp_line– Doublet line emissivity \(j'\). [Units: erg/s/cm^3]u_rad– Path-based radiation energy density \(u_\text{rad}\). [Units: erg/cm^3]a_rad_path– Path-based acceleration due to radiation pressure \(a_\text{rad}\). [Units: cm/s^2]a_rad_scat– Scattering-based acceleration due to radiation pressure \(a_\text{rad,scat}\). [Units: cm/s^2]u_rad_r– Path-based radiation energy density \(u_\text{rad}\) (spherical and cylindrical coordinates). [Units: erg/cm^3]u_rad_r_e2– Path-based sum of squared event-level contributions to the radiation energy density \(\sum_\text{events}(\Delta u_\text{rad})^2\) (spherical coordinates). [Units: erg^2/cm^6]a_rad_r_path– Path-based acceleration due to radiation pressure in the radial direction \(a_\text{rad}\) (spherical and cylindrical coordinates). [Units: cm/s^2]a_rad_r_path_e2– Path-based sum of squared event-level contributions to the radiation-pressure acceleration in the radial direction \(\sum_\text{events}(\Delta a_\text{rad})^2\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_path_cm– Path-based radial acceleration cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_path_cov– Path-based radial acceleration covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_scat– Scattering-based acceleration due to radiation pressure in the radial direction \(a_\text{rad,scat}\) (spherical coordinates). [Units: cm/s^2]a_rad_r_scat_e2– Sum of squared event-level contributions to the scattering-based radiation-pressure acceleration in the radial direction \(\sum_\text{events}(\Delta a_\text{rad,scat})^2\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_scat_cm– Scattering-based radial acceleration cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_scat_cov– Scattering-based radial acceleration covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]F_rad_r_path– Path-based radiation force in the radial direction \(F_\text{rad}^\text{path}\) (spherical coordinates). [Units: g cm/s^2]F_rad_r_path_e2– Path-based sum of squared event-level contributions to the radiation force in the radial direction \(\sum_\text{events}(\Delta F_\text{rad}^\text{path})^2\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_path_cm– Path-based radial force cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_path_cov– Path-based radial force covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_scat– Scattering-based radiation force in the radial direction \(F_\text{rad,scat}\) (spherical coordinates). [Units: g cm/s^2]F_rad_r_scat_e2– Scattering-based sum of squared event-level contributions to the radiation force in the radial direction \(\sum_\text{events}(\Delta F_\text{rad,scat})^2\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_scat_cm– Scattering-based radial force cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_scat_cov– Scattering-based radial force covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]a_rad_z_path– Path-based acceleration due to radiation pressure in the vertical direction \(a_\text{rad}\) (cylindrical coordinates). [Units: cm/s^2]a_rad_z_scat– Scattering-based acceleration due to radiation pressure in the vertical direction \(a_\text{rad,scat}\) (cylindrical coordinates). [Units: cm/s^2]
P_rad_r– Path-based radiation pressure in the radial direction \(P_\text{rad}\) (spherical and cylindrical coordinates). [Units: erg/cm^3]P_rad_z– Path-based radiation pressure in the vertical direction \(P_\text{rad}\) (cylindrical coordinates). [Units: erg/cm^3]P_rad_rz– Path-based radiation pressure in the shear direction \(P_\text{rad}\) (cylindrical coordinates). [Units: erg/cm^3]a_rad_r_grad_u– Packet-level path-based acceleration constructed from the radial energy density gradient \(a_{\nabla u}\) (spherical coordinates). [Units: cm/s^2]a_rad_r_grad_u_cm– Radial acceleration cross moment matrix built from the energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_grad_u_cov– Radial acceleration covariance matrix built from the energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]F_rad_r_grad_u– Path-based radial force constructed from the energy density gradient \(F_{\nabla u}\) (spherical coordinates). [Units: g cm/s^2]F_rad_r_grad_u_cm– Radial force cross moment matrix built from the energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_grad_u_cov– Radial force covariance matrix built from the energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]a_rad_r_div_P– Path-based acceleration constructed from the radial pressure divergence \(a_{\nabla \cdot P}\) (spherical coordinates). [Units: cm/s^2]a_rad_r_div_P_cm– Radial acceleration cross moment matrix built from the pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]a_rad_r_div_P_cov– Radial acceleration covariance matrix built from the pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4]F_rad_r_div_P– Path-based radial force constructed from the pressure divergence \(F_{\nabla \cdot P}\) (spherical coordinates). [Units: g cm/s^2]F_rad_r_div_P_cm– Radial force cross moment matrix built from the pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]F_rad_r_div_P_cov– Radial force covariance matrix built from the pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4]P_rad_xx– Path-based radiation pressure in the xx, yy, zz, xy, xz, yz directions \(P_\text{rad}\) (Cartesian-like coordinates). [Units: erg/cm^3]trap_cum– Cumulative trapping ratio \(t_\text{trap} / t_\text{light}\) (spherical coordinates). [Units: None]trap_x– Frequency-dependent trapping ratio \(t_\text{trap} / t_\text{light}\) (spherical coordinates). [Units: per frequency unit]a_rad_x_path– Path-based radiation acceleration per frequency bin (spherical coordinates). [Units: cm/s^2 per frequency unit]a_rad_x_path_cm– Path-based frequency acceleration cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_path_cov– Path-based frequency acceleration covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_scat– Scattering-based radiation acceleration per frequency bin (spherical coordinates). [Units: cm/s^2 per frequency unit]a_rad_x_scat_e2– Scattering-based sum of squared event-level acceleration contributions per frequency bin (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_scat_cm– Scattering-based frequency acceleration cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_scat_cov– Scattering-based frequency acceleration covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_grad_u– Frequency-dependent acceleration built from the radial energy density gradient (spherical coordinates). [Units: cm/s^2 per frequency unit]a_rad_x_grad_u_cm– Frequency acceleration cross moment matrix built from the radial energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_grad_u_cov– Frequency acceleration covariance matrix built from the radial energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_div_P– Frequency-dependent acceleration built from the radial pressure divergence (spherical coordinates). [Units: cm/s^2 per frequency unit]a_rad_x_div_P_cm– Frequency acceleration cross moment matrix built from the radial pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]a_rad_x_div_P_cov– Frequency acceleration covariance matrix built from the radial pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: cm^2/s^4 per frequency unit^2]F_rad_x_path– Path-based radiation force per frequency bin (spherical coordinates). [Units: g cm/s^2 per frequency unit]F_rad_x_path_cm– Path-based frequency force cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_path_cov– Path-based frequency force covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_scat– Scattering-based radiation force per frequency bin (spherical coordinates). [Units: g cm/s^2 per frequency unit]F_rad_x_scat_e2– Scattering-based sum of squared event-level force contributions per frequency bin (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_scat_cm– Scattering-based frequency force cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_scat_cov– Scattering-based frequency force covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_grad_u– Frequency-dependent force built from the radial energy density gradient (spherical coordinates). [Units: g cm/s^2 per frequency unit]F_rad_x_grad_u_cm– Frequency force cross moment matrix built from the radial energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_grad_u_cov– Frequency force covariance matrix built from the radial energy density gradient, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_div_P– Frequency-dependent force built from the radial pressure divergence (spherical coordinates). [Units: g cm/s^2 per frequency unit]F_rad_x_div_P_cm– Frequency force cross moment matrix built from the radial pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]F_rad_x_div_P_cov– Frequency force covariance matrix built from the radial pressure divergence, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: g^2 cm^2/s^4 per frequency unit^2]M_F_src_path– Path-based force multiplier by source \(M_F^\text{path}(r_\text{source})\) (spherical coordinates). [Units: None]M_F_src_scat– Scattering-based force multiplier by source \(M_F^\text{scat}(r_\text{source})\) (spherical coordinates). [Units: None]M_F_cum_path– Cumulative path-based force multiplier \(M_F^\text{path}(<r)\) (spherical coordinates). [Units: None]M_F_cum_scat– Cumulative scattering-based force multiplier \(M_F^\text{scat}(<r)\) (spherical coordinates). [Units: None]M_F_cum_grad_u– Cumulative force multiplier derived from the radial energy-density gradient, \(-(c/3L)\int_{<r} \nabla u_\text{rad}\,\text{d}V\) (spherical coordinates). [Units: None]M_F_cum_div_P– Cumulative force multiplier derived from the radial pressure divergence, \(-(c/L)\int_{<r} \nabla \cdot P_\text{rad}\,\text{d}V\) (spherical coordinates). [Units: None]M_F_x_path– Path-based force multiplier per frequency bin (spherical coordinates). [Units: per frequency unit]M_F_x_path_cm– Path-based force multiplier frequency cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: per frequency unit^2]M_F_x_path_cov– Path-based force multiplier frequency covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: per frequency unit^2]M_F_x_scat– Scattering-based force multiplier per frequency bin (spherical coordinates). [Units: per frequency unit]M_F_x_scat_cm– Scattering-based force multiplier frequency cross moment matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: per frequency unit^2]M_F_x_scat_cov– Scattering-based force multiplier frequency covariance matrix, packed as the lower triangle with index \(i(i+1)/2+j\) (spherical coordinates). [Units: per frequency unit^2]P_u_cum– Cumulative pressure-to-energy density ratio \(P_\text{rad} / u_\text{rad}\) in the radial direction (spherical coordinates). [Units: None]rho2– Density squared \(\rho^2\). [Units: g^2/cm^6]rho2HI– Density squared times the neutral hydrogen fraction \(x_\text{HI} \rho^2\). [Units: g^2/cm^6]rho_star– Stellar density of each cell \(\rho_\star\). [Units: g/cm^3]ion_front– Ionization front. [Units: None]dx_tot_cumx– Cumulative frequency path length before reaching a given frequency \(\sum_{<|x|} \Delta x\). [Units: None]dl_tot_cumx– Cumulative path length before reaching a given frequency \(\sum_{<|x|} \Delta\ell}\). [Units: cm]l_tot_xesc– Mean path length of photons reaching a given frequency \(\sum_{<|x|} \ell / n_\text{esc}\). [Units: cm]n_scat_xesc– Cumulative number of scatterings before reaching a given frequency \(\sum_{<|x|} n_\text{scat}\). [Units: None]r_xesc– Average escape radius of photons reaching a given frequency \(\sum_{<|x|} r / n_\text{esc}\). [Units: cm]f_xesc– Cumulative number of photons before reaching a given frequency \(\sum_{<|x|} n_\text{esc}\). [Units: None]
Star Fields
n_stars– Number of stars \(n_\text{stars}\). In general, star fields are arrays with this many elements.r_star– Position coordinates \((x,y,z)\). [Units: cm]age_star– Star age. [Units: Gyr]Z_star– Star metallicity \(Z_\star\). [Units: mass fraction]m_star– Stellar mass \(m_\star\). [Units: Msun]m_init_star– Initial stellar mass \(m_{\star,0}\). [Units: Msun]m_massive_star– Current stellar mass contained in massive stars \(m_\text{massive}\). [Units: Msun]L_cont_star– Star continuum band flux \(L_\text{cont}\). [Units: erg/s/angstrom]L_line_star– Star line luminosity \(L_\text{line}\). [Units: erg/s]