resample_bars

czsc.resample_bars(df: DataFrame, target_freq: Freq | AnyStr, raw_bars=True, **kwargs)[source]

将给定的K线数据重新采样为目标周期的K线数据

函数计算逻辑:

  1. 确定目标周期`target_freq`的类型和市场类型。

  2. 添加一个新列`freq_edt`,表示每个数据点对应的目标周期的结束时间。

  3. 根据`freq_edt`对数据进行分组,并对每组数据进行聚合,得到目标周期的K线数据。

  4. 重置索引,并选择需要的列。

  5. 根据`raw_bars`参数,决定返回的数据类型:如果为True,转换为`RawBar`对象;如果为False,直接返回DataFrame。

  6. 如果`drop_unfinished`参数为True,删除最后一根未完成的K线。

Parameters:
  • df

    原始K线数据,必须包含以下列:symbol, dt, open, close, high, low, vol, amount。样例如下:

    symbol dt open close high low 0 000001.XSHG 2015-01-05 09:31:00 3258.63 3259.69 3262.85 3258.63

    1 000001.XSHG 2015-01-05 09:32:00 3258.33 3256.19 3259.55 3256.19 2 000001.XSHG 2015-01-05 09:33:00 3256.10 3257.50 3258.42 3256.10 3 000001.XSHG 2015-01-05 09:34:00 3259.33 3261.76 3261.76 3257.98 4 000001.XSHG 2015-01-05 09:35:00 3261.71 3264.88 3265.48 3261.71

    vol amount

    0 1333523100 4.346872e+12 1 511386100 1.665170e+12 2 455375200 1.483385e+12 3 363393800 1.185303e+12 4 402854600 1.315272e+12

  • target_freq – 目标周期

  • raw_bars – 是否将转换后的K线序列转换为RawBar对象

  • kwargs

    • base_freq: 基础周期,如果不指定,则根据df中的dt列自动推断

    • drop_unfinished: 是否删除最后一根未完成的K线

Returns:

转换后的K线序列