README file for the evolution models in corotlux_evolutions_gs02.tgz
--------------------------------------------------------------------
References for these calculations:
  # Fressin F., Guillot T., Morello V. & Pont F. 2007, ``Interpreting
and predicting the yield of transit surveys: Giant planets in the OGLE
fields", A&A, in press
  # Guillot T., Santos N., Pont F., Iro N., Melo C. & Ribas I. 2006,
``A correlation between the heavy element content of transiting
extrasolar planets and the metallicity of their parent stars", A&A,
453, L21-L24
  # (See also Guillot T & Morel 1994, A&A Suppl. for a description of CEPAM)


This directory contains evolution tables of many "reference planets"
with varied characteristics. In CorotLux it is used as an
interpolation basis to calculate the radii of all simulated planets.


File Names :
------------

The file names all have the same structure :

pegD_t{Teq0}_m{mass}_mc{core mass}.des

- Teq0 : Equilibrium temperature in Kelvins. This would be the
temperature of the planet if it radiated as a black body all the
energy received from its host star.
	possible values : 100, 1000, 1500, 2000

- mass : total mass in earth masses
	possible values : 100, 134, 179, 238, 318, 424, 565, 754, 1005, 3178

- core mass : core mass in earth masses
	possible values : 0, 25, 50, 75, 100


File Structure :
----------------

These files contain basically evolution tables, which give some
physical parameters of the planet as a function of time.  Columns in
the file are :

- AGE	: age in millions of years
- R/RJUP: radius in units of Jupiter's MEAN radius (Rjup=6.98d7 cm)
- L/LJUP: intrinsic luminosity in jovian units (Ljup=3.35d24 erg/s)
- T_EFF	:  effective temperature (including the irradiated flux)
- TEMPERATURE : temperature at 10 bars (outer boundary condition)
- S_CENTRE : specific entropy at the bottom of the envelope
- DELTA_S : difference in specific entropy between the outside and the inside.


Use in Corotlux :
-----------------

Actually, in its current state, CorotLux only uses a small part of
these tables.  For the majority of planets computed in CorotLux
("hot/very hot jupiters"), significant evolution lasts only millions,
or a few dozens of millions years : after such a time, all physical
parameters reach an equilibrium value. As a consequence, we made the
assumption in CorotLux that all the simulated planets had reached this
equilibrium.

Therefore, only the single last lines of these files are read.  What
we need is the equilibrium radius, the 2nd value of the last
line. Finally CorotLux builds from the files the following reference
table, and uses it to infer the radii of simulated planets from their
masses, core masses, and temperatures.


Mass	|	Core Mass	|	Temperature	|	Radius	|
------------------------------------------------------------------------- 		
	|			|			|		|
	|			|			|		|
	|			|			|		|
...