MatthewHeun/matsbyname: v0.5.0

matsbyname 0.5.0 (2022-04-01) New format for documentation pages, including a search function! New vignette "Using summarise in matsbyname" clarifies issues around ambiguities in functions that use a ... argument. aggregation-vignette now includes details on using sum_byname(.summarise = TRUE) with dplyr::summarise(). sum_byname(), matrixproduct_byname(), hadamardproduct_byname(), mean_byname(), geometricmean_byname(), equal_byname(), identical_byname(), samestructure_byname(), and and_byname() all gain argument .summarise to signal intention to operate down a column (.summarise = TRUE) or along a list (.summarise = FALSE). The default value is .summarise = FALSE, thereby maintaining previous behavior. New functions agg_table_to_agg_map() and agg_map_to_agg_table() assist with manipulating aggregation maps. New vignette aggregation-vignette demonstrates the new aggregation functions. Functions rename_to_pref_suff_byname() and aggregate_to_pref_suff_byname() now route to new functions rename_to_piece_byname() and aggregate_pieces_byname(), thereby avoiding code duplication. This change may break some code. These functions now return an empty string ("") when a suffix is requested and one is not found. Previously, these functions returned the entire string when a suffix was not found. New function aggregate_pieces_byname() brings the flexibility of the RCLabels to matsbyname. Remove (comment for now) notation functions in notation.R that have been moved to RCLabels. New function rename_to_piece_byname() will assist with renaming and aggregating according to pieces of row and column names. New function vec_from_store_byname() creates vectors from a matrix (from which row of column names are taken) and a vector (which acts as a store of values) based on matching of pieces of the labels. This new function is made possible by the new RCLabels package. Notation code moved to new package, RCLabels. RCLabels::make_or_pattern() gains new pattern_type, "literal", which returns the row_col_names argument unmodified. trim_rows_cols() gains a warn_if_a_incomplete argument. When TRUE, a warning is issued if argument a is missing entries on margin that are present in mat. Many new tests for new features. But some functions have been moved to RCLabels, so the total number of tests has gone down slightly. Now at 1072 tests, all passing. Test coverage remains at 100 %