matrixplot: Matrixplot

In hzambran/hydroTSM: Time Series Management and Analysis for Hydrological Modelling

Matrixplot

Description

Plots a color matrix, representing the values stored in x.
Originally, it was thought to represent the amount of days with information per year in a set of gauging stations, but it can be used for plotting the information stored in any two dimensional matrix.

Usage

matrixplot(x, ColorRamp="Days", ncolors = 70, main = "", 
           cuts,  cuts.dec=2, cuts.labels, 
           cuts.style=c("equal", "pretty", "fixed", "sd", "quantile", "kmeans", "bclust", "fisher"), 
           legend.cex=1.1,  legend.title="",  legend.title.cex=1.5, legend.fontsize=15, ...)

Arguments

x	matrix to be plotted. Originally: -) Each column of x represent a different gauging station, and it stores the values measured on it -) Each row of x represent the years, and they stores the amount of days with information in each station
ColorRamp	Character or function defining a personalized color ramp for plotting the maps. Valid character values are in c("Days", "Precipitation", "Temperature", "PCPAnomaly", "PCPAnomaly2" "TEMPAnomaly", "TEMPAnomaly2", "TEMPAnomaly3").
ncolors	numeric, indicating the number of color intervals that will be used for representing the information content of x.
main	Main title for the plot
cuts	Numeric, indicating the values used to divide the range of 'x' in the legend of colours. If not provided, it is automatically selected as a function of 'lenght(ColorRamp)'.
cuts.dec	Number of decimal places used to present the numbers that divide the range of 'x' in the legend of colours.
cuts.labels	Character indicating the label to be used in the ccolour legend for each one of the values defined by 'cuts'. If not provided, as.character(cuts)' is used.
cuts.style	character, indicating how to finding class intervals for continuous numerical variables for choosing colours to be used in the figure. See classIntervals
legend.cex	character expansion factor *relative* to current par("cex") used for the legend text.
legend.title	text to be displayed above the legned of colours (e.g., showing the measurement units of the raster being displayed).
legend.title.cex	expansion factor(s) for the legend title. Currently it is not used. See legend.fontsize instead.
legend.fontsize	size of text (in points) used in the legend title (e.g., showing the measurement units of the raster being displayed).
...	further arguments passed to levelplot function (lattice package) or from other methods

Note

Adapted from a not available web page (http://www2.warwick.ac.uk/fac/sci/moac/currentstudents/peter_cock/r/matrix_contour/)

Author(s)

Mauricio Zambrano-Bigiarini, mzb.devel@gmail

See Also

dwi, classIntervals

Examples

## Loading the SanMartino precipitation data
data(SanMartinoPPts)

# Selecting only the values up to Dec/1960
x <- window(SanMartinoPPts, end=as.Date("1960-12-31"))

## Daily zoo to monthly zoo
m <- daily2monthly(x, FUN=sum, na.rm=TRUE)

# Creating a data.frame with monthly values per year in each column
M <- matrix(m, ncol=12, byrow=TRUE)
colnames(M) <- month.abb
rownames(M) <- unique(format(time(m), "%Y"))

# Plotting the monthly precipitation values from 1921 to 1960.
# Useful for identifying dry/wet months
matrixplot(M, ColorRamp="Precipitation", 
           main="Monthly precipitation at San Martino st., [mm/month]")

hzambran/hydroTSM documentation built on June 13, 2025, 11:48 a.m.