tiledbsoma.io.update_var

tiledbsoma.io.update_var(exp: Experiment, new_data: DataFrame, measurement_name: str, *, context: SOMATileDBContext | None = None, platform_config: Dict[str, Mapping[str, Any]] | object | None = None, default_index_name: str = 'var_id') None

Replace the entire var DataFrame with the contents of a new pandas.DataFrame.

Analogous to update_obs, but replaces the var DataFrame within a specific Measurement. See update_obs() for details.

Parameters:
  • expExperiment opened for write.

  • new_data – A pandas.DataFrame containing the final desired data for the Measurement’s var.

  • measurement_name – Key in exp.ms identifying the Measurement whose var will be replaced.

  • context – Optional SOMATileDBContext containing storage parameters, etc.

  • platform_config – Platform-specific options used to update this array, provided in the form {"tiledb": {"create": {"dataframe_dim_zstd_level": 7}}}.

  • default_index_name – Name to assign the index column if it is unnamed or is named "index" in the new_data class:pandas.DataFrame.

See also

Lifecycle

Maturing.