welltest_pta.detect_events

welltest_pta.detect_events(df, cfg=None)[source]

Detect drawdown / buildup events on a parsed gauge DataFrame.

Parameters:
  • df (DataFrame) – Output of welltest_pta.parser.parse(). Must contain timestamp and pressure.

  • cfg (Optional[EventDetectorConfig]) – Detector configuration. Default values cover most DST cases.

Return type:

tuple[DataFrame, EventDetector]

Returns:

  • annotated_df – Copy of df with extra columns p_smooth, dpdt, elapsed_hr, event, p_reservoir.

  • detector – The fitted EventDetector (exposes _p_res, _noise_floor).