---
title: 柯西分布函数
description: "生成符合柯西分布（Cauchy distribution）的随机数向量。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0493.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0493.html
indexId: bd7c783b2ae6e33f1e00de3a7a569908ab1d8326cc4f4ab9d2ccaf02e6d79ca661
---
# 柯西分布函数

生成符合柯西分布（Cauchy distribution）的随机数向量。

#### 接口定义

int vsRngCauchy (const int method, VSLStreamStatePtr stream, const SizeType n, float *r, const float a, const float beta);

int vdRngCauchy (const int method, VSLStreamStatePtr stream, const SizeType n, double *r, const double a, const double beta);


#### 概率密度函数


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| method | int | 随机数生成模式。 VSL\_RNG\_METHOD\_CAUCHY\_ICDF：逆累积分布函数法模式 | 输入 |
| stream | VSLStreamStatePtr类型 | 随机数流。 | 输入 |
| n | SizeType | 输出向量的长度。 | 输入 |
| r | 在vsRngCauchy中是单精度浮点类型指针。 在vdRngCauchy中是双精度浮点类型指针。 | 指向结果的指针。 | 输出 |
| a | 在vsRngCauchy中是单精度浮点类型。 在vdRngCauchy中是双精度浮点类型。 | 柯西分布的location参数。 | 输入 |
| beta | 在vsRngCauchy中是单精度浮点类型。 在vdRngCauchy中是双精度浮点类型。 | 柯西分布的scale参数。 | 输入 |


#### 依赖

#include "krng.h"


#### 示例

```
#include <stdio.h>
#include <stdlib.h>
#include "krng.h"
int main()
{
/* initialize stream with given BRNG type and seed */
VSLStreamStatePtr stream;
unsigned seed = 42;
int errcode = vslNewStream(&stream, VSL_BRNG_MCG59, seed);
if (errcode != VSL_STATUS_OK) {
fprintf(stderr, "Failure in newstream\n");
return 0;
}
SizeType n = 10;
float *r = (float *)malloc(sizeof(float) * n);
if (r == NULL) {
fprintf(stderr, "Failure in malloc\n");
return 0;
}
if (vsRngCauchy(VSL_RNG_METHOD_CAUCHY_ICDF, stream, n, r, 0.0, 1.0)) {
fprintf(stderr, "Failure in vsRngCauchy\n");
goto out;
}
/* deinitialize the stream */
errcode = vslDeleteStream(&stream);
if (errcode != VSL_STATUS_OK) {
fprintf(stderr, "Failure in deleting stream\n");
goto out;
}
out:
free(r);
return 0;
}
```