data-io-loading

Installation
SKILL.md

OmicVerse Data I/O

OmicVerse provides its own data readers under ov.io. These replace scanpy's IO functions with better format handling, spatial geometry support, and Rust backend options. When working in an OmicVerse project, always use ov.io.* for data loading — never fall back to sc.read_* or scanpy.read_*.

Why this matters

OmicVerse's readers are not thin wrappers — they are independent implementations that handle edge cases scanpy misses:

  • 10x H5/MTX: Proper v2/v3 format detection, flexible prefix/compression options
  • Visium: Auto-resolves tissue positions (parquet > csv > legacy csv), loads images + scale factors
  • Visium HD: Cell segmentation with GeoJSON→WKT polygon conversion (not available in scanpy at all)
  • Nanostring SMI: Auto-detects column names across CosMx format variants (not in scanpy)

Migration table: scanpy → OmicVerse

Task DON'T use Use instead
Read any file sc.read(path) ov.read(path)
Read h5ad sc.read_h5ad(f) ov.read(f) or ov.io.read_h5ad(f)
Read 10x H5 sc.read_10x_h5(f) ov.io.read_10x_h5(f)
Related skills
Installs
4
GitHub Stars
985
First Seen
Mar 30, 2026