Frequently Asked Questions
This is a list of Frequently Asked Questions about GYRE. Suggestions for new entries are always most welcome!
How Do I…
- …obtain the GYRE source code?
See the Download section.
- …compile GYRE?
See the Compile section.
- …compile a statically linked verion of GYRE?
STATICenvironment variable to
yesprior to compilation. Note that this currently only works on Linux platforms, and when then
CRMATHenvironment variable is set to
- …run GYRE on multiple cores?
GYRE can take advantage of multiple processors in a shared-memory (multicore) computer through its use of OpenMP. This functionality should be enabled by default, but you can nevertheless force it by setting the
OMPenvironment variable to
yesprior to compilation. Then, set the
OMP_NUM_THREADSenvironment variable to the number of threads you want to use.
- …run GYRE on a cluster?
GYRE can take advantage of multiple nodes in a computer cluster through its use of MPI. To enable this functionality, set the
MPIenvironment variable to
yesprior to compilation. Note that you’ll need to use a version of the MESA Software Development Kit built with MPI support for your cluster’s specific networking technology (e.g., Infiniband); contact the GYRE team for more details.
- …pronounce GYRE?
With a soft ‘g’ rhyming with ‘wire’, like
- …cite GYRE?
See the Citing GYRE section.
- …get support for a problem I’m having?
Post a message to one of the GYRE discussion forums.
- …contact the GYRE team?
Send an email to Rich Townsend.
- …access the documentation for older releases?
Click on the ‘v:…’ dropdown menu at the bottom of the left-hand panel. Note that this menu is only available when viewing the documentation on Read the Docs; it isn’t available in a local build within the
$GYRE_DIR/doc/sphinxdirectory. Also, the legacy documentation is a work-in-progress, and remains incomplete.
- …’Failed during deflate narrowout-of-domain frequency’ mean?
This is an indication that GYRE’s root solver wandered out of bounds when trying to find a complex root of the discriminant function. Try running with a different choice of
MAGNUS_GL2seems to be the most robust), and/or using contour method instead (see the Non-Adiabatic Calculations chapter).
- …the error ‘Illegal Instruction’ arise on MacOS when running with large grid sizes?
This behavior is typically caused by overflow of the OpenMP stack (for more info see here). Try setting the
OMP_STACKSIZEenvironment variable to 500K or 1M.