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
parameters of the &ad_output
and &nad_output
namelist
groups (gyre adiabatic and non-adiabatic calculations,
respectively) and the &tides_output
namelist group
(gyre_tides calculations). These parameters specify the
items to be written, via a comma-separated list.
The following subsections describe the items that may appear in
summary_item_list
, grouped together by functional area. For
each item, the corresponding math symbol is given (if there is one),
together with the datatype, and a brief description. Units (where
applicable) are indicated in brackets [].
Solution Data
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(N_{\rm row}\) |
integer |
number of rows in summary file, each corresponding to a mode found (gyre) or a tidal response evaluated (gyre_tides) |
|
\(N\) |
integer( |
number of spatial grid points |
|
\(\omega\) |
complex( |
dimensionless eigenfrequency |
Observables
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
— |
complex( |
dimensioned frequency; units and reference frame controlled by
|
|
— |
string |
|
|
— |
string |
|
|
\(f_{T}\) |
real( |
Effective temperature perturbation amplitude; evaluated using eqn. 5 of Dupret et al. (2003) |
|
\(f_{\rm g}\) |
real( |
Effective gravity perturbation amplitude; evaluated using eqn. 6 of Dupret et al. (2003) |
|
\(\psi_{T}\) |
real( |
Effective temperature perturbation phase; evaluated using eqn. 5 of Dupret et al. (2003) |
|
\(\psi_{\rm g}\) |
real( |
Effective gravity perturbation phase; evaluated using eqn. 6 of Dupret et al. (2003) |
Classification & Validation
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
— |
integer( |
unique mode index |
|
\(\ell\) |
integer( |
harmonic degree |
|
\(\ell_{\rm i}\) |
complex( |
effective harmonic degree at inner boundary |
|
\(m\) |
integer( |
azimuthal order |
|
\(\np\) |
integer( |
acoustic-wave winding number |
|
\(\ng\) |
integer( |
gravity-wave winding number |
|
\(\npg\) |
integer( |
radial order within the Eckart-Scuflaire-Osaki-Takata scheme (see Takata, 2006b) |
|
\(\omega_{\rm int}\) |
complex( |
dimensionless eigenfrequency; evaluated as omega_{rm int} = sqrt{zeta/E} |
|
\(\zeta\) |
complex( |
integral of \(\sderiv{\zeta}{x}\) with respect to \(x\) |
Perturbations
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(x_{\rm ref}\) |
real |
fractional radius of reference location |
|
\(\txi_{r,{\rm ref}}\) |
complex( |
radial displacement perturbation at reference location [\(R\)] |
|
\(\tPhi'_{\rm ref}\) |
complex( |
Eulerian potential perturbation at reference location [\(GM/R\)] |
|
\((\sderiv{\tPhi'}{x})_{\rm ref}\) |
complex( |
Eulerian potential gradient perturbation at reference location [\(GM/R^{2}\)] |
|
\(\delta\tS_{\rm ref}\) |
complex( |
Lagrangian specific entropy perturbation at reference location [\(R\)] |
|
\(\delta\tL_{\rm R,ref}\) |
complex( |
Lagrangian radiative luminosity perturbation at reference location [\(L\)] |
Energetics & Transport
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(\eta\) |
real( |
normalized growth rate \(\eta\); evaluated using expression in text of page 1186 of Stellingwerf (1978) |
|
\(E\) |
real( |
mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\) |
|
\(E_{\rm p}\) |
real( |
acoustic mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\) where \(\varpi=1\) |
|
\(E_{\rm g}\) |
real( |
gravity mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\) in regions where \(\varpi=-1\) |
|
\(E_{\rm norm}\) |
real( |
normalized inertia; evaluation controlled by |
|
— |
real( |
ratio of mode inertias inertia inside/outside reference location |
|
\(H\) |
real( |
mode energy [\(G M^{2}/R\)]; evaluated as \(\frac{1}{2} \omega^{2} E\) |
|
\(W\) |
real( |
mode work [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{W}{x}\) |
|
\(W_{\epsilon}\) |
real( |
mode work [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{W_{\epsilon}}{x}\) |
|
\(\tau_{\rm ss}\) |
real( |
steady-state torque [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{\tau_{\rm ss}}{x}\) |
|
\(\tau_{\rm tr}\) |
real( |
steady-state torque [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{\tau_{\rm tr}}{x}\) |
Rotation
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(\Omega_{\rm ref}\) |
real( |
rotation angular frequency at reference location[\(\sqrt{GM/R^{3}}\)] |
|
\(\delta \omega\) |
real( |
dimensionless first-order rotational splitting; evaluated using eqn. 3.355 of Aerts et al. (2010) |
|
— |
real( |
dimensioned first-order rotational splitting; units and reference frame controlled by
|
|
\(\beta\) |
real( |
rotation splitting coefficient; evaluated by integrating \(\sderiv{\beta}{x}\) |
Stellar Structure
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(M\) |
real( |
stellar mass [\(\gram\)] |
|
\(R\) |
real( |
stellar radius [\(\cm\)] |
|
\(L\) |
real( |
stellar luminosity [\(\erg\,\second^{-1}\)] |
|
\(\Delta \nu\) |
real( |
asymptotic p-mode large frequency separation [\(\sqrt{GM/R^{3}}\)] |
|
\((\Delta P)^{-1}\) |
real( |
asymptotic g-mode inverse period separation [\(\sqrt{GM/R^{3}}\)] |
Tidal Response
Note that these items are available only when using gyre_tides.
Item |
Symbol |
Datatype |
Description |
---|---|---|---|
|
\(k\) |
integer( |
Fourier harmonic |
|
\(\tPsi'_{\rm ref}\) |
complex( |
Eulerian total potential perturbation at reference location [\(GM/R\)] |
|
\(\tPhi_{\rm T, ref}\) |
real( |
tidal potential at reference location [\(GM/R\)] |
|
\(\Omega_{\rm orb}\) |
real( |
orbital angular frequency; units and reference frame controlled by
|
|
\(q\) |
real( |
ratio of secondary mass to primary mass |
|
\(e\) |
real( |
orbital eccentricity |
|
\(R/a\) |
real( |
ratio of primary radius to orbital semi-major axis |
|
\(\cbar_{\ell,m,k}\) |
real( |
tidal expansion coefficient; see eqn. A1 of Sun et al. (2023) |
|
\(\Gbar^{(1)}_{\ell,m,k}\) |
real( |
secular orbital evolution coefficient; equivalent to \(G^{(1)}_{\ell,m,-k}\) (see Willems et al., 2003) |
|
\(\Gbar^{(2)}_{\ell,m,k}\) |
real( |
secular orbital evolution coefficient; equivalent to \(G^{(2)}_{\ell,m,-k}\) (see Willems et al., 2003) |
|
\(\Gbar^{(3)}_{\ell,m,k}\) |
real( |
secular orbital evolution coefficient; equivalent to \(G^{(3)}_{\ell,m,-k}\) (see Willems et al., 2003) |
|
\(\Gbar^{(4)}_{\ell,m,k}\) |
real( |
secular orbital evolution coefficient; equivalent to \(G^{(4)}_{\ell,m,-k}\) (see Willems et al., 2003) |
Footnotes