# 金融 / 专题函数 / 因子研究 / 因子研究01：Fama-French三四五因子 / 实时计算模型

## `fama_french_multiFactor(beg_t, end_t, factor_arr, rate_type, groups, index_id, cycle)`

声明：function

利用多因子框架，计算区间内Fama_French多因子，可参考文档《2021-01-29-应用专题-多因子框架01：天软多因子框架tsMultiFactor（更新版）》

<!-- tags: 金融 专题函数 因子研究 实时计算模型 查找 搜索 lookup 计算 求解 -->

| 参数         | 类型     | 说明                                                                                                                                 |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `beg_t`      | datetime | 日期，区间开始日                                                                                                                     |
| `end_t`      | datetime | 日期，区间截止日                                                                                                                     |
| `factor_arr` | d_btable | 数据表，必须包含“因子名称”、“因子公式”、“因子方向”、“因子比例(%)”，在计算三四五因子时，一次只能计算一个，不同因子对应的因子公式如下: |
| `rate_type`  | integer  | 用户自定义，加权方式                                                                                                                 |
| `groups`     | string   | 字符串，分组百分位，Groups:="0,50;50,100"，表示分为两组，第一组是 0-50%,第二组 50%-100%                                              |
| `index_id`   | string   | 字符串，指数代码，利用指数成分股计算三四五因子，默认为中证全指                                                                       |
| `cycle`      | string   | 调仓周期，默认为月线；注:关于参数的更多详细内容，请参考天软多因子框架文档                                                            |

返回：array

### 示例

范例01：调用 Fama_French_MultiFactor

```tsl
BegT := 20220221T;
EndT := 20220228T;
IndexID := "SH000985";
Cycle := "日线";
FactorArr := array(("因子名称":"市净率(%)倒数", "因子公式":"1/StockPNA(endt)",
    "因子方向":1, "因子比例(%)":100));
RateType := 4; // 等权
Groups := "0,30;30,70;70,100";  // 分3组
Return Fama_French_MultiFactor(BegT, EndT, FactorArr, RateType, Groups, IndexID, Cycle);
```
