First run

First run#

Overview#

RHM follows standard bin/include/src structure, with program’s logic assembled under project/ folder. 3rd-party/ folder contains several IO libraries (ready-to-use), and presupplied/ contains presupplied data. Makefile is also supplied for compilation.

Since there are many different main programs under project/, some of which may run with settings provided by the user and some may not, making executables is yet user’s responsibility.

Test run#

To perform a test run with presupplied data, run make on some typical script, e.g.

make release app=project/M-R_diagram/m_r_diagram

If successful, the corresponding binary will be put under bin/, following same path as it took to the app. In this case, executing binary would work like follows

bin/project/M-R_diagram/m_r_diagram.out --help

--help invokes manual message for all standardized RHM programs.

To finally see whether physics is in order on your machine, this binary must be supplemented with inputfile. Let’s run it by providing the one under presupplied/APR4/RHMconfig.json:

bin/project/M-R_diagram/m_r_diagram.out --inputfile presupplied/APR4/RHMconfig.json

Expected output :

  • 3rd and 4th columns contain \((M, R)\) pairs of order \((2 \text{M}_\odot, 10 \text{km})\) based on various center pressure fractions.

    • phenomenal work

Unexpected output :

  • “(..) Cannot open file (..)”

    • inputfile path is supplied, but is not recognized as valid

    • Check path’s spelling against presupplied/APR4/RHMconfig.json

    • If correct, make sure there exists a valid file under presupplied/APR4/APR_EOS_Acc_Fe_RHMstandard.dat

    • If exists, make sure there’s an entry in presupplied/APR4/RHMconfig.json ["EoSSetup"]["Datafile"]["Path"] that leads to the file above. Specify absolute path if in doubts.

  • “keyword argument (..) must have value.”

    • program’s key is supplied, but actual value to it is not

  • Whatever else happened

    • Tell me I messed

To attempt other programs, one wants to preserve TOV cache (this way the framework can map star’s mass to central density). For presupplied and any other EoS perform the following

bin/project/M-R_diagram/m_r_diagram.out --inputfile <eos_path> --restrict_stable > <cache_path>

and make sure ["TOVSolver"]["CenterPressure"]["CachePath"] points to the correct cache. For convenience, the cache is already supplied for presupplied EoS.

What’s next?#

  • Investigate the project/ folder for more programs, to see which you may find useful. Stable ones are inspectable via --help flag.

  • Further learn about RHM main programs running settings

  • Learn about how RHM processes input data

  • Supply it with your own EoS!

Contents