PhenoCam 1-day and 3-day Summary File Format
An example 1-day summary file is shown below (for display purposes I've broken the lines with a '\' character). The format of the 3-day file is identical and only the aggregation period changes.
# # 1-day summary product time series for coweeta # # Site: coweeta # Veg Type: DB # ROI ID Number: 0001 # Lat: 35.05959 # Lon: -83.42798 # Elev: 680 # UTC Offset: -5 # Image Count Threshold: 1 # Aggregation Period: 1 # Solar Elevation Min: 10.0 # Time of Day Min: 00:00:00 # Time of Day Max: 23:59:59 # ROI Brightness Min: 100 # ROI Brightness Max: 665 # Creation Date: 2017-02-20 # Creation Time: 09:59:45 # Update Date: 2017-06-15 # Update Time: 05:19:17 # date,year,doy,image_count,midday_filename,midday_r,midday_g,midday_b,midday_gcc,\ midday_rcc,r_mean,r_std,g_mean,g_std,b_mean,b_std,gcc_mean,gcc_std,gcc_50,\ gcc_75,gcc_90,rcc_mean,rcc_std,rcc_50,rcc_75,rcc_90,max_solar_elev,snow_flag,\ outlierflag_gcc_mean,outlierflag_gcc_50,\ outlierflag_gcc_75,outlierflag_gcc_90 2011-04-14,2011,104,20,coweeta_2011_04_14_120136.jpg,85.67173,75.03478,36.48126,\ 0.38052,0.43447,86.51166,9.91545,74.77882,7.53882,41.37125,4.47597,0.36936,\ 0.03041,0.37652,0.37871,0.38066,0.42636,0.03012,0.42873,0.43566,0.45320,\ 64.40871,NA,NA,NA,NA,NA 2011-04-15,2011,105,18,coweeta_2011_04_15_113133.jpg,67.15529,56.44736,24.72372,\ 0.38056,0.45275,58.76109,7.57250,51.56902,6.21108,24.68852,2.01272,0.38167,\ 0.00429,0.38064,0.38499,0.38705,0.43451,0.01100,0.43452,0.44175,0.44833,\ 64.76784,NA,NA,NA,NA,NA
Comment lines at the beginning of the file are preceeded with '# ' and include some basic site metadata along with creation and update dates and times. The number of comment lines and the metadata may change as we get more experience using these file. Dates for which there are no images (or none passing the selection criteria have empty fields as show in the second data line above. When a particular value cannot be calculated it is given a "no data" value of -9999. The last two fields are currently set to this "no data" value as we work on our algorithms for filling these flags.
The columns in the file are described below:
date: local date of middle of time period (1-day or 3-day)
doy: doy for this date. The date/doy values chosen are for fixed days-of-year.
(For the 3-day summary file these will be doy=2, 5, 8, etc.)
image_count: number of images passing the selection criteria
midday_filename: filename for an image which is closest to noon (midday image) on the middle day of summary period
midday_r: mean red DN over ROI for the midday image
midday_g: mean green DN over ROI for the midday image
midday_b: mean blue DN over ROI for thie midday image
midday_gcc: GCC over ROI for midday image
midday_rcc: RCC over ROi for midday image
r_mean: mean value (for all images passing the selection criteria) of the mean red DN over the ROI
r_std: standard deviation of red DN's for same
g_mean: mean value (for all images passing the selection criteria) of the mean green DN over the ROI
g_std: standard deviation of green DN's for same
b_mean: mean value (for all images passing the selection criteria) of the mean blue DN over the ROI
b_std: standard deviation of blue DN's for same
gcc_mean: mean value (for all images passing the selection criteria) of the GCC over the ROI
gcc_std: std. dev. of GCC for same
gcc_90: 90th percentile value for GCC for same
rcc_mean: mean value (for all images passing the selection criteria) of the RCC over the ROI
rcc_std: std. dev. of RCC for same
rcc_90: 90th percentile value for RCC for same
max_sza: maximum solar zenith angle for all images passing selection criteria
outlierflag_gcc_xx: the outlierflag, which is determined separately for the gcc_mean, gcc_50, gcc_75, and gcc_90 time series, can either take on a value of 0 (indicating good data), or 1 (indicating an outlier)
The current default selection criteria is to exclude only image images with a solar zenith angle of less than 10 degrees (above horizon). The summary files are produced from the "all-image" files or ROI Timeseries so implementing your own selection criteria using the fields in that file should be straight forward.