phenotypic.sdk_.replace_image_tables#
- phenotypic.sdk_.replace_image_tables(store_path: Path, tables: PreparedImageTables, *, figures: StoredFigures | None = None, objmap_target: str | None = None, durable: bool | None = None, commit_guard: CommitGuard | None = None) Path[source]#
Refresh one store’s measurement AND metadata tables together.
The
--mode measureanalogue of the promote-time writer: both tables and the root’smetadata_tableblock move as one root-last transaction, so the store never certifies a table it does not have or a snapshot it was not built against. When figures is given, its run folder is written in the same transaction.- Parameters:
store_path (Path) – A promoted
*.ome.zarrstore.tables (PreparedImageTables) – The split payload to write.
figures (StoredFigures | None) – One run’s per-image figures. They replace that run’s folder and descriptor entry only; every other run is carried across unchanged (spec 2026-09-22 §1a).
Noneadds no run and touches no figure, and so does a store whose figures descriptor has aschema_versionthis writer does not know.objmap_target (str | None) – Store-relative path of the label image the measurement table indexes.
Nonereads it from the store.durable (bool | None) –
fsyncbefore promoting.Noneauto-detects SLURM.commit_guard (CommitGuard | None) – Publication guard, checked at the commit point.
- Returns:
The store path.
- Raises:
ValueError – If the store declares no objmap target.
- Return type:
Path