Movatterモバイル変換

fasstr 0.5.3

Updated: 23 Sep 2024

Bug fixes:

• an error occurs with method-of-moments frequency analyses withfitdistrplus version 1.2-1. Internal fasstr code has been adjusted tothe fitdistrplus changes.

fasstr 0.5.2

Updated: 27 Mar 2024

Bug fixes:

• added workaround for issue with scales::cut_short_scale() bug causedby scales 1.3.0. https://github.com/r-lib/scales/issues/413. Fix workswith previous and new versions of scales.

fasstr 0.5.1

Updated: 20 Mar 2023

Bug fixes:

• fixed date_validate bug (issue#93) where functions could not assigndate class when data frame was all NA (eg. Calc_annual_lowflows() for aseasonal station with no complete years).
• fixed add_seasons bug (issue#94) where left_join was not workingproperly
• updated some dplyr and ggplot2 coding with recent updates in thosedependencies

fasstr 0.5.0

Updated: 19 Oct 2022

• This release is a major new update with additional functions andchanges to existing functions to present data and plots in differentways and more consistency across functions, updating various colours toviridis scales for accessibility, as well as updating some internalprocesses and fixing some minor bugs. Some functions have beensuperseded by others, but all functions will still be available withinthe package.

New functions:

• plot_flow_data_symbols() - plots daily data with coloured pointsdesignating symbol categories from symbols column
• plot_annual_symbols() - plots symbols by day of year or annualcounts or percent of days with symbols from symbols column
  
• plot_annual_stats2() - plotting annual stats in ribbons (similar toplot_daily_stats)
• plot_monthly_stats2() - plotting faceted monthly stats in ribbons(similar to plot_daily_stats)
• plot_monthly_means() - plotting long-term monthly means withpercents of long-term MADs
• calc_annual_highflows() and plot_annual_highflows() - calcs/plotsannual high flow data, similar to _annual_lowflow() functions
• calc_annual_extremes() - plots the values and dates from annualminimums and maximums for each year, replacing calc_annual_peaks()
• plot_annual_extremes() - plots the values and dates from annualminimums and maximums for each year, from calc_annual_extremes()
• plot_annual_extremes_year() - plots the values and dates from annualminimums and maximums fora given year
• calc_annual_normal_days() and plot_annual_normal_days() - countsnumber of normal and above/below normal days - replaced superseded_annual_outside_normal() functions
• plot_annual_normal_days_year() - plot days above normal, belownormal and normal for a specific year
• plot_annual_flow_timing_year() - plot annual timing of flows for aspecific year

Function updates:

• plot_missing_data() - new default plot type in tile format. Canchange to original bar plot using plot_type = “bar”.
• plot_data_screening() - now changes the geom_point style based on ifdata is complete or has missing data (plot_availability argument) andnow allows choice of annual summary statistics (include_statsargument)
• screen_flow_data() - now add columns of counts of symbol categoriesprovided by symbol column (HYDAT Symbol column). Can remove columns byusing include_symbols = FALSE.
• plot_annual_means() - added 2 percentile (of annual means) lines toplot, added legend
• calc_annual_peaks() - superseded, replaced withcalc_annual_extremes()
• plot_annual_cumulative_stats() - new default plot type in barformat. Can change to original line plot using plot_type = “line”.
• calc_annual_outside_normal() and plot_annual_outside_normal() -superseded, replaced with calc_annual_normal_days() andplot_annual_normal_days()
• compute_frequency_analysis() - added logical ‘compute_fitting’argument to fit plotting positions (TRUE, default) or don’t and justreturn plotting position results (first 3 objects of output) (FALSE);add custom plot y-axis title

Other updates:

• Plot legends now centered on right, not top
• Changed colour scales on many plots to the viridis palette
• Can now choose 0 and 100 percentiles (was previously between 1 and99)
• Added args plot_inner_percentiles, plot_outer_percentiles, andchanged include_extreme to plot_extreme in various functions
• Added ‘complete_years’ argument to several functions forcross-package consistency. Doesn’t change functionality, butsets/overrides ignore_missing to FALSE and allowed_missing to 0.
• “Year” axes now labeled “Water Year” if water_year_start != 1
• Some appropriate “Day of Year” axes now labeled “Day of Water Year”if water_year_start != 1
• Changed y-axis labels on plots using scales::cut_short_scale() toremove exponents on large numbers
• Annual plots with leading empty years (gaps, missing dates, etc)will now shift plot to first year of data
• Updated vignettes with new functions and updates
• Added complete_years and allowed_missing arguments towrite_full_analysis outputs on the fasstr functions tab

Bug fixes:

• complete_years function now applied to all functions in compute_ andwrite_full_analysis functions
• Removed HYDAT.sqlite file check in compute_HYDAT_peak_frequencies()- leaves check to tidyhydat
• fixed fill_missing_dates water year bug

Internal code:

• cleaning up argument check functions (logical, numeric etc)
• new origin_date internal function
• new filter_complete_yrs arg option (keep_all) to keep all years ofdata, just setting NA if incomplete
• new complete_years fns to get lists of years and start/end/excludeyears

fasstr 0.4.1

Updated: 10 Dec 2021

Updates:

• Fixed major bug: Seasons identifiers were mislabeled whenwater_year_start > 1 for add_seasons() and various functions useseasonal cumulative totals
• Updated documentation - ‘months’ and other param descriptions
• plot_flow_duration() - removed annotation ticks when not inlog-scale
• added ‘log_ticks’ argument to customize adding annotation_ticks ornot when log scale
• removed ‘log_discharge’ from plot_annual_lowflows()

fasstr 0.4.0

Updated: 3 Dec 2021

Updates:

• added flexible ‘allowed_missing’ argument to applicable functions,that allows users to choose the percentage of missing dates, rather thanbinary ignore_missing. ignore_missing argument still functions as itshould (to maintain historical and future use), and is only supersededwhen allowed_missing argument is utilized. This argument is currentlyapplied to functions that make most logical sense (annual and monthlyfunctions) and are appropriate for calculations, i.e. basin summarystatistics (means, percentiles, minimums, maximums). Versions of this,allowed_missing_annual and allowed_missing_monthly, exists for somefunctions that have both annual and monthly statistics and may havedifferent allowances; only applied to summary statistics. The newargument is applied to the following functions:
  • allowed_missing argument: calc_annual_lowflows(),calc_annual_peaks(), calc_annual_stats(), calc_monthly_stats(),compute_annual_frequencies(), compute_frequency_quantile(),plot_annual_stats(), plot_annual_lowflows(), plot_annual_means(),plot_monthly_stats()
  • allowed_missing_annual and allowed_missing_monthly:calc_all_annual_stats(), compute_annual_trends(),compute_full_analysis(), write_full_analysis()
• added ‘months’ argument to following functions (covers all screen_,calc_, plot_, and compute_ functions now):
  • plot_flow_data() - will plot only data from selected months
  • add_cumulative_yield() and add_cumulative_volume() - will accumulateflows just in selected months
  • plot_longterm_daily_stats() - no ribbons where data gaps
  • plot_longterm_monthly_stats() - no ribbons where data gaps
  • calc_ and plot_daily_cumulative_stats() - will accumulate flows justin selected months
  • calc_ and plot_monthly_cumulative_stats() - will accumulate flowsjust in selected months
  • calc_ and plot_annual_cumulative_stats() - will only use monthsselect, won’t calc seasonal totals if not all months
  • calc_ and plot_annual_flow_timing() - will use timing from justselected months
  • calc_all_annual_stats() - will only use months select, won’t calcseasonal totals if not all months
  • compute_annual_trends() - will only use months select, won’t calcseasonal totals if not all months
  • compute_ and write_full_analysis() - will only use months select,won’t calc seasonal totals if not all months
• Updated ‘Users Guide’ vignette and Cheat Sheet with new argumentupdates
• New vignette for GitHub Page: Using USGS dataRetrieval R packagewith fasstr
• fixed bug: multiple custom groups/STATION_NUMBER’s appropriatelymatch to data when using a named vector
• fixed bug: plot_daily_cumulative_stats() now plots accurate customyears
• fixed bug: removed unnecessary legend items fromplot_flow_duration()
• fixed bug: corrected ‘months’ argument in calc_ andplot_annual_outside_normal() to properly filter
• fixed bug: removed unnecessary NA warning in plot_longterm_daily andplot_longterm_monthly_stats
• renamed GitHub branches from ‘master’ to ‘main’ and updated weblinks

fasstr 0.3.3

Updated: 20 Oct 2021

Updates:

• For trending, changed default/recommended method to ‘zhang’ over‘yuelipon’ (https://github.com/pacificclimate/zyp/issues/6)
• Removed check for a hydat.sqlite3 file; tidyhydatstop error catcheserror
• Removed lubridate package dependency
• Fixed ggplot2::guides deprecated arguments warning
• Simplified some internal coding for efficiency
• Removed some function examples to reduce timing; examples of usagein vignettes
• Removed TravisCI, added Github Action R-CMD-check usingusethis::use_github_action_check_standard()

fasstr 0.3.2

Updated: 06 Nov 2020

Updates:

• Added calc_annual_peaks() function to calculate both annual n-daymin. and max. flows with dates of occurrence.
• Added error in volume frequency analysis when providing zero ornegative flow values to the logPIII dist.
• Updated volume frequency analysis documentation.
• Updated all vignettes for package updates, corrections, andissues.
• Added new ‘Get Started’ vignette
• Updated Cheatsheet
• changed yield terminology to water yield from runoff yield
• changed plot axis titles with expression()’s (i.e. m3/s –>cms)

fasstr 0.3.1

Updated: 08 Jan 2020

Updates:

• added/modified files in prep for CRAN submission
• fixed vignette coding errors
• renamed function calc_longterm_mad to calc_longterm_mean
• updated vignettes and README files
• removed calc_longterm_stats and plot_longterm_stats
• updated Examples in all documentation (replaced with a functionchecking for a HYDAT, left for writing functions and largeranalyses)
• fixed multiple typos
• updated DESCRIPTION file

fasstr 0.3.0

Updated: 14 May 2019

Updates:

• Removed logical “water_year” argument and now “water_year_start”controls the start of year alone (default now 1 for January)
• Renamed calc_longterm_stats and plot_longterm stats tocalc_longterm_daily_stats and plot_longterm_daily_stats
• Renamed ‘include_year’ argument to ‘add_year’ for somefunctions
• complete_full_analysis just creates R objects; a newwrite_full_analysis saves the results in a single Excel document, withsome plots in a plots folder; renamed ‘sections’ to ‘analyses’
• add_date_variables() outputs changed slightly to match newwater_year_start argument
• Replaced NULL and NA default values for function arguments tonothing, cleaning up documentation.
• Replaced the package writexls with openxls for morefunctionality
• Plotting: changed facet wrap labels, changed trending symbols
• WSC station numbers with lower-case letters now accepted (08nm116and 08NM116 both work)
• basin_area argument as list now will default to HYDAT area if notlisted, otherwise NA
• Return Period axis has returned to the frequency analysis plot
• Updated all documentation examples
• Internal coding (MonthName levels coding cleaned up)

New:

• calc_longterm_monthly_stats and plot_longterm_monthly_stats thatsummarizes annual monthly mean flows data
• calc_longterm_daily_stats and plot_longterm_daily_stats thatsummarizes daily mean flows data (calc_longterm_stats equivalent)
• write_full_analysis writes the full analysis and doesn’t create anyobjects in R
• testthat functions for testing package (internal usage)

Bugs Fixed:

• No warning now in annual functions if NA values produced for yearslisted in “exclude_years” argument

fasstr 0.2.8

Updated: 11 December 2018

Updates:

• README updates
• Renamed calc_lt_mad() and calc_lt_percentile() tocalc_longterm_mad() and calc_longterm_percentile(), respectively.
• Changed the plot_missing_dates points and lines to bar plots.
• changed add_seasons() function from adding two 4 and 2 seasonscolumns to adding own custom seasons of desired lengths. All subsequentfunction and documentation updated were also completed.
• Renamed some annual and seasonal total volume axes, column names,and plots names.
• Updated the licence year in .R files.
• Temporarily removed ‘Return Period’ axis from frequency plots due toggplot2 3.0.1 issues.

Bugs Fixed:

• compute_full_analysis() now plots all daily statistics plots withyears

New:

• New internal function add_water_months() to streamline someprocesses

fasstr 0.2.7

Updated: 27 September 2018

New:

• compute_frequency_analysis() function to calculate a frequencyanalysis with custom data (update other frequency analysis functions touse this function internally)
• Vignettes completed:
  • Users Guide
  • Full Analysis Guide
  • Trends Analysis Guide
  • Frequency Analysis Guide
  • Under the Hood

Updates:

• frequency analysis updates:
  • option to plot the computed curve or not
  • changed the names of the outputted objects
  • changed the measure names (rolling-day names of the annual_freqanalysis (ex from Q007-day-avg to 7-Day))
  • All parameter documentation info in the compute_frequency_analysisfunction
  • updated full_analysis to include new changes
• Completed Users Guide vignette
• Completed Full Analysis vignette
• Completed Frequency Analysis Vignette
• Updated filetype argument in the write_ functions
• Updated some plot object names

Bug Fixes

• Added trendline to trends plots in compute_full_analysis

fasstr 0.2.6

Updated: 28 June 2018

New:

• plot_annual_means() function to plot annual mean and long-termmeans

Updates:

• Axes breaks and ticks on most plots
• Renamed compute_frequency_stat() tocompute_frequency_quantile()
• calc_ and plot_annual_stats, compute_frequency descriptionupdates
• Renamed Timeseries folder to Screening in compute_full_analysis()function
• README Updates
• Vignettes (renamed full_analysis)

fasstr 0.2.5.1

Updated: 19 June 2018

• Fixed write_objects_list to save in folder it creates
• Fixed calc_daily_stats to remove partial data years

fasstr 0.2.5

Updated: 18 June 2018

New:

• New write_objects_list() function to write all plots and tables froma list of objects (help with frquency analysis writing)
• Added vignettes:
  • ‘fasstr’ Users Guide (to be completed)
  • Trending Analysis Guide (to be completed)
  • Volume Frequency Analysis Guide (to be completed)
  • Under the Hood (to be completed)

Major Function Updates:

• Renamed write_full_analysis to compute_full_analysis which creates alist object with all results with option to write everything. Fixedvarious bugs and issues.
• Joined compute_annual_trends and plot_annual_trends. It now consistsof a list with a tibble of annual data, a tibble of trending results,and all trending plots
• Added ‘months’ argument to calc_long_term() and all screening andmissing data functions; also an include_longterm argument for longtermto choose whether to include or not

Other Updates:

• Fixed bug where ‘groups’ column was not kept in resulting tibble,and add_basin_area(), add_rolling_means()
• Removed Nan and Inf values from calc_monthly_stats when no dataexisted for a month
• Plots of longterm_stats, daily_stats, and flow_duration plot nothing(instead of error) if all data is NA
• Updated documentation for some functions
• Removed colour brewer Set1 on some annual plots due to a lack ofcolours in set

fasstr 0.2.4

Updated: 8 May 2018

• Fixed bug where groups function did not work if not“STATION_NUMBER”
• Added warning if not all dates are dates in column
• Added references in annual_flow_timing() and trending functions
• Added ‘See Also’ documentation for many related functions
• Removed error from daily and monthly cumulative stats/plots with nobasin area (now produces NA)
• Updated write_full_analysis so no section 7 is completed withinsufficient data

fasstr 0.2.3

Updated: 17 April 2018

• Updated write_full_analysis() documentation

fasstr 0.2.2

Updated: 17 April 2018

• Added write_full_analysis() function to write almost almost allplots and tables in a folder
• Added some interal checks functions

fasstr 0.2.1

Updated: 13 April 2018

• Reformatted examples script in testing folder as a temporary helpdocument until a vignette is built
• Moved the previous examples script to a new testing script in thesame folder

fasstr 0.2.0

Updated: 9 April 2018

NEW FEATURES

• Summarize and plot by multiple groups (ex. stations)
• Selecting columns of dates, values, and groupings (ex. stationnumbers) when using ‘data’ argument
• Exported data frames are tibbles
• Exported plots (‘gg’ class) are within lists (multiple plots areproduced with many plot_ functions)
• Updated plot formatting
• More functions utilizing rolling average days
• More filtering arguments for some functions (months,complete_years)
• ‘na’ argument is now ‘ignore_missing’ with default of FALSE for allfunctions
• Additional write_, calc_, add_, compute_, and plot_ functions
• Renaming of some functions
• Exports pipe operator, %>%, to facilitate tidy analyses

REMOVED FEATURES

• Choice for writing within functions - moved to their own write_ dataand plot functions

INTERNAL IMPROVEMENTS

• Reformatted internal structure, including adding internal functionsfor efficiency and argument checks
• Used@Inheritparams to simplifydocumentation

fasstr 0.1.0

Updated: 9 Dec 2017

• Initial package beta version
• Use HYDAT argument to extract HYDAT data using ‘tidyhydat’package
• Included add_, calc_, compute_, and plot_functions
• Included README with basic examples