# RaggedRange — MindSpore Signal+ 使用手册 alpha 文档

# RaggedRange

为每个区间生成等差序列并拼接到一个一维输出，同时返回每段的边界索引。

\[\begin{split}\begin{aligned} L_k &= \left\lceil \frac{\text{limit}_k - \text{start}_k}{\text{delta}_k} \right\rceil,\quad k=0,\dots,\text{range\_count}-1 \\ \text{splits}[0] &= 0,\quad \text{splits}[k+1] = \text{splits}[k] + L_k \\ \text{values}[\text{splits}[k] + j] &= \text{start}_k + j \cdot \text{delta}_k,\quad j=0,\dots,L_k-1 \end{aligned}\end{split}\]

输入：

  - starts - 各段起始值数组地址。

  - limits - 各段终止上界数组地址（半开区间 [start, limit) 语义）。

  - deltas - 各段步长数组地址，要求 `delta_k != 0`，且方向与 `limit_k - start_k` 一致，否则该段长度视为 0。

  - range_count - 段数 K。

  - core_mask（可选） - 核掩码（仅适用于共享存储版本）。

输出：

  - values - 扁平化拼接的结果数组地址，长度为 `splits[range_count]`。

  - splits - 长度为 `range_count + 1` 的整型数组，记录各段边界，且 `splits[0] = 0`。

支持平台：

  `FT78NE` `MT7004`

备注

- 当前实现覆盖 int8、int16、int32、fp32、fp64 五种类型。

- 不进行数值饱和裁剪；请确保序列不会在对应类型范围内溢出。

- 共享存储版本要求输入/输出地址位于共享可见的存储空间（如 GSM/DDR/SMC 等）。

共享存储版本：

void i8_raggedrange_s(int8_t *starts, int8_t *limits, int8_t *deltas, int range_count, int8_t *values, int *splits, int core_mask)

void i16_raggedrange_s(int16_t *starts, int16_t *limits, int16_t *deltas, int range_count, int16_t *values, int *splits, int core_mask)

void i32_raggedrange_s(int32_t *starts, int32_t *limits, int32_t *deltas, int range_count, int32_t *values, int *splits, int core_mask)

void fp_raggedrange_s(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits, int core_mask)

void dp_raggedrange_s(double *starts, double *limits, double *deltas, int range_count, double *values, int *splits, int core_mask)

  C调用示例：

       1#include <stdio.h>
       2#include <stdbool.h>
       3
       4int main(int argc, char* argv[]) {
       5    float *starts = (float *)0xA0000000;   // DDR
       6    float *limits = (float *)0xA0100000;   // DDR
       7    float *deltas = (float *)0xA0200000;   // DDR
       8    float *values = (float *)0xA0300000;   // DDR
       9    int   *splits = (int   *)0xA0400000;   // DDR
      10    int range_count = 3;
      11    int core_mask = 0xff;
      12    fp_raggedrange_s(starts, limits, deltas, range_count, values, splits, core_mask);
      13    return 0;
      14}

私有存储版本：

void i8_raggedrange_p(int8_t *starts, int8_t *limits, int8_t *deltas, int range_count, int8_t *values, int *splits)

void i16_raggedrange_p(int16_t *starts, int16_t *limits, int16_t *deltas, int range_count, int16_t *values, int *splits)

void i32_raggedrange_p(int32_t *starts, int32_t *limits, int32_t *deltas, int range_count, int32_t *values, int *splits)

void fp_raggedrange_p(float *starts, float *limits, float *deltas, int range_count, float *values, int *splits)

void dp_raggedrange_p(double *starts, double *limits, double *deltas, int range_count, double *values, int *splits)

  C调用示例：

       1#include <stdio.h>
       2
       3int main(int argc, char* argv[]) {
       4    int32_t *starts = (int32_t *)0x10000000; // L2
       5    int32_t *limits = (int32_t *)0x10001000; // L2
       6    int32_t *deltas = (int32_t *)0x10002000; // L2
       7    int32_t *values = (int32_t *)0x10003000; // L2/DDR
       8    int     *splits = (int     *)0x10004000; // L2/DDR
       9    int range_count = 2;
      10    i32_raggedrange_p(starts, limits, deltas, range_count, values, splits);
      11    return 0;
      12}