output column content of HelioClim-3 webservices

Last update: June 2017

HC3 unified format:

• HC3 unified format for the horizontal plane
• HC3 unified format for fix-tilted and normal plane

HC3 classic format:

\     Plane orientation Time step   \ Horizontal (GHI only) Fix-tilted (all components, horizontal and fix-tilted) Tracking (1D or 2D) (all components, horizontal and tracking) Monthly HCmonth Daily values of Global Horizontal Irradiation (GHI) average over the month HCmonthIncl Monthly irradiation values (all the radiation components) over a fix-tilted and horizontal plane HCmonthTracking Monthly irradiation values (all the radiation components) over a normal (2-D tracking) and horizontal plane Weekly HCweek Daily values of GHI average over the week - - Daily HCday Daily values of GHI HCdayIncl Daily irradiation values (all the radiation components) over a fix-tilted and horizontal plane HCdayTracking Daily irradiation values (all the radiation components) over a normal and horizontal plane Hourly HChour Hourly values of GHI HChourIncl Hourly irradiation values (all the radiation components) over a fix-tilted and horizontal plane HChourTracking Hourly irradiation values (all the radiation components) over a normal and horizontal plane 15 min (from 1 to 30 min) HC15 15 min values of GHI HC15Incl 15 min irradiation values (all the radiation components) over a fix-tilted and horizontal plane HC15Tracking 15 min irradiation values (all the radiation components) over a normal and horizontal plane

HC3 unified format - horizontal plane

1	2	3	4	5	6
Date	Time	Global Horiz	Clear-Sky	Top of Atmosphere	Code

1. Date: format yyyy-mm-dd
2. Time: format HH:MM
3. Global Horizontal irradiation over the period in Wh/m² (-999 if no data)
4. Clear-Sky: Irradiation over the period if the sky were clear in Wh/m²
5. Top of Atmosphere: Irradiation over the period at the top of the atmosphere (extraterrestrial) in Wh/m²
6. The reliability column has several forms depending of the time step:
   1. Code: 0: no data, 1: sun below horizon, 2: satellite assessment, 5: interpolation in time, 6: forecast
   2. Nb slots (%): ratio of the number of valid slots and the number of slots during the daylength in percent
   3. Nb valid days: number of valid days in the period

Top of page

HC3 unified format - fix-tilted and normal plane

1	2	3	4	5	6	7	8	9	10	11	12
Date	Time	Direct Inclined	Diffuse Inclined	Reflected	Global Inclined	Direct Horiz	Diffus Horiz	Global Horiz	Clear-Sky	Top of Atmosphere	Code

1. Date: format yyyy-mm-dd
2. Time: format HH:MM
3. Direct Inclined: irradiation over the period in Wh/m² (-999 if no data)
4. Diffuse Inclined irradiation over the period in Wh/m² (-999 if no data)
5. Reflected inclined irradiation over the period in Wh/m² (-999 if no data)
6. Global Inclined irradiation over the period in Wh/m² (-999 if no data)
7. Direct Horizontal irradiation over the period in Wh/m² (-999 if no data)
8. Diffuse Horizontal irradiation over the period in Wh/m² (-999 if no data)
9. Global Horizontal irradiation over the period in Wh/m² (-999 if no data)
10. Clear-Sky: Irradiation over the period if the sky were clear in Wh/m²
11. Top of Atmosphere: Irradiation over the period at the top of the atmosphere (extraterrestrial) in Wh/m²
12. The reliability column has several forms depending of the time step:
    1. Code: 0: no data, 1: sun below horizon, 2: satellite assessment, 5: interpolation in time, 6: forecast
    2. Nb slots (%): ratio of the number of valid slots and the number of slots during the daylength in percent
    3. Nb valid days: number of valid days in the period

Top of page

HCmonth

1	2	3	4	5	6	7	8	9	10
year	month	Irradiance	Lower bound	Upper bound	Nb valid days	Top of Atmosphere	Clear-Sky	Irradiation	Irradiation J/cm²

1. year
2. month: number of the month in the year
3. irradiance (GHI) averaged over the period in W/m² (-999 if no data)
4. lower bound of the uncertainty on the irradiance values in W/m²
5. upper bound of the uncertainty on the irradiance values in W/m²
6. Nb valid days: number of valid days in the month
7. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in W/m²
8. Cls: typical irradiance averaged over the period if the sky were clear in W/m²
9. Irradiation (GHI): monthly mean of daily irradiation in Wh/m² (-999 if no data)
10. Irradiation (GHI): monthly mean of daily irradiation in J/cm² (-999 if no data)

Top of page

