Below are a few practical examples and step-by-step instructions to bring users 
up to speed in learning how to run the Fortran codes provided with this 
package. Commands are intended for UNIX based systems (UNIX/Linux/Mac OS X) 
having installed a gfortran (or ifort) compiler. 
Please refer to the README file for a more detailed description of each program.

Example 1: open the package and successfully obtain a table of BCs in a 
	   number of selected filters, for a given value of reddening E(B-V).

Example 2: use the program colstar.for to obtain solar synthetic BVI colours.

Example 3: use the program bcstars.for to derive bolometric correction for a 
	   sample of stars of known logg, [Fe/H] and Teff (the sample of stars 
	   is passed via the file input.sample)


********************************************************************************
				*** Example 1 ***
********************************************************************************


1.1) Unpack BCcodes.tar.gz  (type e.g., "tar -xvf BCcodes.tar.gz").

1.2) Unpack BCtables.tar.gz (type e.g., "tar -xvf BCtables.tar.gz").

1.3) Move the content of the directory BCtables/ into BCcodes/ 
     (type e.g., "mv BCtables/* BCcodes/").

1.4) Go into BCcodes/ (type e.g., "cd BCcodes").

1.5) On a WINDOWS machine change "/" into "\" in the following two codes 
     (obviously this step must be done only once): 
     getinputbcs.for 
     gettestbcs.for

1.6) In selectbc.data choose models and filters (see explanation in README, 
     and in Appendix A of Casagrande & VandenBerg, 2014). Notice that since 
     bolometric corrections -BCs- are returned, then a colour index 
     i-j = BC_j - BC_i

1.7) Compile getinputbcs.for, gettestbcs.for, getbctable.for, and chkbctable.for
     type e.g., "ifort getinputbcs.for -o getinputbcs.exe"
	        "ifort gettestbcs.for  -o gettestbcs.exe"
	        "ifort getbctable.for  -o getbctable.exe"
	        "ifort chkbctable.for  -o chkbctable.exe"
   A free compiler upon which the compilation has also been checked is 
   gfortran. So, similarly type:    
   	     	"gfortran getinputbcs.for -o getinputbcs.exe"
   		 etc...

1.8) Execute getinputbcs.exe (type e.g., "./getinputbcs.exe").

Steps 1.8.1) - 1.8.3) below are for the purpose of checking the accuracy of the 
interpolation routines. Should the user wish to skip these steps, then move 
directly to 1.9).
 
1.8.1) Execute gettestbcs.exe  (type e.g., "./gettestbcs.exe") and select a 
       value for reddening (i.e. type 1, 2, 3, 4, 5 or 6).

1.8.2) Execute getbctable.exe (type e.g., "./getbctable.exe", using SAME E(B-V) 
       as chosen above. I.e., if e.g., 3 has been chosen, then at this stage 
       type 0.14).

1.8.3) Execute chkbctable.exe (type e.g., "./chkbctable.exe").

1.9) Execute getbctable.exe (type e.g., "./getbctable.exe", using whichever 
     value of E(B-V) between 0 and 0.72).

Steps 1.1) - 1.9) define the series of steps necessary to successfully obtain a 
table of BCs in the filters selected in selectbc.data, using the E(B-V) value 
input when executing getbctable.exe


********************************************************************************
				*** Example 2 ***
********************************************************************************

2.1) The user might additionally wish to explore the use of colstar.for. To 
     obtain e.g., the solar B, V and I magnitudes, choose in selectbc.data:
     1 = ialf 
     3 = nfil
     7 36
     7 37
     7 39

2.2) Then repeat step 1.8) and 1.9) above -using E(B-V) = 0.-

2.3) Compile colstar.for (type e.g., 
     "ifort colstar.for bcutil.for -o colstar.exe").

2.4) Execute colstar.exe (type e.g., "./colstar.exe")
     The program will return the solar M_V = 4.818, B-V = 0.637 and V-I = 0.698 
     colours (in this case using the ubvri90 transformations, since 7 has been 
     used in selectbc.data) and then stop.
     This is because the second part of the program needs to cycle through 
     ialf from 1 to 4. Thus repeat step 2.1) and 1.8) 1.9), setting 2 = ialf, 
     3 = ialf and 4 = ialf in selectbc.data.
     Once that is done, execute colstar.exe again and it will correctly work 
     until termination. 


********************************************************************************
				*** Example 3 ***
********************************************************************************

3.1) bcstars.for is a program that determines BCs (up to 5 filters, as selected 
     in selectbc.data) for stars of known logg, [Fe/H], Teff. The stars for 
     which this program determine BCs are provided via the input file called 
     input.sample (more stars can be added in this input file, one per line).

3.2) bcgo is an executable file (shell script) which contains all commands 
     to compile (assuming a gfortran compiler), link and execute relevant 
     files in the case 1 = ialf (should bcgo not appear as executable, type 
     e.g., "chmod u+x bcgo" to obtain the executable permission). Check comment
     lines in bcgo for the meaning of each instruction. 
     After having selected the filters the user wish to compute BCs for (in 
     selectbc.data), bcgo must be executed, by typing on the command line 
     e.g., "./bcgo". 
     The user will be asked to insert the value of reddening at which BCs want 
     to be computed. After that, BCs in up to five filters will be written on 
     the screen, one line for each of the input object in input.sample (if 
     less than 5 filters are selected, 0.000 will be returned in the remaining 
     columns).