# 金融 / 专题函数 / 因子研究 / 因子研究07：天软风格因子收益率 / 应用模型

## `index_rm_factorRet(d_type)`

声明：function

返回指数最新日因子收益率(%)，与系统证券、时间相关，底层调用模型Index_RM_FactorRetQK

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

| 参数     | 类型    | 说明                                            |
| -------- | ------- | ----------------------------------------------- |
| `d_type` | integer | 用户自定义，数据类型，默认为3，提取风格因子收益 |

返回：array

### 示例

范例01：提取中证全指市场，20210120日的风格因子收益率(%)

```tsl
// 提取中证全指市场，20210120日的风格因子收益率(%)
IndexID := "SH000985";
EndT := 20210120T;
DType := 3;
setsysparam(pn_stock(), IndexID);
setsysparam(pn_date(), EndT);
return Index_RM_FactorRet(DType);
```

## `index_rm_factorRetQK(beg_t, end_t, d_type)`

声明：function

返回区间因子收益率(%)，与系统证券相关，日线，底层调用模型RM_GetFactorReturnByStocks

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

| 参数     | 类型     | 说明                                            |
| -------- | -------- | ----------------------------------------------- |
| `beg_t`  | datetime | 日期类型，开始日                                |
| `end_t`  | datetime | 日期类型，截止日                                |
| `d_type` | integer  | 用户自定义，数据类型，默认为3，提取风格因子收益 |

返回：array

### 示例

范例01：提取沪深300市场，2020年每天的风格因子收益(%)

```tsl
// 提取沪深300市场，2020年每天的风格因子收益(%)
IndexID := "SH000300";
BegT := 20200101T;
EndT := 20201231T;
DType := 3;
setsysparam(pn_stock(), IndexID);
return Index_RM_FactorRetQK(BegT, EndT, DType);
```

## `index_rm_specificRet()`

声明：function

返回指数成分股最新特质收益率(%)，部分成分股被剔除，与系统证券、时间相关，底层调用模型RM_GetFactorReturnByStocks

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

返回：array

### 示例

范例01：提取中证500市场，20210120日的成分股特质收益率

```tsl
// 提取中证500市场，20210120日的成分股特质收益率
IndexID := "SH000905";
EndT := 20210120T;
setsysparam(pn_stock(), IndexID);
setsysparam(pn_date(), EndT);
return Index_RM_SpecificRet();
```

## `stock_rm_specificRet(index_id)`

声明：function

返回个股最新市场交易日的特质收益率(%)，与系统证券、时间相关 （时间市场对齐），不在指数成分股中 or被剔除的股票，返回nil，底层调用模型Index_RM_SpecificRet

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

| 参数       | 类型   | 说明             |
| ---------- | ------ | ---------------- |
| `index_id` | string | 字符串，市场指数 |

返回：float

### 示例

范例01：提取中证全指市场上，浦发银行在20210120日的特质收益率(%)

```tsl
// 提取中证全指市场上，浦发银行在20210120日的特质收益率(%)
stock := "SH600000";
endt := 20210120T;
IndexID := "SH000985";
setsysparam(pn_stock(), stock);
setsysparam(pn_date(), EndT);
return Stock_RM_SpecificRet(IndexID); // 输出：0.00872166
```

## `stock_rm_specificRetQK(beg_t, end_t, index_id)`

声明：function

返回个股区间特质收益率(%)，与系统证券相关，区间为市场对齐，底层调用模型Stock_RM_SpecificRet

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

| 参数       | 类型     | 说明             |
| ---------- | -------- | ---------------- |
| `beg_t`    | datetime | 日期，开始日     |
| `end_t`    | datetime | 日期，截止日     |
| `index_id` | string   | 字符串，市场指数 |

返回：array

### 示例

范例01：提取中证全指市场上，浦发银行在20201201~20201231日的特质收益率序列

```tsl
// 提取中证全指市场上，浦发银行在20201201~20201231日的特质收益率序列
stock := "SH600000";
begt := 20201201T;
endt := 20201231T;
IndexID := "SH000985";
setsysparam(pn_stock(), stock);
return Stock_RM_SpecificRetQK(begt, endt, IndexID);
```

## `stocks_rm_specificRet(stocks, index_id, end_t)`

声明：function

返回股票池指定日特质收益率(%)，不在指数成分股中 or被剔除的股票 没有特质收益率数据，底层调用模型Index_RM_SpecificRet

<!-- tags: 金融 专题函数 因子研究 07： 因子研究天软风格因子收益率 应用模型 查找 搜索 lookup 返回 获取 -->

| 参数       | 类型     | 说明                   |
| ---------- | -------- | ---------------------- |
| `stocks`   | array    | 一维字符串数组，股票池 |
| `index_id` | string   | 字符串，市场指数       |
| `end_t`    | datetime | 日期，截止日           |

返回：array

### 示例

范例01：提取中证全指市场上，上证50成分股在20210120日的特质收益率(%)

```tsl
// 提取中证全指市场上，上证50成分股在20210120日的特质收益率(%)
Stocks := getbk("上证50");
IndexID := "SH000985";
EndT := 20210120T;
return Stocks_RM_SpecificRet(Stocks, IndexID, EndT);
```