HCweek

1	2	3	4	5	6	7	8	9	10	11
year	month	day	Irradiance	Lower bound	Upper bound	Nb valid days	Top of Atmosphere	Clear-Sky	Irradiation	Irradiation J/cm²

1. year
2. month: number of the month in the year
3. day: number of the first day of each week in the month
4. irradiance (GHI) averaged over the period in W/m² (-999 if no data)
5. lower bound of the uncertainty on the irradiance values in W/m²
6. upper bound of the uncertainty on the irradiance values in W/m²
7. Nb valid days: number of valid days in the week
8. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in W/m²
9. Cls: typical irradiance averaged over the period if the sky were clear in W/m²
10. Irradiation (GHI): weekly mean of daily irradiation in Wh/m² (-999 if no data)
11. Irradiation (GHI): weekly mean of daily irradiation in J/cm² (-999 if no data)

Top of page

HCday

1	2	3	4	5	6	7	8	9	10	11
	month	day	Irradiance	Lower bound	Upper bound	Nb slots	Top of Atmosphere	Clear-Sky	Irradiation	Irradiation J/cm²

1. year
2. month: number of the month in the year
3. day: number of the day in the month
4. irradiance (GHI) averaged over the period in W/m² (-999 if no data)
5. lower bound of the uncertainty on the irradiance values in W/m²
6. upper bound of the uncertainty on the irradiance values in W/m²
7. Nb slots (%): ratio of the number of valid slots and the number of slots during the daylength in percent (%)
8. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in W/m²
9. Cls: typical irradiance averaged over the period if the sky were clear in W/m²
10. irradiation (GHI) over the period in Wh/m² (-999 if no data)
11. irradiation (GHI) over the period in J/cm² (-999 if no data)

Top of page

HChour

1	2	3	4	5	6	7	8	9	10	11
	month	day	time	Irradiance	Lower bound	Upper bound	code	Top of Atmosphere	Clear-Sky	Irradiation

1. year
2. month: number of the month in the year
3. day: number of the day in the month
4. time: hour in the day
5. irradiance (GHI) averaged over the period in W/m² (-999 if no data)
6. lower bound of the uncertainty on the irradiance values in W/m²
7. upper bound of the uncertainty on the irradiance values in W/m²
8. code: 0: no data; 1: sun below horizon; 2: satellite assessment; 5: interpolation in time
9. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in W/m²
10. Cls: typical irradiance averaged over the period if the sky were clear in W/m²
11. irradiation (GHI) over the period in Wh/m² (-999 if no data)

Top of page

HC15

1	2	3	4	5	6	7	8	9	10	11
	month	day	time	Irradiance	Lower bound	Upper bound	Code	Top of Atmosphere	Clear-Sky	Irradiation

1. year
2. month: number of the month in the year
3. day: number of the day in the month
4. time: decimal hour in the day
5. irradiance (GHI) averaged over the period in W/m² (-999 if no data)
6. lower bound of the uncertainty on the irradiance values in W/m²
7. upper bound of the uncertainty on the irradiance values in W/m²
8. code: 0: no data; 1: sun below horizon; 2: satellite assessment; 5: interpolation in time
9. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in W/m²
10. Cls: typical irradiance averaged over the period if the sky were clear in W/m²
11. irradiation (GHI) over the period in Wh/m² (-999 if no data)

More information about the lower and upper bounds
From the comparisons between HelioClim-3 and the ground station measurements, a classification (bins) of bias which mostly depends on the sun position in the sky is derived. These bins are then used to compute the lower and upper bounds of the GHI for the hour slot. With this algorithm, nothing guaranties that the upper bound is lower than the clear sky value and effectively, it happens that mostly for near clear sky days that the upper bound is higher than the clear sky value.
These bounds are intended to give an estimate of the error. Here are the expressions:
Lower bound = I + relativeBias - relativeStandardDeviation
Upper bound = I + relativeBias + relativeStandardDeviation
...where the "relativeBias" and the "relativeStandardDeviation" are computed from the comparison of HelioClim-3 and the station measurements. There is a 68% chance that the actual value is comprised between lower and upper bounds.

Top of page

HCmonthincl

1	2	3	4	5	6	7	8	9	10	11
	Month	Nb valid days	Direct Inclined	Diffuse Inclined	Reflected	Global Inclined	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Nb valid days: number of valid days in the month
4. Direct inclined irradiation averaged over the period in Wh/m² (-999 if no data)
5. Diffuse inclined irradiation averaged over the period in Wh/m² (-999 if no data)
6. Reflected inclined irradiation averaged over the period in Wh/m² (-999 if no data)
7. Global inclined irradiation averaged over the period in Wh/m² (-999 if no data)
8. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HCdayIncl

