GO.db in Suggests and guard the examples and tests that run
ChIPseeker::annotatePeak() on it, fixing Windows r-universe failures where
it is no longer installed implicitly.
(PR #216)exampleDMRs dataset: annotated DMRs between all type groups of
exampleTumourNormal, used by the examples of the DMR helper functions so
they no longer recompute DMRs or annotation.
(PR #207)makeQset() and the generation vignette now use a single
MEDIPSData bam file restricted to chr21, and the sliceDMRs() example for
adjPval now uses metric = adjPval.
(PR #207)ChIPseeker::annotatePeak() runs in the test suite.
summariseDMRsByGene() is now tested on exampleDMRs, and the mouse tests
annotate for real once instead of three times, checking the remaining TxDb
argument forms against the object each resolves to. The cached example
qseaSet now uses one sampling depth throughout.
(PR #207)addLibraryInformation() now handles matrix-backed library tables.
(PR #208)getDataTable() preserves sample names containing assay suffixes by removing
only the final method suffix.
(PR #208)makeQset() now drops reads on chromosomes outside chrSelect before the
CpG enrichment, so a BAM with other chromosomes no longer warns about
out-of-bound ranges.
(#122, PR #171)runHMMCopy(), and so makeQset() and addHMMcopyCNV(), no longer passes
on the loess warnings from HMMcopy's GC correction. Other warnings are
still passed on.
(#122, PR #171)plotGeneHeatmap() now uses an explicit mart instead of the one stored on
the qseaSet, and exampleMouse no longer stores a Mart for the retired
Ensembl nov2020 archive: mouse users pass a mart matching mm10.
(#173, PR #174)poolSamples() now runs on exampleTumourNormal and on qsea's example
set, and its example is no longer wrapped in \dontrun{}. It has new
renormalise and maxPatternDensity arguments for addNormalisation(), and
renormalise = FALSE pools the CpG-dense example data, which cannot be
normalised. It also falls back to the pulldown libraries when the set has no
input libraries, pools only samples with the same name (Sim1 no longer
takes Sim12), keeps every library column and keeps the set's enrichment
method.
(#152, #153, PR #181)addMedipsEnrichmentFactors() now replaces the relH and GoGe columns
that addBamCoveragePairedAndUnpaired() already wrote, instead of adding a
second pair, so addLibraryInformation() and getSampleQCSummary() work on
the result.
(#152, PR #181)plotGeneHeatmap() now stops with an error when the Ensembl BioMart does
not answer within getOption("mesa_ensemblTimeout", 5) seconds, instead of
retrying biomaRt through three connection timeouts. A mart with its own
http_config is not probed.
(#183, PR #184)exampleMouse qseaSet has been regenerated from
data-raw/exampleMouse.R. Its sampleTable has an updated group column
giving each sample's replicate group, and no longer has a project_name
column.
(#200, PR #201)qseaSet slots that qsea does not expose:
getLibraries() and setLibraries() for the library tables,
getEnrichment() and setEnrichment() for the enrichment fit, and
setCounts(), setRegions(), setSampleTable(), setParameters() and
setCNV() for the slots qsea only lets you read. getLibraries(),
setLibraries(), getEnrichment() and setEnrichment() can read or write
a whole slot or a single named slot element. setParameters() merges
the parameters it is given in a named list, replacing matching values and
retaining parameters not provided.
(PR #205)asRangedSummarizedExperiment() to convert a qseaSet to a
rangedSummarizedExperiment for compatibility with other BioConductor
packages. This is still in progress, with further updates expected.
(PR #208)annotateWindows(), getGenomicFeatureDistribution(),
plotGenomicFeatureDistribution(), plotGeneHeatmap() and
setMesaParallel() now run instead of sitting in \donttest{} or
\dontrun{}. Annotation examples run when the TxDb and OrgDb packages are
installed, plotGenomicFeatureDistribution() no longer annotates human data
with the mm10 annotation, plotGeneHeatmap() runs one example instead of
three, and annotateWindows() restores the mesa_* options it sets. The
internal mixThreeQsetSamples() no longer has an example, and the
exampleMouse title now says it holds 4 mouse samples.
(#153, PR #179)addHMMcopyCNV() example now runs, on the MEDIPSData chr22 BAM. mesa
gains gc_hg19_chr22_100kb and map_hg19_chr22_100kb, the GC and
mappability of hg19 chr22 in 100 kb bins, built by two new data-raw/
scripts from public sources. The addHMMcopyCNV() help no longer says that
only hg38 is supported, and says that windowSize must match the tracks.
(#180, #153, PR #182)data-raw/ scripts for reference data (hg38CpGIslands,
ENCODEbadRegions, FantomRegions, hg19ToHg38.over.chain,
hg38_450kArrayGR, hg38UltraStableProbes and the gc_hg38_* and
map_hg38_* tracks) now download their public sources instead of reading
internal paths. The scripts and help pages for exampleTumourNormal and
exampleMouse have updated descriptions.
(#95, #200,s PR #195, PR #201)writeBigWigs() test no longer reads the bigWig back on Windows, where
rtracklayer cannot import bigWig files. The other checks still run there.
(#203, PR #204)mixSamples(), combineQsets() and combineQsetsList(),
getMesaGenome(), getMesaTxDb() and getMesaAnnoDb(), removeCNV(),
renameQsetNames(), renameSamples(), filterByNonOverlaps(),
makeTransposedTable(), countWindowsAboveCutoff(),
subsetWindowsOverBackground(), removeLibraryFactors(), writeBigWigs(),
getGenomicFeatureDistribution(), plotGenomicFeatureDistribution(),
plotDMRUpset(), and the shape and colour scales and error checks of
getPCA() and plotDimRed().
(#193, PR #194)makeQset() option
tests build on small synthetic yeast BAMs, only one hg19 and one GRCh38
makeQset() test still read the MEDIPSData BAMs, and the live-Ensembl mouse
test only runs when MESA_LIVE_ENSEMBL is set. The calculateCGEnrichment()
test now pins relH and GoGe to a relative tolerance of 1e-6 instead of 5.
The UMAP tests no longer run gc() inside uwot::umap(), which cut
test-pca.R from about 20 s to 2 s.
(#189, PR #192)makeQset() and calculateCGEnrichment() tests now run by default, so
every test runs under R CMD check; the option and helper that switched
slow tests off are gone. The hg19 test uses chr21 and chr22 to stay fast.
(#121, PR #178)calculateCGEnrichment() works without GenomicRanges
attached (#81) now runs first in every test run, so it is no longer skipped.
(#121, PR #178)exampleQset, correlation, UMAP and general-functionality tests
now run by default instead of behind skip_long_checks(), using the cached
example qseaSet; skip_long_checks() moved into
tests/testthat/helper-skip.R.
(#121, PR #177)makeQset() tests now use the public MEDIPSData
BAM files instead of a file on an internal server, so they run in CI.
(#122, PR #171)plotGeneHeatmap() and mouse tests now run offline against cached
Ensembl lookups instead of skipping when Ensembl can't be reached, and
tests that change the mesa_* annotation options restore them afterwards.
(#123, PR #172)qseaSet slot with @. Every read now goes
through a qsea::get*() accessor or one of the new mesa ones, and every
write through a new setter, so slot access is confined to R/qseaSlots.R.
The refactor preserves behaviour except that
addBamCoveragePairedAndUnpaired() now replaces parameter values with
matching names rather than appending duplicate entries, and
setMart(qs, NULL) leaves a NULL entry in the parameters slot whereas
previously it used to be deleted.
(PR #205)getSampleNames() documentation and the data and QC vignette
are now at most 80 characters, clearing those BiocCheck formatting notes.
(#169, PR #170)R CMD check now runs those tests,
including the exact read-count check, against the built package.
(#121, PR #178)R/ or vignettes/ is longer than 80
characters, contains a tab or is indented by a number of spaces that is not
a multiple of 4.
(#169, PR #170)plotGeneHeatmap() example and the live mouse test now run only when
Ensembl answers, so R CMD check no longer waits on a hung archive.
(#183, PR #184)R CMD check step now stops after 40 minutes.
(#183, PR #184)docs/ folder. CI builds the pkgdown site and serves
it from the gh-pages branch, so the site and its links are unchanged.
(#196, PR #199)mesaDimRed, mesaPCA and mesaUMAP objects are now checked for internal
consistency, and validObject() rejects an inconsistent one with a message
naming the problem: duplicate or missing windows, results without sample IDs,
mixed PCA and UMAP results, results covering different samples, or samples
absent from sampleTable or dataTable.
(#115, PR #149)getSampleNames() now works on mesaDimRed objects and returns the sample
IDs their results cover (sample group names with useGroupMeans = TRUE).
(#10, PR #149)mesaDimRed, mesaPCA and mesaUMAP objects
without @: getResults(), getParameters(), getCoordinates(),
getPrcomp(), getWindowNames(), getDataTable(), getSampleTable() and
getSampleNames(). On a mesaDimRed, getResults(), getCoordinates(),
getPrcomp() and getWindowNames() return a list with one element per
result. getCoordinates(), getWindowNames() and getSampleNames() also
work directly on mesaPCA and mesaUMAP objects, and getPrcomp() on
mesaPCA objects. The first argument of getDataTable() is now x
instead of qseaSet.
(#117, PR #158)as.data.frame() can now be applied to mesaDimRed objects, returning one
table of coordinates and sample annotations for all PCA or UMAP results in
the object.
(#117, PR #158)getWindowNames() now says "Unknown data type" when given something that
is not a qseaSet, mesaDimRed, mesaPCA, mesaUMAP, GRanges or
window table.
(#117, PR #158)plotPCA() and plotUMAP() no longer fail when the sampleTable has a
column named like a component (for example PC1); the plot uses the
computed coordinates.
(#117, PR #158)plotPCA() and plotUMAP() now say that params$method must be "PCA" or
"UMAP" when a mesaDimRed has none, instead of failing with "argument is
of length zero".
(#117, PR #158)mesaDimRed validity now checks sample IDs against the
sampleTable$sample_name column, as qsea does, rather than its row names,
and says so when the column is missing.
(#117, PR #158)mesaDimRed objects no longer have a samples slot, and
mesaDimRed() no longer takes a samples argument. Code that reads
@samples should call getSampleNames() instead, and code that passes
samples = to mesaDimRed() should drop it; objects saved with an earlier
version still load and work.
(#10, PR #149)mesaDimRed, mesaPCA and mesaUMAP constructors and
for each validity check.
(#116, PR #149)NEWS.md bullet now ends with the issue and the pull request that
delivered it, for example
([#162](https://github.com/cruk-mi/mesa/issues/162), [PR #165](https://github.com/cruk-mi/mesa/pull/165)).mesaDimRed, mesaPCA and mesaUMAP help pages list their accessors,
?dimRedAccessors documents them, and the PCA vignette shows how to read a
getPCA() result.
(#7, PR #158)exampleTumourNormal, links to
the pkgdown site and vignettes, and citations.
(PR #108)citation("mesa") now returns the two published papers.
(PR #108)data-raw/figures/.
(PR #110)?mesa is now a user-facing overview listed in the reference index: what
enrichment sequencing measures, the workflow from makeQset() to
annotateWindows(), the example datasets and the vignettes.
(#118, PR #151)addBamCoveragePairedAndUnpaired(), addMedipsEnrichmentFactors(),
addNormalisation(), annotateWindows(),
getGenomicFeatureDistribution(), getMesaAnnoDb(), getMesaGenome(),
getMesaTxDb(), makeQset(), plotGenomicFeatureDistribution(),
plotRegionsHeatmap(), runHMMCopy(), summariseDMRsByGene(),
exampleMouse and exampleTumourNormal. Examples that need MEDIPSData or
the annotation packages are skipped when those are not installed.
(#118, PR #151)addMedipsEnrichmentFactors() example works: it adds coverage before
calculating the enrichment factors, instead of failing.
(#118, PR #151)makeQset() argument properPairsOnly and CNVmethod = "None", the
group1/group2 contrast columns of calculateDMRs(), and describe the
blind calibration and getBetaTable(useGroupMeans = TRUE) output correctly.
(#120, PR #155)?addHyperStableFraction and
?hg38UltraStableProbes now links to its DOI instead of PubMed.
(PR #155)main; Codecov
statuses are informational.
(PR #108)immunedeconv (with its GitHub
dependencies) or imsig, which mesa does not use, and takes ggtree from
Bioconductor instead of a GitHub pin. It now installs nothing from GitHub,
so it no longer needs the pinned archives and SHA check added in 0.99.7.
(PR #132)vX.Y.Z tag now publishes a GitHub Release with the source
tarball and that version's NEWS.md notes, once the tag matches
DESCRIPTION and NEWS.md and passes the r-universe Bioconductor build.
(PR #112)R CMD check. A push to
an open pull request no longer starts a second run, and cancels the
superseded one.
(PR #114)calculateCGEnrichment() no longer depends on MEDIPS: reads are imported
with Rsamtools and CpGs located with Biostrings. This fixes a crash in a
fresh session (could not find function "strand<-") and silent read loss on
chromosomes longer than 2^29 bp. Read counts are otherwise unchanged.
(#81, PR #102)calculateCGEnrichment() now errors on a chr.select entry absent from the
BSgenome instead of returning no reads.
(PR #102)uniq now accepts only 0 (keep all reads) or 1 (one read per location);
the unused p-value form is removed.
(PR #102)chr.select = NULL, CpGs are located only on chromosomes that carry
reads, which is much faster on genomes with many scaffolds (e.g. hg19).
(PR #102)MEDIPS removed from Suggests.
(PR #102)Config/roxygen2/version in DESCRIPTION; the
devcontainer installs that exact version. Regenerated man/ and NAMESPACE
with roxygen2 8.1.0 (link anchors and importFrom() formatting only).
(PR #105)roxygen-drift CI job that fails when man/ or NAMESPACE is out
of sync with the roxygen comments in R/.
(PR #105)GenomicAlignments::cigarWidthAlongReferenceSpace() with
cigarillo::cigar_extent_along_ref(), fixing the vignette build on
Bioconductor devel (GenomicAlignments >= 1.49.1).
(PR #98)≥, ≤, ∈) with ASCII equivalents (>=,
<=, in) in roxygen2 comments and .Rd files to fix LaTeX errors in the
PDF manual.
(PR #88)summariseDMRsByGene() example in \donttest{} to keep
R CMD check within the 10-minute limit (~52 s saved).
(PR #88)bioconductor/bioconductor_docker,
dropping conda; devcontainer and CI now share the same toolchain. The
R (>=) line in DESCRIPTION is the single source of truth: Bioc version
and image tag are derived automatically; upgrading R requires editing that
one line only.
(PR #92)testthat blocks with skip_long_checks() to keep
R CMD check within the Bioconductor 15-minute limit.
(PR #84)skip_long_checks() guard to the calculateCGEnrichment test, which
also fails in CI due to a missing strand<- in the MEDIPS namespace.
(PR #84)GPL-3 to GPL (>=2).
(PR #80)qsea::getExampleQseaSet() calls in getUMAP() examples with
exampleTumourNormal, removing slow synthetic data generation from
R CMD check example runs.
(PR #77)addNormalisation() examples in \donttest{}: the function
requires windows across a range of CpG densities for background
estimation, which the pre-filtered example datasets do not provide.
(PR #77)plotly PNG device error on headless build servers
(PR #75)ragg_png device in PCA vignette chunks to resolve
Cairo/X11 dependency issues in CI
(PR #75)R CMD check TIMEOUT: skip_long_checks() read options()
instead of getOption(), so slow tests never skipped. Also set
options(skip_long_checks = TRUE) in tests/testthat.R.
(PR #77)qsea::getExampleQseaSet() builds via
cachedExampleQset() (helper-fixtures.R) and gated the slowest
test_that() blocks behind skip_long_checks().
(PR #77)addHMMcopyCNV(): replaced qsea:::makeGenomeWindows() with a
fixed-width GRanges reimplementation, correcting window widths and
boundaries.
(PR #77)addHyperStableFraction() now uses identical() for the BSgenome
check, avoiding an "argument is of length zero" error when the
BSgenome parameter is missing (NULL).
(PR #77)mixSamples() now reports which sample name(s) are absent from the
qseaSet instead of a generic stopifnot() failure, restoring the
diagnostics lost when qsea:::checkSamples() was dropped.
(PR #77)mixThreeQsetSamples() likewise now names the absent sample(s) rather
than failing with a generic stopifnot() message.
(PR #77)qsea via @import
(R/mesa-package.R), replaced all qsea:::/janitor::: calls with
public-API equivalents or inline slot assignments, and declared five
data-object names in utils::globalVariables().
(PR #77)LINE_LENGTH notes; where :: cannot be broken across
lines, replaced long namespace-qualified names with getExportedValue()
(for annotation-package objects in R/genome.R, R/qseaExtra.R) and
utils::data() (for package datasets in R/calculateEnrichment.R,
R/qseaExtra.R) — both are semantically equivalent to pkg::name but
can be formatted across multiple lines
(PR #76)\donttest{} across getPCA(), getUMAP(),
getDimRed(), plotUMAP(), plotDimRed(), makeQset(), annotateWindows(),
getGenomicFeatureDistribution(), plotRegionsHeatmap(), plotGeneHeatmap(),
plotGenomicFeatureDistribution(), summariseDMRsByGene(), writeDMRsToExcel(),
writeDMRsToBed(), and calculateCGEnrichmentGRanges() — fixes R CMD check
TIMEOUT on Bioconductor build machines.
(#74)@examples block in plotRegionsHeatmap() that caused
identical examples to appear twice in the generated Rd file.
(#74)\code{\link[pkg]{function}} syntax —
R-devel (4.6) is stricter about package-anchored topic resolution.
(#73)hg38UltraStableProbes, plotRegionsHeatmap,
renameSamples, and sliceDMRs documentation to stay within 100 characters.
(#73)inst/scripts/install_mesa.R — standard BiocManager::install()
is sufficient for installation.
(#73)devtools::check() and BiocCheck::BiocCheck().
(#73)sliceDMRs to take the 'top' DMRs in each contrast, based on a specified ranking column. !24getMesaGenome(), getMesaTxDb(), and getMesaAnnoDb() functions to complete mesa's genome management system. Supports hg38, hg19, and mm10 with extensible architecture. !68plotGenomicFeatureDistribution() now supports multiple genomes via genome, TxDb, and annoDb parameters. Function now works with mesa's genome system via setMesaGenome() or custom genome builds. No longer limited to hg38. !68inst/scripts/install_mesa.R: one-shot installer that automatically sets the correct Bioconductor version and validates environment consistency — see README for usage. !72plotPCA into a submethod for the qsea defined method. !11plotPCA gains a verbose option to turn off most of the messages produced. !11plotPCA and plotUMAP now default to filled shapes rather than empty shapes if less than 6 shapes are required. !36plotPCA and plotUMAP can now specify the shapes used via shapePalette, even if no shape annotation is being given. !36getSampleTable is now defined for PCA/UMAP objects. !11plotGeneHeatmap now automatically retries if it fails to connect to biomaRt, and fails with a clear error message if it cannot connect. !44fdrThres changed to FDRthres in calculateDMRs and subsetWindowsOverBackground. !48makeQset now checks that the chromosomes provided match with those present in the BSgenome. !32"PairedAndR1s" coverage method for makeQset will now only process reads that are present in the regions, this should reduce memory requirements and fix issues when _alt chromosomes exist in the bam files. This means the fragment size measurements are now only calculated over the selected regions. !32plotPCA and plotUMAP no longer take the qseaSet as an input. The PCA/UMAP object has a copy of the sampleTable which may be modified instead. !58seq_along rather than 1:n throughout. !67actions/checkout@v2 to v4; added system info step to CI for easier debugging. !71plotGenomicFeatureDistribution and getGenomicFeatureDistribution internal as they currently only work for hg38. !14calculateFractionReadsInGRanges internal as it seems to be returning the fraction of windows that overlap not reads. !14countWindowsAboveCutoff internal as it needs the arguments renaming and better documentation. !14getAnnotationDataFrame and getAnnotationDataFrameIndividual as they are superseded by getAnnotation and the shift to tidy evaluation via sampleAnnotation in the plotting functions. !14colnames function definion on a qseaSet, which was not working anyway. !14dropAvgFragDetails as no longer required. !63.Rbuildignore to exclude .github, .devcontainer, docs/ and other non-package files from the build — silences related R CMD check notes. !70installDependencies.R. !72makeTransposedTable no longer adds chr to the window names even if they already had a chr prefix. !14... inside plotGeneHeatmap and plotRegionsHeatmap. !14writeDMRsToBed should now correctly export the files. !14plotRegionsHeatmap was given more than one region that overlapped one window. !21addMedipsEnrichmentFactors (thanks @daonslog for reporting). !14makeQset, renameSamples and renameQsetNames will no longer accept sample names that are not valid column names in R without quotation. !31fragmentLength when calling makeQset with the CNVmethod = "MeCap" option, and fix an issue with hg19 GRanges. !21plotPCA now plots a shape column that contains NA values without needing to also specifying NAshape. !36plotPCA and plotUMAP no longer print a NULLcol or NULLshape column in the legend when using filled shapes. !36plotPCA and plotUMAP now show the fill colour as opposed to black points in the legend when using filled shapes. !36fragmentLength when calling makeQset with the CNVmethod = "MeCap" option, and fix an issue with hg19 GRanges. !21makeQset printed the wrong number of paired reads being filtered out due to having an insert size outside of the selected size range. !32plotPCA when using ggplot2 4.0.0. !55plotGenomicFeatureDistribution that occurred with Bioconductor 3.21 when multiple chromosome columns existed after ChIPseeker annotation. !68plotGeneHeatmap() examples to handle transient Ensembl connection errors during R CMD check. !70plyranges::mutate() calls throughout the package — plyranges 1.30 no longer re-exports dplyr::mutate(). !72GRanges-class Rd cross-references in liftOverHg19(), getCGPositions(), and qseaTableToChrGRanges(). !72plotGeneHeatmap() examples failing during R CMD check due to transient Ensembl connection timeouts. !72This is the first released version on github, following a lengthy period of internal development. Many things have changed in a major overhaul of the package.
summariseDMRsByGene now correctly summarises genes when they have different positions or lengths in different windows. !5plotCorrelationMatrix no longer crashes when no annotation is being used. !5covr coverage.getPCA() and getUMAP() now return an object of class mesaDimRed, which wraps the previous list based output. This object now contains a copy of the sampleTable, which may be edited using mutate and left_join.plotGeneHeatmap.plotPCA() and plotUMAP() no longer require passing the qseaSet, as the sampleTable is stored in the object.setMesaGenome, setMesaTxDb and setMesaAnnoDb to set global defaults for the annotation packages required by annotateWindows. This has the effect that annotateWindows will no longer assume hg38 by default with no arguments.summariseDMRsByGene function now requires annotateWindows to have already been called on the DMRs (previously it called this internally if necessary).poolSamples now returns data frames instead of matrices in the libraries slot.select now works when dropping a column. !6downSample now works correctly again following changes to how table and enframe interact.calculateDMRs now correctly returns an empty data frame if no DMRs are found.plotPCA now works when colouring by a factor variable.mutate now cannot be used to change the sample_name in the sample table of a qseaSet which breaks the object. renameQsetNames or renameSamples must be used for this.gc_hg38_10kb and map_hg38_10kb (GC and mappability tracks for hg38 at 10kb resolution) for package size reasons.Fixed how the relative enrichment (relH/GoGe) calculation is performed (addMedipsEnrichmentFactors) when using the qsea default method for reads (#1).
Filtering a qseaSet now works correctly when a qseaSet has no cnv data.
Fixed pull to work directly on a qseaSet to return a column of the sampleTable.
Removed mutateQset, filterQset, arrangeQset, sortQset, pullQset, leftJoinQset as these just work on the dplyr verbs directly.
Combined getBetaMeans and getNormalisedReadSum into new function called summariseAcrossWindows.
This allows an arbitrary function to be (e.g. mean or sd) to be applied over all the windows in each sample, and returns a data frame with one result per sample.
Added a new function addSummaryAcrossWindows that performs summariseAcrossWindows but returns the qseaSet with the results added to the sampleTable.
Added a function asValidGranges that checks if an object can be coerced to a GRanges object and does so if possible.
Added setMesaGenome function to globally set which genome to be used for plotting functions.
Standardised on using "Windows" instead of "Regions".
For instance, filterRegions is now filterWindows, and plotGRangesHeatmap is now plotRegionsHeatmap.
Added a function getWindows to mimic getRegions from qsea.
Complete overhaul of the PCA functionality.
getPCA and plotPCA, and the getPCAwithBatch function has been removed.UMAP functionality added, using the same framework as PCAs, with getUMAP and getPCA.
This is still experimental.
Changed pivotDMRsLonger to return columns "group1" and "group2" instead of "sample1" and "sample2".
In DMR results, moved the betaDelta columns to be after the equivalent adjPval columns instead of all being at the end.
Renamed the contrastsToDo argument of makeDMRs to just contrasts.
mixSamples (formerly mixQsetSamples) no longer sets type and tumour in the sampleTable of the returned qseaSet.
Changes to heatmap plotting functions (plotRegionsHeatmap and plotGeneHeatmap, plotCNVHeatmap):
plotGRangesHeatmap is now renamed as plotRegionsHeatmap
Both support a useGroups argument, to determine whether to average over the "group" column of the sampleTable or not.
Argument signatureGR of plotRegionsHeatmap changed to regionsToOverlap.
Changed from pheatmap package to ComplexHeatmap package for the plotting.
The method of adding sample annotations has been overhauled.
This is now specified using sampleAnnotation (instead of annotationCol), and does not support the use of the getAnnotationDataFrame function.
These options now directly take the name of the features to be plotted, supporting unquoted tidy evaluation, i.e. all of these work:
sampleAnnotation = group
sampleAnnotation = c(group, type)
sampleAnnotation = c("group","type")
Heatmaps can now have windows annotated with the use of windowAnnotation.
This supports unquoted tidy evaluation as well, and can use anything on the qseaSet regions slot or on the regionsToOverlap argument.
The getAnnotationDataFrame and getAnnotationDataFrameIndividual functions have been removed.
The colours for the annotations have been overhauled. These now try to choose appropriate colour scales for continuous data based on whether they are strictly positive or not. For discrete annotations, the colours are set globally for the entire annotation set, to try and prevent the occurrance of different annotations using very similar colours.
getDataTable function can now keep the suffix (e.g. _nrpm or _beta) if required.
removeWindowsOverCutoff and keepWindowsOverCutoff have been replaced by a more general function called subsetWindowsBySignal.
This allows for a general function to be specified (for instance mean or max) as well as a threshold, enabling for the filtering of windows based on that function.
Parallelisation of functions is now controlled explicitly by the setMesaParallel function.
This must be used to enable multicore evaluation.
When calculating DMRs, by default the qseaSet will now be filtered to only include samples which are present in the contrasts for the calculating of the dispersion estimates in the generalised linear model.
This can be controlled by the calcDispersionAll option.
The pre-filtering of windows based on expression is unchanged - this only uses samples included in the contrasts.
The difference in mean beta values in the DMR output has been renamed from betaDelta to deltaBeta to reflect the mathematical usage \tex{\Delta \beta}.
Updated documentation in many functions.
Authors updated to include Paddy Harker, Kevin Brennan and Katarzyna Kamieniecka.
Removed exporting of internal functions: dropAvgFragDetails, getBamCoveragePairedAndUnpairedR1, mixThreeQsetSamples, getCGPositions, fitQseaGLM, getDMRsData, subsetWindowsOverBackground.
Renamed many functions throughout the package:
| Previous Function Name | New Function Name |
|---------------------------------|--------------------------------|
| addQseaNormalisationSteps | addNormalisation |
| annotateData | annotateWindows |
| calculateArrayBetas | convertToArrayBetaTable |
| calculateCpGEnrichment | calculateCGEnrichment |
| calculateCpGEnrichmentGRanges | calculateCGEnrichmentGRanges |
| countWindowsOverCutoff | countWindowsAboveCutoff |
| downsampleQsea | downSample |
| filterRegions | filterWindows |
| liftOverhg19 | liftOverHg19 |
| mixQsetSamples | mixSamples |
| plotDMRUpSet | plotDMRUpset |
| qseaWriteDMRsBeds | writeDMRsToBed |
| qseaWriteDMRsExcel | writeDMRsToExcel |
| relabelQset | renameSamples |
| summariseByGene | summariseDMRsByGene |
Six functions have been replaced by different functions (detailed above).
+---------------------------+--------------------------+
| Previous Function | Replacement Function(s) |
+===========================+==========================+
| getQseaPCA | getPCA/plotPCA |
| | |
| getPCAwithBatch | |
+---------------------------+--------------------------+
| getBetaMeans | summariseAcrossWindows |
| | |
| getNormalisedReadSum | |
+---------------------------+--------------------------+
| removeWindowsOverCutoff | subsetWindowsBySignal |
| | |
| keepWindowsOverCutoff | |
+---------------------------+--------------------------+
Renamed data objects:
| Previous data name | New data name |
|---------------------------|-----------------------|
| encodeBlacklist | ENCODEbadRegions |
| examplePairedTumourQset | exampleTumourNormal |
plotGeneHeatmap now uses bioMaRt to find the gene details, based on the genome or mart supplied.
filterByOverlaps now works when the `qseaSet` regions contains "chr" but the regions to filter by do not or vice versa.
Removed all references to PooledControl sample (previously suggested for normalisation).
Various R CMD check warning issues fixed.!6
filterByOverlaps no longer allows the option to take a list of window ID numbers.
Fixed addMedipsEnrichmentFactors function inside makeQset when using the "qseaPaired" coverageMethod.
Fixed tests for addMedipsEnrichmentFactors.
* pull is not working directly, pullQset must be used.
Version set for initial release in v2.0.1 of the internal CBC Nextflow pipeline.