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_row

\(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

\(N\)

integer(n_row)

number of spatial grid points

omega

\(\omega\)

complex(n_row)

dimensionless eigenfrequency

Observables

Item

Symbol

Datatype

Description

freq

complex(n_row)

dimensioned frequency; units and reference frame controlled by freq_units and freq_frame parameters

freq_units

string

freq_units parameter

freq_frame

string

freq_frame parameter

f_T

\(f_{T}\)

real(n_row)

Effective temperature perturbation amplitude; evaluated using eqn. 5 of Dupret et al. (2003)

f_g

\(f_{\rm g}\)

real(n_row)

Effective gravity perturbation amplitude; evaluated using eqn. 6 of Dupret et al. (2003)

psi_T

\(\psi_{T}\)

real(n_row)

Effective temperature perturbation phase; evaluated using eqn. 5 of Dupret et al. (2003)

psi_g

\(\psi_{\rm g}\)

real(n_row)

Effective gravity perturbation phase; evaluated using eqn. 6 of Dupret et al. (2003)

Classification & Validation

Item

Symbol

Datatype

Description

id

integer(n_row)

unique mode index

l

\(\ell\)

integer(n_row)

harmonic degree

l_i

\(\ell_{\rm i}\)

complex(n_row)

effective harmonic degree at inner boundary

m

\(m\)

integer(n_row)

azimuthal order

n_p

\(\nump\)

integer(n_row)

acoustic-wave winding number

n_g

\(\numg\)

integer(n_row)

gravity-wave winding number

n_pg

\(\numpg\)

integer(n_row)

radial order within the Eckart-Scuflaire-Osaki-Takata scheme (see Takata, 2006b)

omega_int

\(\omega_{\rm int}\)

complex(n_row)

dimensionless eigenfrequency; evaluated as \(\omega_{\rm int} = \sqrt{\zeta/E}\)

zeta

\(\zeta\)

complex(n_row)

integral of \(\sderiv{\zeta}{x}\) with respect to \(x\)

Perturbations

Item

Symbol

Datatype

Description

x_ref

\(x_{\rm ref}\)

real

fractional radius of reference location

xi_r_ref

\(\txi_{r,{\rm ref}}\)

complex(n_row)

radial displacement perturbation at reference location [\(R\)]

eul_Phi_ref

\(\tPhi'_{\rm ref}\)

complex(n_row)

Eulerian potential perturbation at reference location [\(GM/R\)]

deul_Phi_ref

\((\sderiv{\tPhi'}{x})_{\rm ref}\)

complex(n_row)

Eulerian potential gradient perturbation at reference location [\(GM/R^{2}\)]

lag_S_ref

\(\delta\tS_{\rm ref}\)

complex(n_row)

Lagrangian specific entropy perturbation at reference location [\(R\)]

lag_L_ref

\(\delta\tL_{\rm R,ref}\)

complex(n_row)

Lagrangian radiative luminosity perturbation at reference location [\(L\)]

Energetics & Transport

Item

Symbol

Datatype

Description

eta[1]

\(\eta\)

real(n_row)

normalized growth rate \(\eta\); evaluated using expression in text of page 1186 of Stellingwerf (1978)

E

\(E\)

real(n_row)

mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\)

E_p

\(E_{\rm p}\)

real(n_row)

acoustic mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\) where \(\varpi=1\)

E_g

\(E_{\rm g}\)

real(n_row)

gravity mode inertia [\(M R^{2}\)]; evaluated by integrating \(\sderiv{E}{x}\) in regions where \(\varpi=-1\)

E_norm

\(E_{\rm norm}\)

real(n_row)

normalized inertia; evaluation controlled by inertia_norm parameter

E_ratio

real(n_row)

ratio of mode inertia outside reference location, to total inertia

H

\(H\)

real(n_row)

mode energy [\(G M^{2}/R\)]; evaluated as \(\frac{1}{2} \omega^{2} E\)

W[1]

\(W\)

real(n_row)

mode work [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{W}{x}\)

W_eps[1]

\(W_{\epsilon}\)

real(n_row)

mode work [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{W_{\epsilon}}{x}\)

tau_ss

\(\tau_{\rm ss}\)

real(n_row)

steady-state torque [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{\tau_{\rm ss}}{x}\)

tau_tr

\(\tau_{\rm tr}\)

real(n_row)

steady-state torque [\(G M^{2}/R\)]; evaluated by integrating \(\sderiv{\tau_{\rm tr}}{x}\)

Rotation

Item

Symbol

Datatype

Description

Omega_rot_ref

\(\Omega_{\rm rot,ref}\)

real(n_row)

rotation angular frequency at reference location[\(\sqrt{GM/R^{3}}\)]

domega_rot

\(\Delta \omega\)

real(n_row)

dimensionless first-order rotational splitting; evaluated using eqn. 3.355 of Aerts et al. (2010)

dfreq_rot

real(n_row)

dimensioned first-order rotational splitting; units and reference frame controlled by freq_units and freq_frame parameters

beta

\(\beta\)

real(n_row)

rotation splitting coefficient; evaluated by integrating \(\sderiv{\beta}{x}\)

Stellar Structure

Item

Symbol

Datatype

Description

M_star[2]

\(M\)

real(n_row)

stellar mass [\(\gram\)]

R_star[2]

\(R\)

real(n_row)

stellar radius [\(\cm\)]

L_star[2]

\(L\)

real(n_row)

stellar luminosity [\(\erg\,\second^{-1}\)]

Delta_p

\(\Delta \nu\)

real(n_row)

asymptotic p-mode large frequency separation [\(\sqrt{GM/R^{3}}\)]

Delta_g

\((\Delta P)^{-1}\)

real(n_row)

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

\(k\)

integer(n_row)

Fourier harmonic

eul_Psi_ref

\(\tPsi'_{\rm ref}\)

complex(n_row)

Eulerian total potential perturbation at reference location [\(GM/R\)]

Phi_T_ref

\(\tPhi_{\rm T, ref}\)

real(n_row)

tidal potential at reference location [\(GM/R\)]

Omega_orb

\(\Oorb\)

real(n_row)

orbital angular frequency; units and reference frame controlled by freq_units and freq_frame parameters

q

\(q\)

real(n_row)

ratio of secondary mass to primary mass

e

\(e\)

real(n_row)

orbital eccentricity

R_a

\(R/a\)

real(n_row)

ratio of primary radius to orbital semi-major axis

cbar

\(\cbar_{\ell,m,k}\)

real(n_row)

tidal expansion coefficient; see eqn. A1 of Sun et al. (2023)

Gbar_1

\(\Gbar^{(1)}_{\ell,m,k}\)

real(n_row)

secular orbital evolution coefficient; equivalent to \(G^{(1)}_{\ell,m,-k}\) (see Willems et al., 2003)

Gbar_2

\(\Gbar^{(2)}_{\ell,m,k}\)

real(n_row)

secular orbital evolution coefficient; equivalent to \(G^{(2)}_{\ell,m,-k}\) (see Willems et al., 2003)

Gbar_3

\(\Gbar^{(3)}_{\ell,m,k}\)

real(n_row)

secular orbital evolution coefficient; equivalent to \(G^{(3)}_{\ell,m,-k}\) (see Willems et al., 2003)

Gbar_4

\(\Gbar^{(4)}_{\ell,m,k}\)

real(n_row)

secular orbital evolution coefficient; equivalent to \(G^{(4)}_{\ell,m,-k}\) (see Willems et al., 2003)

Footnotes