Changes in version 2.8.0 o Added the test.genes= argument to trainSingleR(), to restrict marker detection to only those genes in the test dataset. This is also checked against rownames(test) in classifySingleR() to ensure that the test's feature space is consistent with the space used during training. o The introduction of test.genes= means that we no longer need to explicitly subset the rows of the reference dataset (to match the test features) in SingleR(). This saves memory by avoiding an unnecessary copy of the reference dataset, but may also slightly alter the marker selection as ties are broken in a different way. Namely, if the top X genes are used as markers, and the X-th and (X+1)-th gene have the same log-fold change, tie breaking will be based on the ordering of the rows in the reference matrix - which is no longer the same as in the previous version of SingleR. This results in some slight differences in the markers that propagate down to the classification results. o Restored the BNPARAM= argument in trainSingleR(), to enable more fine-grained specification of neighbor search algorithms. The approximate= argument is deprecated. o Soft-deprecated check.missing= in classifySingleR() and combineRecomputedResults(). This is because any filtering will cause a mismatch between the row names of tests and the test.genes in trained. Rather, filtering should be done prior to trainSingleR(), as is done in the main SingleR() function. o combineRecomputedResults() now supports fine-tuning to resolve closely-related labels from different references. This is similar to the fine-tuning in classifySingleR() where the feature space is iterately redefined as the union of markers of labels with near-highest scores. o Added the plotMarkerHeatmap() function to plot a diagnostic heatmap of the most interesting markers for each label. Changes in version 2.0.0 o The format of the output of trainSingleR() has changed and is no longer back-compatible. o recompute=FALSE in trainSingleR() does nothing; all integrated analyses are now done with recompute=TRUE. To that end, combineCommonResults() is also deprecated. o genes = "sd" and its associated options in trainSingleR() are no longer supported. o first.labels is no longer reported in classifySingleR(). o Added another parallelization mechanism via num.threads= and C++11 threads. This should be much more memory efficient than using BiocParallel. o combineRecomputedScores() will automatically handle mismatches in the input references by default. Changes in version 1.6.0 o Relaxed the requirements for consistent row names in combineRecomputedResults(). o Support sparse DelayedArray inputs in classifySingleR(). o Parallelize over labels instead of rows in aggregateReference(), with minor changes in the setting of the seed. Restrict the PCA to the top 1000 most highly variable genes, for speed. Changes in version 1.4.0 o Migrated all of the dataset getter functions to the celldex package. o Streamlined the vignette to point to the book at . o Added a restrict= argument to trainSingleR() and SingleR() to easily restrict to a subset of features. o Deprecated the method= argument in SingleR(). o Protect against accidental data.frames in ref= or test= in all functions. Changes in version 1.2.0 o Added support for consolidating labels from multiple references via combineResults(). o Added mappings to standardized Cell Ontology terms in all *Data() functions. o Changed the name of the labels input of plotScoreDistribution() to labels.use for consistency across functions. o Fixed a label from adipocytes to astrocytes in BlueprintEncodeData(). o Removed umlauts from labels (e.g., naive) in NovershternHematopoieticData() to avoid problems with Windows. o Perform PCA before clustering in aggregateReference() for speed and memory efficiency. o Modified genes="all" behavior in trainSingleR() to report DE-based markers for fine-tuning only. Changes in version 1.0.0 o New package SingleR for cell type annotation.