asc_frequency_histogram

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√

功 能 说 明

对 直 方 图 数 据 进 行 频 率 统 计。根 据 低 位/高 位 模 式 分 别 统 计[0, 127]和[128, 255]区 间 内 的 数 据，dst数 据 中 的 第n位 数 据 代 表src中n出 现 的 频 率，并 在dst源 数 据 基 础 上 累 加 所 统 计 出 的 数 据。

Vector Length长 度 为256Byte，dst数 据 类 型 为uint16_t，一 个dst可 以 存 储128个 数 据，因 此 需 要 两 个dst。BIN0表 示 低 位 模 式，统 计src中[0, 127]范 围 内 的 数 据 写 入；BIN1表 示 高 位 模 式，统 计src中[128, 255]范 围 内 的 数 据 写 入。

统 计 方 式 如 下 图 所 示，其 中dst0表 示 低 位 模 式，dst1表 示 高 位 模 式。

函 数 原 型

C++

// 低 位 模 式
__simd_callee__ inline void asc_frequency_histogram_bin0(vector_uint16_t& dst, vector_uint8_t src, vector_bool mask)
// 高 位 模 式
__simd_callee__ inline void asc_frequency_histogram_bin1(vector_uint16_t& dst, vector_uint8_t src, vector_bool mask)

参 数 说 明

参 数 名	输 入/输 出	描 述
dst	输 出	目 的 操 作 数（矢 量 数 据 寄 存 器）。
src	输 入	源 操 作 数（矢 量 数 据 寄 存 器）。
mask	输 入	源 操 作 数 掩 码（掩 码 寄 存 器），用 于 指 示 在 计 算 过 程 中 哪 些 元 素 参 与 计 算。对 应 位 置 为1时 参 与 计 算，为0时 不 参 与 计 算。mask未 筛 选 的 元 素 在 输 出 中 置 零。

矢 量 数 据 寄 存 器 和 掩 码 寄 存 器 的 详 细 说 明 请 参 见reg数 据 类 型 定 义.md。

返 回 值 说 明

无

流 水 类 型

PIPE_V

约 束 说 明

无

调 用 示 例

C++

vector_uint16_t dst;
vector_uint8_t src;
vector_bool mask = asc_create_mask_b8(PAT_ALL);
asc_loadalign(src, src_addr); // src_addr是 外 部 输 入 的UB内 存 空 间 地 址。
asc_frequency_histogram_bin0(dst, src, mask);