Readme

Description: 
         A computer code (procedure) written in Interactive Data Language 
         (IDL, version 8.4) to compute the spectral line profile indicators used 
         by Lanza et al. (2018, Astronomy & Astrophysics vol. 616, A155; 
         arXiv:1804.07039). The procedure takes the fits files provided by the 
         data reduction software (DRS) of HARPS or HARPS-N as an input. 
         
         An example for the input files is provided in the directory /input with
         the sole purpose of allowing you to test the proper compilation and 
         running of the procedure. Details on an auxiliary source file (mpfit.pro) 
         required for compilation are provided in the header of the procedure 
         file and in Appendix A of the above mentioned paper. Interested users 
         are warmly recommended to read them before compiling and running the 
         procedure. Information on how to use these indicators can be found in
         Lanza et al 2018, A&A 616, A155, https://arxiv.org/abs/1804.07039

File summary and contents:

- Readme: this description ASCII file; 

- asym_ind.pro: the IDL procedure to compute the asymmetry indicators and the 
  FWHM of the CCF as specified by Lanza et al. 2018; please change the string 
  PATH and the string OPERATION before compiling and running as explained in the
  header of the procedure file (see also Appendix A of Lanza et al. 2018); 
  WARNING: when using files produced by the DRS of HARPS@ESO, please check the 
  dimensions of the matrixes extracted from the FITS files because the current 
  version of the procedure assumes those of the files produced by the DRS of 
  HARPS-N@TNG;
  
- mpfit.pro: the fitting routine used by asym_ind.pro (see the header of the 
  above file for instructions about the compilation and Lanza et al. 2018, 
  Appendix A); this procedure is authored by Craig B. Markwardt, NASA/GSFC; see
  http://cow.physics.wisc.edu/~craigm/idl/fitting.html
  
- /input: a directory containing a sample dataset consisting of *_ccf_* and 
  *_bis_* files of the star HD108874 as provided by the DRS of HARPS-N 
  (see Lanza et al. 2018, Appendix A); for more information on this dataset you 
  can refer to the GAPS series paper dedicated to HD 108874, that is Benatti 
  et al. 2017, A&A 599, A90; this directory contains also two files that list
  the names of the *_bis_* and *_ccf_* FITS files, that is flistbis.lis and 
  flistccf.lis, respectively. You have to prepare files like these when you use 
  a different dataset - Unix operating systems allow you to make these file with 
  the commands > ls -1 *_bis_* > flistbis.lis and > ls -1 *_ccf_* > flistccf.lis
  
- output.dat: the sample output file containing the asymmetry parameters and the
  FWHM of the CCF together with other information as specified in the header of 
  asym_ind.pro. The format of this file lines is '(1x,3f20.8,i9,20f20.8)'. 

  For further info please send an email to: antonino.lanza@inaf.it