---
title: "ClikaRT::ops::poisson"
sidebar_label: "poisson"
description: "Independent Poisson draws from per-element rates. \\[ x_i \\sim \\mathrm{Poisson}(\\lambda_i) \\] rates per-element rates; non-negative, float dtype. device stream or device; default = the input's."
---

<!-- Generated by tools/doxygen2mdx from Doxygen XML. Do not edit. -->

<span class="api-kind api-kind--function">function</span>

## poisson() {#poisson}

<div class="api-signature">

[`Tensor`](../Tensor.md) **`poisson`**([`Tensor`](../Tensor.md) `rates`, [`StreamOrDevice`](../StreamOrDevice.md) `device` `=` `{}`)

</div>

Independent Poisson draws from per-element rates.

$$
x_i \sim \mathrm{Poisson}(\lambda_i)
$$

**Parameters**

- `rates`: per-element rates; non-negative, float dtype.
- `device`: stream or device; default = the input's.

**Returns:** draws shaped and typed like `rates`.

**Throws**

- `ClikaRT::Error`: (`INVALID_ARGUMENT`) on a negative rate.

<div class="api-declared">

Declared in `ClikaRT/compute/ops.h`, line 4176

</div>