---
title: Distribution (latest version)
description: API reference for samplomatic.distributions.Distribution in the latest version of samplomatic
source: https://quantum.cloud.ibm.com/docs/en/api/samplomatic/auto/distributions-distribution
---

# Distribution

*class* `samplomatic.distributions.Distribution(num_subsystems: int)`

[GitHub](https://github.com/Qiskit/samplomatic/tree/main/samplomatic/distributions/distribution.py#L23-L57)

Bases: [`object`](https://docs.python.org/3/builtins/functions.html#object)

A distribution over virtual gates.

**Parameters**

**num\_subsystems** – The number of subsystems that this distribution samples.

**Attributes Summary**

|                                                                                                                                 |                                      |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| [`register_type`](#samplomatic.distributions.Distribution.register_type "samplomatic.distributions.Distribution.register_type") | The virtual gate type being sampled. |

**Methods Summary**

|                                                                                                                       |                          |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [`sample`](#samplomatic.distributions.Distribution.sample "samplomatic.distributions.Distribution.sample")(size, rng) | Sample the distribution. |

**Attributes Documentation**

### register\_type

The virtual gate type being sampled.

**Methods Documentation**

### sample

*abstractmethod* `sample(size: int, rng: Generator) → VirtualRegister`

[GitHub](https://github.com/Qiskit/samplomatic/tree/main/samplomatic/distributions/distribution.py#L38-L48)

Sample the distribution.

**Parameters**

- **size** – The number elements to sample.
- **rng** – A randomness generator.

**Returns**

The samples.