NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #3231 most downloaded on PyPI
Annotated data.
Latest stable
0.13.4
Last release 2 months ago
18 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Most releases are documented
notes for 51 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
125 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
- Passing positional arguments to anndata.io.read_loom() besides the path is now deprecated #538 I Virshup
Added anndata.AnnData.to_memory() for returning an in memory object from a backed one #470 #542 V Bergen I Virshup
anndata.AnnData.write_loom() now writes obs_names and var_names using the Index ’s .name attribute, if set #538 I Virshup
Fixed bug where np.str_ column names errored at write time #457 I Virshup
Fixed “value.index does not match parent’s axis 0/1 names” error triggered when a data frame is stored in obsm/varm after obs_names/var_names is updated #461 G Eraslan
Fixed adata.write_csvs when adata is a view #462 I Virshup
Fixed null values being converted to strings when strings are converted to categorical #529 I Virshup
Fixed handling of compression key word arguments #536 I Virshup
Fixed copying a backed AnnData from changing which file the original object points at #533 ilia-kats
Fixed a bug where calling AnnData.concatenate an AnnData with no variables would error #537 I Virshup
Passing positional arguments to anndata.io.read_loom() besides the path is now deprecated #538 I Virshup
anndata.io.read_loom() arguments obsm_names and varm_names are now deprecated in favour of obsm_mapping and varm_mapping #538 I Virshup
(v0.7.6)=
11 April, 2021anndata.AnnData.to_memory for returning an in memory object from a backed one {pr}470 {pr}542 {smaller}V Bergen {smaller}I Virshupanndata.AnnData.write_loom now writes obs_names and var_names using the Index's .name attribute, if set {pr}538 {smaller}I Virshupnp.str_ column names errored at write time {pr}457 {smaller}I Virshup461 {smaller}G Eraslanadata.write_csvs when adata is a view {pr}462 {smaller}I Virshup529 {smaller}I Virshup536 {smaller}I VirshupAnnData from changing which file the original object points at {pr}533 {smaller}ilia-katsAnnData.concatenate an AnnData with no variables would error {pr}537 {smaller}I Virshupanndata.io.read_loom besides the path is now deprecated {pr}538 {smaller}I Virshupanndata.io.read_loom arguments obsm_names and varm_names are now deprecated in favour of obsm_mapping and varm_mapping {pr}538 {smaller}I VirshupYour coding agent can read these notes before it upgrades. Set up the MCP server →
- Added ipython tab completion and a useful return from .keys to adata.uns #415 I Virshup
Added ipython tab completion and a useful return from .keys to adata.uns #415 I Virshup
Compatibility with h5py>=3 strings #444 I Virshup
Allow adata.raw = None , as is documented #447 I Virshup
Fix warnings from pandas 1.1 #425 I Virshup
(v0.7.5)=
12 November, 2020.keys to adata.uns {pr}415 {smaller}I Virshuph5py>=3 strings {pr}444 {smaller}I Virshupadata.raw = None, as is documented {pr}447 {smaller}I Virshup425 {smaller}I Virshup- New function anndata.concat() for concatenating AnnData objects along either observations or variables
New function anndata.concat() for concatenating AnnData objects along either observations or variables
New documentation section: Concatenation
AnnData object created from dataframes with sparse values will have sparse .X #395 I Virshup
Fixed error from AnnData.concatenate by bumping minimum versions of numpy and pandas #385
Fixed colors being incorrectly changed when AnnData object was subset #388
(v0.7.4)=
10 July, 2020378 {smaller}I Virshupanndata.concat for concatenating AnnData objects along either observations or variables/tutorials/concatenation.X {pr}395 {smaller}I VirshupAnnData.concatenate by bumping minimum versions of numpy and pandas {issue}385AnnData object was subset {pr}388- Fixed bug where graphs used too much memory when copying #381 I Virshup
Fixed bug where graphs used too much memory when copying #381 I Virshup
(v0.7.3)=
20 May, 2020381 {smaller}I Virshup- obsp is now preferred for storing pairwise relationships between observations. In practice, this means there will be deprecation warnings and reform…
Elements of uns can now be merged, see #350
Outer joins now work for layers and obsm , see #352
Fill value for outer joins can now be specified
Expect improvements in performance, see #303
obsp and varp can now be transposed #370 A Wolf
obs_names_make_unique() is now better at making values unique, and will warn if ambiguities arise #345 M Weiden
obsp is now preferred for storing pairwise relationships between observations. In practice, this means there will be deprecation warnings and reformatting applied to objects which stored connectivities under uns["neighbors"] . Square matrices in uns will no longer be sliced (use .{obs,var}p instead). #337 I Virshup
ImplicitModificationWarning is now exported #315 P Angerer
Better support for ndarray subclasses stored in AnnData objects #335 michalk8
Fixed inplace modification of Index objects by the make unique function #348 I Virshup
Passing ambiguous keys to AnnData.obs_vector and AnnData.var_vector now throws errors #340 I Virshup
Fix instantiating AnnData objects from DataFrame #316 P Angerer
Fixed indexing into AnnData objects with arrays like adata[adata[:, gene].X > 0] #332 I Virshup
Fixed type of version #315 P Angerer
Fixed deprecated import from pandas #319 P Angerer
(v0.7.2)=
15 May, 2020I Virshupuns can now be merged, see {pr}350layers and obsm, see {pr}352303~anndata.AnnData.obsp and {attr}~anndata.AnnData.varp can now be transposed {pr}370 {smaller}A Wolf~anndata.AnnData.obs_names_make_unique is now better at making values unique, and will warn if ambiguities arise {pr}345 {smaller}M Weiden~anndata.AnnData.obsp is now preferred for storing pairwise relationships between observations. In practice, this means there will be deprecation warnings and reformatting applied to objects which stored connectivities under uns["neighbors"]. Square matrices in {attr}~anndata.AnnData.uns will no longer be sliced (use .{obs,var}p instead). {pr}337 {smaller}I Virshup~anndata.ImplicitModificationWarning is now exported {pr}315 {smaller}P Angerer~numpy.ndarray subclasses stored in AnnData objects {pr}335 {smaller}michalk8~pandas.Index objects by the make unique function {pr}348 {smaller}I VirshupAnnData.obs_vector and AnnData.var_vector now throws errors {pr}340 {smaller}I Virshup~anndata.AnnData objects from {class}~pandas.DataFrame {pr}316 {smaller}P AngererAnnData objects with arrays like adata[adata[:, gene].X > 0] {pr}332 {smaller}I Virshup315 {smaller}P Angererpandas {pr}319 {smaller}P AngererNothing published for this version
Nothing published for this version
Breaking changes introduced between 0.6.22.post1 and 0.7 :
Warning
Breaking changes introduced between 0.6.22.post1 and 0.7 :
Elements of AnnData s don’t have their dimensionality reduced when the main object is subset. This is to maintain consistency when subsetting. See discussion in #145 .
Internal modules like anndata.core are private and their contents are not stable: See #174 .
The old deprecated attributes .smp* . .add and .data have been removed.
Indexing into a view no longer keeps a reference to intermediate view, see #62 .
Views are now lazy. Elements of view of AnnData are not indexed until they’re accessed.
Indexing with scalars no longer reduces dimensionality of contained arrays, see #145 .
All elements of AnnData should now follow the same rules about how they’re subset, see #145 .
Can now index by observations and variables at the same time.
Reading and writing has been overhauled for simplification and speed.
Time and memory usage can be half of previous in typical use cases
Zarr backend now supports sparse arrays, and generally is closer to having the same features as HDF5.
Backed mode should see significant speed and memory improvements for access along compressed dimensions and IO. PR #241 .
Categorical s can now be ordered (PR #230 ) and written to disk with a large number of categories (PR #217 ).
New attributes obsp and varp have been added for two dimensional arrays where each axis corresponds to a single axis of the AnnData object. PR #207 .
These are intended to store values like cell-by-cell graphs, which are currently stored in uns .
Sparse arrays are now allowed as values in all mapping attributes.
DataFrames are now allowed as values in obsm and varm .
All mapping attributes now share an implementation and will have the same behaviour. PR #164 .
Mapping attributes now have ipython tab completion (e.g. adata.obsm["\t can provide suggestions) PR #183 .
AnnData attributes are now delete-able (e.g. del adata.raw ) PR #242 .
Many many bug fixes
(v0.7.0)=
22 January, 2020Breaking changes introduced between `0.6.22.post1` and `0.7`:
- Elements of {class}`~anndata.AnnData`s don’t have their dimensionality reduced when the main object is subset.
This is to maintain consistency when subsetting. See discussion in {issue}`145`.
- Internal modules like `anndata.core` are private and their contents are not stable: See {issue}`174`.
- The old deprecated attributes `.smp*`. `.add` and `.data` have been removed.
16462.145.145.167241.~pandas.Categoricals can now be ordered (PR {pr}230) and written to disk with a large number of categories (PR {pr}217).(obsm, varm, layers, ...)~anndata.AnnData.obsp and {attr}~anndata.AnnData.varp have been added for two dimensional arrays where each axis corresponds to a single axis of the AnnData object. PR {pr}207.~anndata.AnnData.uns.~anndata.AnnData.obsm and {attr}~anndata.AnnData.varm.164.adata.obsm["\\t can provide suggestions) PR {pr}183.~anndata.AnnData attributes are now delete-able (e.g. del adata.raw) PR {pr}242.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- compatibility with Seurat converter
compatibility with Seurat converter
tremendous speedup for ~anndata.AnnData.concatenate
bug fix for deep copy of unstructured annotation after slicing
bug fix for reading HDF5 stored single-category annotations
'outer join' concatenation: adds zeros for concatenation of sparse data and nans for dense data
better memory efficiency in loom exports
(v0.6.0)=
1 May, 2018~anndata.AnnData.concatenate'outer join' concatenation: adds zeros for concatenation of sparse data and nans for dense dataNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- inform about duplicates in var_names and resolve them using var_names_make_unique()
inform about duplicates in var_names and resolve them using var_names_make_unique()
automatically remove unused categories after slicing
read/write .loom files using loompy 2
fixed read/write for a few text file formats
read UMI tools files: read_umi_tools()
(v0.5.0)=
9 February, 2018~anndata.AnnData.var_names and resolve them using {func}~anndata.AnnData.var_names_make_unique~anndata.io.read_umi_toolsNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
- scalability beyond dataset sizes that fit into memory: see this blog post
read/write .loom files
scalability beyond dataset sizes that fit into memory: see this blog post
AnnData has a raw attribute, which simplifies storing the data matrix when you consider it raw : see the clustering tutorial
Contents
(v0.4.0)=
23 December, 2017~anndata.AnnData has a {class}~anndata.AnnData.raw attribute, which simplifies storing the data matrix when you consider it raw: see the clustering tutorialNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.