This section of the CD-ROM contains additional material supporting
the information in

Chapter 20:
Validation and Ranking Methodologies for Solar Radiation Models

of the book:
Modeling Solar Radiation at the Earth's Surface.
Recent Advances

published by Springer-Verlag, Heidelberg

November 2007
-------------------------------------

This directory contains the following text files:

1. 'Models_performance_compar.f'
A Fortran 77 program that calculates the direct, diffuse and
global irradiances from 38 radiation models.
This program uses the input file 'Models_perf_exp.dat.txt' and
outputs the file 'Models_perf_exp.out.txt', which are both
described below.
This source file needs to be formatted with the proper "line feed"
for your operating system (if different from Unix) and compiled. An
executable for PowerPC Macintosh computers is provided (see below).


2. 'Models_performance_compar_exe'
Executable of the previous file for PowerPC Macintosh computers. To
execute, open the Terminal, change directory (command 'cd') to the exact
location of this executable, and type './Models_performance_compar_exe'.


3. 'Models_perf_exp.dat.txt'
Sample input data file for the Fortran program defined above. This
text file needs to be formatted with the proper "line feed" for
your operating system (if different from Unix), and saved under
the same name.
This file contains the benchmark data described in Gueymard
(2007).
The first line is a comment:
Benchmark_test_AIOP_May03

The second line is read only once at run time by the Fortran
program. It must contain: latitude, longitude, altitude, time
zone, time shift, max. allowable zenith angle; all sperated by
tabs, spaces or commas.
Example: 36.605     -97.493   0.318     -6   0    85

The third line is a comment; currently it is the header for all
the rows that follow it. The description of these inputs is in the
Fortran file.
Example: year  month     day  LST  p    w   uo   un   beta2    alfa1
alfa2     piar1     piar2     rhog alpha     beta T
DNI_measured   Diffuse_measured    Global_measured

The fourth to Nth line contain the sequential input data, one row per
data point.
In this example file, there are 30 rows for as amny data points.
Note that, for this sample file, three extra columns have been
added. They are the measured direct, diffuse and global irradiance
data for this benchmark dataset. They are not used by the program,
but are provided to allow further comparisons betweeen the models'
predictions and the corresponding measurements.


4. 'Models_perf_exp.out.txt'
Output data file for the Fortran program defined above. This file
can be imported into spreadsheet or statistical software for
further processing.

