amos_uroi_wrap: Wrapper function for analyzing data from AMOS

In phenofun: Automated Processing of Webcam Images for Phenological Classification

Description

This function allows to analyze webcam data from AMOS (http://amos.cse.wustl.edu/) with the uROI method in a fully automated way. Only the parameters of camera, year, month and hour of images to be analyzed have to be specified. Example code can be downloaded at http://bothmann.userweb.mwn.de/dissertation.html.

Usage

amos_uroi_wrap(camera, year_analysis, months_analysis, hour_analysis,
  do_mean_greenness = TRUE, do_strucchange = TRUE, testmode = FALSE,
  only_download = FALSE, folder_results = getwd(),
  name_of_analysis = substr(as.character(Sys.time()), 1, 10),
  folder_data = getwd(), n_pc_vec = 12, k_vec = 4:10, nstart = 2,
  save_results = TRUE, save_masks = TRUE, masks_type = ".jpg",
  a_vec = seq(1, 150, by = 1), b_vec = seq(1, 100, by = 1), mask = NULL,
  ...)

Arguments

camera	Name of the camera (five-digit number, see http://amos.cse.wustl.edu/)
year_analysis	Year(s) to be analyzed as vector
months_analysis	Month(s) to be analyzed as vector
hour_analysis	Hour(s) to be analyzed as vector
do_mean_greenness	If TRUE (default), time series of percentage greenness inside the ROIs are computed
do_strucchange	If TRUE (default), points of structural changes are searched for and OC values are computed
testmode	If TRUE, only 10 images for testing are analyzed, default is FALSE
only_download	If TRUE, images are downloaded but not analyzed, default is FALSE
folder_results	Folder where the results will be saved, default is the current working directory
name_of_analysis	Name of subfolder for the results of the analysis, default is the date as yyyy-mm-dd
folder_data	Folder where the data will be saved, default is the current working directory
n_pc_vec	Vector of numbers of eigenimages
k_vec	Vector of numbers of clusters for k-means
nstart	Number of iterations k-means
save_results	If TRUE (default), results of clustering are saved
save_masks	If TRUE (default), masks are saved
masks_type	File name extension of masks, default is .jpg
a_vec	Possible spring doys
b_vec	Possible autumn doys (counted backwards from 31.12.)
mask	Do not edit, masks will be loaded automatically
...	Further arguments

Value

As output, all resulting masks and percentage greenness time series inside the masks are saved in subfolders of folder_results. Additionally, overlays of all masks of the best setting with a background image and the background image itself are saved in folder_results, ordered with respect to optimality criterion OC2.

phenofun documentation built on Jan. 22, 2017, 9:01 p.m.