r"""
BIOSCAN-5M PyTorch Dataset.
:Date: 2024-06-05
:Authors:
- Scott C. Lowe <scott.code.lowe@gmail.com>
:Copyright: 2024, Scott C. Lowe
:License: MIT
"""
import os
from enum import Enum
from typing import Any, Callable, Iterable, List, Optional, Set, Tuple, Union
import numpy as np
import numpy.typing as npt
import pandas
import PIL
import torch
from torchvision.datasets.utils import check_integrity, download_and_extract_archive
from torchvision.datasets.vision import VisionDataset
__all__ = ["BIOSCAN5M", "load_bioscan5m_metadata"]
RGB_MEAN = torch.tensor([0.76281859, 0.76503749, 0.76373138])
RGB_STDEV = torch.tensor([0.14205404, 0.15642502, 0.17309470])
COLUMN_DTYPES = {
"processid": str,
"sampleid": str,
"taxon": "category",
"phylum": "category",
"class": "category",
"order": "category",
"family": "category",
"subfamily": "category",
"genus": "category",
"species": "category",
"dna_bin": "category",
"dna_barcode": str,
"country": "category",
"province_state": "category",
"coord-lat": float,
"coord-lon": float,
"image_measurement_value": float,
"area_fraction": float,
"scale_factor": float,
"inferred_ranks": "uint8",
"split": str,
"index_bioscan_1M_insect": "Int64",
"chunk": str,
}
USECOLS = [
"processid",
"chunk",
"phylum",
"class",
"order",
"family",
"subfamily",
"genus",
"species",
"dna_bin",
"dna_barcode",
"country",
"province_state",
"coord-lat",
"coord-lon",
"image_measurement_value",
"area_fraction",
"scale_factor",
"split",
]
VALID_SPLITS = ["pretrain", "train", "val", "test", "key_unseen", "val_unseen", "test_unseen", "other_heldout"]
SPLIT_ALIASES = {"validation": "val"}
VALID_METASPLITS = ["all", "seen", "unseen"]
SEEN_SPLITS = ["train", "val", "test"]
UNSEEN_SPLITS = ["key_unseen", "val_unseen", "test_unseen"]
def explode_metasplit(metasplit: str, verify: bool = False) -> Set[str]:
"""
Convert a metasplit string into its set of constituent splits.
.. versionadded:: 1.2.0
Parameters
----------
metasplit : str
The metasplit to explode.
verify : bool, default=False
If ``True``, verify that the constitutent splits are valid.
Returns
-------
set of str
The canonical splits within the metasplit.
Examples
--------
>>> explode_metasplit("pretrain+train")
{'pretrain', 'train'}
>>> explode_metasplit("seen")
{'train', 'val', 'test'}
>>> explode_metasplit("train")
{'train'}
>>> explode_metasplit("validation")
{'val'}
"""
if metasplit is None:
metasplit = "all"
split_list = [s.strip() for s in metasplit.split("+")]
split_list = [SPLIT_ALIASES.get(s, s) for s in split_list]
split_set = set(split_list)
if "all" in split_list:
split_set.remove("all")
split_set |= set(VALID_SPLITS)
if "seen" in split_list:
split_set.remove("seen")
split_set |= set(SEEN_SPLITS)
if "unseen" in split_list:
split_set.remove("unseen")
split_set |= set(UNSEEN_SPLITS)
if verify:
# Verify the constituent splits are valid
invalid_splits = split_set - set(VALID_SPLITS)
if invalid_splits:
msg_valid_names = f"Valid split names are: {', '.join(repr(s) for s in VALID_METASPLITS + VALID_SPLITS)}."
if split_set == {metasplit}:
raise ValueError(f"Invalid split name {repr(metasplit)}. {msg_valid_names}")
plural = "s" if len(invalid_splits) > 1 else ""
raise ValueError(
f"Invalid split name{plural} {', '.join(repr(s) for s in invalid_splits)} within requested metasplit"
f" {repr(metasplit)}. {msg_valid_names}"
)
return split_set
def get_image_path(row):
r"""Get the image path for a row in the metadata DataFrame.
Parameters
----------
row : pandas.Series
A row in the metadata DataFrame.
Returns
-------
str
The path to the image file.
"""
image_path = row["split"] + os.path.sep
if pandas.notna(row["chunk"]) and row["chunk"]:
image_path += str(row["chunk"]) + os.path.sep
image_path += row["processid"] + ".jpg"
return image_path
class MetadataDtype(Enum):
DEFAULT = "BIOSCAN5M_default_dtypes"
load_metadata = load_bioscan5m_metadata
[docs]
class BIOSCAN5M(VisionDataset):
r"""
`BIOSCAN-5M <https://github.com/bioscan-ml/BIOSCAN-5M>`_ Dataset.
Parameters
----------
root : str
The root directory, to contain the downloaded tarball files, and bioscan5m
data directory.
split : str, default="train"
The dataset partition.
One of:
- ``"pretrain"``
- ``"train"``
- ``"val"``
- ``"test"``
- ``"key_unseen"``
- ``"val_unseen"``
- ``"test_unseen"``
- ``"other_heldout"``
- ``"all"``, which is the union of all splits
- ``"seen"``, which is the union of {train, val, test}
- ``"unseen"``, which is the union of {key_unseen, val_unseen, test_unseen}
Set to ``"all"`` to include all splits.
The ``split`` parameter can also be specified as collection of partitions
joined by ``"+"``. For example, ``split="pretrain+train"`` will return a dataset
comprised of the pretraining and training partitions.
.. note::
There is distributional shift between the partitions, which means the
validation and test accuracy are not directly comparable, and the
accuracy for the seen and unseen splits are not directly comparable.
For more details, please see Appendix R.3 of the
`BIOSCAN-5M paper <https://arxiv.org/abs/2406.12723>`_.
modality : str or Iterable[str], default=("image", "dna")
Which data modalities to use. One of, or a list of:
``"image"``, ``"dna"``, or any column name in the metadata CSV file.
Examples of column names which may be of interest are
``"coord-lat"`` (latitude of collection location),
``"coord-lon"`` (longitude of collection location),
and ``"image_measurement_value"`` (specimen size, in pixels).
.. versionchanged:: 1.1.0
Added support for arbitrary modalities.
image_package : str, default="cropped_256"
The package to load images from. One of:
``"original_full"``, ``"cropped"``, ``"original_256"``, ``"cropped_256"``.
reduce_repeated_barcodes : bool, default=False
Whether to reduce the dataset to only one sample per barcode.
max_nucleotides : int, default=660
Maximum number of nucleotides to keep in the DNA barcode.
Set to ``None`` to keep the original data without truncation.
.. note::
COI DNA barcodes are typically 658 base pairs long for insects
(`Elbrecht et al., 2019 <https://doi.org/10.7717/peerj.7745>`_),
and an additional two base pairs are included as a buffer for the
primer sequence.
Although the BIOSCAN-5M dataset itself contains longer sequences,
characters after the first 660 base pairs are likely to be inaccurate
reads, and not part of the DNA barcode.
Hence we recommend limiting the DNA barcode to the first 660 nucleotides.
If you don't know much about DNA barcodes, you probably shouldn't
change this parameter.
target_type : str or Iterable[str], default="species"
Type of target to use. One of, or a list of:
- ``"phylum"``
- ``"class"``
- ``"order"``
- ``"family"``
- ``"subfamily"``
- ``"genus"``
- ``"species"``
- ``"dna_bin"`` (a species-level label derived from
`DNA barcode clustering by BOLD <https://portal.boldsystems.org/bin>`_)
target_format : str, default="index"
Format in which the targets will be returned. One of:
``"index"``, ``"text"``.
If this is set to ``"index"`` (default), target(s) will each be returned as
integer indices, each of which corresponds to a value for that taxonomic rank in
a look-up-table.
Missing values will be filled with ``-1``.
This format is appropriate for use in classification tasks.
If this is set to ``"text"``, the target(s) will each be returned as a string,
appropriate for processing with language models.
.. versionadded:: 1.1.0
output_format : str, default="tuple"
Format in which :meth:`__getitem__` will be returned. One of:
``"tuple"``, ``"dict"``.
If this is set to ``"tuple"`` (default), all modalities and targets will be
returned together as a single tuple.
If this is set to ``"dict"``, the output will be returned as a dictionary
containing the modalities and targets as separate keys.
.. versionadded:: 1.3.0
transform : Callable, optional
Image transformation pipeline.
dna_transform : Callable, optional
DNA barcode transformation pipeline.
target_transform : Callable, optional
Label transformation pipeline.
download : bool, default=False
If ``True``, downloads the dataset from the internet and puts it in root directory.
If dataset is already downloaded, it is not downloaded again.
Images are only downloaded if the ``"image"`` modality is requested.
Note that only ``image_package=cropped_256`` is supported for automatic image download.
Attributes
----------
metadata : pandas.DataFrame
The metadata associated with the samples in the select split, loaded using
:func:`load_bioscan5m_metadata`.
"""
base_folder = "bioscan5m"
meta = {
"urls": [
"https://zenodo.org/records/11973457/files/BIOSCAN_5M_Insect_Dataset_metadata_MultiTypes.zip",
"https://huggingface.co/datasets/bioscan-ml/BIOSCAN-5M/resolve/eeefb30/BIOSCAN_5M_Insect_Dataset_metadata_MultiTypes.zip", # noqa: E501
],
"filename": os.path.join("metadata", "csv", "BIOSCAN_5M_Insect_Dataset_metadata.csv"),
"archive_md5": "ac381b69fafdbaedc2f9cfb89e3571f7",
"csv_md5": "603020b433ef566946efba7a08dbb23d",
}
zip_files = {
"eval": {
"cropped_256": {
"url": "https://zenodo.org/records/11973457/files/BIOSCAN_5M_cropped_256_eval.zip",
"md5": "16a997f72a8cd08cbcf7becafe2dda50",
},
},
"pretrain01": {
"cropped_256": {
"url": "https://zenodo.org/records/11973457/files/BIOSCAN_5M_cropped_256_pretrain.01.zip",
"md5": "0e1cfa86dc7fa4d9c10036990992a2dd",
},
},
"pretrain02": {
"cropped_256": {
"url": "https://zenodo.org/records/11973457/files/BIOSCAN_5M_cropped_256_pretrain.02.zip",
"md5": "ca3191d307957732e8108121b20a2059",
},
},
"train": {
"cropped_256": {
"url": "https://zenodo.org/records/11973457/files/BIOSCAN_5M_cropped_256_train.zip",
"md5": "3f170db5d95610644883dafc73389049",
},
},
}
image_files = {
"pretrain": [
("pretrain/00/AACTA1040-20.jpg", {"cropped_256": "053311d26acb22a4726b867e558147ce"}),
("pretrain/ff/YGEN686-22.jpg", {"cropped_256": "053df72d6162d7d7512bc6d5571b52bd"}),
("pretrain/fe/YGEN2059-22.jpg", {"cropped_256": "5e0798d46efb11f6450150d07d185e7d"}),
],
"train": [
("train/0/AACTA1026-20.jpg", {"cropped_256": "a0746c803d07cbc7a87d808db763b8dc"}),
("train/f/YGEN986-22.jpg", {"cropped_256": "42f3e0873cd924a0084adb31eb263fd2"}),
],
"val": [
("val/AACTA161-20.jpg", {"cropped_256": "43834d843e992b546abbcb0c6d6f0d43"}),
("val/YGEN925-22.jpg", {"cropped_256": "c523319d0201306bd6fe530c362efeef"}),
],
"test": [
("test/AACTA1436-20.jpg", {"cropped_256": "dbe6de711585d84d5dd526dd42ce735d"}),
("test/YGEN995-22.jpg", {"cropped_256": "e369efbe1ef0a4259fc8ba42d8cb4b4c"}),
],
"key_unseen": [
("key_unseen/AACTA5263-20.jpg", {"cropped_256": "856411c5ecfa238ce2dac607a1207784"}),
("key_unseen/YGEN2149-22.jpg", {"cropped_256": "6d804a23ae6582e7d0ce9f296ad4390e"}),
],
"val_unseen": [
("val_unseen/ABOTH8801-22.jpg", {"cropped_256": "31e04be94df9f470ea79ff1266e36888"}),
("val_unseen/YGEN2173-22.jpg", {"cropped_256": "8f63d89962ed4092bd205274bc24036f"}),
],
"test_unseen": [
("test_unseen/BCMIN4148-23.jpg", {"cropped_256": "d3542d6cc943256723a1a39a18f845e5"}),
("test_unseen/YDBB974-21.jpg", {"cropped_256": "9cff547b03468b1552fb1647001d202f"}),
],
"other_heldout": [
("other_heldout/0/ABSSI1639-22.jpg", {"cropped_256": "82506b391cc33aa08b86f4c930c401a1"}),
("other_heldout/f/YDBB6502-21.jpg", {"cropped_256": "0ea33145fcb57997605ea450a979e5d2"}),
],
}
def __init__(
self,
root,
split: str = "train",
modality: Union[str, Iterable[str]] = ("image", "dna"),
image_package: str = "cropped_256",
reduce_repeated_barcodes: bool = False,
max_nucleotides: Union[int, None] = 660,
target_type: Union[str, Iterable[str]] = "species",
target_format: str = "index",
output_format: str = "tuple",
transform: Optional[Callable] = None,
dna_transform: Optional[Callable] = None,
target_transform: Optional[Callable] = None,
download: bool = False,
) -> None:
root = os.path.expanduser(root)
super().__init__(root, transform=transform, target_transform=target_transform)
self.metadata = None
self.root = root
self.image_package = image_package
self.image_dir = os.path.join(self.root, self.base_folder, "images", self.image_package)
self.metadata_path = os.path.join(self.root, self.base_folder, self.meta["filename"])
self.split = SPLIT_ALIASES.get(split, split)
self.target_format = target_format
self.output_format = "dict" if output_format == "dictionary" else output_format
self.reduce_repeated_barcodes = reduce_repeated_barcodes
self.max_nucleotides = max_nucleotides
self.dna_transform = dna_transform
if isinstance(modality, str):
self.modality = [modality]
else:
self.modality = list(modality)
if isinstance(target_type, str):
self.target_type = [target_type]
else:
self.target_type = list(target_type)
self.target_type = ["dna_bin" if t == "uri" else t for t in self.target_type]
if not self.target_type and self.target_transform is not None:
raise RuntimeError("target_transform is specified but target_type is empty")
if self.target_format not in ["index", "text"]:
raise ValueError(f"Unknown target_format: {repr(self.target_format)}")
if download:
self.download()
if not self._check_integrity():
raise EnvironmentError(f"{type(self).__name__} dataset not found, incomplete, or corrupted: {self.root}.")
self._load_metadata()
[docs]
def index2label(
self,
index: Union[int, List[int], npt.NDArray[np.int_]],
column: Optional[str] = None,
) -> Union[str, npt.NDArray[np.str_]]:
r"""
Convert target's integer index to text label.
.. versionadded:: 1.1.0
Parameters
----------
index : int or array_like[int]
The integer index or indices to map to labels.
column : str, default=same as ``self.target_type``
The dataset column name to map.
This should be one of the possible values for ``target_type``.
By default, the column name is the ``target_type`` used for the class,
provided it is a single value.
Returns
-------
str or numpy.array[str]
The text label or labels corresponding to the integer index or indices
in the specified column.
Entries containing missing values, indicated by negative indices, are mapped
to an empty string.
Examples
--------
>>> dataset.index2label([4], "order")
'Diptera'
>>> dataset.index2label([4, 9, -1, 4], "order")
array(['Diptera', 'Lepidoptera', '', 'Diptera'], dtype=object)
"""
if column is not None:
pass
elif len(self.target_type) == 1:
column = self.target_type[0]
else:
raise ValueError("column must be specified if there isn't a single target_type")
if not hasattr(index, "__len__"):
# Single index
if index < 0:
return ""
return self.metadata[column].cat.categories[index]
if isinstance(index, str):
raise TypeError(
f"index must be an int or array-like of ints, not a string: {repr(index)}."
" Did you mean to call label2index?"
)
index = np.asarray(index)
out = self.metadata[column].cat.categories[index]
out = np.asarray(out)
out[index < 0] = ""
return out
[docs]
def label2index(
self,
label: Union[str, Iterable[str]],
column: Optional[str] = None,
) -> Union[int, npt.NDArray[np.int_]]:
r"""
Convert target's text label to integer index.
.. versionadded:: 1.1.0
Parameters
----------
label : str or Iterable[str]
The text label or labels to map to integer indices.
column : str, default=same as ``self.target_type``
The dataset column name to map.
This should be one of the possible values for ``target_type``.
By default, the column name is the ``target_type`` used for the class,
provided it is a single value.
Returns
-------
int or numpy.array[int]
The integer index or indices corresponding to the text label or labels
in the specified column.
Entries containing missing values, indicated by empty strings or NaN values,
are mapped to ``-1``.
Examples
--------
>>> dataset.label2index("Diptera", "order")
4
>>> dataset.label2index(["Diptera", "Lepidoptera", "", "Diptera"], "order")
array([4, 9, -1, 4])
"""
if column is not None:
pass
elif len(self.target_type) == 1:
column = self.target_type[0]
else:
raise ValueError("column must be specified if there isn't a single target_type")
if pandas.isna(label) or label == "":
# Single index
return -1
if isinstance(label, str):
try:
return self.metadata[column].cat.categories.get_loc(label)
except KeyError:
raise KeyError(f"Label {repr(label)} not found in metadata column {repr(column)}") from None
if isinstance(label, (int, np.integer)):
raise TypeError(
f"label must be a string or list of strings, not an int: {repr(label)}."
" Did you mean to call index2label?"
)
labels = label
try:
out = [
-1 if lab == "" or pandas.isna(lab) else self.metadata[column].cat.categories.get_loc(lab)
for lab in labels
]
except KeyError:
raise KeyError(f"Label {repr(label)} not found in metadata column {repr(column)}") from None
out = np.asarray(out)
return out
def __len__(self):
return len(self.metadata)
[docs]
def __getitem__(self, index: int) -> Tuple[Any, ...]:
r"""
Get a sample from the dataset.
Parameters
----------
index : int
Index of the sample to retrieve.
Returns
-------
tuple or dict
If ``output_format="tuple"``, the output will be a tuple containing:
- image : PIL.Image.Image or Any
The image, if the ``"image"`` modality is requested, optionally transformed
by the ``transform`` pipeline.
- dna : str or Any
The DNA barcode, if the ``"dna"`` modality is requested, optionally
transformed by the ``dna_transform`` pipeline.
- \*modalities : Any
Any other modalities requested, as specified in the ``modality`` parameter.
The data is extracted from the appropriate column in the metadata TSV file,
without any transformations. Missing values will be filled with NaN.
- target : int or Tuple[int, ...] or str or Tuple[str, ...] or None
The target(s), optionally transformed by the ``target_transform`` pipeline.
If ``target_format="index"``, the target(s) will be returned as integer
indices, with missing values filled with ``-1``.
If ``target_format="text"``, the target(s) will be returned as a string.
If there are multiple targets, they will be returned as a tuple.
If ``target_type`` is an empty list, the output ``target`` will be ``None``.
If ``output_format="dict"``, the output will be a dictionary with keys
and values as follows:
- keys for each of the modalities specified in the ``modality`` parameter,
with corresponding values as described above.
The values for the image and DNA barcode modalities are transformed by
their respective pipelines if specified.
- keys for each of the targets specified in ``target_type``,
with corresponding value equal to that target's label
(e.g. ``out["species"] == "Gnamptogenys sulcata"``)
- for each of the keys in ``target_type``, the corresponding index column (``{target}_index``),
with value equal to that target's index
(e.g. ``out["species_index"] == 240``)
- the key ``"target"``, whose contents are as described above
.. versionchanged:: 1.3.0
Added support for ``output_format="dict"``.
"""
sample = self.metadata.iloc[index]
img_path = os.path.join(self.image_dir, sample["image_path"])
values = []
for modality in self.modality:
if modality == "image":
X = PIL.Image.open(img_path)
if self.transform is not None:
X = self.transform(X)
elif modality in ["dna_barcode", "dna", "barcode"]:
X = sample["dna_barcode"]
if self.dna_transform is not None:
X = self.dna_transform(X)
elif modality in self.metadata.columns:
X = sample[modality]
else:
raise ValueError(f"Unfamiliar modality: {repr(modality)}")
values.append((modality, X))
target = []
for t in self.target_type:
if self.target_format == "index":
target.append(sample[f"{t}_index"])
elif self.target_format == "text":
target.append(sample[t])
else:
raise ValueError(f"Unknown target_format: {repr(self.target_format)}")
if self.output_format == "dict":
values.append((t, sample[t]))
key = f"{t}_index"
if key in sample:
values.append((key, sample[key]))
if target:
target = tuple(target) if len(target) > 1 else target[0]
if self.target_transform is not None:
target = self.target_transform(target)
else:
target = None
values.append(("target", target))
if self.output_format == "tuple":
return tuple(v for _, v in values)
elif self.output_format == "dict":
return dict(values)
else:
raise ValueError(f"Unknown output_format: {repr(self.output_format)}")
def _check_integrity_metadata(self, verbose=1) -> bool:
p = self.metadata_path
check = check_integrity(p, self.meta["csv_md5"])
if verbose >= 1 and not check:
if not os.path.exists(p):
print(f"File missing: {p}")
else:
print(f"File invalid: {p}")
if verbose >= 2 and check:
print(f"File present: {p}")
return check
def _check_integrity_images(self, split=None, verbose=1) -> bool:
if not os.path.isdir(self.image_dir):
if verbose >= 1:
print(f"Image directory missing: {self.image_dir}")
return False
if split is None:
split = self.split
split_set = explode_metasplit(split, verify=True)
check_all = True
for s in split_set:
for file, data in self.image_files[s]:
file = os.path.join(self.image_dir, file)
if self.image_package in data:
check = check_integrity(file, data[self.image_package])
else:
check = os.path.exists(file)
check_all &= check
if verbose >= 1 and not check:
if not os.path.exists(os.path.dirname(os.path.dirname(file))):
print(f"Directory missing: {os.path.dirname(os.path.dirname(file))}")
break
elif not os.path.exists(os.path.dirname(file)):
print(f"Directory missing: {os.path.dirname(file)}")
break
elif not os.path.exists(file):
print(f"File missing: {file}")
else:
print(f"File invalid: {file}")
if verbose >= 2 and check:
print(f"File present: {file}")
return check_all
def _check_integrity(self, verbose=1) -> bool:
r"""
Check if the dataset is already downloaded and extracted.
Parameters
----------
verbose : int, default=1
Verbosity level.
Returns
-------
bool
True if the dataset is already downloaded and extracted, False otherwise.
"""
check = True
check &= self._check_integrity_metadata(verbose=verbose)
if "image" in self.modality:
check &= self._check_integrity_images(verbose=verbose)
if not check and verbose >= 1:
print(f"{type(self).__name__} dataset not found, incomplete, or corrupted.")
return check
def _download_metadata(self, verbose=1) -> None:
if self._check_integrity_metadata(verbose=verbose):
if verbose >= 1:
print("Metadata CSV file already downloaded and verified")
return
download_and_extract_archive(self.meta["urls"][0], self.root, md5=self.meta["archive_md5"])
def _download_image_zip(self, partition_set, image_package=None) -> None:
if image_package is None:
image_package = self.image_package
if image_package not in self.zip_files[partition_set]:
raise NotImplementedError(
f"Automatic download of image_package={repr(image_package)} is not yet implemented."
" Please manually download and extract the zip files."
)
data = self.zip_files[partition_set][image_package]
download_and_extract_archive(data["url"], self.root, md5=data.get("md5"))
def _download_images(self, verbose=1) -> None:
any_missing = False
split_set = explode_metasplit(self.split, verify=False)
if "pretrain" in split_set and not self._check_integrity_images("pretrain", verbose=verbose):
any_missing = True
self._download_image_zip("pretrain01")
self._download_image_zip("pretrain02")
if "train" in split_set and not self._check_integrity_images("train", verbose=verbose):
any_missing = True
self._download_image_zip("train")
eval_partitions = ["val", "test", "key_unseen", "val_unseen", "test_unseen", "other_heldout"]
if any(s in split_set and not self._check_integrity_images(s, verbose=verbose) for s in eval_partitions):
any_missing = True
self._download_image_zip("eval")
if verbose >= 1 and not any_missing:
print("Images already downloaded and verified")
[docs]
def download(self) -> None:
r"""
Download and extract the data.
"""
self._download_metadata()
if "image" in self.modality:
self._download_images()
def _load_metadata(self) -> pandas.DataFrame:
r"""
Load metadata from CSV file and prepare it for training.
"""
self.metadata = load_metadata(
self.metadata_path,
max_nucleotides=self.max_nucleotides,
reduce_repeated_barcodes=self.reduce_repeated_barcodes,
split=self.split,
usecols=USECOLS,
)
return self.metadata
def extra_repr(self) -> str:
xr = ""
xr += f"split: {repr(self.split)}\n"
xr += f"modality: {repr(self.modality)}\n"
if "image" in self.modality:
xr += f"image_package: {repr(self.image_package)}\n"
if self.reduce_repeated_barcodes:
xr += f"reduce_repeated_barcodes: {repr(self.reduce_repeated_barcodes)}\n"
has_dna_modality = any(m in self.modality for m in ["dna", "dna_barcode", "barcode"])
if has_dna_modality and self.max_nucleotides != 660:
xr += f"max_nucleotides: {repr(self.max_nucleotides)}\n"
xr += f"target_type: {repr(self.target_type)}\n"
if len(self.target_type) > 0:
xr += f"target_format: {repr(self.target_format)}\n"
xr += f"output_format: {repr(self.output_format)}"
if has_dna_modality and self.dna_transform is not None:
xr += f"\ndna_transform: {repr(self.dna_transform)}"
return xr