New embeddings API
Census embeddings can now accessed using a new, simplified API. Check the notebooks for [collaboration](https://github.com/chanzuckerberg/cellxgene-census/blob/main/api/python/notebooks/api_demo/census_access_maintained_embeddings.ipynb) and [hosted](https://github.com/chanzuckerberg/cellxgene-census/blob/main/api/python/notebooks/api_demo/census_embedding.ipynb) models for more information.
obs columns are now categorical instead of strings
Starting from the `2024-04-01` Census build, a subset of the columns in the `obs` dataframe are now categorical instead of strings.
For **Python users**, note that Pandas will encode these columns as `pandas.Categorical` for which some downstream operations may need to be adapted. See [this link](https://pandas.pydata.org/docs/user_guide/categorical.html#operations) for more details. In particular:
> Series methods like Series.value_counts() will use all categories, even if some categories are not present in the data
and
> DataFrame methods like sum, groupby, pivot, value_counts also show “unused” categories when observed=False, which is the default.
For **R users**, note that these columns will be encoded as `factor` and similarly downstream operations may need to be adapted. See [this link](https://r4ds.had.co.nz/factors.html) for more details.
For **Python and R users** interfacing with `arrow`, these columns will be encoded as `dictionary`, see more details for R in [this link](https://arrow.apache.org/docs/r/reference/dictionary.html) and Python in [this link](https://arrow.apache.org/docs/python/generated/pyarrow.dictionary.html).
Additions
* [builder] enable Arrow Dictionary feature flag by bkmartinjr in https://github.com/chanzuckerberg/cellxgene-census/pull/1064
* [python] New embeddings API by ebezzi in https://github.com/chanzuckerberg/cellxgene-census/pull/1023
* [docs] New embeddings API notebooks by ebezzi in https://github.com/chanzuckerberg/cellxgene-census/pull/1070
**Full Changelog**: https://github.com/chanzuckerberg/cellxgene-census/compare/v1.12.0...v1.13.0