## Release History of the airGRteaching Package ### 0.2.10.68 Release Notes (2020-10-22) #### Version control and issue tracking - Users can now track changes (https://gitlab.irstea.fr/HYCAR-Hydro/airgrteaching) and issues (https://gitlab.irstea.fr/HYCAR-Hydro/airgrteaching/issues) #### User-visible changes - the theme agument of the ShinyGR() function now uses partial matching ____________________________________________________________________________________ ### 0.2.9.25 Release Notes (2020-10-16) #### New features - in the ShinyGR() interface, there is a new tab panel that shows a summary sheets of basin if the name of the dataset contains the code station (8 characters : 1 letter and 7 numbers) of the Banque Hydro French database (so it is available only for the dataset of this database) ([#10](https://gitlab.irstea.fr/HYCAR-Hydro/airgrteaching/-/issues/10)) #### User-visible changes - the theme agument of the ShinyGR() function now works even if a wrong character case #### CRAN-compatibility updates - when the package is loaded or when the dyplot() and the ShinyGR() function are used, a message warns the users if they use a version of 'htmlwidgets' < 1.5.2.9000. The latest version of this package, available on GitHub, avoids troubles with the use of dynamic graphics of the 'dygraphs' package (called by the dyplot*() and the ShinyGR() functions) ([#5](https://gitlab.irstea.fr/HYCAR-Hydro/airgrteaching/-/issues/5)) ____________________________________________________________________________________ ### 0.2.8.69 Release Notes (2020-02-28) #### New features - added as.data.frame.airGRt() method in order to create a data.frame from outputs of PrepGR(), CalGR() and SimGR() functions. This data.frame always presents the same structure and contains observed flow, simulated flow, simulated solid precipitation fraction, etc. When it does not make sense, the concerned column is assigned with NA values (e.g. Qsim with the PrepGR() function) - a digital object identifier (DOI) now allows to identify the manual of the 'airGRteaching' package. When you use airGRteaching in your work, please always cite both the article and the manual. The last one allows to know the version of the package that is used in order to enhance reproducible research. The references can be displayed with the citation("airGRteaching") command - two themes of alternative stylesheet are available ("Inrae" and "Saclay") using the theme agument of the ShinyGR() function #### Deprecated and defunct - The CalGR argument is now deprecated in the SimGR() function. It has been replaced by the use of the Param argument which can be set by an object of the class CalGR or by a vector of parameters #### Bug fixes - ShinyGR() now runs when independent arguments (DatesR, Precip, etc.) are used instead of the ObsDF argument #### User-visible changes - it is now possible to use the GR4H and GR5H hourly models with or without CemaNeige. For that, in the PrepGR(), the HydroModel argument could be set to "GR4H" or "GR5H". In the GUI, launched by ShinyGR() function, nothing changed, only the daily models are available. So, now airGRteaching depends on the version of 'airGR' >= 1.4.3.52) - it is now possible to run the PrepGR() function when discharge is not provided in Qobs. If it is the case, the CalGR() function will return an error message because it is not possible to calibrate the model. The SimGR() function will return a warning message because it is not possible to compute any efficiency criterion - it is now possible to run the ShinyGR() function when discharge is not provided in Qobs - when observed discharge is provided in ShinyGR(), the first plotting panel now draws the flow error time series - the plot() function is now exported - the dyplot.PrepGR(), dyplot.CalGR() and dyplot.SimGR() functions are no longer exported - there is now only one help page for all plot.*() functions (use ?plot to call it) #### CRAN-compatibility updates - when the package is loaded, a message warns the users if they use a version of 'htmlwidgets' < 1.5.1.9000. The latest version of this package, available on GitHub, avoids troubles with the use of dynamic graphics of the 'dygraphs' package (called by the dyplot*() and the ShinyGR() functions) ____________________________________________________________________________________ ### 0.2.6.29 Release Notes (2019-05-02) #### Bug fixes - ShinyGR() can export the csv table again. It was broken due to modifications to the version 1.2.13.16 of the 'airGR' package #### User-visible changes - it is now possible to export the diagram plot of the model from the ShinyGR() interface ____________________________________________________________________________________ ### 0.2.6.27 Release Notes (2019-04-23) #### Bug fixes - ShinyGR() may now run for any timezone - ShinyGR() takes into account the fact that on 1 time step airGR::ErrorCrit_KGE do not return CritName (temporary patch) - ShinyGR() takes into account the fact that the previous simulation could have a missing value criterion - ShinyGR() takes into account the fact the prevuous Qsim is sometimes to long of one value (temporary patch) #### User-visible changes - The WarmUp element returned by CalGR() and SimGR() now presents a timezone defined as UTC ____________________________________________________________________________________ ### 0.2.6.14 Release Notes (2019-04-03) #### CRAN-compatibility updates - now depends on the latest version (1.2.13.16) of the 'airGR' package: CalGR(), SimGR() and ShinyGR() have been updated - the 'htmlwidgets' package is no longer imported #### User-visible changes - the CemaNeige model is now allowed when the model diagram is drawn in ShinyGR() - .DiagramGR() and .TypeModelGR() are now private functions - time format of "Period" and "Event" sliders of the ShinyGR() function is now "%Y-%m-%d" with the latest versions of the 'shiny' package (like it was with th old versions) ____________________________________________________________________________________ ### 0.2.3.2 Release Notes (2018-08-08) #### CRAN-compatibility updates - now depends on the latest version (1.1.1.6) of the 'dygraphs' package from CRAN (embeded 'dygraphs' functions have been removed) #### User-visible changes - the article reference is updated - .DiagramGR() no longer returns errors when inputs are not yet available in ShinyGR() ____________________________________________________________________________________ ### 0.2.2.2 Release Notes (2018-03-21) #### Bug fixes - bug fixed in ShinyGR(), the criteria values are now right on Unix system #### User-visible changes - vignette added ____________________________________________________________________________________ ### 0.2.0.9 Release Notes (2018-03-16) #### CRAN-compatibility updates - embeding 'dygraphs' functions to avoid user to install the last version of this package from GitHub (import of devtools not necessary) ____________________________________________________________________________________ ### 0.1.11.26 Release Notes (2018-02-01) #### Bug fixes - bug fixed in ShinyGR() when C1 (or C2) is modified after calibration; the calibration button is now reset - bug fixed in warm-up, calibration and simulation periods checks in CalGR() and SimGR() functions #### Deprecated and defunct - ObsBV argument has been renamed ObsDF in PrepGR() and ShinyGR() functions #### User-visible changes - update and homogenization of the unit of time abbreviation in .TypeModelGR() and ShinyGR() - graphical parameters recorded and executed when the plot.PrepGR(), plot.CalGR() and plot.SimGR() functions exit ____________________________________________________________________________________ ### 0.1.10.0 Release Notes (2018-01-30) #### Deprecated and defunct - ObsGR() function (and relatives arguments in CalGR() and SimGR() has been renamed PrepGR() ____________________________________________________________________________________ ### 0.1.9.29 Release Notes (2018-01-30) #### Bug fixes - missing exchange added on exp. store when plotting GR6J model diagram in ShinyGR() - exp store now appears exported png file of state variables plot in ShinyGR() when GR6J is used - animate button fixed in ShinyGR() - bug fixed in ShinyGR() to show previous sim. when model or dataset changes - bug fixed in ShinyGR() to show previous sim. when time window changes but keeps the same length - bug fixed to disable calibration when there is no Qobs in ShinyGR() #### User-visible changes - it is now possible to draw the model diagram in ShinyGR() using the GR6J model - exp. store now appears in state variables plot in ShinyGR() when GR6J is used - update and homogenization of the unit of time abbreviation in .TypeModelGR() and ShinyGR() - write "< - 99.99" in the criteria table of ShinyGR() when a criterion is very low - ShinyGR() now allows a list format for ObsBV data.frame and CemaNeige inputs ____________________________________________________________________________________ ### 0.1.8.14 Release Notes (2017-11-29) #### Bug fixes - ObsGR() function now returns an error if the time zone is not defined as "UTC" - in ShinyGR() background color defined to black when the Flatly theme is used - bug fixed in ShinyGR() when inputs are defined in vectors (not in a data.frame) - Psol et Pliq bars are reversed in dyplot.default() #### User-visible changes - new reactive to prepare data for plotting in the ShinyGR() interface ____________________________________________________________________________________ ### 0.1.7.6 Release Notes (2017-10-05) #### User-visible changes - SimGR() now runs only once to compute all ErrorCrit - it is now possible to show the table of the last simulation criteria in the ShinyGR() interface - it is now possible to export state variable plot from the ShinyGR() interface ____________________________________________________________________________________ ### 0.1.6.15 Release Notes (2017-09-29) #### New features - dyplot() now allows to draw an additional time series of flow #### Bug fixes - bug fixed when zooming after changing snow model on plot to see the last simulation in ShinyGR() - dyplot() now plots Pliq and Psol when CemaNeige is used (dyStackedBarGroup() instead of the plotter argument) #### User-visible changes - disable and enable buttons in ShinyGR() interface (using the 'shinyjs' package) - it is now possible to register the last simulation and draw it on Model diagram of ShinyGR() ____________________________________________________________________________________ ### 0.1.5.22 Release Notes (2017-09-14) #### New features - it is now possible to export some plots and tables from ShinyGR() interface - in ShinyGR(), TypeModel inputIds renamed into HydroModel #### Bug fixes - period slider is linked to the 'dygraphs' selected period #### Deprecated and defunct - deprecated Param arguments in ShinyGR() #### User-visible changes - the size of the "Model performance" plot is now adapted if CemaNeige is used or not #### CRAN-compatibility updates - dyplot() updated to be compatible with 'dygraphs' >= 1.1.1.4 (available only on GitHub) ____________________________________________________________________________________ ### 0.1.4.0 Release Notes (2017-07-21) #### New features - ShinyGR() now use 'dygraphs' devices (except for model perf.) #### User-visible changes - dyplot.default() now draws precipitation as a true bar plot and not a step plot ____________________________________________________________________________________ ### 0.1.3.9 Release Notes (2017-06-22) #### New features - added GR5J in the Model diagram of ShinyGR() - it is now possible to choose the objective function to calibrate the model #### Bug fixes - NA values can be drawn by dyplot*() functions ____________________________________________________________________________________ ### 0.1.2.52 Release Notes (2017-06-02) #### New features - shiny.SimGR() now presents a theme argument that allows to change the stylesheet #### Deprecated and defunct - the shiny.SimGR() function has been renamed into ShinyGR() #### Bug fixes - bug fixed in ShinyGR() to plot state variables with GRJ #### User-visible changes - the shiny.SimGR() function has been renamed into ShinyGR() ____________________________________________________________________________________ ### 0.1.1.20 Release Notes (2017-03-21) #### User-visible changes - in shiny.SimGR() if the model diagram is plotted, the animation can be run only from the Event slider and no more from the "Period" slider - SimGR() now also returns the OptionsCrit value #### CRAN-compatibility updates - the package now depends on 'airGR' version 1.0.5.22 ____________________________________________________________________________________ ### 0.0.3.15 Release Notes (2017-01-19) #### New features - it is now possible to calibrate the model in shiny.SimGR() and to draw new plots - dyplot.default() gains a Roller period argument #### Deprecated and defunct - TypeModelGR() is now a private function #### Bug fixes - bug fixed, it is now possible to run CalGR() with verbose = FALSE - bug fixed in plot.CalGR() (it does not use anymore a global variable)