Changes in version 2.2.0: BUG FIXES o Restore the `correctSystematicG` option in `getCTSS()`. See #61. o Restore object class consistency in if / else statement in private function `bam2CTSS`. Fixes #49. o Restore proper CTSS conversion from BAM files (bug introduced in v1.34.0) while fixing issue #36. o Ensure Tag Clusters have a Seqinfo. Fixes #63. Changes in version 2.0.0: BACKWARDS-INCOMPATIBLE CHANGES o The `CAGEset` class is removed. o Accessors using plain `data.frame` formats are removed. o Modifier functions return the object instead of silently modifying it in the global environment. Thus, you can use R pipes (`|>`). o Removed export function that unconditionally wrote files to the working directory, such as `exportCTSStoBedGraph`. As a replacement a new converter is provided, `exportToBrowserTrack`, that produces `UCSCData` objects that the user can then wite to files using the _rtracklayer_ package. o Removed the `extractExpressionClass` function, as the information is easily accessible from within the `CTSS` or `ConsensusClusters` objects. NEW FEATURES o `CTSSnormalizedTpmGR` and `CTSStagCountGR` now accept `"all"` as a special sample name to return them all in a `GRangesList` object. o Plot interquantile width and expression clusters with ggplot2. BUG FIXES o Corrected the `getExpressionProfiles` function to accept CAGEexp objects. o Updated the `exampleCAGEexp` object to contain expression classes. o Restore paraclu support for CAGEexp objects. o Corrected a bug in `aggregateTagClusters` that was causing mislabelling of tag clusters (PR#42). o Prevent `plotReverseCumulatives` from crashing when values are not in range. (PR#43). Changes in version 1.34.0: BUG FIXES o Reform the CTSS class. New accessor: `CTSS()` (with no dot). o Correct a class error when loading BAM files. (Closes #36). o Use the BSgenome object from the main environment if available. Changes in version 1.32.0: BUG FIXES o Update end coordinates before start coordinates in the function `.aggregateTagClustersGR()`. This should stop triggering "'width(x)' cannot contain negative integers" errors. o Correct `.make.consensus.clusters` internal function. This should stop triggering "Consensus clusters must not overlap with each other" errors. o Allow empty `CTSS.chr` objects. o Correct `plotInterquantileWidth()` to really use consensus clusters when passed the argument `clusters = "consensusClusters". o Fix failures on `CAGEexp` objects containing only one sample. Changes in version 1.30.0: BUG FIXES o Correct usage of `&&` for vector comparison in pairs.DataFrame(). o Adjust to latest SummarizedExperiment MultiAssayExperiment versions. Changes in version 1.28.0: BACKWARDS-INCOMPATIBLE CHANGES: o The CTSS objects are now based on the UnstitchedGPos class instead of the parent GPos class. Existing CAGEexp objects might give errors after package upgrade. NEW FEATURES o Depends on MultiAssayExperiemnt instead of previously Importing it. No need to load it by hand (nor SummaryExperiment) anymore. BUG FIXES o Correct strand in .remove.added.G private function (PR#26). Changes in version 1.26.0: DOCUMENTATION o Split the "CAGE resources" documentation into a separate vignette. Changes in version 1.24.0: NEW FEATURES o plotAnnot(): the "group" argument now accepts formulas such as "~ a + b" to indicate names of metadata column that will be pasted together to form a new group factor. BUG FIXES o Prevent mergeSamples() from producing colData that cause other functions to crash later when coercing to data.frame. o Repaired paraclu support for CAGEset objects. o normalizeTagCount() works again on CAGEset objects. o consensusClustersGR() reports expression score of the selected sample (instead of silently ignoring the "sample" argument and reporting expression sum on all the samples). Changes in version 1.22.0: BACKWARDS-INCOMPATIBLE CHANGES: o The plotting functions send their output to the graphical device instead of writing it to a file. This makes their use more consistent with most plotting functions in R. NEW FEATURES o New "CAGEexp" class extending the MultiAssayExperiment class. It stores expression data more efficiently than "CAGEset", and uses core Bioconductor typse natively. For backwards compatibility it also support many of the original generic functions for "CAGEset" objects. Sample names in CAGEexp objects must by syntactically valid. Some methods are not yet available for CAGEexp object (see the vignette). Conversely some new functions will not be available for CAGEset objects. o New "CTSS" and "TagClusters" classes wrapping GPos and GRanges objects, for more type safety. o New functions for quality controls such as plotAnnot() or hanabiPlot(). See the CAGEexp vignette for details. o New removeStrandInvaders() function to count and remove strand-invasion artefacts (see Tang et al., 2013, doi:10.1093/nar/gks112). o Data export as DESeqDataSet object for DESeq2 with the new consensusClustersDESeq2() and GeneExpDESeq2() functions. o New "bedctss" format to load the FANTOM5 and FANTOM6 CAGE data. o Multicore parallelisation with BiocParallel instead of parallel. o New function sampleList() to help looping on samples with lapply(). o New plotCorrelation2() function, faster than plotCorrelation() because it is plain black and white. o Multicore loading of CTSS data in CAGEexp objects. OTHER CHANGES o Example data "exampleCAGEexp", "exampleCAGEexp" and "exampleZv9_annot" are now is lazy-loaded. o NULL can be passed as genome name, to circumvent the requirement for a BSgenome object when actually not needing one. o In CAGEexp objects, expression quantile positions are given relative to the cluster start site. o For performance reasons, the positions of a quantile Q is now calculated as the position of the first base where cumulative expression is higher or equal to Q% of the total expression of a cluster. o plotReverseCumulatives(): - fitInRange accepts a value of "NULL" to turn off power law fitting. - New "legend" argument to remove legend when set to "FALSE". - Axis range and labels can be modified with xlab/ylab and xlim/ylim. - Ladders steps start on the values instead of being centered on. o setColors(): allow lowercase in color names. BUG FIXES o Corrected a bug that was crashing CAGEset objects when loading more than one BAM file. o Load BAM as gapped alignment with readGAlignments() instead of scanBam(). Without this correction, TSS position on minus strand is incorrect in case of indels in the read. DOCUMENTATION UPDATES o Roxygen is used to generate the manual pages. o A new HTML vignette describes the "CAGEexp" class. CHANGES in version 1.18.1 : o getCTSS() can now load data from large BAM files. Before this update, there were "negative length vectors" errors when filtering out low quality reads from datasets with multiple dozens of millions of sequences. CHANGES in version 1.18.0 : o Added Charles Plessy as co-maintainer. o Remove warning by replacing deprecated ignoreSelf() with drop.self(). CHANGES in previous versions: Updated to version 1.13.4 (27/04/2016) 26/04/2016 updated the vignette 26/04/2016 added support for BED file CAGE tags input - included the new accepted value for inputFilesType="bed" 24/04/2016 added support for paired-end BAM file CAGE data input (CAGEscan) - included the new accepted value for inputFilesType="bamPairedEnd" Updated to version 1.13.3 (18/04/2016) 18/04/2016 updated the vignette 14/04/2016 modified the consensusClusters() function to allow extracting sample-specific information, such as CAGE signal, position of the dominant TSS and interquantile width in a specific sample (i.e. consensusClusters() now behaves analogously to tagClusters() function) 10/03/2016 fixed the bandwidth of the smoothing kernel for plotting correlation density plots to always scale with the number of bins 10/03/2016 added new argument to plotCorrelation() function that allows controlling figure size in pixels 03/11/2015 fixed the format of exporting bed12 files for tag clusters, which contained overlapping blocks per record and caused problems when trying to convert bed to bigBed 03/11/2015 added an option of exporting CTSS bedGraph files to BigWig format - added a new argument to exportCTSStoBedGraph() function Updated to version 1.13.0 (15/10/2015, Bioconductor 3.2 release) Updated to version 1.10.2 in the release and 1.11.2 in the development (11/10/2015) 11/10/2015 changed to selective import from data.table package to resolve the conflict regarding the shift function Updated to version 1.10.1 in the release and 1.11.1 in the development (17/09/2015) 15/05/2015 updated the vignette 15/05/2015 enabled changing xlim and ylim when plotting interquantile width distribution 13/05/2015 added mergeCAGEsets() function for merging two CAGEset objects 11/05/2015 defined 'as' method for coercing a data.frame into a CAGEset object Updated to version 1.11.0 (17/04/2015, Bioconductor 3.1 release) Updated to version 1.9.3 (06/02/2015) 06/02/2015 CAGEr package has now been published in NAR! If you find this package useful in your work, please cite: Haberle et al. (2015) CAGEr: precise TSS data retrieval and high-resolution promoterome mining for integrative analyses. Nucleic Acids Research 43(8):e51, doi:10.1093/nar/gkv054. Check citation("CAGEr") for more details. 13/01/2015 fixed the error message in tagClusters() function for the case no qLow and qUp values are specified Updated to version 1.9.2 (03/12/2014) 03/12/2014 updated the vignette - fixed the references Updated to version 1.9.1 (01/12/2014) 01/12/2014 fixed the bug in importing data from ENCODEprojectCAGE data package using importPublicData() function when importing from multiple datasets that contain groups with the same name Updated to version 1.9.0 (14/10/2014, Bioconductor 3.0 release) Updated to version 1.7.2 (01/06/2014) 01/06/2014 replaced the .RData files in the /data folder with the more compressed ones Updated to version 1.7.1 (30/05/2014) 30/05/2014 updated the vignette with the description of available public CAGE data resources and how to use them in CAGEr 25/05/2014 added a list of available human and mouse FANTOM5 samples as a dataset that can be loaded via call to data(FANTOM5humanSamples) or data(FANTOM5mouseSamples) 25/05/2014 modified the importPublicData() function so that it supports importing FANTOM5 data for human and mouse directly from FANTOM web resource, as well as data from several CAGE data packages 23/05/2014 optimized the creation of CTSS table across samples by performing merge on data.tables rather than data.frames - reading the data into CAGEset object from BAM or CTSS files is now ~10X faster Updated to version 1.7.0 (14/04/2014, Bioconductor 2.14 release) Updated to version 1.5.5 (01/04/2014) 13/02/2014 fixed bug in function for plotting interquantile width (in cases of multiple pairs of low and high quantiles present it was sometime fetching multiple columns and stopping with an error) 12/02/2014 fix typo in Details section of man page for exportToBed function 12/02/2014 fixed the bug in function for systematic correction of G addition bias (it was stopping with an error in a rare case when all reads beginning with a G and mapping to the genome are derived by trimming the G mismatch from upstream position) Updated to version 1.5.3 (10/11/2013) 08/11/2013 fixed the bug in importPublicData function that caused problems when importing only one sample 08/11/2013 fixed error in BibTex file Updated to version 1.5.2 (06/11/2013) 06/11/2013 updated vignette and NEWS file Updated to version 1.5.1 (02/11/2013) 02/11/2013 moved vignette source to /vignettes folder Updated to version 1.5.0 15/10/2013 Biodonductor 2.14. release Updated to version 1.3.10 in the development (24/09/2013) 24/09/2013 optimized calculation of K-S p-values for shifting promoters using vectorized functions 23/09/2013 removed a .C call to the pKS2 function from stats package and replaced it by an R implementation of pKS2 Updated to version 1.2.9 in the release and 1.3.9 in the development (23/08/2013) 23/08/2013 added consensusClustersTpm() function for retrieving matrix with tpm values for consensus clusters across all samples Updated to version 1.2.8 in the release and 1.3.8 in the development (23/08/2013) 22/08/2013 modified all functions to work on data from only one strand (some were previously giving error in such case) 21/08/2013 fixed the bug in calling CTSSs from reads on minus strand when not correcting for G addition, i.e. when removeFirstG=FALSE Updated to version 1.2.7 in the release and 1.3.7 in the development (08/08/2013) 08/08/2013 added new argument to aggregateTagClusters() function (excludeSignalBelowThreshold) that controls which TCs will contribute to the total CAGE signal of the consensus cluster - only the ones above the threshold that are used initially to set the boundaries of the consensus cluster, or all TCs that overlap the resulting consensus clusters 07/08/2013 enabled retrieving interquantile width for tag clusters - added new returnInterquantileWidth argument to tagClusters() function 06/07/2013 enabled importing entire CTSS table with multiple columns of tag counts representing multiple samples/experiments - allowed setting imputFilesType to "CTSStable" when creating CAGEset object and extended getCTSS function accordingly to read the entire table at once and fill the object Updated to version 1.2.6 in the release and 1.3.6 in the development (23/07/2013) 22/07/2013 replaced multicore package dependency with parallel package (suggested by Bioconductor core team) 21/07/2013 fixed the bug in using loaded genome when correcting for G nucleotide bias 20/07/2013 fixed plotReverseCumulatives to work with only one sample in the CAGEset 19/07/2013 changed naming of correlation plot files to distinguish CTSS from consensus clusters plot Updated to version 1.2.5 in the release and 1.3.5 in the development (28/06/2013) 28/06/2013 updated the vignette Updated to version 1.2.4 in the release and 1.3.4 in the development (16/06/2013) 16/06/2013 allowed plotting reverse cumulatives for normalized tag counts - added new argument to plotReverseCumulatives() function 15/06/2013 implemented calculating suggested referent power-law distribution and visualizing the distribution and its parameters on reverse cumulatives plot when calling plotReverseCumulatives() function 14/06/2013 allowed assigning user-specified colors to samples to be used in visualizations - added new setColors() function 13/06/2013 allowed plotting scatter plots and correlation for both individual TSSs (raw or normalized values) and consensus clusters - added new argument to plotCorrelation() function Updated to version 1.2.3. in the release and 1.3.3 in the development (12/06/2013) 12/06/2013 implemented plotting pairwise scatter plots of CAGE tag count and calculating correlation between samples - added new plotCorrelation() function Updated to version 1.2.2. in the release and 1.3.2 in the development (30/05/2013) 30/05/2013 implemented the algorithm for correcting 'G' nucleotide addition bias to CAGE tags described in Carninci et al., Nature Genetics 2006 - added a new option 'correctSystematicG' to getCTSS function Updated to version 1.2.1 in the release and 1.3.1 in the development (28/05/2013) 28/05/2013 fixed the bug in reporting number of CTSSs in cluster when clustering CTSSs using custom clusters (for empty clusters it was returning that the number of CTSSs is 1, although the signal is 0) 28/05/2013 fixed the bug in clustering CTSSs using custom clusters when run with multicore=FALSE (it was returning to many clusters - correct specified region but all of the regions on each chromosome, not only the specified one) 22/05/2013 fixed the column classes in CTSS data.frame when reading the data from bam files (to match the classes when reading from ctss files) 21/05/2013 updated the vignette with explanation on how to use custom build genomes 21/05/2013 allowed usage of custom build BSgenome packages by removing the check whether the specified genome is present in the available.genomes() from BSgenome package Updated to version 1.2.0 in the release and 1.3.0 in the development (02/05/2013) 02/05/2013 updated the vignette 02/05/2013 added a new feature in the plotReverseCumulatives function, so that the slope of the fitted power-law distribution in the user selected range of values is shown on the plot for each sample (helps to choose appropriate alpha parameter for normalization) 02/05/2013 fixed a bug in selecting the range of tag count values for fitting power-law distribution in normalization 01/05/2013 added sample labels as names to library sizes vector 29/04/2013 implemented statistical testing (Kolmogorov-Smirnov test) for differential promoter usage based on cumulative sums of CAGE signal along the promoters (implemented within the scoreShift function) 20/04/2013 added pass-through option "none" for 'method' parameter in normalizeTagCount function to enable using raw tag counts in downstream steps (CTSS clustering, promoter width, etc.) 19/04/2013 optimized scoreShift function to extract and process only the cumulative sums for samples being compared 19/04/2013 replaced lapply with a for loop in the scoreShift function to avoid invoking multicore within lapply 18/04/2013 fixed wrong error message in plotExpressionProfiles function that notifies about accepted values for 'what' parameter 27/03/2013 added data.table to the list of dependencies and optimized various parts of the code to use data.table instead of data.frame