# 金融 / 金融工程 / 因子研究 / 绩效分析 / 收益率评价 / 中间函数 / 常用报表

## `fi_report_excessYields(rt_data, fname_pf, fname_bm, fname_date, plot_type)`

声明：function

分析组合与基准的超额收益，计算超额收益率、累计收益、相对净值和回撤指标；可返回完整数据集或生成多子图

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 超额收益 回撤 相对净值 -->

| 参数         | 类型        | 说明                           |
| ------------ | ----------- | ------------------------------ |
| `rt_data`    | array       | 二维数组，净值收益率百分比序列 |
| `fname_pf`   | string      | 组合字段名称                   |
| `fname_bm`   | string      | 基准字段名称                   |
| `fname_date` | string      | 日期字段名称                   |
| `plot_type`  | user_define | 返回类型                       |

plot_type 取值

- `0` — 返回包含超额、累计、回撤和相对净值的完整数据集
- `1` — 返回 `tssubplot_lines` 生成的多子图数组

返回：array

### 示例

范例01：生成组合与基准的超额收益图表

```tsl
rt_data := TSUT_Data_ZSZF();
return fi_report_excessYields(rt_data, '沪深300', '中证500', '截止日', 1);
```

## `fi_report_corrAnalysis(rt_data, fname_date)`

声明：function

生成收益率评价的相关性分析报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 相关性 分析 -->

| 参数         | 类型    | 说明                         |
| ------------ | ------- | ---------------------------- |
| `rt_data`    | db_data | 收益率数据表                 |
| `fname_date` | string  | 日期字段名称，通常为“截止日” |

返回：array

### 示例

范例01：生成相关性分析报表

```tsl
rt_data := tsindexs_get_rQK2('TSI010001', 20250601T, 20260601T, '日线', 1);
fname_date := '截止日';
return fi_report_corrAnalysis(rt_data, fname_date);
```

## `fi_report_historicalPerformance(rt_data, fname_bm, fname_date, cycle, factor_roll_n_year)`

声明：function

生成收益率评价的历史行情走势报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 历史行情 走势 -->

| 参数                 | 类型       | 说明                                       |
| -------------------- | ---------- | ------------------------------------------ |
| `rt_data`            | db_data    | 收益率数据表                               |
| `fname_bm`           | string     | 基准字段名称                               |
| `fname_date`         | string     | 日期字段名称                               |
| `cycle`              | cycle_list | 滚动周期；官网范例未传入，定义未说明默认值 |
| `factor_roll_n_year` | integer    | 滚动年数；官网范例未传入，定义未说明默认值 |

返回：array

### 示例

范例01：生成历史行情走势报表

```tsl
rt_data := tsindexs_get_rQK('TSI010001', 20250601T, 20260601T, '日线', 'SH000300');
fname_bm := 'SH000300';
fname_date := '截止日';
return fi_report_historicalPerformance(rt_data, fname_bm, fname_date);
```

## `fi_report_periodReturn(rt_data, fname_date)`

声明：function

生成收益率评价的阶段收益报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 阶段收益 业绩查询 -->

| 参数         | 类型    | 说明                         |
| ------------ | ------- | ---------------------------- |
| `rt_data`    | db_data | 收益率数据表                 |
| `fname_date` | string  | 日期字段名称，通常为“截止日” |

返回：array

### 示例

范例01：生成阶段收益报表

```tsl
rt_data := tsindexs_get_rQK('TSI010001', 20250601T, 20260601T, '日线');
fname_date := '截止日';
return fi_report_periodReturn(rt_data, fname_date);
```

## `fi_report_returnAndRisk(rt_data, fname_date, qk_type, cycle, days_in_1_y)`

声明：function

生成收益率评价的阶段收益风险特征报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 收益 风险 阶段 -->

| 参数          | 类型        | 说明                                       |
| ------------- | ----------- | ------------------------------------------ |
| `rt_data`     | db_data     | 收益率数据表                               |
| `fname_date`  | string      | 日期字段名称，通常为“截止日”               |
| `qk_type`     | user_define | 采样类型                                   |
| `cycle`       | cycle_list  | 采样周期                                   |
| `days_in_1_y` | integer     | 年化系数；官网范例未传入，定义未说明默认值 |

qk_type 取值

- `0` — 固定周期
- `1` — 滚动周期

返回：array

### 示例

范例01：按固定季度生成阶段收益风险特征报表

```tsl
rt_data := tsindexs_get_rQK(
    array('TSI010001', 'TSI010002'), 20250601T, 20260601T, '日线');
fname_date := '截止日';
qk_type := 0;
cycle := '季线';
return fi_report_returnAndRisk(rt_data, fname_date, qk_type, cycle);
```

## `fi_report_riskFeature(rt_data, fname_bm, fname_date, days_in_1_y)`

声明：function

生成收益率评价的收益风险特征报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 收益 风险 特征 -->

| 参数          | 类型    | 说明                                       |
| ------------- | ------- | ------------------------------------------ |
| `rt_data`     | db_data | 收益率数据表                               |
| `fname_bm`    | string  | 基准字段名称                               |
| `fname_date`  | string  | 日期字段名称                               |
| `days_in_1_y` | integer | 年化系数；官网范例未传入，定义未说明默认值 |

返回：array

### 示例

范例01：生成收益风险特征报表

```tsl
rt_data := tsindexs_get_rQK('TSI010001', 20250601T, 20260601T, '日线', 'SH000300');
fname_bm := 'SH000300';
fname_date := '截止日';
return fi_report_riskFeature(rt_data, fname_bm, fname_date);
```

## `fi_report_rollReturn(rt_data, fname_date, cycle)`

声明：function

生成收益率评价的滚动收益报表

<!-- tags: 金融 金融工程 因子研究 绩效分析 收益率评价 常用报表 滚动收益 业绩查询 -->

| 参数         | 类型       | 说明                         |
| ------------ | ---------- | ---------------------------- |
| `rt_data`    | db_data    | 收益率数据表                 |
| `fname_date` | string     | 日期字段名称，通常为“截止日” |
| `cycle`      | cycle_list | 滚动周期                     |

返回：array

### 示例

范例01：生成季度滚动收益报表

```tsl
rt_data := tsindexs_get_rQK('TSI010001', 20250601T, 20260601T, '日线');
fname_date := '截止日';
cycle := '季线';
return fi_report_rollReturn(rt_data, fname_date, cycle);
```
