Expand description
Stream a column selection (and an optional row selection or renumbering)
of a sparse backend into a fresh backend without materialising the
survivors. Shared by the split / subsample / subset-* CLI handlers,
by the in-place subset and reorder of SparseIo, and by downstream
crates (faba’s qc) that filter a matrix by cells and features.
Structs§
- RowMap
- Where each row of the input lands in the output:
to[old]is its new index,Nonewhen the row is dropped;nrowis the output’s row count. Rows may land in any order, and an output row may be fed by no input row (it is then empty), but never by two.
Functions§
- stream_
column_ selection - Stream a column selection (with an optional row filter) into a fresh backend, without ever materialising the survivors.
- stream_
mapped_ selection - Stream the columns
selected_columnsofdata, in that order, into a fresh backend atfile_out, its rows renumbered (dropped, reordered) byrowswhen given, with the given names anddata’s metadata. Returns the output’s(rows, columns, non-zeros).