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
  • snow_flag: TBD
  • 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.