cellxgene_census.download_source_h5ad
- cellxgene_census.download_source_h5ad(dataset_id: str, to_path: str, *, census_version: str = 'stable', progress_bar: bool = True) None
Download the source H5AD dataset, for the given dataset_id, to the user-specified file name.
- Parameters:
dataset_id – Fetch the source (original) H5AD associated with this
dataset_id
.to_path – The file name where the downloaded H5AD will be written. Must not already exist.
census_version – The census version name. Defaults to
"stable"
.progress_bar – Whether to display a progress bar. Defaults to
True
.
- Raises:
ValueError – if the path already exists (i.e., will not overwrite an existing file), or is not a file.
Lifecycle
maturing
See also
get_source_h5ad_uri()
: Look up the location of the source H5AD.Examples
>>> download_source_h5ad("8e47ed12-c658-4252-b126-381df8d52a3d", to_path="/tmp/data.h5ad")