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.

…pronounce GYRE?

With a soft ‘g’ rhyming with ‘wire’, like this.

…cite GYRE?

See the Citing GYRE section.

…ask a general question about GYRE?

Start a new discussion on the GitHub discussions page.

…get support for a problem I’m having?

Open an issue on the GitHub issues page.

…contact the GYRE team?

Send an email to Rich Townsend.

…run GYRE on multiple cores?

Parallel Execution of GYRE should be enabled by default, but you can nevertheless force it by setting the OMP environment variable to yes prior to compilation. Then, set the OMP_NUM_THREADS environment variable to the number of threads you want to use (or leave unset for a sensible default choice).

…access the documentation for older releases?

Click on the ‘v:…’ dropdown menu in the bottom-right. 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/docs directory. Also, the legacy documentation is a work-in-progress, and remains incomplete.

What Does…

…’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 diff_scheme option (MAGNUS_GL2 seems to be the most robust), and/or using contour method instead (see the Non-Adiabatic Oscillations chapter).

Why Does…

…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_STACKSIZE environment variable to 500K or 1M.