NEWS.md

Changes in version 1.38.0

Bug fixes and minor improvements

• Fixed bug in getWithColData when colData from i object did not align with sampleMap(mae) colname order (@aboyoun / James Bonaffini, #346)

Changes in version 1.36.0

New features

• Defunct longFormat generic and methods replaced with longForm
• Added hasRowData method check for assays
• subsetByRowData and intersectByRowData allow filtering of rows based on values in assay rowData (#228)

Bug fixes and minor improvements

• Properly document i subsetByRow and [ bracket methods.
• Match subsetByRow method signatures to generic.

Changes in version 1.34.0

New features

• Replace longFormat generic and methods with longForm (@lgatto, #333)
• Use h5mread::h5writeDimnames instead of HDF5Array::h5writeDimnames
• Add note to warning message in saveHDF5MultiAssayExperiment to use loadHDF5MultiAssayExperiment to reliably load data

Bug fixes and minor improvements

• Add package anchors to links in documentation
• Optimize subsetByColData (@leopoldguyot, #334)
• Use BiocBaseUtils::checkInstalled to check for Suggests packages
• Additional checks for j and ... in double bracket [[ MultiAssayExperiment method

Changes in version 1.32.0

Bug fixes and minor improvements

• Various documentation improvements to MultiAssayExperimenToMAF, saveHDF5MultiAssayExperiment, and reexports
• When rownames are numeric characters e.g., "1", ensure they stay character when converting MultiAssayExperiment to longFormat.

Changes in version 1.30.2

Bug fixes and minor improvements

• The colData<- replacement method now correctly works with data.frame value inputs (@drighelli, #330).
• Updated CITATION information in the main vignette.
• Use reshape2::melt instead of stats::reshape to preserve row names in longFormat

Changes in version 1.28.0

New features

• Dropped experiments are no longer kept in the metadata slot. They can be seen with drops() (@LTLA, #323).

Bug fixes and minor improvements

• Checking colnames in sampleMap vs ExperimentList is more robust by only comparing unique and sorted values in each.

Changes in version 1.26.0

New features

• showReplicated displays the actual colnames of technical replicates by assay and biological unit.
• The bracket replacement method [<- for MultiAssayExperiment now also replaces the names with those from the right-hand side of the operation, if any (@DarioS, #319)

Bug fixes and minor improvements

• During single assay replacement [[<-, the re-ordering of assays based on the value input was invalid when empty assays present (@danielinteractive, #322).
• Permuting assays also updates the order of names in the MultiAssayExperiment and assays in the sampleMap

Changes in version 1.24.0

New features

• replicates provides the actual colnames identified as replicate observations for a particular biological unit in the sampleMap

Bug fixes and minor improvements

• Added an assay<- replacement method for robustifying saveHDF5MultiAssayExperiment with plain matrices
• Use BiocBaseUtils::setSlots and avoid warnings of triple colon use.
• Resolve issue when colData has one column when merging two MultiAssayExperiment objects, i.e., using the c method (@cvanderaa, #315)
• Increase efficiency in colnames and rownames methods (@cvanderaa, #314)
• Make 'prefix' inputs consistent in saveHDF5MultiAssayExperiment and loadHDF5MultiAssayExperiment (@asiyeka, #313)
• Improve performance for replicated method
• Update wideFormat documentation, when replicates present additional sets of columns will be appended to the produced DataFrame (@DarioS, #312)

Changes in version 1.22.0

Bug fixes and minor improvements

• Add data("miniACC") to examples after removing lazy loading.
• Class definition prototypes defined for cleaner extensibility (@hpages, #306).
• Doc and internal improvments to MultiAssayExperimentToMAF
• synAssay and nonSynAssay now require exact assay names in MultiAssayExperimentToMAF

Changes in version 1.20.0

Bug fixes and minor improvements

• Avoid dropping experiments with repeated calls to subsetByColData and remove harmonization (@cvanderaa, #302)
• getWithColData suppresses messages from natural subsetting operations by default with verbose = FALSE (@bhagwataditya, #301)
• getWithColData was using the old default (drop = TRUE) and causing an error when the experiment is empty (@danielinteractive, #300).
• Calls to the internal .harmonize operation are reduced to increase memory efficiency, when identical experiment colnames present (@LTLA, #299).
• subsetByColData now errors on subscript vectors longer than the nrow of the colData (previously a warning).
• colData<- includes a check for identical row names. If so, direct replacement of the colData occurs without harmonization.
• Added a warning when an empty sampleMap is provided in the constructor function which may cause unexpected behavior. Documentation is updated to include more details on the sampleMap input.

Changes in version 1.18.0

New features

• saveHDF5MultiAssayExperiment allows users to save data from most classes (excluding RaggedExperiment) into a single H5 file (ctb @hpages)
• Support for maftools conversion has been added as MultiAssayExperimentToMAF (ctb @PoisonAlien)
• renameColname and renamePrimary provide renaming facilities for column names in experiments and rownames in the colData, respectively
• Users can now rename some or all the column names in experiments using colnames(mae) <- value
• When replacing colData or experiments (including [[<-), new rownames and colnames (respectively) are checked against existing values and an error is given when none match
• Using List objects to replace the data in the ExperimentList is now supported
• splitAssay allows users to separate / split columns across assays
• makeHitList is a facilitator function to create the logical lists that are required as input to splitAssay
• drop argument when subsetting a MultiAssayExperiment is now FALSE by default

Bug fixes and minor improvements

• Updated the constructor function to auto-populate rownames in colData when it is missing (@LTLA, #287)
• The metadata now includes names of dropped experiments
• Updated validity checks to support array-like classes
• Dropped experiments are tracked in the metadata

Changes in version 1.16.0

New features

• Coercion methods from list/List to MultiAssayExperiment method now available.

Bug fixes and minor improvements

• Provide more details in documentation for mergeReplicates
• Improved documentation for accessor function return values, helper function examples (@llrs, #281)
• Fixed bug when using longFormat with character assay matrices (@jonocarroll, #282)

Changes in version 1.14.0

New features

• exportClass creates a number of .csv data files for exporting data
• Allow vector input i for selecting assays in longFormat (@lgatto, #266)
• Updates to 'Using MultiAssayExperiment with DelayedMatrix' vignette

Bug fixes and minor improvements

• Warn when colData rownames and ExperimentList colnames are empty (@LTLA #262)
• Add informative error message for ExperimentList (@lgatto, #265)
• Informative warning when dropping ExperimentList element columns (@lwaldron)
• Fixes to constructor functions, MultiAssayExperiment and MatchedAssayExperiment (@lgatto, #267 #268, @lwaldron)
• Add warning when j in mae[i, j, k] is longer than colData rows
• Strict argument matching between generic and methods
• Updates due to class(matrix())
• UpsetSamples more robust to differences in names between split sampleMap and names(ExperimentList) (@jonocarroll, #269)
• Refactored and improved UpsetSamples
• ExperimentList propagation of mcols and metadata (@vobencha, #270)
• Enforcement of validObject with replacement methods colData and sampleMap (@vobencha, #271)

Changes in version 1.12.0

Bug fixes and minor improvements

• Improvements to the main vignette, MultiAssayExperiment class schematic now included (@mtmorgan, #261)
• Updated documentation for the upsetSamples function
• Update code to use splitAsList from S4Vectors (@hpages)
• Fixed bug with metadata disappearing from ExperimentList when replacing it inside a MultiAssayExperiment object (@lawremi, #259)
• Fixed the formatting of the NEWS file

Changes in version 1.10.0

New features

• getWithColData now allows easy extraction of experiments (such as SummarizedExperiment) with associated colData data
• Single bracket replace method implemented for MultiAssayExperiment assays

Bug fixes and minor improvements

• isEmpty method fixed for ExperimentLists containing matrices
• MultiAssayExperiment now inherits from the standard Annotated virtual class
• c method better distinguishes between list and ExperimentList inputs
• Improvements on .getHits internal method for obtaining correct queries on row metadata
• Subsetting mechanism tweaked to do nothing when subsetting by NULL rows compared to empty rows (i.e., character(0L))
• Improved README.md

Changes in version 1.8.0

New features

• The single bracket replacement method [<- added to support assignment of assay datasets
• Users can now rename experiments in a MultiAssayExperiment with names(x) <- value
• replicated and mergeReplicates functions have been refactored and improved
• combining MultiAssayExperiments now possible with c function
• Subsetting MultiAssayExperiment by a list or List type class now returns experiments in the input order for rows, columns, and assays

Bug fixes and minor improvements

• wideFormat function improvements and bug fixes with name indicator subsetting
• BiocGenerics:::replaceSlots used instead of replace methods
• Added tests for anyReplicated, c, and names<- functions
• Unit tests added for replacement method testing
• Renamed objects in examples for brevity and descriptiveness
• Updated importFrom directives
• Internal sample names check now only works on non-empty colnames
• Various documentation improvements
• listToMap re-written for efficiency
• Various improvements to subsetting mechanism
• subsetByAssay bug fixed when using an integer index (@vjcitn, #)

Changes in version 1.6.0

New features

• DataFrame now exported for users (@DarioS, #242)
• c is smarter at matching colnames with primary names and creating a sampleMap
• The MatchedAssayExperiment constructor function now works either a single MultiAssayExperiment or the essential components of one.
• Renamed duplicated function to replicated
• Added coercion functions from List and list to ExperimentList
• Improve speed of reshape functions from previous change (wideFormat)
• Remove clusterOn function and move to Bioconductor/MultiOmicQC package on GitHub
• duplicated has been deprecated, use replicated and anyReplicated
• removed dependencies on tidyr and reshape2
• Moved the API shiny function to waldronlab/MultiAssayShiny package
• Reduced imports (removed shinydashboard and shiny)
• Method requirement checks for classes are practical using try()
• Deprecated methods removed: pData
• Deprecated class removed: RangedRaggedAssay
• Assay-selective subsetting implemented via list/List class subsettors

Bug fixes and minor improvements

• Added an isEmpty method for ExperimentList to account for an empty matrix
• Documentation improvements to MultiAssayExperiment-class and MultiAssayExperiment-helpers
• c internals improved
• Explicitly check for DataFrame in ExperimentList
• Fixed documentation warnings for inexact links
• Fix subsetting order in bracket method ([)
• Minor vignette changes
• Supply a collapse character for wideFormat column names
• upsetSamples does not munge experiment names with special characters when check.names = FALSE (by default keeps hyphens, underscores, etc.). A nameFilter functional argument allows operations such as substr on the experiment names. (@vjcitn, #231)
• Updates to prepMultiAssay
• Enhancements to the main vignette
• New format for NEWS section
• updated duplicated function now returns FALSE for non-duplicated samples
• Improved ExperimentList constructor now handles multiple key = value entries
• Removed updateObject before giving warning
• Removed old RTCGAToolbox example vignette
• Official manuscript citation added
• Improved examples (removed ExpressionSet legacy objects)

Changes in version 1.1.59

New features

• rearrange is now broken up into longFormat and wideFormat functions.
• Helper functions now have a dedicated man page, see: ?'MultiAssayExperiment-helpers'

Bug fixes and minor improvements

• A subset can affect the order of rows (previously it didn't)
• rownames are exclusively used to create longFormat DataFrames
• The longFormat,ExperimentList-method now returns a long DataFrame
• Minor improvements to tests

Changes in version 1.1.52

New features

• reduce removed and broken up into mergeReplicates and intersectColumns
• Additional helper introduced: intersectRows

Changes in version 1.1.49

New features

• pData deprecated in favor of colData
• Quick start vignette now available

Bug fixes and minor improvements

• Fixed API function link
• Removed coercion to old RangedRaggedAssay class
• Improved listToMap

Changes in version 1.1.44

Bug fixes and minor improvements

• Renamed PrepMultiAssay to prepMultiAssay (lower p following convention)

Changes in version 1.1.43

New features

• The MultiAssayExperiment quickstart guide vignette added
• Deprecation of the RangedRaggedAssay class. Use RaggedExperiment package instead.
• reduce function simplified
• mapFrom convenience argument added to the c,MultiAssayExperiment-method
• assay and assays methods have been revised to conform to SummarizedExperiment standards

Bug fixes and minor improvements

• API() now points to the correct web document
• ExperimentList constructor no longer coerces GRangesList to RangedRaggedAssay
• Documentation changes: consolidate man pages for experiments, experiments<-, sampleMap, and sampleMap<-
• removal of internal getHits method, simplified helper function in place
• prepMultiAssay helper now returns a list with names corresponding to the MultiAssayExperiment constructor function

Changes in version 1.1.37

New features

• MatchedAssayExperiment subclass added for matched samples in all assays
• Supply mini ACC dataset data(miniACC)
• Provide reference table for methods in package, see vignettes
• Merge with GitHub development version

Bug fixes and minor improvements

• ensure assay column in sampleMap is a factor
• rearrange long DataFrame correctly
• remove support for RangedRaggedAssay - deprecate
• drop = FALSE in single column subset of colData
• default sampleMap representation as empty DataFrame with colnames
• added combine c vignette section for adding experiments to an existing

Changes in version 1.1.27

New features

• c method implemented for experiments with 1:1 sample matches in pData rows
• MultiAssayExperiment show method improved
• Double bracket [[ extracts single experiment (replacement also included)
• Internal getHits methods removed and refactored subsetByRows
• subsetBypData available
• rearrange method now supports "wide" format outputs

Bug fixes and minor improvements

• Updates to HDF5 vignette
• More examples to documentation
• Numerous bug fixes
• mapToList uses the more efficient splitAsList function

Changes in version 1.1.17

New features

• upsetSamples function implemented

Changes in version 1.1.16

New features

• Implement shape argument for rearrange function: wide now available

Bug fixes and minor improvements

• Updated vignettes: DelayedMatrix & PRAD MultiAssayExperiment object

Changes in version 1.1.15

New features

• disjoin method for RangedRaggedAssay

Bug fixes and minor improvements

• show method for RangedRaggedAssay abbreviated. No longer summarizes data with assay
• Documentation changes for reduce and disjoin

Changes in version 1.1.12

New features

• gather/collect function name changed to rearrange
• clusterSex now clusterOn, works with characteristic of choice

Changes in version 1.1.11

New features

• Renamed gather function to collect

Changes in version 1.1.10

New features

• Double bracket method for MultiAssayExperiment available

Changes in version 1.1.9

New features

• clusterSex function available for clustering gender from expression data

Bug fixes and minor improvements

• Improvements to documentation

Changes in version 1.1.6

New features

• Added an example HNSC dataset

Bug fixes and minor improvements

• Improve documentation of assay method for the RangedRaggedAssay
• Bug fixes for assay method
• Removed method pollution for other Bioconductor classes
• assay method only shows numeric or character data

Changes in version 1.1.2

New features

• extract method renamed to gather
• gather allows for inclusion of pData columns
• gather method supports common classes; creates a "tidy" DataFrame with pData rownames, ExperimentList rownames, ExperimentList columns, assay names, and optional pData columns

Bug fixes and minor improvements

• Fix assay arguments for the RangedRaggedAssay method
• Subsetting by column now arranges sampleMap in proper order

Changes in version 1.1.1

New features

• extract method now available for common classes - creates tidy data.frame from data
• Example section added to vignette for converting data frames to Bioconductor objects
• dimnames method added to RangedRaggedAssay
• $ (DollarSign) method available for MultiAssayExperiment to access pData column
• metadata<- set method now available for the MultiAssayExperiment
• Improved MultiAssayExperiment constructor with renamed argument "experiments" for the ExperimentList or list input.
• updateObject method now available for old instances of the MultiAssayExperiment
• Users with invalid MultiAssayExperiments should update and re-serialize them
• complete.cases method available for the MultiAssayExperiment class
• sampleMap column names renamed to assay (prev. "assayname"), primary, and colname (prev. "assay")
• New vignete available for creating MultiAssayExperiment objects with TCGA data
• Elist class renamed to ExperimentList
• ExperimentList constructor is homonymous
• ExperimentList accessor now called experiments
• ExperimentList replacement method is now experiments<-
• Updated vignettes to reflect change of names
• assay method for RangedRaggedAssay works on inner metadata columns now
• vignette examples available for HDF5Array package
• Improved outline for main vignette
• assay method available for RangedRaggedAssay and other classes. Created to obtain raw data from certain classes (see ?assay,(class),ANY-method).
• Subsetting by non-character i (#108)
• PrepMultiAssay helper function now available to aid in creating object (#122)
• Vignette now building (#125)
• Preliminary assay method for RangedRaggedAssay
• Replacement method for colnames now available for the RangedRaggedAssay class.

Bug fixes and minor improvements

• Documentation updated with new roxygen version
• Improved RangedRaggedAssay rowname construction
• Improved show method for the RangedRaggedAssay class
• Improved MultiAssayExperiment constructor now handles stray assays, colnames, pData rownames, and sampleMap rows
• metadata argument available in the MultiAssayExperiment constructor function
• Fix bug when subsetting for unmatched samples/colnames (drop = FALSE) in constructor
• drop argument now works as intended when using List inherited objects
• A proper dimnames method added to MultiAssayExperiment
• Added informative error to MultiAssayExperiment constructor
• Improved show method display
• Removed warning message when only ExperimentList argument provided
• Superfluous subset function removed
• sampleMap uses character vectors instead of Rle
• Elist order consistent when subsetting
• mapToList preserves list order