## ----options, include = FALSE-------------------------------------------------
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  warning = FALSE
)

## ----prep-file----------------------------------------------------------------
library(anndataR)
library(Seurat)

h5ad_file <- system.file("extdata", "example.h5ad", package = "anndataR")

## ----read-data----------------------------------------------------------------
seurat_obj <- read_h5ad(h5ad_file, as = "Seurat")
seurat_obj

## ----convert-seurat-----------------------------------------------------------
adata <- read_h5ad(h5ad_file)
seurat_obj <- adata$as_Seurat()
seurat_obj

## ----prep-file-zarr-----------------------------------------------------------
# Please use "example_v3.zarr.zip" for AnnData stored as Zarr version 3
zarr_path <- system.file("extdata", "example_v2.zarr.zip", package = "anndataR")
td <- tempdir(check = TRUE)
unzip(zarr_path, exdir = td)
zarr_path <- file.path(td, "example_v2.zarr")

seurat_obj_zarr <- read_zarr(zarr_path, as = "Seurat")
seurat_obj_zarr

## ----convert-seurat-zarr------------------------------------------------------
adata <- read_zarr(zarr_path)
seurat_obj_zarr <- adata$as_Seurat()
seurat_obj_zarr

## ----mapping, fig.cap = "Mapping between `AnnData` and `Seurat` objects", fig.wide = TRUE, echo = FALSE----
knitr::include_graphics("../man/figures/AnnData-Seurat.png")

## ----customize-seurat-conversion----------------------------------------------
seurat_obj <- adata$as_Seurat(
  layers_mapping = c("counts", "dense_counts"),
  object_metadata_mapping = c(metadata1 = "Int", metadata2 = "Float"),
  assay_metadata_mapping = FALSE,
  reduction_mapping = list(
    pca = c(key = "PC_", embeddings = "X_pca", loadings = "PCs"),
    umap = c(key = "UMAP_", embeddings = "X_umap")
  ),
  graph_mapping = TRUE,
  misc_mapping = c(misc1 = "Bool", misc2 = "IntScalar")
)
seurat_obj

## ----write-seurat, eval=FALSE-------------------------------------------------
# write_h5ad(seurat_obj, tempfile(fileext = ".h5ad"))
# write_zarr(seurat_obj, tempfile(fileext = ".zarr"))

## ----convert-to-anndata, eval=FALSE-------------------------------------------
# adata <- as_AnnData(seurat_obj)
# adata$write_h5ad(tempfile(fileext = ".h5ad"))
# adata$write_zarr(tempfile(fileext = ".zarr"))

## ----customize-anndata-conversion---------------------------------------------
adata <- as_AnnData(
  seurat_obj,
  assay_name = "RNA",
  x_mapping = "counts",
  layers_mapping = c("dense_counts"),
  obs_mapping = c(RNA_count = "nCount_RNA", metadata1 = "metadata1"),
  var_mapping = FALSE,
  obsm_mapping = list(X_pca = "pca", X_umap = "umap"),
  obsp_mapping = TRUE,
  uns_mapping = c("misc1", "misc2")
)
adata

## ----sessioninfo--------------------------------------------------------------
sessionInfo()