hydroTSM

About hydroTSM
GIT access
Download/Files
News
Check results
Package R docs

new

About hydroTSM

What is hydroTSM ?

hydroTSM is an R package that provides S3 functions for management, analysis, interpolation and plotting of time series used in hydrology and related environmental sciences. In particular, this package is highly oriented to hydrological modelling tasks.

The focus of this package has been put in providing a collection of tools useful for the daily work of hydrologists (although an effort was made to optimize each function as much as possible, functionality has had priority over speed).

Bugs / comments / questions / collaboration of any kind are very welcomed, and in particular, datasets that can be included in this package for academic purposes.

Installation

# Stable version install.packages("hydroTSM") # Latest (under-development) releaseinstall.packages("hydroTSM",, "http://rforge.net/", type="source")

Package Description

Package: hydroTSM Version: 0.6-3 Title: Time Series Management, Analysis and Interpolation for Hydrological Modelling Maintainer: Mauricio Zambrano-Bigiarini Description: S3 functions for management, analysis, interpolation and plotting of time series used in hydrology and related environmental sciences. In particular, this package is highly oriented to hydrological modelling tasks. The focus of this package has been put in providing a collection of tools useful for the daily work of hydrologists (although an effort was made to optimise each function as much as possible, functionality has had priority over speed). Bugs / comments / questions / collaboration of any kind are very welcomed, and in particular, datasets that can be included in this package for academic purposes. Depends: R (>= 2.10.0), zoo (>= 1.7-2), xts (>= 0.9-7) License: GPL (>=2)

Citation

citation("hydroTSM")

Vignette

http://cran.r-project.org/web/packages/hydroTSM/vignettes/hydroTSM_Vignette.pdf

Related Material

R: a statistical environment for hydrological analysis (abstract)
R: a statistical environment for hydrological analysis (poster)

BugReports

https://www.rforge.net/bugzilla/describecomponents.cgi?product=hydroTSM

What's New?

