**supplementary_files**: contains some extra files for plotting

**example_V1298Tau**: evolve the four young V1298 Tau planets as shown in "X-ray irradiation and evaporation of the four young planets around V1298 Tau" (Poppenhaeger et al. 2020)

## Our Model Assumptions

We do not make use of full-blown hydrodynamical simulations, but instead couple existing parametrizations of planetary mass-radius relations with an energy-limited hydrodynamic escape model to estimate the mass-loss rate over time.

**population_evolution**: evolve a whole population of planets (implemented in the future)

\ No newline at end of file

### Mass-loss description: <br>

<ahref="https://www.codecogs.com/eqnedit.php?latex=\small&space;\dot{M}&space;=&space;\epsilon&space;\frac{(\pi&space;R_{XUV}^2)&space;F_{\mathrm{XUV}}}{K&space;G&space;M_{pl}/R_{pl}&space;}&space;=&space;\epsilon&space;\frac{3&space;\beta^2&space;F_{\mathrm{XUV}}}{4&space;G&space;K&space;\rho_{pl}}\,,"target="_blank"><imgsrc="https://latex.codecogs.com/gif.latex?\small&space;\dot{M}&space;=&space;\epsilon&space;\frac{(\pi&space;R_{XUV}^2)&space;F_{\mathrm{XUV}}}{K&space;G&space;M_{pl}/R_{pl}&space;}&space;=&space;\epsilon&space;\frac{3&space;\beta^2&space;F_{\mathrm{XUV}}}{4&space;G&space;K&space;\rho_{pl}}\,,"title="\small \dot{M} = \epsilon \frac{(\pi R_{XUV}^2) F_{\mathrm{XUV}}}{K G M_{pl}/R_{pl} } = \epsilon \frac{3 \beta^2 F_{\mathrm{XUV}}}{4 G K \rho_{pl}}\,,"/></a>

is the efficiency of the atmospheric escape with a value between 0 and 1, and K is a factor representing the impact of Roche lobe overflow (Erkaev et al., 2007), which can take on values of 1 for no Roche lobe influence and <1 for planets filling significant fractions of their Roche lobes.

### Planet Model description: <br>

At the moment, the user can choose between two planet models.

1.*Planet with a rocky core and H/He envelope atop*<br>

We use the tabulated models of Lopez & Fortney (2014), who calculate radii for low-mass planets with hydrogen-helium envelopes on top of Earth-like rocky cores, taking into account the cooling and thermal contraction of the atmospheres of such planets over time. Their simulations extend to young planetary ages, at which planets are expected to still be warm and possibly inflated. Simple analytical fits to their simulation results are provided, which we use to trace the thermal and photoevaporative evolution of the planetary radius over time.

1.*Planet which follows the empirical mass-radius relationships observed for planets around older stars*<br>

(see Otegi et al. (2020), also Chen & Kipping (2017)) <br>

These "mature" relationships show two regimes, one for small rocky planets up to radii of about 2 Earth radii and one for larger planets with volatile-rich envelopes. The scatter is low in the rocky planet regime and larger in the gaseous planet regime: as core vs. envelope fractions may vary, there is a broader range of observed masses at a given planetary radius for those larger planets.

1.*Giant planets with mass-radius relations computed using MESA*<br>

To be implemented...

## Repository Structure:

***platypos_package**: contains the planet classes & all the necessary funtions to construct a planet and make it evolve

(LoF014 planet with rocky core & gaseous envelope OR planet based on mass-radius relation for mature planets (Ot20))

***supplementary_files**: contains some extra files for plotting

(Tu et al., 2015 model tracks for the X-ray luminosity evolution,

Jackson et al., 2012 sample of X-ray measurements in young clusters)

***example_V1298Tau**: evolve the four young V1298 Tau planets as shown in "X-ray irradiation and evaporation of the four young planets around V1298 Tau" (Poppenhaeger, Ketzer, Mallon 2020)

[Link to our paper: ](https://arxiv.org/abs/2005.10240)

***population_evolution**: evolve a whole population of planets (to be fully implemented in the future)