If you haven’t already, it’s a good idea to sign up for the mesa-users mailing list. This mailing list is the place to post questions asking the MESA community for help, and you may be able to find the answers to common questions by searching through the mesa-users list archive. This mailing list is also the place where the MESA team posts important announcements like new MESA releases.

Many questions that appear on the mesa-users list have answers already available somewhere in the MESA world. Navigating through this world is not always straightforward. Here is a little guide on how to do that.

1. Installation

The first thing to do is to follow exactly the installation steps explained in Installing MESA.

In case of problems installing MESA, look at the section on troubleshooting and consult the MESA FAQ.

If you cannot find the answer to your problems in these pages, search the mesa-users list archive to see if someone has had a similar problem in the past.

If you still cannot find the answer to your installation problem, post your question to mesa-users@lists.mesastar.org describing the problem. When you do that, it is important to follow the clear procedure detailed in the troubleshooting guide. This tells you which information you need to provide for people to be able to help you.

2. Using MESA

MESA is built to allow users to run experiments in stellar evolution. As such, a lot of freedom is given to the users in terms of choosing parameters and their values. This can be overwhelming when using MESA for the first time.

The first step is to go through the example detailed here: Running MESA.

There are also more examples located in the subdirectory $MESA_DIR/star/test_suite. There you will find examples closer to the type of star you want to study. Some of these test cases are documented in detail in the Test suite documentation. You can use these cases as starting points for your inlists, and slowly modify them to fit your needs. Please beware that the examples in the test suite are not necessarily at the correct resolution, since they need to run fast, and you may need to adjust the resolution to have results that are converged. Please note also, and this is very important, that MESA defaults or test_suite inlists will generally NOT be optimal or even acceptable for your particular science cases. It is your responsibility to ensure that the MESA options and controls you choose are appropriate for the physics you want to study. This will usually require appropriate testing and critical analysis of the models obtained.

There is a section in the documentation about building inlists.

Another source of examples is the MESA Marketplace and the MESA Zenodo community. There you will find inlists used in published papers and MESA Summer School material. You will also find MESA community written guidance on using MESA.

3. YouTube videos

Installing MESA on Linux

Installing MESA on osx

Getting started with MESA

Using pgstar for your MESA project