eof {wql}R Documentation

Empirical orthogonal function analysis

Description

Finds and rotates empirical orthogonal functions (EOFs).

Usage

eof(x, n, scale. = TRUE)

Arguments

x

a data frame or matrix, with no missing values

n

number of EOFs to retain for rotation

scale.

logical indicating whether the (centered) variables should be scaled to have unit variance

Details

EOF analysis is used to study patterns of variability (“modes”) in a matrix time series and how these patterns change with time (“amplitude time series”). Hannachi et al. (2007) give a detailed discussion of this exploratory approach with emphasis on meteorological data. In oceanography and climatology, the time series represent observations at different spatial locations (columns) over time (rows). But columns can also be seasons of the year (Jassby et al. 1999) or even a combination of seasons and depth layers (Jassby et al. 1990). EOF analysis uses the same techniques as principal component analysis, but the time series are observations of the same variable in the same units. Scaling the data is optional, but it is the default here.

Eigenvectors (unscaled EOFs) and corresponding eigenvalues (amount of explained variance) are found by singular value decomposition of the centered and (optionally) scaled data matrix using prcomp. In order to facilitate a physical interpretation of the variability modes, a subset consisting of the n most important EOFs is rotated (Richman 1986). eofNum can be used to help choose n. Hannachi et al. (2007) recommend orthogonal rotation of EOFs scaled by the square root of the corresponding eigenvalues to avoid possible computation problems and reduce sensitivity to the choice of n. We follow this recommendation here, using the varimax method for the orthogonal rotation.

Note that the signs of the EOFs are arbitrary.

Value

A list with the following members:

REOF

a matrix with rotated EOFs

amplitude

a matrix with amplitude time series of REOFs

eigen.pct

all eigenvalues of correlation matrix as percent of total variance

variance

variance explained by retained EOFs

Author(s)

Alan Jassby, James Cloern

References

Hannachi, A., Jolliffe, I.T., and Stephenson, D.B. (2007) Empirical orthogonal functions and related techniques in atmospheric science: A review. International Journal of Climatology 27, 1119–1152.

Jassby, A.D., Powell, T.M., and Goldman, C.R. (1990) Interannual fluctuations in primary production: Direct physical effects and the trophic cascade at Castle Lake, California (USA). Limnology and Oceanography 35, 1021–1038.

Jassby, A.D., Goldman, C.R., Reuter, J.E., and Richards, R.C. (1999) Origins and scale dependence of temporal variability in the transparency of Lake Tahoe, California-Nevada. Limnology and Oceanography 44, 282–294.

Richman, M. (1986) Rotation of principal components. Journal of Climatology 6, 293–335.

See Also

eofNum, eofPlot, monthCor, ts2df

Examples


# Create an annual matrix time series
chla1 <- aggregate(sfbayChla, 1, mean, na.rm = TRUE)
chla1 <- chla1[, 1:12]  # remove stations with missing years
# eofNum (see examples) suggests n = 1
eof(chla1, 1)


[Package wql version 1.0.1 Index]