Skip to contents

anndataR 1.3.5

  • Add a group argument to read_h5ad(), write_h5ad(), as_HDF5AnnData() and HDF5AnnData, to read and write an AnnData stored in a group inside an HDF5 file, e.g. a modality inside a .h5mu file (PR #521, issue #466).
  • Fix as_AnnData() failing with `rownames(X)` is not as expected when the assay of a SingleCellExperiment mapped to X has different dimnames than the object (PR #576, issue #390).
  • Fix as_AnnData() dropping the loadings of a Seurat reduction when their row names already match the feature names of the object (PR #592).
  • Ensure Zarr v2 string arrays don’t get the vlen-utf8 filter twice, since an upcoming version of Rarr might already specify this (PR #557, Huber-group-EMBL/Rarr#111).
  • Fix as_Seurat() failing with No feature overlap between existing object and new layer data when var_names contain underscores: the underscores are now replaced with dashes in the feature names of the Seurat object, with a warning (PR #593, issue #476).
  • Require rhdf5 >= 2.57.13, which fixes the spurious NA_character_ warning for numeric datasets containing NA, and remove the skips in the file closure tests (PR #579, Huber-group-EMBL/rhdf5#241).
  • Error when writing a logical matrix containing NA to H5AD or Zarr, instead of writing a nullable-boolean that neither R nor Python anndata can read back. Convert it to numeric first (issue #545).
  • Require Rarr >= 2.1.59, which fixes reading and writing Zarr stores on R 4.6.2: every zstd-compressed array failed there with argument is of length zero (PR #591, Huber-group-EMBL/Rarr#298).
  • Write a length 1 NA_character_ as a nullable-string-array to Zarr and H5AD, so that it stays missing: Zarr stored it as the string "NA", and Python anndata read it from H5AD as an empty string (PR #585, issue #581).
  • Regenerate the man pages, which still showed the old default compression of write_zarr() and missed a contributor (PR #594).
  • Fix writing empty arrays to Zarr v3, which produced stores that Python anndata couldn’t read: empty dimensions now get a chunk size of 1, as zarr-python does (PR #587, Huber-group-EMBL/Rarr#294).
  • Add backed = TRUE to read_zarr() and as_ZarrAnnData() to read matrices as ZarrArray-backed DelayedArrays (PR #507).
  • Add https://bioc.r-universe.dev as a repository in the workflows that check against Bioconductor devel, so that new versions of dependencies can be installed before they reach the Bioconductor repositories (PR #595).
  • Add Umami analytics to the {pkgdown} site (PR #590).

anndataR 1.3.4

  • Replace the internal create_zarr() and create_zarr_group() helpers with Rarr::write_zarr_group() and require Rarr >= 2.1.27 (PR #490).
  • Use zstd by default in write_zarr() (PR #540).
  • Write length 1 data.frame columns and indices as arrays instead of scalars (PR #556, issue #553).
  • Fix writing integer matrices containing NA to Zarr, which produced stores that couldn’t be read back: as for H5AD, they are now written as double (PR #546, issue #542).
  • Keep NA in double and integer matrices written to H5AD instead of replacing it with NaN, so that NA and NaN can still be told apart when reading the file back in R. Python anndata reads both as NaN (PR #546).
  • Fix the error and warning messages when reading or writing an element fails: the original error is now shown as the cause, instead of being parsed as a cli expression, which failed with Could not parse cli `{}` expression (PR #547, issue #531).
  • Check that the indices of sparse matrices fit their shape when reading H5AD files and Zarr stores, with an error that suggests the indices may not be 0-based (PR #547, issue #531).
  • Fix writing non-ASCII strings to H5AD files by using UTF-8 for string datasets (PR #555, issue #400).
  • Re-enable testing against Python anndata >= 0.13, and remove the warning that ReticulateAnnData gave for these versions (PR #569, issue #514).
  • Skip the Python-written Zarr v2 roundtrip tests when the installed Python anndata can no longer write Zarr v2, as anndata main does (PR #568, issue #514).
  • Skip the None key that Python anndata >= 0.13 uses for X when reading layers through ReticulateAnnData and py_to_r(), and keep X when setting layers (PR #563, issue #514).
  • Ignore the None (.X) entry that Python anndata >= 0.13.2 lists under layers: when comparing printed objects in the roundtrip tests (PR #564, issue #514).
  • Drop 3D layers from the layers roundtrip tests, because Python anndata >= 0.13 refuses to write them (PR #571, issue #514).
  • Require Rarr >= 2.1.45 to read the sharded Zarr v3 stores that Python anndata >= 0.13 writes by default, because older versions can return wrong values for sharded arrays (PR #572, issue #514).

anndataR 1.3.3

  • Add a strict mode for the Python tests: with ANNDATAR_TEST_REQUIRE_PYTHON=true, the Python skip helpers error with the actual import error instead of skipping, so that a broken Python environment can’t silently skip all Python tests. Used by scverse/integration-testing to test against anndata main (PR #533, issue #515).
  • Fix writing data.frames in obsm/varm so that the stored index is the obs_names/var_names of the parent object instead of R’s automatic row numbers, which produced files that Python anndata refused to read (PR #501, PR #525).

anndataR 1.3.2

  • Support the anndata.AnnData class name used by Python anndata >= 0.13 in py_to_r() and ReticulateAnnData, and warn that anndata >= 0.13 is not fully supported yet (PR #510, issue #499).
  • Add support for nullable-string-array elements in H5AD and Zarr (PR #480).
  • Fix hdf5_write_boolean_dataset() writing logical matrices as flat 1D datasets instead of preserving their shape (PR #496).
  • Remove the workaround for LZF compression of VLen strings and require rhdf5 >= 2.57.5, which fixes the issue upstream (PR #497).
  • Pin Python mudata to < 0.4 in the usage_python vignette, as mudata 0.4 can no longer read the legacy example .h5mu file (PR #512, issue #511).
  • Pin Python mudata to < 0.4 in the pkgdown and macOS-Intel check workflows as well, because py_require() pins in the vignette are ignored when RETICULATE_PYTHON is forced (PR #518, issue #511).
  • Remove the as.na attribute that rhdf5 2.57.12 adds to datasets containing NA when comparing R-written files to Python-written ones in the roundtrip tests (PR #519, issue #517).
  • Skip the H5AD file-closure tests while rhdf5 2.57.12 emits a spurious NA_character_ warning for numeric datasets containing NA, tracked as a known issue until the fix from Huber-group-EMBL/rhdf5#242 reaches Bioconductor devel (PR #520).
  • Remove the special handling of Zarr v3 structured datatypes in the tests, now that Rarr supports them (PR #498).
  • Check RELEASE_* branches against Bioconductor release and devel against Bioconductor devel, instead of checking devel against both (PR #502).
  • Run BiocCheck on RELEASE_* branches as well as on devel (PR #504).

anndataR 1.3.1

  • Add support for reading backed objects using DelayedArray matrices, including a backed argument for HDF5AnnData and InMemoryAnnData, and conversion of backed AnnData objects to SingleCellExperiment/Seurat (PR #387).
  • Add support for writing Zarr v3 stores, using (i) zarr_format argument of write_zarr()/as_ZarrAnnData() or (ii) the anndataR.zarr_format option. New stores are written as Zarr v3 by default (PR #455).
  • Write strings as VLen-UTF8 rather than as fixed-width, so that string arrays read back as variable length strings in Python anndata (PR #455).
  • Use the format of an existing Zarr store when writing to it and truncate the store when mode = "w", so that a store can no longer end up with a mix of Zarr v2 and v3 nodes (PR #455).
  • Enable additional linters and optimise several suboptimal code patterns (PR #453).
  • Fix create_zarr() so that Zarr stores can be created at relative paths and at paths containing regex metacharacters (PR #478).
  • Fix use of & instead of && when validating column names in AbstractAnnData (PR #487).
  • Update tests to take into account the Rarr structured datatype breaking change (PR #462).
  • Temporarily require Python anndata < 0.13.0 in tests, workflows and the Python usage vignette (PR #481).
  • Add Zarr to the benchmarks (PR #446).
  • Add Bioconductor R-universe checks (PR #470).
  • Fix CI runners (PR #457).
  • Upgrade to roxygen2 8.0.0.
  • Simplify roxygen documentation for the H5AD and Zarr helpers by using @inheritParams (PR #479).
  • Update CITATION with the published paper (PR #464).
  • Mark Zarr support as implemented in the class diagram (PR #460).

anndataR 1.3.0

  • Bioconductor 3.24 devel

anndataR 1.2.3

Backported from the development branch (PR #538):

  • Fix writing data.frames in obsm/varm so that the stored index is the obs_names/var_names of the parent object instead of R’s automatic row numbers, which produced files that Python anndata refused to read (PR #501, PR #525).
  • Pin Python to 3.14 in the benchmark and pkgdown workflows, as h5py has no wheels for Python 3.15 yet (PR #534).

anndataR 1.2.2

Backported from the development branch (PR #503, PR #523):

  • Add support for nullable-string-array elements in H5AD and Zarr (PR #480).
  • Fix hdf5_write_boolean_dataset() writing logical matrices as flat 1D datasets instead of preserving their shape (PR #496, thanks @JuanTejedor!).
  • Check RELEASE_* branches against their own Bioconductor version instead of against Bioconductor devel, and run the checks on pushes to release branches (PR #502).
  • Support the anndata.AnnData class name used by Python anndata >= 0.13 in py_to_r() and ReticulateAnnData, and warn that anndata >= 0.13 is not fully supported yet (PR #510, issue #499).
  • Pin Python mudata to < 0.4 in the usage_python vignette and in the pkgdown and check workflows, as mudata 0.4 can no longer read the legacy example .h5mu file (PR #512, PR #518, issue #511).
  • Update the Zarr recarray tests to take into account the Rarr structured datatype breaking change, so that they pass with both Bioconductor release and devel versions of Rarr (PR #462).
  • Measure test coverage against the Bioconductor version the branch targets instead of always against devel (PR #523).
  • Drop the R-devel setup workaround for the Windows and macOS ARM check jobs, which installed R devel against Bioconductor 3.23 packages (PR #523).

anndataR 1.2.1

Backported from the development branch (PR #489):

  • Fix create_zarr() so that Zarr stores can be created at relative paths and at paths containing regex metacharacters (PR #478).
  • Fix conditional expression in AbstractAnnData matrix validation (PR #487).
  • Require Python anndata<0.13.0 in tests, workflows and vignettes (PR #481).
  • Update CITATION with the published paper (PR #464).

anndataR 1.2.0

  • Bioconductor 3.23 release

anndataR 1.1.3

  • Prepare for Bioconductor 3.23 release (PR #449).
  • Add initial Zarr support for reading and writing .zarr stores (PR #190).

anndataR 1.1.2

  • Fix broken links (PR #429).
  • Fix the software design vignette (PR #438).
  • Fix GitHub Actions MacOS/Windows setup issue (PR #447).

anndataR 1.1.1

  • Fix CI (PR #418).
  • Add continuous benchmarking using bencher (PR #423, PR #425).
  • Handle unnamed SingleCellExperiment assays in as_AnnData() by automatically assigning names with a warning (PR #420).
  • Optimise sparse matrix reading performance by avoiding Matrix::sparseMatrix and constructing objects manually (PR #417).
  • Allow manually setting chunk size for HDF5 writes (PR #424).
  • Add auto-chunking for HDF5 writes to improve performance (PR #424).

anndataR 1.1.0

  • Bioconductor 3.23 devel
  • Separate reading and writing keys in HDF5AnnData (PR #392).
  • Add a check for 0 dimensions when converting to Seurat (PR #393).
  • Warn that matrix dim names will not be written to H5AD files (PR #396).
  • Add a warning to .from_SCE_convert() (PR #402).
  • Warn when a rotation is provided but not stored in a LinearEmbeddingMatrix (PR #407).
  • Fix linting issues (PR #389).
  • Add Bioconductor badges (PR #375).
  • Update {pkgdown} rendering (PR #379).
  • Force loading the environment in the Python vignette (PR #394).
  • Add issue templates (PR #395).
  • Update GitHub Actions based on those used by {rhdf5} (PR #378).
  • Set different cache versions in GitHub Actions (PR #403).
  • Update CI (PR #416).

anndataR 1.0.2

  • Fix broken links (PR #430).

anndataR 1.0.1

  • Update author email address (PR #410).
  • Fix linting issues (PR #412).
  • Fix roundtrip test; ensure that X is always 2-dimensional (PR #413).
  • Fix HDF5 write test; make sure to only pass CsparseMatrix to Seurat (PR #413).

anndataR 1.0.0

  • Bioconductor 3.22 release (October 2025)

anndataR 0.99.6

  • Use the correct mapping figure in the SingleCellExperiment usage vignette (PR #372)
  • Fix accessing layers keys for ReticulateAnnData (PR #372)
  • Minor updates to the Python usage vignette (PR #372)
  • Add the Python vignette to the {pkgdown} index (PR #372)

anndataR 0.99.4

  • Address minor issues from Bioconductor checks (PR #371)
    • Combine the opts_chunks$set() calls in the Python usage vignette
    • Replace \donttrun with \donttest in man pages

anndataR 0.99.3

New functionality

  • Implemented an AnnDataView class, which provides a lazy view of an AnnData object without copying data (PR #324)
  • Implemented S3 methods for AbstractAnnData objects: dim, nrow, ncol, dimnames, rownames, colnames, and [ (PR #324)
  • Add ReticulateAnnData class for seamless Python integration via {reticulate} (PR #322)
  • Add AGENTS.md with instructions for developers (PR #367).

Major changes

  • Refactor obs/var_names handling for improved data consistency (PR #328)
    • InMemoryAnnData now stores obs_names and var_names as separate private fields instead of relying on rownames of obs/var data.frames
    • HDF5AnnData maintains separate obs/var names management to ensure consistency between obs/var data.frames and dimnames
    • All matrix data (X, layers, obsm, varm, obsp, varp) is now stored internally without dimnames for consistency
    • Dimnames are added on-the-fly when users access data, ensuring proper obs/var name display

Minor changes

Bug fixes

  • Add compression parameter to additional write operations in HDF5AnnData for consistency (PR #328)
  • Directly use obs_names and var_names properties instead of corresponding indirect S3 methods rownames and colnames (PR #328)
  • Fix error message variable name in .validate_aligned_array() method (expected_colnames → expected_rownames) (PR #328)
  • Fix Seurat conversion for PCA loadings with variable feature subsets (PR #328)
    • Seurat PCA loadings only contain variable features, not all genes
    • Now properly expands loadings matrix to include all genes with zeros for non-variable features
    • Adds warning when rownames don’t match var_names during conversion
  • Avoid writing character datasets to H5AD files with LZF compression as it causes R to crash (PR #356)
  • Handle slots that may have incomplete dimensions when converting from Seurat. These are now skipped with a warning instead of indirectly raising an error. (PR #369)

Documentation

  • citation("anndataR") now returns details of the {anndataR} preprint (PR #351)
  • Update vignettes to clarify and expand text and improve formatting (PR #360)

anndataR 0.99.2

  • Add @return to R6 object man pages to address {BiocCheck} warning (PR #319)

anndataR 0.99.1

  • Resubmit because of failing Bioc checks (PR #318)

anndataR 0.99.0

  • Bump required R version to 4.5 in preparation for Bioconductor submission (PR #309)
  • Remove deprecated functions and arguments (PR #311, PR #313)
  • Minor clean-ups and improvements (PR #313).
  • Add more tests to increase coverage (PR #315)

anndataR 0.2.0

Breaking changes

  • Switch the HDF5 back end to use the {rhdf5} package instead of {hdf5r} (PR #283, Fixes #272, #175, #299)
    • This addresses various issues related to H5AD files and allows better integration with Bioconductor. Most of the previous known issues have now been resolved.
    • It also greatly improves compatibility with H5AD files written by Python anndata
    • NOTE: Make sure to install {rhdf5} instead of {hdf5r} to be able to read and write H5AD files!

Major changes

  • Updates for compatibility with Python anndata >= 0.12.0 (PR #305, Fixes #304)
    • Add helpers for reading/writing NULL values to/from H5AD files
    • Writing of NULL values can be disabled by setting option(anndataR.write_null = FALSE) to allow the files to be read by Python anndata < 0.12.0
  • A counts or data layer is no longer required during Seurat conversion (PR #284)
    • There will still be a warning if neither of this is present as it may affect compatibility with {Seurat} functions

Minor changes

  • Use accessor functions/methods instead of direct slot access where possible (PR #291)
  • Refactor superfluous for loops (PR #298)
  • Change uses of sapply() to vapply() (PR #294)
  • Ignore development_status.Rmd vignette when building package (PR #296)
  • Remove anndataR.Rproj file from repository (PR #292)

Bug fixes

  • Fix a bug where string arrays were not transposed correctly when writing to H5AD files (PR #305)
  • Fix a bug where the dimensions of dense arrays were not properly conserved when reading from H5AD (PR #305)

Documentation

  • Simplify and update vignettes (PR #282)
  • Add Bioconductor installation instructions in preparation for submission (PR #297)

Testing

  • Improvements to round trip testing (PR #283, PR #293, PR #305)
    • Most round trip tests are now enabled and pass successfully
    • Conversion helpers have been added to assist with {reticulate} tests

anndataR 0.1.0 (initial release candidate)

Initial release candidate of {anndataR} including:

  • Native reading and writing of H5AD files
  • R implementations of InMemoryAnnData and HDF5AnnData objects
  • Conversion between AnnData and SingleCellExperiment or Seurat objects
  • Extensive function documentation and vignettes demonstrating usage
  • Comprehensive unit testing and identification of known issues