CEPAM Version 3.7.3 (09/06/2021)The code requires subversion scons gfortran idl (not mandatory - demo mode ok) ---------------------------------------------------------------------------------------------------- REPOSITORY The latest version of this code should be obtained from the following repository: svn co https://svn.oca.eu/codes/CEPAM/trunk where is the main directory of the code (I would use e.g., svn_CEPAM_trunk) ---------------------------------------------------------------------------------------------------- INSTALL In , type scons install (Note: you may have to do it twice) ---------------------------------------------------------------------------------------------------- TESTS In the main directory, type scons test -> Then choose the following options: P to test a polytropic model S to test static models of Jupiter and Saturn O to test optimization models of Jupiter and Saturn E to test evolution models (Jupiter, Saturn or exoplanets) The principle of the tests is that a script copies test_expls/ into tmp/test_expls, runs CEPAM in tmp/test_expls and then compares the results in tmp/test_expls to those in test_expls. In order to test the code manually, you may do cd tmp/test_expls/ cepam (or /bin/cepam if your PATH is not properly set) ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- RUNNING CEPAM RUNNING CEPAM: 1. PATH It is recommended to add /bin to your PATH, in order to be able to run CEPAM easily ---------------------------------------------------------------------------------------------------- RUNNING CEPAM: 2. INPUT/OUTPUT A CEPAM model is to be run in a directory with the following structure: data: a symbolic link pointing to /data + The INPUT files cepam.don -> main parameters of the code cepam_etat.don -> parameters for the equation of state to be used cepam_atm.don -> parameters for the atmospheric boundary condition (for static models only) evol.don -> parameters for the evolution output files .ini -> parameters of the model (mass, rotation rate, core mass and internal composition) .don -> alternative to .ini (old version) + Other optional INPUT files + The INPUT/OUTPUT file .bin -> Initial and final model in binary form The OUTPUT FILES are: .bin -> final model in binary form .csv -> final (evolution or static model) in csv format .des -> final (evolution or static model) in ASCII format _ev.csv -> Timesteps of the evolution sequence (for evolution models only) _evol.csv -> A series of interior models at different timesteps in csv format _evol.des -> A series of interior models at different timesteps in ASCII format _js.csv -> A list of parameters including radius, mass, and gravitational moments (Js) ---------------------------------------------------------------------------------------------------- RUNNING CEPAM: 3. THE OPTIONS Upon running cepam, there are several options 1st question: -> Type "Enter" (interactive mode) 2nd question: -> Select either 2 -> If you want to calculate a static model 3 -> If you want to run an evolution model 3rd question: Provide the name of the The following files should exist: .bin and .ini (or .don) If you chose option 2 (STATIC model) 4th question: Do you want to include high order terms in the calculation of the Js -> select "o" for "yes" If you chose option 3 (EVOLUTION model) 4th question: What is your initial radius? (In Rjup units) -- The code starts from an initially compact model and increases the (uniform) dS/dt until you reach the selected radius -> Choose 2.0 (often a reasonable choice for hot to cold Jupiters) 5th question: (initial) value of the c=dS/dt constant -> Choose e.g. 1d-2 (corresponding to a compact solution - however you may have to change that between 1d-6 and 1d0 depending on the characteristics of your model) ---------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------- ADDITIONAL CODES Two additional codes may be useful cepasc2bin Transforms .bin files into .basc and vice-versa This is useful because the binary files are not necessarily easily transferable from one computer to another optimise This optimises models of Jupiter and Saturn to match observed gravitational moments ---------------------------------------------------------------------------------------------------- AUTHORS Tristan GUILLOT Pierre MOREL With significant contributions from Mathieu HAVEL Vivien PARMENTIER Yamila MIGUEL Diana VALENCIA Lucile FAYON Masahiro IKOMA ---------------------------------------------------------------------------------------------------- This README was written for the following CEPAM version: CEPAM Version 3.5.15 (31/01/2017) @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@