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