lib_tracking

21 jun 2023

Library "lib_tracking"
tracking highest and lowest with anchor point to track over dynamic periods, e.g. to track a Session HH/LL live and get the bar/time of the LTF wick that matches the HTF HH/LL

// DESIGN DECISION
// why anchored replacements for ta.highest / ta.highestbars / ta.lowest / ta.lowestbars:
// 1. they require a fixed length/lookback which makes it easier to calculate, but
// 2. this prevents us from tracking the HH/LL of a changing timeframe, e.g. live tracking the HH/LL of a running session or unfinished higher timeframe
// 3. tracking with anchor/start/reset flag allows to persist values until the next start/reset, so no other external storage is required


track_highest(value, reset, track_this_bar)
  Parameters:
    value (float)
    reset (bool): boolean flag to restart tracking from this point (a.k.a anchor)
    track_this_bar (bool): allows enabling and disabling of tracking, e.g. before a session starts or after it ends, values can be kept until next reset.

track_lowest(value, reset, track_this_bar)
  Parameters:
    value (float)
    reset (bool): boolean flag to restart tracking from this point (a.k.a anchor)
    track_this_bar (bool): allows enabling and disabling of tracking, e.g. before a session starts or after it ends, values can be kept until next reset.

track_hl_htf(htf, value_high, value_low)
  Parameters:
    htf (string): the higher timeframe in pinescript string notation
    value_high (float)
    value_low (float)
  Returns: [bool started, bool closing, bool cancelled, float highest, int highest_time, int highest_index, float lowest, int lowest_time, int lowest_index]