<!-- # hard line break macro for HTML -->

# fiftyone.core.map.batcher.id_batch

Abstract mapping backend

Copyright 2017-2026, Voxel51, Inc.
<br/>
[voxel51.com](https://voxel51.com/)
<br/>
<br/>

**Classes:**

| [`SampleIdBatch`](#fiftyone.core.map.batcher.id_batch.SampleIdBatch)(\*sample_ids)   | Sample batch using ids   |
|--------------------------------------------------------------------------------------|--------------------------|

### *class* fiftyone.core.map.batcher.id_batch.SampleIdBatch(\*sample_ids: [ObjectId](https://pymongo.readthedocs.io/en/stable/api/bson/objectid.html#bson.objectid.ObjectId))

Bases: [`SampleBatch`](fiftyone.core.map.batcher.batch.md#fiftyone.core.map.batcher.batch.SampleBatch)

Sample batch using ids

**Methods:**

| [`get_max_batch_size`](#fiftyone.core.map.batcher.id_batch.SampleIdBatch.get_max_batch_size)()            | Get max batch size                        |
|-----------------------------------------------------------------------------------------------------------|-------------------------------------------|
| [`split`](#fiftyone.core.map.batcher.id_batch.SampleIdBatch.split)(sample_collection, num_workers[, ...]) | Create a list of sample batches           |
| [`create_subset`](#fiftyone.core.map.batcher.id_batch.SampleIdBatch.create_subset)(sample_collection)     | Create a sample collection from the batch |

**Attributes:**

| [`total`](#fiftyone.core.map.batcher.id_batch.SampleIdBatch.total)   | Get the total number of samples in the batch   |
|----------------------------------------------------------------------|------------------------------------------------|

#### *classmethod* get_max_batch_size()

Get max batch size

#### *classmethod* split(sample_collection: [SampleCollection](fiftyone.core.map.typing.md#fiftyone.core.map.typing.SampleCollection)[T], num_workers: int, batch_size: int | None = None) → List[[SampleIdBatch](#fiftyone.core.map.batcher.id_batch.SampleIdBatch)]

Create a list of sample batches

#### *property* total *: int*

Get the total number of samples in the batch

#### create_subset(sample_collection: [SampleCollection](fiftyone.core.map.typing.md#fiftyone.core.map.typing.SampleCollection)[T]) → [SampleCollection](fiftyone.core.map.typing.md#fiftyone.core.map.typing.SampleCollection)[T]

Create a sample collection from the batch
