Summary Files
Summary files collect together global properties, such as
eigenfrequencies and radial orders, of all solutions (modes, tidal
responses, etc.) found during a run. The specific data written to a
summary file are controlled by the summary_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
summary_item_list, grouped together by functional area.
Solution Data
n_row(type: integer)Number of rows \(N_{\rm row}\) in summary file, each corresponding to a mode found (gyre) or a tidal response evaluated (gyre_tides)
n(type: integer, dimension:n_row)Number of spatial grid points \(N\)
omega(type: complex, dimension:n_row)Dimensionless angular frequency \(\omega\)
x_ref(type: real, dimension:n_row)Dimensionless radial coordinate \(\xref\) of reference location
chi(type: real, dimension:n_row)Root-finding convergence parameter \(\chi\)
n_iter(type: integer, dimension:n_row)Root-finding number of iterations
Observables
freq(type: complex, dimension:n_row, 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, dimension:n_row)Effective temperature perturbation amplitude \(f_{T}\); evaluated at reference location using eqn. (5) of Dupret et al. (2003)
f_g(type: real, dimension:n_row)Effective gravity perturbation amplitude \(f_{g}\); evaluated at reference location using eqn. (6) of Dupret et al. (2003)
psi_T(type: real, dimension:n_row)Effective temperature perturbation phase \(\psi_{T}\); evaluated at reference location using eqn. (5) of Dupret et al. (2003)
psi_g(type: real, dimension:n_row)Effective gravity perturbation phase \(\psi_{g}\); evaluated at reference location using eqn. (6) of Dupret et al. (2003)
Classification & Validation
id(type: integer, dimension:n_row)Unique mode index
l(type: integer, dimension:n_row)Harmonic degree \(\ell\)
l_i(type: complex, dimension:n_row)Effective harmonic degree at inner boundary \(\ell_{\rm i}\)
m(type: integer, dimension:n_row)Azimuthal order \(m\)
n_p(type: integer, dimension:n_row)Acoustic-wave winding number \(\nump\)
n_g(type: integer, dimension:n_row)Gravity-wave winding number \(\numg\)
n_pg(type: integer, dimension:n_row)Radial order \(\numpg\) within the Eckart-Scuflaire-Osaki-Takata scheme (see Takata, 2006b)
omega_int(type: complex, dimension:n_row)Dimensionless eigenfrequency \(\omega_{\rm int}\) based on integral expression; evaluated using eqn. (A8) of Townsend et al. (2025)
zeta(type: complex, dimension:n_row)Integrated frequency weight \(\zeta \equiv \int \sderiv{\zeta}{x} \, \diff{x}\)
Perturbations
xi_r_ref(type: complex, dimension:n_row, units: \(\Rstar\))Radial displacement perturbation \(\txi_{r,{\rm ref}}\) at reference location
xi_h_ref(type: complex, dimension:n_row, units: \(\Rstar\))Horizontal displacement perturbation \(\txi_{\rm h,ref}\) at reference location
eul_Phi_ref(type: complex, dimension:n_row, units: \(G\Mstar/\Rstar\))Eulerian potential perturbation \(\tPhi'_{\rm ref}\) at reference location
deul_Phi_ref(type: complex, dimension:n_row, units: \(G\Mstar/\Rstar^{2}\))Eulerian potential gradient perturbation \((\sderiv{\tPhi'}{r})_{\rm ref}\) at reference location
lag_S_ref(type: complex, dimension:n_row, units: \(\cP\))Lagrangian specific entropy perturbation \(\delta\tS_{\rm ref}\) at reference location
lag_L_ref(type: complex, dimension:n_row, units: \(\Lstar\))Lagrangian radiative luminosity perturbation \(\delta\tL_{\rm R,ref}\) at reference location
Energetics & Transport
eta(type: real, dimension:n_row)Normalized growth rate \(\eta\); evaluated using expression in text of page 1186 of Stellingwerf (1978)[1]
E(type: real, dimension:n_row, units: \(\Mstar\Rstar^{2}\))Mode inertia \(E \equiv \int \sderiv{E}{x} \, \diff{x}\)
E_p(type: real, dimension:n_row, 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, dimension:n_row, 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, dimension:n_row)Normalized inertia \(E_{\rm norm}\); evaluation controlled by
inertia_normoption
E_ratio(type: real, dimension:n_row)Ratio of mode inertia outside reference location, to total inertia
H(type: real, dimension:n_row, units: \(G\Mstar^{2}/\Rstar\))Mode energy \(H \equiv \frac{1}{2} \omega^{2} E\)
W(type: real, dimension:n_row, units: \(G\Mstar^{2}/\Rstar\))Mode work \(W \equiv \int \sderiv{W}{x} \, \diff{x}\)[1]
W_eps(type: real, dimension:n_row, units: \(G\Mstar^{2}/\Rstar\))Mode nuclear work \(W_{\epsilon} \equiv \int \sderiv{W_{\epsilon}}{x} \, \diff{x}\)[1]
tau_ss(type: real, dimension:n_row, 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, dimension:n_row, units: \(G\Mstar^{2}/\Rstar\))
Rotation
Omega_rot_ref(type: real, dimension:n_row, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Rotation angular frequency \(\Omega_{\rm rot,ref}\) at reference location
domega_rot(type: real, dimension:n_row)Dimensionless first-order rotational splitting \(\Delta \omega\); evaluated using eqn. (3.355) of Aerts et al. (2010)
dfreq_rot(type: real, dimension:n_row, units: controlled byfreq_unitsandfreq_frameoptions)Dimensioned first-order rotational splitting
beta(type: real, dimension:n_row)Rotation splitting coefficient \(\beta \equiv \int \sderiv{\beta}{x} \, \diff{x}\)
Stellar Structure
L_star(type: real, dimension:n_row, units: \(\erg\,\second^{-1}\))Stellar luminosity \(\Lstar\)[2]
Delta_p(type: real, dimension:n_row, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Asymptotic p-mode large frequency separation \(\Delta \nu\)
Delta_g(type: real, dimension:n_row, units: \(\sqrt{G\Mstar/\Rstar^{3}}\))Asymptotic g-mode inverse period separation \((\Delta P)^{-1}\)
Tidal Response
Note that these fields are available only when using gyre_tides.
k(type: integer, dimension:n_row)Fourier harmonic \(k\)
eul_Psi_ref(type: complex, dimension:n_row, units: \(G\Mstar/\Rstar\))Eulerian total potential perturbation \(\tPsi'_{\rm ref}\) at reference location
deul_Psi_ref(type: complex, dimension:n_row, units: \(G\Mstar/\Rstar^{2}\))Eulerian total potential gradient perturbation \((\sderiv{\tPsi'}{r})_{\rm ref}\) at reference location
Phi_T_ref(type: real, dimension:n_row, units: \(G\Mstar/\Rstar\))Tidal potential \(\tPhi_{\rm T, ref}\) at reference location
dPhi_T_ref(type: real, dimension:n_row, units: \(G\Mstar/\Rstar^{2}\))Tidal potential gradient \((\sderiv{\tPhi_{\rm T}}{x})_{\rm ref}\) at reference location
Omega_orb(type: real, dimension:n_row, units: controlled byfreq_unitsandfreq_frameoptions)Orbital angular frequency \(\Oorb\)
q(type: real, dimension:n_row)Ratio \(q\) of secondary mass to primary mass
e(type: real, dimension:n_row)Orbital eccentricity \(e\)
R_a(type: real, dimension:n_row)Ratio \(R/a\) of primary radius to orbital semi-major axis
cbar(type: real, dimension:n_row)Tidal expansion coefficient \(\cbar_{\ell,m,k}\); see eqn. (A1) of Sun et al. (2023)
Gbar_1(type: real, dimension:n_row)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, dimension:n_row)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, dimension:n_row)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, dimension:n_row)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, dimension:n_row)Secular energy transfer coefficient \(\Gbar^{(E)}_{\ell,m,k}\); derived from \(\Gbar^{(4)}_{\ell,m,k}\) by dropping the leading \(m\) term
Footnotes