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).