# tensorplay.random API

Source: https://www.tensorplay.cn/docs/api/tensorplay.random.html

## Functions 8

[#](#api-tensorplay.random.default_generator)

### default_generator

function[Full reference ↗](/docs/generated/tensorplay.random.default_generator.html)

```python
tensorplay.random.default_generator() → tensorplay._C.Generator
```

[#](#api-tensorplay.random.fork_rng)

### fork_rng

function[Full reference ↗](/docs/generated/tensorplay.random.fork_rng.html)

```python
tensorplay.random.fork_rng(devices=None, enabled=True, _caller='fork_rng', _devices_kw='devices')
```

Forks the RNG state: code inside the context gets a pristine RNG.

Saves the CPU RNG state and the RNG state of every CUDA device listed in
devices on entry and restores them on exit, so random operations
inside the block do not advance the outer streams.  devices=[] forks
only the CPU generator.

[#](#api-tensorplay.random.get_rng_state)

### get_rng_state

function[Full reference ↗](/docs/generated/tensorplay.random.get_rng_state.html)

```python
tensorplay.random.get_rng_state() → tensorplay::Tensor
```

[#](#api-tensorplay.random.initial_seed)

### initial_seed

function[Full reference ↗](/docs/generated/tensorplay.random.initial_seed.html)

```python
tensorplay.random.initial_seed() → int
```

[#](#api-tensorplay.random.manual_seed)

### manual_seed

function[Full reference ↗](/docs/generated/tensorplay.random.manual_seed.html)

```python
tensorplay.random.manual_seed(seed: SupportsInt | SupportsIndex) → None
```

[#](#api-tensorplay.random.seed)

### seed

function[Full reference ↗](/docs/generated/tensorplay.random.seed.html)

```python
tensorplay.random.seed() → int
```

[#](#api-tensorplay.random.set_rng_state)

### set_rng_state

function[Full reference ↗](/docs/generated/tensorplay.random.set_rng_state.html)

```python
tensorplay.random.set_rng_state(new_state: tensorplay::Tensor) → None
```

[#](#api-tensorplay.random.thread_safe_generator)

### thread_safe_generator

function[Full reference ↗](/docs/generated/tensorplay.random.thread_safe_generator.html)

```python
tensorplay.random.thread_safe_generator()
```

Returns a thread-safe random number generator for use in DataLoader workers.

This function provides a convenient way for transforms and user code to use
thread-safe random number generation without manually checking worker context.

When called in a DataLoader thread worker, returns the worker’s thread-local
[tensorplay.Generator](/docs/generated/tensorplay.Generator.html#tensorplay.Generator). When called in the main process or process workers,
returns None (which causes operations to use the default global RNG).

Example

```
>>> from tensorplay.random import thread_safe_generator
>>> generator = thread_safe_generator()
>>> tensorplay.randint(0, 10, (5,), generator=generator)
```