climograph | R Documentation |

Function to draw a climograph based on precipitation and air temperature data, with several options for customisation.

```
climograph(pcp, tmean, tmx, tmn, na.rm=TRUE,
from, to, date.fmt="%Y-%m-%d",
main="Climograph", pcp.label="Precipitation, [mm]",
tmean.label="Air temperature, [\U00B0 C]", start.month=1, pcp.solid.thr,
pcp.ylim, temp.ylim,pcp.col="lightblue", pcp.solid.col="skyblue2",
tmean.col="darkred", tmn.col="blue", tmx.col="red",
pcp.labels=TRUE,
tmean.labels=TRUE, tmx.labels=TRUE, tmn.labels=TRUE,
pcp.labels.cex=0.8, temp.labels.cex=0.8,
pcp.labels.dx=c(rep(ifelse(plot.pcp.probs, -0.25, 0.0),6),
rep(ifelse(plot.pcp.probs, -0.25, 0.0),6)),
pcp.labels.dy=rep(2, 12),
temp.labels.dx=c(rep(-0.2,6), rep(0.2,6)), temp.labels.dy=rep(-0.4, 12),
plot.pcp.probs=TRUE, pcp.probs=c(0.25, 0.75),
plot.temp.probs=TRUE, temp.probs=c(0.25, 0.75),
temp.probs.col=c("#3399FF", "#FF9966", "#FFCC66"),
temp.probs.alpha=0.3,
lat, lon
)
```

`pcp` |
variable of type zoo with monthly, daily or subdaily precipitation data. |

`tmean` |
variable of type 'zoo' with monthly, daily or subdaily mean temperature data. |

`tmx` |
variable of type 'zoo' with monthly, daily or subdaily maximum temperature data. |