1	2	3	4	5	6	7	8	9	10	11
	Month	Day	Direct Inclined	Diffuse Inclined	Reflected	Global Inclined	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. day: number of the day in the month
4. Direct inclined irradiation averaged over the period in Wh/m² (-999 if no data)
5. Diffuse inclined irradiation averaged over the period in Wh/m² (-999 if no data)
6. Reflected inclined irradiation averaged over the period in Wh/m² (-999 if no data)
7. Global inclined irradiation averaged over the period in Wh/m² (-999 if no data)
8. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HChourIncl

1	2	3	4	5	6	7	8	9	10	11	12
	Month	Day	Hour	Direct Inclined	Diffuse Inclined	Reflected	Global Inclined	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Day: number of the day in the month
4. Hour in the day
5. Direct inclined irradiation averaged over the period in Wh/m² (-999 if no data)
6. Diffuse inclined irradiation averaged over the period in Wh/m² (-999 if no data)
7. Reflected inclined irradiation averaged over the period in Wh/m² (-999 if no data)
8. Global inclined irradiation averaged over the period in Wh/m² (-999 if no data)
9. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
12. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HC15incl

1	2	3	4	5	6	7	8	9	10	11	12
	Month	Day	Hour	Direct Inclined	Diffuse Inclined	Reflected	Global Inclined	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Day: number of the day in the month
4. Hour: decimal hour in the day
5. Direct inclined irradiation averaged over the period in Wh/m² (-999 if no data)
6. Diffuse inclined irradiation averaged over the period in Wh/m² (-999 if no data)
7. Reflected inclined irradiation averaged over the period in Wh/m² (-999 if no data)
8. Global inclined irradiation averaged over the period in Wh/m² (-999 if no data)
9. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
12. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HCmonthTracking

1	2	3	4	5	6	7	8	9	10	11
	Month	Nb valid days	Direct NI	Diffuse NI	Reflected	Global NI	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Nb valid days: number of valid days in the month
4. Direct NI: direct normal irradiation averaged over the period in Wh/m² (-999 if no data)
5. Diffuse NI: diffuse normal irradiation averaged over the period in Wh/m² (-999 if no data)
6. Reflected normal irradiation averaged over the period in Wh/m² (-999 if no data)
7. Global NI: global normal irradiation averaged over the period in Wh/m² (-999 if no data)
8. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HCdayTracking

1	2	3	4	5	6	7	8	9	10	11
	Month	Days	Direct NI	Diffuse NI	Reflected	Global NI	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Days: number of the day in the month
4. Direct NI: direct normal irradiation averaged over the period in Wh/m² (-999 if no data)
5. Diffuse NI: diffuse normal irradiation averaged over the period in Wh/m² (-999 if no data)
6. Reflected normal irradiation averaged over the period in Wh/m² (-999 if no data)
7. Global NI: global normal irradiation averaged over the period in Wh/m² (-999 if no data)
8. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HChourTracking

1	2	3	4	5	6	7	8	9	10	11	12
	Month	Day	Hour	Direct NI	Diffuse NI	Reflected	Global NI	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Day: number of the day in the month
4. Hour in the day
5. Direct NI: direct normal irradiation averaged over the period in Wh/m² (-999 if no data)
6. Diffuse NI: diffuse normal irradiation averaged over the period in Wh/m² (-999 if no data)
7. Reflected normal irradiation averaged over the period in Wh/m² (-999 if no data)
8. Global NI: global normal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
12. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page

HC15Tracking

1	2	3	4	5	6	7	8	9	10	11	12
	Month	Day	Hour	Direct NI	Diffuse NI	Reflected	Global NI	Direct Horiz	Diffus Horiz	Global Horiz	Top of Atmosphere

1. year
2. month: number of the month in the year
3. Day: number of the day in the month
4. Hour: decimal hour in the day
5. Direct NI: direct normal irradiation averaged over the period in Wh/m² (-999 if no data)
6. Diffuse NI: diffuse normal irradiation averaged over the period in Wh/m² (-999 if no data)
7. Reflected normal irradiation averaged over the period in Wh/m² (-999 if no data)
8. Global NI: global normal irradiation averaged over the period in Wh/m² (-999 if no data)
9. Direct horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
10. Diffuse horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
11. Global horizontal irradiation averaged over the period in Wh/m² (-999 if no data)
12. ToA: downwards irradiance averaged over the period at the top of the atmosphere (extraterrestrial) in Wh/m²

Top of page