calour.experiment.Experiment.join_experiments¶

Experiment.join_experiments(other, field_name='experiments', prefixes=None)[source]¶

Combine two Experiment objects into one.

A new column will be added to the combined Experiment.sample_metadata to store which of the 2 combined objects it is from.

Parameters:	other (Experiment) – The Experiment object to combine with the current one. If both experiments contain the same feature metadata column and there is a conflict between the two, the value will be taken from exp and not from other. field_name (None or str, optional) – Name of the new sample_metdata field containing the experiment each sample is coming from. If it is None, don’t add such column. prefixes (tuple of (str, str), optional) – Prefix to append to the sample_metadata index for identical samples in the 2 experiments. Required only if the two experiments share any identical sample ID
Returns:	A new experiment with samples from both experiments concatenated, features from both experiments merged.
Return type:	Experiment