`tmn` |
variable of type 'zoo' with monthly, daily or subdaily minimum temperature data.
ONLY used (together with |

`na.rm` |
Logical. Should missing values be removed? |

`from` |
OPTIONAL, used for extracting a subset of values. |

`to` |
OPTIONAL, used for extracting a subset of values. |

`date.fmt` |
Character indicating the format in which the dates are stored in |

`main` |
Character representing the main title of the plot. |

`pcp.label` |
Character used in the legend to represent the monthly average precipitation (mostly thought for languages different from English). |

`tmean.label` |
Character used in the legend to represent the monthly average temperature (mostly thought for languages different from English). |

`start.month` |
[OPTIONAL]. Only used when the (hydrological) year of interest is different from the calendar year. numeric in [1:12] indicating the starting month of the (hydrological) year. Numeric values in [1, 12] represents months in [January, December]. By default |

`pcp.solid.thr` |
[OPTIONAL]. Only used when using (sub)daily precipitation and temperature are gives as input data. When daily |

`pcp.ylim` |
[OPTIONAL] numeric of length 2 with the the range used for the precipitation axis. The second value should be larger than the first one. |

`temp.ylim` |
[OPTIONAL] numeric of length 2 with the the range used for the secondary temperature axis. The second value should be larger than the first one. |

`pcp.col` |
Color used in the legend to represent the monthly average precipitation. |

`pcp.solid.col` |
Color used in the legend to represent the monthly average solid precipitation. |

`tmean.col` |
Color used in the legend to represent the monthly average temperature. |

`tmn.col` |
Color used in the legend to represent the monthly minimum temperature. |

`tmx.col` |
Color used in the legend to represent the monthly maximum temperature. |

`pcp.labels` |
logical. Should monthly precipitation values to be shown above the bars?. By default |

`tmean.labels` |
logical. Should monthly mean temperature values to be shown above the lines?. By default |

`tmx.labels` |
logical. Should monthly maximum temperature values to be shown above the lines?. By default |

`tmn.labels` |
logical. Should monthly minimum temperature values to be shown above the lines?. By default |

`pcp.labels.cex` |
numeric giving the amount by which plotting characters used to show the numeric values of monthly precipitation values are scaled relative to the default. |

`temp.labels.cex` |
numeric giving the amount by which plotting characters used to show the numeric values of monthly air temperature values (mean, maximum, minimum) are scaled relative to the default. |

`pcp.labels.dx` |
numeric of length 12 giving the amount of horizontal coordinate positions that have to be used to shift the labels of monthly precipitation values. |

`pcp.labels.dy` |
numeric of length 12 giving the amount of vertical coordinate positions that have to be used to shift the labels of monthly precipitation values. |

`temp.labels.dx` |
numeric of length 12 giving the amount of horizontal coordinate positions that have to be used to shift the labels of monthly air temperature values (mean, maximum, minimum). |

`temp.labels.dy` |
numeric of length 12 giving the amount of vertical coordinate positions that have to be used to shift the labels of monthly air temperature values (mean, maximum, minimum). |

`plot.pcp.probs` |
logical used to decide whether to show uncertainty values around the monthly mean precipitation values. By default |

`pcp.probs` |
numeric of length 2. It defines the quantile values used to compute the lower an upper uncertainty bounds for each one of the 12 monthly precipitation values. |

`plot.temp.probs` |
logical used to decide whether to show uncertainty values around the monthly mean temperature values. By default |

`temp.probs` |
numeric of length 2. It is used to define quantile values used to compute the lower an upper uncertainty bounds for each one of the 12 monthly mean temperature values. |

`temp.probs.col` |
character of length 3, with the colors used to for plotting the uncertainty bands around the average monthly values of the minimum, mean and maximum air temperature, respectively. |

`temp.probs.alpha` |
numeric of length 1, with the factor used to modify the opacity of |

`lat` |
[OPTIONAL] numeric or character used to show the latitude for which the climograph was plotted for. |

`lon` |
[OPTIONAL] numeric or character used to show the longitude for which the climograph was plotted for. |

If the output climograph present some mixed or not legible characters, you might try resizing the graphical window and run climograph again with the new size, until you get the climograph in the way you want to.

Mauricio Zambrano-Bigiarini, mzb.devel@gmail

`monthlyfunction`

```
######################
## Ex1: Loading the DAILY precipitation, maximum and minimum air temperature at
## station Maquehue Temuco Ad (Chile)
data(MaquehueTemuco)
pcp <- MaquehueTemuco[, 1]
tmx <- MaquehueTemuco[, 2]
tmn <- MaquehueTemuco[, 3]
## Plotting a full climograph
m <- climograph(pcp=pcp, tmx=tmx, tmn=tmn, na.rm=TRUE,
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## Not run:
## Plotting a climograph with uncertainty bands around mean values,
## but with no labels for tmx and tmn
m <- climograph(pcp=pcp, tmx=tmx, tmn=tmn, na.rm=TRUE, tmx.labels=FALSE, tmn.labels=FALSE,
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## Plotting a climograph with uncertainty bands around mean values, but with no labels for
## tmx, tmn and pcp
m <- climograph(pcp=pcp, tmx=tmx, tmn=tmn, na.rm=TRUE,
pcp.labels=FALSE, tmean.labels=FALSE, tmx.labels=FALSE, tmn.labels=FALSE,
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## Plotting a climograph with no uncertainty bands around mean values
m <- climograph(pcp=pcp, tmx=tmx, tmn=tmn, na.rm=TRUE, plot.pcp.probs=FALSE, plot.temp.probs=FALSE,
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## Plotting the most basic climograph: only mean values of precipiation and air temperature
m <- climograph(pcp=pcp, tmean=0.5*(tmn+tmx), na.rm=TRUE, plot.pcp.probs=FALSE,
plot.temp.probs=FALSE, main="Maquehue Temuco Ad (Chile)",
lat=-38.770, lon=-72.637)
## Plotting a full climograph, starting in April (start.month=4) instead of January (start.month=1),
## to better represent the hydrological year in Chile (South America)
m <- climograph(pcp=pcp, tmx=tmx, tmn=tmn, na.rm=TRUE,
start.month=4, temp.labels.dx=c(rep(-0.2,4), rep(0.2,6),rep(-0.2,2)),
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## Plotting a full climograph with monthly data
pcp.m <- daily2monthly(pcp, FUN=sum)
tmx.m <- daily2monthly(tmx, FUN=mean)
tmn.m <- daily2monthly(tmn, FUN=mean)
m <- climograph(pcp=pcp.m, tmx=tmx.m, tmn=tmn.m, na.rm=TRUE,
main="Maquehue Temuco Ad (Chile)", lat=-38.770, lon=-72.637)
## End(Not run)
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.