NEWS/ChangeLog for hydroTSM -------------------------- 0.7-0 (under-development) o new function: `subhourly2hourly' for aggregating sub-hourly values into hourly ones. o `hydroplot' : -) now works correctly with zoo objects that have multiple columns, and separate (internal) functions are provided for zoo and data.frame objects. -) `from' argument has a default value of NULL -) `to' argument has a default value of NULL -) new argument `dates' in order to facilitate the transformation into zoo when working with data.frame objects o `sname2plot' : -) now works correctly with zoo objects that have multiple columns, and separate (internal) functions are provided for zoo and data.frame objects. -) `from' argument has a default value of NULL -) `to' argument has a default value of NULL o `climograph' : -) now it plots the minimum and maximum temperature when they are provided -) new argument `tmn.col' to choose the color to be used to plot the minimum monthly temperature -) new argument `tmx.col' to choose the color to be used to plot the maximum monthly temperature -) new argument `pcp.labels' to decide whether to show the numeric values above the monthly precipitation bars -) new argument `tmean.labels' to decide whether to show the numeric values above the monthly mean temperature lines -) new argument `tmx.labels' to decide whether to show the numeric values above the monthly maximum temperature lines -) new argument `tmn.labels' to decide whether to show the numeric values above the monthly minimum temperature lines o subdaily2daily': -) new argument start.fmt' to indicate the format used to provide `start' -) new argument tz' to indicate the time zone used for both start' argument and the datetimes of the object o NAMESPACE file: -) hydroplot' and sname2plot' are now exported S3 methods 0.6-0 11-Mar-2020 o Package tested against R Under development (unstable) (2020-03-10 r77920) -- "Unsuffered Consequences", following an imperative request made by CRAN. o Vignette on Introductory Analysis of Daily Precipitation was moved from Sweave to Knitr and now includes a climograph example o subdaily2daily' : new argument start' to allow daily observations start at any time different from 00:00:00 UTC. o `time2season' : class of objects is now tested in a way compatible with the upcoming R 4.0.0 o `dm2seasonal' : class of objects is now tested in a way compatible with the upcoming R 4.0.0 o `matrixplot' : class of objects is now tested in a way compatible with the upcoming R 4.0.0 0.5-1 07-Aug-2017 (after CRAN comments) o DESCRIPTION file : -) `Keywords' field completly removed o dwi' : -) some examples were wrapped into dontrun' to avoid running times larger than 10s in CRAN. 0.5-0 07-Aug-2017 o repository management moved from SVN to GIT, including rforge. o citation with DOI is now possible (and new CITATION file). o new function `climograph' to draw a climograph based on precipitation and temperature data. o subdaily2daily' : -) now it works with several (all?) FUN functions, including sum', min', max'. (thanks to Jamis Bruening !)) o subdaily2daily' : -) now it works with several (all?) FUN functions, including sum', min', max'. (thanks to Jamis Bruening !)) o monthlyfunction' : -) argument ...' is now taken into account. o seasonalfunction' : -) argument ...' is now taken into account. o annualfunction' : -) argument ...' is now taken into account. o `hydrokrige' : -) 'require(maptools)' was replaced by 'requireNamespace("maptools", quietly = TRUE)' -) calls to overlay' were replaced by calls to over' because overaly' was deprecated in sp' 1.1-0. -) new examples about how to get the interpolated values in each cell and polygon when 'type="both"' is used (thanks to Jochen Scholtes !) o 'mspplot ' : -) 'require(maptools)' was replaced by 'requireNamespace("maptools", quietly = TRUE)' o `hypsometric' : -) fixed (very unusual) error: "Error en integrate(f = f, lower = 0, upper = 1) : maximum number of subdivisions reached" (thanks to Jose Martinez Batlle !) o extract' : -) trgt' argument allows multiple months or years to be selected (when 'class(trgt) c("integer", "numeric")') o fdc' : -) cex.lab' argument is working now (thanks to Elcin Tan !). -) new example about computing streamflow values corresponding to a given percentage of time equalled or exceeded (thanks to Prajjwal Panday !) -) corrected small error in the documentation of lQ.thr' and hQ.thr' (thanks to Luis Andrés Guillén !) o `daily2annual.zoo' : -) fixed bug appeared in R 3.2.x (or 3.1.2) which raised an error for data.frames when 'out.fmt="%Y"': Error in format.default(structure(as.character(x), names = names(x), dim = dim(x), : o 'drawTimeAxis : -) new argument `mgp' to provide greater flexibility. o DESCRIPTION file : -) sp' now requires version >= 1.1-0, because overlay' was deprecated in that version of `sp' -) lattice' package was moved from Suggests' to Imports' (use of levelplot' function in `matrixplot'). -) maptools' package was moved from Suggests' to Imports' (use of readShapePoly' function in `hydrokrige') -) Packages stats', utils', methods', graphics', `grDevices' are now added in the Imports section. -) CRAN website removed from URL field in DESCRIPTION file (requested by CRAN). Only https://github.com/hzambran/hydroTSM is shown now. o NAMESPACE file : -) several functions explicitly imported from the c(stats, utils, methods, graphics, grDevices) to be compatible with R 3.3.0. -) `plot.xts' NOT used anymore, to avoid error raised by xts>=0.10-0 -) index' and 'time<-' imported from zoo' package. -) over', 'coordinates<-', 'proj4string<-' imported from sp' package. -) readShapePoly' imported from maptools' package. -) start', end' and window', aggregate' are now explicitly imported from the stats' package (affects dwi', izoo2rzoo' and monthlyfunction') -) Fifty three (53) S3 methods are now registered. 0.4-2-1 22-Jan-2014 (after CRAN comments) o `Author' field was removed from DESCRIPTION file o WhatsNew.txt' file was renamed ChangeLog' o dwi' : part of the Examples' section was marked as `dontrun', because it execution took more than 5 seconds. o mspplot': part of the Examples' section was marked as `dontrun', because it execution took more than 5 seconds. 0.4-2 21-Jan-2014 o fdc' : -) lwd' argument is now used (thanks to Bernard Bisselink !) -) fixed error raised when some element(s) in x were equal to zero, 'plot=TRUE' and 'log=y' or 'log=xy' (thanks to David Young !). The error was: Error in xy.coords(x, y, xlabel, ylabel, log) : x' and y' lengths differ o sname2plot' : dates' argument is not required any more o sname2ts' : dates' argument is not required any more o monthlyfunction.matrix' : dates' argument is not required any more o monthlyfunction.data.frame' : dates' argument is not required any more o annualfunction.matrix' : dates' argument is not required any more o annualfunction.data.frame' : dates' argument is not required any more o seasonalfunction.matrix' : dates' argument is not required any more o seasonalfunction.data.frame': dates' argument is not required any more o daily2annual.matrix' : dates' argument is not required any more o daily2annual.data.frame' : dates' argument is not required any more o daily2monthly.matrix' : dates' argument is not required any more o daily2monthly.data.frame' : dates' argument is not required any more o dm2seasonal.matrix' : dates' argument is not required any more o dm2seasonal.data.frame' : dates' argument is not required any more o hydrokrige.data.frame' : dates' argument is not required any more o dwi.data.frame' : dates' argument is not required any more o 'maptools:::readShapePoly' was replaced by 'maptools::readShapePoly' in all the package (functions hydrokrige' and mspplot') o 'require(xts)' was removed from `hydroplot' o zoo' package removed from Imports' and `Enhances' (due to changes in CRAN policies) o xts' package removed from Imports' (due to changes in CRAN policies) o improved vignette (moved from Sweave to knitr) 0.4-1 31-May-2013 o DESCRIPTION : xts' package was added to the Imports' section o `fdc' : truncation of some lines in the PDF manual are fixed now. o `sname2plot': truncation of some lines in the PDF manual are fixed now. 0.4-0 31-May-2013 o major changes: -) all the functions should now be compatible with sub-daily time series. See details below. -) package is now tested against R 3.0.X -) updated vignette. Now it includes some examples about computation of extreme indices of daily precipitation. -) new dataset: `KarameaAtGorgeQts', with hourly streamflows for the Karamea River(New Zeland), provided by the National Institute of Water and Atmospheric Research (http://www.niwa.co.nz/), thanks to the kind collaboration of Shailesh Singh. -) e-mail address of maintainer was changed from the @ing.unit.it to the @gmail.com domain -) DESCRIPTION: new `MailingList' field, indicating the r-sig mailing list to be used for questions related to this package o new function: `subdaily2daily' for aggregating sub-daily values into daily ones o new function: `subdaily2monthly' for computing monthly values from sub-daily time series o new function: `subdaily2annual' for computing annual values from sub-daily time series o new function: `subdaily2seasonal' for computing seasonal values for every year of a sub-daily time series o new function: `hip' for creating a sequence (or counting the number) of hours between two date/time objects o sname2plot' : -) new argument season.names', to customise the names of the weather seasons used for plotting -) default value for `dates' argument was set to 1 (before it was missing) o hydroplot' : new argument season.names', to customise the names of the weather seasons used for plotting o `daily2monthly' : now it handles sub-daily and weekly values o `daily2annual' : now it handles sub-daily, weekly and quarterly values o `monthlyfunction' : now it handles sub-daily values o `dm2seasonal' : -) now it handles sub-daily and weekly values -) improved examples o `time2season' : now it handles "POSIXct" and "POSIXt" values o `seasonalfunction.zoo' : season names are now correctly given (instead of just numbers) for zoo objects that are matrix/data.frame as well o annualfunction.zoo' : na.rm' argument is now used when the input zoo object is a matrix/data.frame (previously a single value of 1 was artificially introduced to the annual ts of each column when 'na.rm=TRUE', while a single value of 0 was artificially introduced to the annual ts of each column when 'na.rm=FALSE') => generally a very small difference o `dip' : more informative error messages o `mip' : more informative error messages o `yip' : more informative error messages o monthlyfunction.matrix' : default value for dates' argument was set to 1 (before it was missing) o monthlyfunction.data.frame' : default value for dates' argument was set to 1 (before it was missing) o annualfunction.matrix' : default value for dates' argument was set to 1 (before it was missing) o annualfunction.data.frame' : default value for dates' argument was set to 1 (before it was missing) o seasonalfunction.matrix' : default value for dates' argument was set to 1 (before it was missing) o seasonalfunction.data.frame': default value for dates' argument was set to 1 (before it was missing) o daily2annual.matrix' : default value for dates' argument was set to 1 (before it was missing) o daily2annual.data.frame' : default value for dates' argument was set to 1 (before it was missing) o daily2monthly.matrix' : default value for dates' argument was set to 1 (before it was missing) o daily2monthly.data.frame' : default value for dates' argument was set to 1 (before it was missing) o dm2seasonal.matrix' : default value for dates' argument was set to 1 (before it was missing) o dm2seasonal.data.frame' : default value for dates' argument was set to 1 (before it was missing) o hydrokrige.data.frame' : default value for dates' argument was set to 1 (before it was missing) o sname2ts' : default value for dates' argument was set to 1 (before it was missing) o `zoo2RHtest' : broken links were removed and replaced by new ones. Thanks to Gang Dong and Yan Li ! o NAMESPACE : functions from packages zoo and xts are now imported explicitly ################################################### # Previous Releases (see old file 'ChangeLog)' # ################################################### 0.3-6 18-Oct-2012 0.3-5 04-Jul-2012 0.3-4 03-May-2012 0.3-3 07-Nov-2011 0.3-2 15-Sep-2011 0.3-1 14-Sep-2011 0.3-0 01-Sep-2011 0.2-2 14-Apr-2011 0.2-1 30-Nov-2010 0.2-0 10-Oct-2010 0.1.7 05-Mar-2009 (It was never released, because it finally becomes v0.2-0) 0.1.6 30-Nov-2009 0.1.5 16-Nov-2009 0.1.4 02-Nov-2009 0.1.3 13-Oct-2009 0.1.2 01-Oct-2009 0.1.1 15-Sep-2009 0.1.0 07-Sep-2009 (but the functions were developed since 2007)