# 策略评价 / 择时效果

## `tsTimingEvaluation`

声明：class

择时效果评价框架

<!-- tags: 评估 择时能力 策略评估 市场时机 -->

### `FIndexID`

声明：field

标的指数代码 SH000300

可见性：`public`

类型：string

### `FSignalData`

声明：field

信号序列数据 空数组，Array()，必须设置

可见性：`public`

类型：array

### `FClearCycle`

声明：field

净值清算周期 日线

可见性：`public`

类型：string

### `FOpenFeeRate`

声明：field

开仓费率(%) 0

可见性：`public`

类型：real

### `FCloseFeeRate`

声明：field

平仓费率(%) 0

可见性：`public`

类型：real

### `FDaysIn1y`

声明：field

年化系数 -1，基于净值清算周期匹配

可见性：`public`

类型：int

### `FyRf`

声明：field

年化无风险收益率(%) 2.5

可见性：`public`

类型：real

### `Calc_Signal(beg_t, end_t, cycle, signal_call_str)`

声明：function

获取区间择时信号数据，该方法主要用于用户提供信号生成模型即方式 2，来获得信号数据

<!-- tags: 查询 计算 -->

可见性：`public`

| 参数              | 类型     | 说明                                                        |
| ----------------- | -------- | ----------------------------------------------------------- |
| `beg_t`           | datetime | 择时评价区间的开始日期                                      |
| `end_t`           | datetime | 择时评价区间的截止日期                                      |
| `cycle`           | string   | 择时信号的计算周期                                          |
| `signal_call_str` | string   | 信号生成模型的执行串，例如 `MySignalModel(param1,param2,…)` |

返回：table

### `Get_Signal_Detail()`

声明：function

获取多空信号数据（该数据是对原始多空信号数据进行整理后得到，用于后续净值清算用）

<!-- tags: 查询 单位净值 资产净值 多空组合 多头空头 -->

可见性：`public`

返回：table

### `Get_Signal_Subtotals()`

声明：function

获取信号多空小计，是对各个看多或看空持续期的时间和收益的统计，样式见下表

<!-- tags: 查询 汇总 多空组合 多头空头 时间处理 日期时间 -->

可见性：`public`

返回：table

### `Get_Signal_Summary(ev_type)`

声明：function

获取持仓统计评价（根据 Get_Signal_Subtotals()中结果进行汇总统计），评价指标见持仓统计

<!-- tags: 查询 评估 仓位 -->

可见性：`public`

| 参数      | 类型    | 说明                                                                    |
| --------- | ------- | ----------------------------------------------------------------------- |
| `ev_type` | integer | 评价类型：-1 核心指标；0 全部指标；1 次数；2 时间；3 收益率；4 极端统计 |

返回：table

### `Get_Rt_Cum(return_type)`

声明：function

获取择时累计（超额）收益率(%)

<!-- tags: 查询 择时 累计收益率 累计超额收益率 收益评价 -->

可见性：`public`

| 参数          | 类型    | 说明                                     |
| ------------- | ------- | ---------------------------------------- |
| `return_type` | integer | 收益口径：0 累计收益率；1 累计超额收益率 |

返回：value

### `Get_ABSPFM_Summary()`

声明：function

获取绝对收益风险概览，针对的是净值收益率数据的评价，评价指标见绝对收益评价

<!-- tags: 查询 评估 回报率 投资收益 风险管理 风控 单位净值 资产净值 -->

可见性：`public`

返回：table

### `Get_RelPFM_Summary()`

声明：function

获取相对收益风险概览，针对的是超额收益率数据的评价，评价指标见相对收益评价

<!-- tags: 查询 评估 回报率 投资收益 风险管理 风控 主动收益 -->

可见性：`public`

返回：table

### `Get_Rt_RollSubtotals(cy)`

声明：function

获取净值滚动表现

<!-- tags: 查询 单位净值 资产净值 -->

可见性：`public`

| 参数 | 类型   | 说明                           |
| ---- | ------ | ------------------------------ |
| `cy` | string | 滚动周期（暂支持日频以上低频） |

返回：table

### `Get_Rt_Detail()`

声明：function

获取择时净值及回撤详情

<!-- tags: 查询 最大回撤 亏损幅度 单位净值 资产净值 -->

可见性：`public`

返回：table

### `Get_Rt_Report_plot()`

声明：function

获取净值及回撤图形报告

<!-- tags: 查询 绘图 图表 可视化 最大回撤 亏损幅度 单位净值 资产净值 -->

可见性：`public`

返回：table
