Detail Files
Detail files store spatial quantities, such as eigenfunctions and
differential inertias, for an individual solution (mode, tidal
response, etc.) found during a run. The specific data written to
detail files are controlled by the detail_item_list
options of the &ad_output and &nad_output namelist
groups (gyre adiabatic and non-adiabatic calculations,
respectively) and the &tide_output namelist group
(gyre_tides calculations). These options specify the
data to be written via a comma-separated list of fields.
The following subsections describe the fields that may appear in
detail_item_list, grouped together by functional area.
Solution Data
n(type: integer)Number of spatial grid points \(N\)
omega(type: complex)Dimensionless angular frequency \(\omega\)
x(type: real, dimension:n)Dimensionless radial coordinate \(x \equiv r/\Rstar\)
x_ref(type: real)Dimensionless radial coordinate \(\xref\) of reference location
dx_min(type: real)Minimum radial spacing \(\Delta x_{\rm min}\) in spatial grid
dx_max(type: real)Maximum radial spacing \(\Delta x_{\rm max}\) in spatial grid
dx_rms(type: real)Root-mean-square spacing \(\Delta x_{\rm rms}\) of spatial grid
y_1(type: complex, dimension:n)Dependent variable \(y_{1}\)
y_2(type: complex, dimension:n)Dependent variable \(y_{2}\)
y_3(type: complex, dimension:n)Dependent variable \(y_{3}\)
y_4(type: complex, dimension:n)Dependent variable \(y_{4}\)
y_5(type: complex, dimension:n)Dependent variable \(y_{5}\)
y_6(type: complex, dimension:n)Dependent variable \(y_{6}\)
chi(type: real)Root-finding convergence parameter \(\chi\)
n_iter(type: integer)Root-finding number of iterations
The definitions of the dependent variables \(\{y_{1},\ldots,y_{6}\}\) are provided in the Oscillation Equations chapter.
Observables
freq(type: complex, units: controlled byfreq_unitsandfreq_frameoptions)Dimensioned frequency
freq_units(type: string)Value of
freq_unitsoption
freq_frame(type: string)Value of
freq_frameoption
f_T(type: real)Effective temperature perturbation amplitude \(f_{T}\); evaluated at reference location using eqn. (5) of Dupret et al. (2003)
f_g(type: real)Effective gravity perturbation amplitude \(f_{g}\); evaluated at reference location using eqn. (6) of Dupret et al. (2003)
psi_T(type: real)Effective temperature perturbation phase \(\psi_{T}\); evaluated at reference location using eqn. (5) of Dupret et al. (2003)
psi_g(type: real)Effective gravity perturbation phase \(\psi_{g}\); evaluated at reference location using eqn. (6) of Dupret et al. (2003)
Classification & Validation
id(type: integer)Unique mode index
l(type: integer)Harmonic degree \(\ell\)
l_i(type: complex)Effective harmonic degree at inner boundary \(\ell_{\rm i}\)
m(type: integer)Azimuthal order \(m\)
n_p(type: integer)Acoustic-wave winding number \(\nump\)
n_g(type: integer)Gravity-wave winding number \(\numg\)
n_pg(type: integer)Radial order \(\numpg\) within the Eckart-Scuflaire-Osaki-Takata scheme (see Takata, 2006b)
omega_int(type: complex)Dimensionless eigenfrequency \(\omega_{\rm int}\) based on integral expression; evaluated using eqn. (A8) of Townsend et al. (2025)
dzeta_dx(type: complex, dimension:n, units: \(G\Mstar^{2}/\Rstar\))Frequency weight function \(\sderiv{\zeta}{x}\); evaluated from the integrand in eqn. (A5) of Townsend et al. (2025) with \(n'=n\)
zeta(type: complex)Integrated frequency weight \(\zeta \equiv \int \sderiv{\zeta}{x} \, \diff{x}\)
Yt_1(type: complex, dimension:n)Primary eigenfunction \(\mathcal{Y}_{1}\) for Takata classification; evaluated using a rescaled eqn. (69) of Takata (2006b)
Yt_2(type: complex, dimension:n)Secondary eigenfunction \(\mathcal{Y}_{2}\) for Takata classification; evaluated using a rescaled eqn. (70) of Takata (2006b)
I_0(type: complex, dimension:n)First integral \(I_{0}\) for radial modes; evaluated using eqn. (42) of Takata (2006a)
I_1(type: complex, dimension:n)First integral \(I_{1}\) for dipole modes; evaluated using eqn. (43) of Takata (2006a)
prop_type(type: integer, dimension:n)Wave propagation type: \(\varpi = 1\) in acoustic-wave regions, \(\varpi=-1\) in gravity-wave regions, and \(\varpi=0\) in evanescent regions
Perturbations
xi_r_ref(type: complex, units: \(\Rstar\))Radial displacement perturbation \(\txi_{r,{\rm ref}}\) at reference location
xi_h_ref(type: complex, units: \(\Rstar\))Horizontal displacement perturbation \(\txi_{\rm h,ref}\) at reference location
eul_Phi_ref(type: complex, units: \(G\Mstar/\Rstar\))Eulerian potential perturbation \(\tPhi'_{\rm ref}\) at reference location
deul_Phi_ref(type: complex, units: \(G\Mstar/\Rstar^{2}\))Eulerian potential gradient perturbation \((\sderiv{\tPhi'}{r})_{\rm ref}\) at reference location
lag_S_ref(type: complex, units: \(\cP\))Lagrangian specific entropy perturbation \(\delta\tS_{\rm ref}\) at reference location
lag_L_ref(type: complex, units: \(\Lstar\))Lagrangian radiative luminosity perturbation \(\delta\tL_{\rm R,ref}\) at reference location
xi_r(type: complex, dimension:n, units: \(\Rstar\))Radial displacement perturbation \(\txir\)
xi_h(type: complex, dimension:n, units: \(\Rstar\))Horizontal displacement perturbation \(\txih\)
eul_Phi(type: complex, dimension:n, units: \(G\Mstar/\Rstar\))Eulerian potential perturbation \(\tPhi'\)
deul_Phi(type: complex, dimension:n, units: \(G\Mstar/\Rstar^{2}\))Eulerian potential gradient perturbation \(\sderiv{\tPhi'}{r}\)
lag_S(type: complex, dimension:n, units: \(\cP\))Lagrangian specific entropy perturbation \(\delta\tS\)
lag_L(type: complex, dimension:n, units: \(\Lstar\))Lagrangian radiative luminosity perturbation \(\delta\tLrad\)
eul_P(type: complex, dimension:n, units: \(P\))Eulerian total pressure perturbation \(\tP'\)
eul_rho(type: complex, dimension:n, units: \(\rho\))Eulerian density perturbation \(\trho'\)
eul_T(type: complex, dimension:n, units: \(T\))Eulerian temperature perturbation \(\tT'\)
lag_P(type: complex, dimension:n, units: \(P\))Lagrangian total pressure perturbation \(\delta\tP\)
lag_rho(type: complex, dimension:n, units: \(\rho\))Lagrangian density perturbation \(\delta\trho\)
lag_T(type: complex, dimension:n, units: \(T\))Lagrangian temperature perturbation \(\delta\tT\)
Energetics & Transport
eta(type: real)Normalized growth rate \(\eta\); evaluated using expression in text of page 1186 of Stellingwerf (1978)[1]
E(type: real, units: \(\Mstar\Rstar^{2}\))Mode inertia \(E \equiv \int \sderiv{E}{x} \, \diff{x}\)
E_p(type: real, units: \(\Mstar\Rstar^{2}\))Acoustic mode inertia \(E_{\rm p}\); evaluated by integrating \(\sderiv{E}{x}\) with respect to \(x\) across regions where \(\varpi=1\)
E_g(type: real, units: \(\Mstar\Rstar^{2}\))Gravity mode inertia \(E_{\rm g}\); evaluated by integrating \(\sderiv{E}{x}\) with respect to \(x\) across regions where \(\varpi=-1\)
E_norm(type: real)Normalized inertia \(E_{\rm norm}\); evaluation controlled by
inertia_normoption
E_ratio(type: real)Ratio of mode inertia outside reference location, to total inertia
H(type: real, units: \(G\Mstar^{2}/\Rstar\))Mode energy \(H \equiv \frac{1}{2} \omega^{2} E\)
W(type: real, units: \(G\Mstar^{2}/\Rstar\))Mode work \(W \equiv \int \sderiv{W}{x} \, \diff{x}\)[1]
W_eps(type: real, units: \(G\Mstar^{2}/\Rstar\))Mode nuclear work \(W_{\epsilon} \equiv \int \sderiv{W_{\epsilon}}{x} \, \diff{x}\)[1]
tau_ss(type: real, units: \(G\Mstar^{2}/\Rstar\))Steady-state torque \(\tau_{\rm ss} \equiv \int \sderiv{\tau_{\rm ss}}{x} \, \diff{x}\)[1]
tau_tr(type: real, units: \(G\Mstar^{2}/\Rstar\))Transient torque \(\tau_{\rm tr} \equiv \int \sderiv{\tau_{\rm tr}}{x} \, \diff{x}\)[1]
dE_dx(type: real, dimension:n, units: \(\Mstar \Rstar^{2}\))Differential inertia \(\sderiv{E}{x}\); evaluated using eqn. (3.139) of Aerts et al. (2010)
dW_dx(type: real, dimension:n, units: \(G\Mstar^{2}/\Rstar\))Differential work \(\sderiv{W}{x}\); evaluated using eqn. (25.9) of Unno et al. (1989)[1]
dW_eps_dx(type: real, dimension:n, units: \(G\Mstar^{2}/\Rstar\))Differential nuclear work \(\sderiv{W_{\epsilon}}{x}\); evaluated using eqn. (25.9) of Unno et al. (1989)[1]
dtau_ss_dx(type: real, dimension:n, units: \(G\Mstar^{2}/\Rstar\))Steady-state differential torque \(\sderiv{\tau_{\rm ss}}{x}\); evaluated using eqn. (13) of Townsend et al. (2018)[1]
dtau_tr_dx(type: real, dimension:n, units: \(G\Mstar^{2}/\Rstar\))Transient differential torque \(\sderiv{\tau_{\rm tr}}{x}\); evaluated using eqn. (14) of Townsend et al. (2018)[1]
alpha_0(type: real, dimension:n)Excitation coefficient \(\alpha_{0}\); evaluated using eqn. (26.10) of Unno et al. (1989)[1]
alpha_1(type: real, dimension:n)Excitation coefficient \(\alpha_{1}\); evaluated using eqn. (26.12) of Unno et al. (1989)[1]
Rotation
Omega_rot_ref(type: real, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Rotation angular frequency \(\Omega_{\rm rot,ref}\) at reference location
Omega_rot(type: real, dimension:n, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Rotation angular frequency \(\Orot\)
domega_rot(type: real)Dimensionless first-order rotational splitting \(\Delta \omega\); evaluated using eqn. (3.355) of Aerts et al. (2010)
dfreq_rot(type: real, units: controlled byfreq_unitsandfreq_frameoptions)Dimensioned first-order rotational splitting
beta(type: real)Rotation splitting coefficient \(\beta \equiv \int \sderiv{\beta}{x} \, \diff{x}\)
dbeta_dx(type: real, dimension:n)Un-normalized rotation splitting kernel \(\sderiv{\beta}{x}\); evaluated using eqn. (3.357) of Aerts et al. (2010)
lambda(type: complex, dimension:n)Angular eigenvalue \(\lambda\)
Stellar Structure
M_star(type: real, units: \(\gram\))Stellar mass \(\Mstar\)[2]
R_star(type: real, units: \(\cm\))Stellar radius \(\Rstar\)[2]
L_star(type: real, units: \(\erg\,\second^{-1}\))Stellar luminosity \(\Lstar\)[2]
Delta_p(type: real, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Asymptotic p-mode large frequency separation \(\Delta \nu\)
Delta_g(type: real, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Asymptotic g-mode inverse period separation \((\Delta P)^{-1}\)
V_2(type: real, dimension:n)Rescaled homology invariant \(V_2 \equiv x^{-2} V\); defined in Structure Coefficients section
As(type: real, dimension:n)Schwarzschild discriminant \(A^{*}\); defined in Structure Coefficients section
U(type: real, dimension:n)Homology invariant \(U\); defined in Structure Coefficients section
c_1(type: real, dimension:n)Structure coefficient \(c_{1}\); defined in Structure Coefficients section
Gamma_1(type: real, dimension:n)Adiabatic exponent \(\Gammi\); defined in Linearized Equations section
upsilon_T(type: real, dimension:n)Thermodynamic coefficient \(\upsT\); defined in Linearized Equations section[1]
nabla_ad(type: real, dimension:n)Adiabatic temperature gradient \(\nabad\); defined in Linearized Equations section[1]
dnabla_ad(type: real, dimension:n)Logarithmic gradient \(\dnabad \equiv \sderiv{\ln\nabad}{\ln x}\) of adiabatic temperature gradient[1]
nabla(type: real, dimension:n)Temperature gradient \(\nabla\); defined in Structure Coefficients section[1]
c_lum(type: real, dimension:n)Structure coefficient \(\clum\); defined in Structure Coefficients section[1]
c_rad(type: real, dimension:n)Structure coefficient \(\crad\); defined in Structure Coefficients section[1]
c_thn(type: real, dimension:n)Structure coefficient \(\cthn\); defined in Structure Coefficients section[1]
c_thk(type: real, dimension:n)Structure coefficient \(\cthk\); defined in Structure Coefficients section[1]
c_eps(type: real, dimension:n)Structure coefficient \(\ceps\); defined in Structure Coefficients section[1]
c_egv(type: real, dimension:n)Structure coefficient \(\cegv\); defined in Structure Coefficients section[1]
eps_rho(type: real, dimension:n)Nuclear energy generation partial \(\epsnucrho\); defined in Linearized Equations section[1]
eps_T(type: real, dimension:n)Nuclear energy generation partial \(\epsnucT\); defined in Linearized Equations section[1]
kap_rho(type: real, dimension:n)Opacity partial \(\kaprho\); defined in Linearized Equations section[1]
kap_T(type: real, dimension:n)Opacity partial \(\kapT\); defined in Linearized Equations section[1]
Tidal Response
Note that these fields are available only when using gyre_tides.
k(type: integer)Fourier harmonic \(k\)
eul_Psi_ref(type: complex, units: \(G\Mstar/\Rstar\))Eulerian total potential perturbation \(\tPsi'_{\rm ref}\) at reference location
deul_Psi_ref(type: complex, units: \(G\Mstar/\Rstar^{2}\))Eulerian total potential gradient perturbation \((\sderiv{\tPsi'}{r})_{\rm ref}\) at reference location
Phi_T_ref(type: real, units: \(G\Mstar/\Rstar\))Tidal potential \(\tPhi_{\rm T, ref}\) at reference location
dPhi_T_ref(type: real, units: \(G\Mstar/\Rstar^{2}\))Tidal potential gradient \((\sderiv{\tPhi_{\rm T}}{x})_{\rm ref}\) at reference location
eul_Psi(type: complex, dimension:n, units: \(G\Mstar/\Rstar\))Eulerian total potential perturbation \(\tPsi'\)
deul_Psi(type: complex, dimension:n, units: \(G\Mstar/\Rstar^{2}\))Eulerian total potential gradient perturbation \(\sderiv{\tPsi'}{r}\)
Phi_T(type: real, dimension:n, units: \(G\Mstar/\Rstar\))Tidal potential \(\tPhi_{{\rm T}}\)
dPhi_T(type: real, dimension:n, units: \(G\Mstar/\Rstar^{2}\))Tidal potential gradient \(\sderiv{\tPhi_{\rm T}}{x}\)
Omega_orb(type: real, units: controlled byfreq_unitsandfreq_frameoptions)Orbital angular frequency \(\Oorb\)
q(type: real)Ratio \(q\) of secondary mass to primary mass
e(type: real)Orbital eccentricity \(e\)
R_a(type: real)Ratio \(R/a\) of primary radius to orbital semi-major axis
cbar(type: real)Tidal expansion coefficient \(\cbar_{\ell,m,k}\); see eqn. (A1) of Sun et al. (2023)
Gbar_1(type: real)Secular orbital evolution coefficient \(\Gbar^{(1)}_{\ell,m,k}\); equivalent to \(G^{(1)}_{\ell,m,-k}\) (see Willems et al., 2003)
Gbar_2(type: real)Secular orbital evolution coefficient \(\Gbar^{(2)}_{\ell,m,k}\); equivalent to \(G^{(2)}_{\ell,m,-k}\) (see Willems et al., 2003)
Gbar_3(type: real)Secular orbital evolution coefficient \(\Gbar^{(3)}_{\ell,m,k}\); equivalent to \(G^{(3)}_{\ell,m,-k}\) (see Willems et al., 2003)
Gbar_4(type: real)Secular orbital evolution coefficient \(\Gbar^{(4)}_{\ell,m,k}\); equivalent to \(G^{(4)}_{\ell,m,-k}\) (see Willems et al., 2003)
Gbar_E(type: real)Secular energy transfer coefficient \(\Gbar^{(E)}_{\ell,m,k}\); derived from \(\Gbar^{(4)}_{\ell,m,k}\) by dropping the leading \(m\) term
Footnotes