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_upper and n_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_HI and x_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]

  • 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]

  • rho_dust – Dust density \(\rho_\text{dust}\). [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 – Radiation energy density \(u_\text{rad}\). [Units: erg/cm^3]

  • 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]

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_init_star – Initial stellar mass \(m_{\star,0}\). [Units: Msun]

  • m_massive_star – Current stellar mass contained in massive stars. [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]