eventstudies (version 1.2.2)

eesSummary: Summary statistics of extreme events

Description

This function generates summary statistics for identification and analysis of extreme events.

Usage

eesSummary(input)

Arguments

input

object returned by ‘get.clusters.formatted’

Value

A list object containing:

data.summary

a ‘data.frame’ containing summary of the minimum, maximum, inter-quartile range, mean, median, standard deviation and quantile values at 5%, 25%, 75% and 95%.

lower.tail

a ‘list’ that contains ‘extreme.event.distribution’, ‘runlength’, ‘quantile.values’ and ‘yearly.extreme.event’ for the events on the lower tail of the distribution. See ‘Details’.

upper.tail

a ‘list’ that contains ‘extreme.event.distribution’, ‘runlength’, ‘quantile.values’ and ‘yearly.extreme.event’ for the events on the upper tail of the distribution. See ‘Details’.

Details

This function generates summary statistics of extreme events, using the tail events as returned by the function ‘get.clusters.formatted’.

Following statistics are generated for both lower and upper tail events:

• ‘extreme.event.distribution’ provides summary statistics on the number of consecutive events (“clustered” events) and those that are not (“unclustered” events). Consecutive events that are “mixed”, i.e., with upper (lower) tail event occurring after a lower (upper) tail event, are classified separately.

• ‘runlength’: When events are “clustered”, ‘runlength’ classifies such clusters into different duration bins.

• ‘quantile.values’: Within such events, ‘quantile.values’ provide the probability distribution values at 0%, 25%, 50%, 75% and 100%, alongside the mean.

• ‘yearly.extreme.event’: A year-wise tabulation of such extreme events, with a clustered event taken as one event.

References

Ila Patnaik, Nirvikar Singh and Ajay Shah (2013). Foreign Investors under stress: Evidence from India. International Finance, 16(2), 213-244. http://onlinelibrary.wiley.com/doi/10.1111/j.1468-2362.2013.12032.x/abstract http://macrofinance.nipfp.org.in/releases/PatnaikShahSingh2013_Foreign_Investors.html

Examples

# NOT RUN {
data(OtherReturns)

formattedClusters <- get.clusters.formatted(event.series = OtherReturns[, "SP500"],
                                          response.series = OtherReturns[, "NiftyIndex"])

ees.summary.tables <- eesSummary(formattedClusters)
str(ees.summary.tables, max.level = 2)
# }