anndata - Annotated Data

AnnData provides a scalable way of keeping track of data and learned annotations.

• See Scanpy’s documentation for usage related to single cell data.

• Discuss development on GitHub.

• Install via pip install anndata or conda install anndata -c bioconda.

• anndata was initially built for Scanpy (Genome Biology, 2018).

News

COVID-19 datasets distributed as h5ad 2020-04-01

In a joint initiative, the Wellcome Sanger Institute, the Human Cell Atlas, and the CZI distribute datasets related to COVID-19 via anndata’s h5ad files: covid19cellatlas.org. It wasn’t anticipated that the initial idea of sharing and backing an on-disk representation of AnnData would become so widely adopted. Curious? Read up more on the format.

Latest additions

On master

Functionality

• Added ipython tab completion and a useful return from .keys to adata.uns PR 415 I Virshup

0.7.4 2020-07-10

Concatenation overhaul PR 378 I Virshup

• New function anndata.concat() for concatenating AnnData objects along either observations or variables

• New documentation section: Concatenation

Functionality

• AnnData object created from dataframes with sparse values will have sparse .X PR 395 I Virshup

Bug fixes

• Fixed error from AnnData.concatenate by bumping minimum versions of numpy and pandas issue 385

• Fixed colors being incorrectly changed when AnnData object was subset PR 388

0.7.3 2020-05-20

Bug fixes

• Fixed bug where graphs used too much memory when copying PR 381 I Virshup

0.7.2 2020-05-15

Concatenation overhaul I Virshup

• Elements of uns can now be merged, see PR 350

• Outer joins now work for layers and obsm, see PR 352

• Fill value for outer joins can now be specified

• Expect improvments in performance, see issue 303

Functionality

• obsp and varp can now be transposed PR 370 A Wolf

• obs_names_make_unique() is now better at making values unique, and will warn if ambiguities arise PR 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). PR 337 I Virshup

• ImplicitModificationWarning is now exported PR 315 P Angerer

• Better support for ndarray subclasses stored in AnnData objects PR 335 michalk8

Bug fixes

• Fixed inplace modification of Index objects by the make unique function PR 348 I Virshup

• Passing ambiguous keys to obs_vector() and var_vector() now throws errors PR 340 I Virshup

• Fix instantiating AnnData objects from DataFrame PR 316 P Angerer

• Fixed indexing into AnnData objects with arrays like adata[adata[:, gene].X > 0] PR 332 I Virshup

• Fixed type of version PR 315 P Angerer

• Fixed deprecated import from pandas PR 319 P Angerer