 3D/OPTIM3D RVS spectra

0) Producers
   Andrea Chiavassa <andrea.chiavassa@oca.eu> for the spectra with Optim3D
   F. Thevenin      <frederic.thevenin@oca.eu> for the spectra 
   Z. Magic         for the 3D simulations (no more in Academia)
   R. Collet 	    for the 3D simulations (no more in Academia)
   M. Asplund 	    for the 3D simulations (no more in Academia)

   Date: July 2013 - Update in March 2020

1) Model atmosphere code
   The 3D radiation-hydrodynamic (RHD) simulations of convection at the surface of late-type stars have been done using the StaggerCode (Nordlund et al. 2009, Living Reviews in Solar Physics, vol. 6, no. 2). The code  solves the full set of hydrodynamical equations for the conservation of mass,  momentum, and energy coupled to an accurate treatment of the radiative transfer. 
StaggerCode uses a realistic equation-of- state that accounts for ionization, recombination, and dissociation (Mihalas et al. 1988, ApJ 331, 815) and both continuous (Trampedach et al., priv. comm.) and line opacities (Gustafsson et al. 2008, A&A, 486, 951). In order to reduce the computational burden for the solution of the radiative transfer equation, we approximate the source function with the Planck function at the local temperature and neglect the contribution of scattering to the total extinction in the optically thin layers. 
The wavelength dependence of the radiative transfer is taken into account using opacity bins as in Nordlund (1982, A&A, 107, 1). 

2) Model atmosphere grids: StaggerGrid (Magic et al. 2013, A&A, 557, A26).
The production of the 3D is done with the StaggerCode for a range of temperature from 4000 to 7000 K, step of 500 K; log(g) from 1.5 to +5.0, step of 0.5 dec (g in units of cm/s^2); and metallicity of [Fe/H] = +0.5, +0.0, -0.5, -1.0, -2.0, -3.0, -4.0 (Magic et al. 2013, Fig.1). 

3) Model calculation setup: Optim3D 
We used the 3D pure local thermal equilibrium (LTE) radiative transfer code Optim3D (Chiavassa et al. 2009, A&A, 506, 1351) to compute spectra from the snapshots of the RHD simulations. The code takes into account the Doppler shifts due to convective motions.
 The radiative transfer equation is solved monochromatically using extinction pre-tabulated coefficients as a function of temperature, density, and wavelength. The lookup tables were computed for the same chemical compositions as the RHD simulations using the same extensive atomic and molecular opacity data as the latest generation of MARCS models (Gustafsson et al. 2008, A&A, 486, 951). 
We assumed a zero microturbulence since the velocity fields inherent in 3D models are expected to self-consistently and adequately account for non-thermal Doppler broadening of spectral lines. The temperature and density ranges spanned by the tables are optimized for the values encountered in the RHD simulations. Optim3D computes the emerging intensities for vertical rays cast through the computational box, for all required wavelengths (see also Chiavassa et al. 2010, A&A, 524, id.A93, and Chiavassa et al 2012, A&A, 540, id.A5, for the application of Optim3D to RHD box-in-a-star simulations). The procedure is repeated after tilting the computational box by an angle theta with respect to the line of sight (vertical axis) and rotating it azimuthally by an angle phi. The final result is a spatially resolved intensity spectrum at different angles. 

The spectra in are computed along rays of four mu-angles = cos(theta) = [0.88, 0.65, 0.55, 0.34] degrees and four phi-angles [0, 90, 180, 270] degrees, after which we performed a disk integration and a temporal average over all selected snapshots. Part of this production work for Gaia applications has been also published in Chiavassa et al. 2012 (Journal of Physics: Conference Series, 328)
All the spectra are now available on Pollux Database (http://npollux.lupm.univ-montp2.fr) and published in Chiavassa et al. 2018, A&A, 611, A11

3bis) Abundances and linelist
The version4 is an update of version3 with a not negligible corrections to the accuracy of the oscillation strengths in spectra lines in the spectral range of Calcium triplet. These corrections have been tested against the solar spectrum (see TN...) and come from Bigot & Thevenin 2006 (MNRAS, 372, Issue 2, pp. 609-614) and Bigot & Thevenin 2008 (Journal of Physics: Conference Series, Volume 130, Issue 1)
Beside that, the abundances and linelist used are the same as in version3: Grevesse & Sauval abundaces from Space Science Reviews, v. 85, Issue 1/2, p. 161-174 (1998). The molecular and atomic linelist is the one provided by the CU6 in January 2016.


4) Calculation of RVS spectra 
   a) RVS spectra: vacuum wavelength range 840-890 nm. The synthetic spectra are computed with a wavelength step of 0.003 nm. All predicted atomic and molecular lines are  included. The unnormalised flux at each wavelength is given in units of W/m^2/nm.
In this second release (version3 - Mars 2015) I include all the simulations available with metallicity [Fe/H] = +0.5, +0.0, -0.5, -1.0, -2.0 
 
The total numeber of RVS spectra is 131.

5) File naming convention
   3Dmodels_<model>.<spectrum_type>
   where "model" encodes the name of the simulation, e.g. "t5777g44m1005";
         "spectrum_type" is "rvs"
   The name of the simulations has the following meaning: 
t5777 ---> the approximative effective temperature
g44 ---> the log(g)=4.4
m00 ---> metallicity is [Fe/H] = +0.0
m05 ---> metallicity is [Fe/H] = -0.5
m10 ---> metallicity is [Fe/H] = -1.0
m20 ---> metallicity is [Fe/H] = -2.0
p05 ---> metallicity is [Fe/H] = +0.5
05  ---> is the relaxed version of the simulation
       	       	   	       	       		 	
6) Extension of the header
   Header is formatted according to the Cycle3 input Gaia libraries guidelines.
   Additional "element_ind" are appended for all chemical abundances 
   deviating from the solar abundance table and not present in the standard
   header. All abundances are given in units log(N_El/N_H)+12. The alpha/Fe
   parameter is 0.0 for [Fe/H] = +0.5, +0.0, 0.2 for [Fe/H] = -0.5 and 0.4 for [Fe/H] = -1.0, -2.0

7) References
Principal references -->
3D Spectra, available publicly on POLLUX database: Chiavassa et al. 2018, A&A, 611, A11
3D grid simulations: Magic Z., Collet R., Asplund M., Trampedach R., Hayek W., Chiavassa A., Stein R. F., Nordlund A., A&A, 557, A26
OPTIM3D (RT code used): Chiavassa, A., Plez, B., Josselin, E., Freytag, B. 2009, A&A, 506, 1351
Stagger-code (RHD code used): Norduld et al. 2009, Living Reviews in Solar Physics, 6, 2
	
8) Acknowledgments
    We thank B. Plez for providing the molecular linelists.
================= END ==========================================================
