# 金融 / 专题函数 / 因子研究 / 多因子框架 / 构造器

## `tsmf_factory_byAllUserData(my_factor_arr, factorname, begt, end_t, index_id)`

声明：function

返回因子库中有用户自己计算的因子（导入外部因子）

<!-- tags: 金融 专题函数 因子研究 多因子框架 构造器 查找 搜索 lookup 返回 获取 -->

| 参数            | 类型     | 说明                    |
| --------------- | -------- | ----------------------- |
| `my_factor_arr` | db_data  | 数据表类型,用户外部因子 |
| `factorname`    | string   | 字符串,因子名称         |
| `begt`          | datetime | 日期,开始日             |
| `end_t`         | datetime | 日期,截止日             |
| `index_id`      | string   | 指数,基准               |

返回：array

## `tsmf_factory_byFactorarr(factorarr, indexid)`

声明：function

返回多因子评价构造器-01.1-每期固定因子库

<!-- tags: 金融 专题函数 因子研究 多因子框架 构造器 查找 搜索 lookup 返回 获取 -->

| 参数        | 类型       | 说明                 |
| ----------- | ---------- | -------------------- |
| `factorarr` | datetime   | 日期,因子库          |
| `indexid`   | index_list | 指数,基准指数&选股域 |

返回：array

### 示例

范例01：调用 tsmf_factory_byFactorarr

```tsl
factors := unit(MF_Demo_Data_YS_03).samplefactors();
mobj := tsmf_factory_byFactorarr(factors, 'SZ399903');
mobj.Fcycle := cy_month();
mobj.fbegt := 20200101T;
mobj.fendt := 20210101T;
mobj.backtest();
return mobj.getgroupreturn(1, cy_day()); // 更多见多因子框架相关文档。
```

范例02：调用 tsmf_factory_byFactorarr

```tsl
factorarr := TSUT_Data_factorRandN()['因子库'];
obj := tsmf_factory_byFactorarr(factorarr, 'SH000300');
obj.backtest();
return obj.getgroupreturn(1, cy_day()); // 更多见多因子框架相关文档。
```

## `tsmf_factory_bySigleStockFormula(formula, indexid)`

声明：function

返回多因子评价构造器-01.2-单个股票因子公式

<!-- tags: 金融 专题函数 因子研究 多因子框架 构造器 查找 搜索 lookup 返回 获取 -->

| 参数      | 类型       | 说明                 |
| --------- | ---------- | -------------------- |
| `formula` | string     | 字符串,因子公式      |
| `indexid` | index_list | 指数,基准指数&选股域 |

返回：array

### 示例

范例01：调用 tsmf_factory_bySigleStockFormula

```tsl
obj := tsmf_factory_bySigleStockFormula('close()', 'SH000300');
obj.backtest();
return obj.getgroupreturn(1, cy_day()); // 更多见多因子框架相关文档。
```

## `tsmf_factory_byUserDataAndFactorarr(my_factor_arr, factor_arr, begt, end_t, index_id)`

声明：function

返回多因子评价构造器-02.1-导入外部计算好的因子

<!-- tags: 金融 专题函数 因子研究 多因子框架 构造器 查找 搜索 lookup 返回 获取 -->

| 参数            | 类型       | 说明                    |
| --------------- | ---------- | ----------------------- |
| `my_factor_arr` | db_data    | 数据表类型,用户外部因子 |
| `factor_arr`    | db_data    | 数据表类型,因子选择     |
| `begt`          | date       | 日期,开始日             |
| `end_t`         | date       | 日期,截止日             |
| `index_id`      | index_list | 指数,基准               |

返回：array
