tiledbsoma.ExperimentAxisQuery

class tiledbsoma.ExperimentAxisQuery

Axis-based query against a SOMA Experiment.

ExperimentAxisQuery allows easy selection and extraction of data from a single Measurement in an Experiment, by obs/var (axis) coordinates and/or value filter.

The primary use for this class is slicing Experiment X layers by obs or var value and/or coordinates. Slicing on SparseNDArray X matrices is supported; DenseNDArray is not supported at this time.

Lifecycle: maturing

__init__()

Methods

X(layer_name, *[, batch_size, partitions, ...])	Returns an X layer as a sparse read.
__init__()
close()	Releases resources associated with this query.
obs(*[, column_names, batch_size, ...])	Returns obs as an Arrow table iterator.
obs_joinids()	Returns obs soma_joinids as an Arrow array.
obs_scene_ids()	Returns a pyarrow array with scene ids that contain obs from this query.
obsm(layer)	Returns an obsm layer as a sparse read.
obsp(layer)	Returns an obsp layer as a sparse read.
to_anndata(X_name, *[, column_names, ...])	Executes the query and return result as an AnnData in-memory object.
var(*[, column_names, batch_size, ...])	Returns var as an Arrow table iterator.
var_joinids()	Returns var soma_joinids as an Arrow array.
var_scene_ids()	Return a pyarrow array with scene ids that contain var from this query.
varm(layer)	Returns a varm layer as a sparse read.
varp(layer)	Returns a varp layer as a sparse read.

Attributes

indexer	A soma_joinid indexer for both obs and var axes.
n_obs	The number of obs axis query results.
n_vars	The number of var axis query results.