# 金融 / 专题函数 / 策略评价 / 绩效分析 / 收益率评价 / 收益

## `fi_avg_gain(r, days_in_1_y)`

声明：function

返回平均盈利(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                              |
| ------------- | ------- | --------------------------------------------------------------------------------- |
| `r`           | array   | 数组,收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `days_in_1_y` | integer | 整数,年化天数, 小于0、默认时表不年化                                              |

返回：array/real

### 示例

范例01：调用 FI_Avg_Gain

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_Avg_Gain(r); // 输出：0.97715653
```

## `fi_avg_loss(r, days_in_1_y)`

声明：function

返回平均亏损(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                              |
| ------------- | ------- | --------------------------------------------------------------------------------- |
| `r`           | array   | 数组,收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `days_in_1_y` | integer | 整数,年化天数, 小于0、默认时表不年化                                              |

返回：array/real

### 示例

范例01：调用 FI_Avg_Loss

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_Avg_Loss(r); // 输出：-0.78105665
```

## `fi_avg_ret(r, days_in_1_y)`

声明：function

返回算术平均收益率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                              |
| ------------- | ------- | --------------------------------------------------------------------------------- |
| `r`           | array   | 数组,收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `days_in_1_y` | integer | 整数,年化天数, 小于0、默认时表不年化                                              |

返回：array/real

### 示例

范例01：调用 FI_Avg_ret

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_Avg_ret(r); // 输出：0.1340789
```

## `fi_cagr(r, days_in_1_y)`

声明：function

返回复合年化收益率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                              |
| ------------- | ------- | --------------------------------------------------------------------------------- |
| `r`           | array   | 数组,收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `days_in_1_y` | integer | 整数,年化天数, 小于0、默认时表不年化                                              |

返回：array/real

### 示例

范例01：调用 FI_cagr

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_cagr(r); // 输出：0.12630749
```

## `fi_cumReturn(r)`

声明：function

返回累计收益率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数 | 类型  | 说明                                                                              |
| ---- | ----- | --------------------------------------------------------------------------------- |
| `r`  | array | 数组,收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |

返回：array/real

### 示例

范例01：调用 FI_CumReturn

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_CumReturn(r); // 输出：36.06952656
```

## `fi_down_capture(r, br, days_in_1_y)`

声明：function

返回下行捕获率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                               |
| ------------- | ------- | ---------------------------------------------------------------------------------- |
| `r`           | array   | 数组，收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `br`          | array   | 数组，基准收益率序列(%)，与r等长的一维数组数组                                     |
| `days_in_1_y` | integer | 整数,年化天数，小于0、默认时表不年化                                               |

返回：array/real

### 示例

范例01：调用 FI_Down_Capture

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
br := table_r[:, '中证500'];
return FI_Down_Capture(r, br); // 输出：67.89157151
```

## `fi_up_capture(r, br, days_in_1_y)`

声明：function

返回上行捕获率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                               |
| ------------- | ------- | ---------------------------------------------------------------------------------- |
| `r`           | array   | 数组，收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `br`          | array   | 数组，基准收益率序列(%)，与r等长的一维数组数组                                     |
| `days_in_1_y` | integer | 整数,年化天数，小于0、默认时表不年化                                               |

返回：array/real

### 示例

范例01：调用 FI_Up_Capture

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
br := table_r[:, '中证500'];
return FI_Up_Capture(r, br); // 输出：78.40257847
```

## `fi_up_down_capture(r, br, days_in_1_y)`

声明：function

返回上/下捕获比率

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数          | 类型    | 说明                                                                               |
| ------------- | ------- | ---------------------------------------------------------------------------------- |
| `r`           | array   | 数组，收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |
| `br`          | array   | 数组，基准收益率序列(%)，与r等长的一维数组数组                                     |
| `days_in_1_y` | integer | 整数,年化天数，小于0、默认时表不年化                                               |

返回：array/real

### 示例

范例01：调用 FI_UP_Down_Capture

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
br := table_r[:, '中证500'];
return FI_UP_Down_Capture(r, br); // 输出：1.1548205
```

## `fi_win_pct(r)`

声明：function

返回胜率(%)

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数 | 类型  | 说明                                                                               |
| ---- | ----- | ---------------------------------------------------------------------------------- |
| `r`  | array | 数组，收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |

返回：array/real

### 示例

范例01：调用 FI_Win_pct

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_Win_pct(r); // 输出：52.04918033
```

## `fi_winLoss_ratio(r)`

声明：function

返回盈亏比

<!-- tags: 金融 专题函数 策略评价 绩效分析 收益率评价 收益 返回 获取 -->

| 参数 | 类型  | 说明                                                                               |
| ---- | ----- | ---------------------------------------------------------------------------------- |
| `r`  | array | 数组，收益率(%)，可为一维数字数组，或者用一列表示一个资产收益率（%）序列的二维数组 |

返回：array/real

### 示例

范例01：调用 FI_WinLoss_ratio

```tsl
table_r := TSUT_Data_ZSZF(); // 取2019年全年的日收益率(%)
r := table_r[:, '沪深300'];
return FI_WinLoss_ratio(r); // 输出：1.35799904
```
