scirpy.tl.clonal_expansion

scirpy.tl.clonal_expansion#

scirpy.tl.clonal_expansion(adata, *, target_col='clone_id', expanded_in=None, breakpoints=(1, 2), clip_at=None, key_added='clonal_expansion', inplace=True, **kwargs)#

Adds a column to obs recording which clonotypes are expanded.

nan`s in the clonotype column remain `nan in the output.

Parameters:
  • adata (Union[AnnData, MuData, DataHandler]) – AnnData or MuData object that contains AIRR information.

  • target_col (str (default: 'clone_id')) – Column containing the clontype annoataion

  • expanded_in (Optional[str] (default: None)) – Calculate clonal expansion within groups. Usually makes sense to set this to the column containing sample annotation. If set to None, a clonotype counts as expanded if there’s any cell of the same clonotype across the entire dataset.

  • breakpoints (Sequence[int] (default: (1, 2))) –

    summarize clonotypes with a size smaller or equal than the specified numbers into groups. For instance, if this is (1, 2, 5), there will be four categories:

    • all clonotypes with a size of 1 (singletons)

    • all clonotypes with a size of 2

    • all clonotypes with a size between 3 and 5 (inclusive)

    • all clonotypes with a size > 5

  • clip_at (Optional[int] (default: None)) – This argument is superseded by breakpoints and is only kept for backwards-compatibility. Specifying a value of clip_at = N equals to specifying breakpoints = (1, 2, 3, ..., N) Specifying both clip_at overrides breakpoints.

  • key_added (str (default: 'clonal_expansion')) – Key under which the result will be stored in obs, if inplace is True. When the function is running on MuData, the result will be written to both mdata.obs["{airr_mod}:{key_added}"] and mdata.mod[airr_mod].obs[key_added].

  • inplace (bool (default: True)) – If True, a column with the result will be stored in obs. Otherwise the result will be returned.

  • airr_mod – Name of the modality with AIRR information is stored in the MuData object. if an AnnData object is passed to the function, this parameter is ignored.

Return type:

None | Series

Returns:

Depending on the value of inplace, adds a column to adata or returns a Series with the clipped count per cell.