30.09.2014 Views

Package 'extRemes' - What are R and CRAN?

Package 'extRemes' - What are R and CRAN?

Package 'extRemes' - What are R and CRAN?

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

18 decluster<br />

which.cols<br />

which.plot<br />

method<br />

clusterfun<br />

groups<br />

r<br />

replace.with<br />

numeric of length one or two. The first component tells which column is the one<br />

to decluster, <strong>and</strong> the second component tells which, if any, column is to serve as<br />

groups.<br />

character string naming the type of plot to make.<br />

character string naming the declustering method to employ.<br />

character string naming a function to be applied to the clusters (the returned<br />

value is used). Typically, for extreme value analysis (EVA), this will be the<br />

cluster maximum (default), but other options <strong>are</strong> ok as long as they return a<br />

single number.<br />

numeric of length x giving natural groupings that should be considered as separate<br />

clusters. For example, suppose data cover only summer months across<br />

several years. It would probably not make sense to decluster the data across<br />

years (i.e., a new cluster should be defined if they occur in different years).<br />

integer run length stating how many threshold deficits should be used to define<br />

a new cluster.<br />

number, NaN, Inf, -Inf, or NA. <strong>What</strong> should the remaining values in the cluster<br />

be replaced with? The default replaces them with threshold, which for most<br />

EVA purposes is ideal.<br />

na.action function to be called to h<strong>and</strong>le missing values.<br />

xlab, ylab, main, col<br />

optioal arguments to the plot function. If not used, then reasonable default<br />

values <strong>are</strong> used.<br />

... optional arguments to decluster.runs or clusterfun.<br />

plot: optional arguments to plot.<br />

Not used by print.<br />

Details<br />

Runs declustering (see Coles, 2001 sec. 5.3.2): Extremes separated by fewer than r non-extremes<br />

belong to the same cluster.<br />

Intervals declustering (Ferro <strong>and</strong> Segers, 2003): Extremes separated by fewer than r non-extremes<br />

belong to the same cluster, where r is the nc-th largest interexceedance time <strong>and</strong> nc, the number of<br />

clusters, is estimated from the extremal index, theta, <strong>and</strong> the times between extremes. Setting theta<br />

= 1 causes each extreme to form a separate cluster.<br />

The print statement will report the resulting extremal index estimate based on either the runs or<br />

intervals estimate depending on the method argument as well as the number of clusters <strong>and</strong> run<br />

length. For runs declustering, the run length is the same as the argument given by the user, <strong>and</strong> for<br />

intervals method, it is an estimated run length for the resulting declustered data. Note that if the<br />

declustered data <strong>are</strong> independent, the extremal index should be close to one (if not equal to 1).<br />

Value<br />

A numeric vector of class “declustered” is returned with various attributes including:<br />

call<br />

the function call.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!