lib_statemachine_modified

1月20日

Library "lib_statemachine_modified"

Modified to fix bugs and create getState and priorState methods.

method step(this, before, after, condition)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    before (int): (int): Current state before transition
    after (int): (int): State to transition to
    condition (bool): (bool): Condition to trigger the transition
  Returns: (bool): True if the state changed, else False

method step(this, after, condition)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    after (int): (int): State to transition to
    condition (bool): (bool): Condition to trigger the transition
  Returns: (bool): True if the state changed, else False

method currentState(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

method previousState(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

method changed(this, within_bars)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    within_bars (int): (int): Number of bars to look back for a state change
  Returns: (bool): True if a state change occurred within the timeframe, else False

method reset(this, condition, min_occurrences)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    condition (bool): (bool): Condition to trigger the reset
    min_occurrences (int): (int): Minimum number of times the condition must be true to reset
  Returns: (bool): True if the state was reset, else False

StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_state (series int)
    last_change_bar (series int)

1月22日

版本注释

v2

Added:
method didWeJustChangeThisBar(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

method didWeChangeFromTo(this, fromState, toState, within_bars)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    fromState (int)
    toState (int)
    within_bars (int)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_state (series int)
    last_change_bar (series int)
    last_distinct_prior_state (series int)

1月24日

版本注释

v3

Added:
method getLatestState(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_state (series int)
    last_change_bar (series int)
    last_distinct_prior_state (series int)
    stateHistory (array<float>)

3月7日

版本注释

v4

Added:
method changedPriorToCurrentBar(this, within_bars)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    within_bars (int): (int): Number of bars to look back for a state change
  Returns: (bool): True if a state change occurred within the timeframe, else False

Removed:
method changed(this, within_bars)

3月7日

版本注释

v5

Added:
method getLatestIndexOfState(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

StateRecord
  Fields:
    state (series int)
    bar_index (series int)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_state (series int)
    last_change_bar (series int)
    last_distinct_prior_state (series int)
    stateHistory (array<StateRecord>)

3月10日

版本注释

Library: lib_statemachine_modified (v6)
Types
StateRecord

Fields:
state (int): The state value recorded at a given moment.
bar_index (int): The bar index when that state was recorded.
StateMachine

Fields:
state (int): The current state of the machine (default 0).
neutral (int): The designated neutral (default) state.
enabled (bool): Flag to enable/disable state transitions.
reset_counter (int): Counter tracking how many times the reset condition has been met.
prior_state (int): The state immediately preceding the current state.
last_change_bar (int): The bar index at which the last state change occurred (or na if none).
last_distinct_prior_state (int): The last distinct state before the current transition.
stateHistory (StateRecord[]): An array storing a history of state transitions.
Methods
step(this, before, after, condition)

Namespace: StateMachine
Parameters:
this (StateMachine): The state machine instance.
before (int): The expected current state before the transition.
after (int): The target state to transition to.
condition (bool): Condition that triggers the transition.
Returns: (bool) — true if the state transition occurs; otherwise, false.
Notes:
If after differs from the current state, a new StateRecord is appended to stateHistory.
Updates prior_state, last_change_bar, and resets the reset_counter.
Overloaded step(this, after, condition)

Uses the current state as the expected before value.
Parameters:
this (StateMachine)
after (int): The target state.
condition (bool): Trigger condition.
Returns: (bool) — true if the state changed; otherwise, false.
currentState(this)

Parameters: this (StateMachine)
Returns: (int) — The current state.
previousState(this)

Parameters: this (StateMachine)
Returns: (int) — The state immediately prior to the current state change.
changedPriorToCurrentBar(this, within_bars)

Parameters:
this (StateMachine)
within_bars (int): Number of bars to look back for a state change (excluding the current bar).
Returns: (bool) — true if a state change occurred within the specified timeframe; otherwise, false.
didWeJustChangeThisBar(this)

Parameters: this (StateMachine)
Returns: (bool) — true if the state changed exactly on the current bar; otherwise, false.
didWeChangeFromTo(this, fromState, toState, within_bars)

Parameters:
this (StateMachine)
fromState (int): The state expected before the transition.
toState (int): The state expected after the transition.
within_bars (int): The timeframe (in bars) within which the transition should have occurred.
Returns: (bool) — true if the specific transition occurred recently; otherwise, false.
reset(this, condition, min_occurrences)

Parameters:
this (StateMachine)
condition (bool): The condition that may trigger a reset.
min_occurrences (int): The number of times the condition must be met before the reset occurs.
Returns: (bool) — true if the state machine was reset to the neutral state; otherwise, false.
getLatestState(this)

Parameters: this (StateMachine)
Returns: (int) — The latest recorded state from stateHistory (or na if none exists).
getLatestIndexOfState(this)

Parameters: this (StateMachine)
Returns: (int) — The bar index of the latest state record (or na if stateHistory is empty).
barsSinceState(this, searchState)

Parameters:
this (StateMachine)
searchState (int): The state to search for in the history.
Returns: (int) — The number of bars since the specified state was last active; returns na if that state has never been active.
Notes:
Iterates through stateHistory (accessed in reverse order) to find the most recent occurrence of searchState and computes the difference between the current bar index and the recorded bar index.

3月10日

版本注释

v7

Updated:
method barsSinceState(this, searchState, isLast)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    searchState (int): (int): The state to search for.
    isLast (bool): (bool): (Optional, default = true)
      If true, returns the number of bars elapsed since the most recent record where the state is active
        (i.e. where record.state == searchState);
      if false, returns the number of bars elapsed since the record where the state was first triggered
        (i.e. where record.before == searchState).
  Returns: (int): Number of bars since the state was active, or na if never active.

StateRecord
  Fields:
    before (series int)
    state (series int)
    barIndex (series int)

3月11日

版本注释

v8

Added:
method previousBarState(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

3月11日

版本注释

v9

Added:
method print_transitions(this, n)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    n (int): (int): The number of most recent transitions to include in the log.
  Returns: (string): A log of the last N state transitions.

method wasConditionMetOnBar(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_bar_state (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)

3月11日

版本注释

v10
Fix issue with print_transitions

3月11日

版本注释

v11

3月11日

版本注释

v12

Added:
method setStateNames(this, mapping)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    mapping (array<string>)

method getStateName(this, s)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    s (int)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_bar_state (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)

3月11日

版本注释

v13

Added:
method print_transitions_array(this, n)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    n (int): (int): The number of most recent transitions to include in the array (default is 2).
  Returns: (int[]): An array of state integers from the last n transitions.

3月11日

版本注释

v14

Added:
method statesArrayToText(this, states)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    states (array<int>): (int[]): An array of state integers.
  Returns: (string): A string with each state name on a separate line.

method print_transitions_names(this, n)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    n (int): (int): The number of most recent transitions to include (default is 2).
  Returns: (string): A formatted string where each state's name is on a new line.

3月11日

版本注释

v15
- fix bug method statesArrayToText(StateMachine this, int[] states) check for empty array

3月11日

版本注释

v16

Added:
method getOverlappingTransitions(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

StateOverlap
  Fields:
    state1 (series int)
    state2 (series int)
    barIndex (series int)

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    prior_bar_state (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)

3月11日

版本注释

v17

Added:
method printOverlappingTransitions(this)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)

3月11日

版本注释

v18

Added:
method showStateHistory(this, s)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    s (int): (int): The state to search for in the state history.
  Returns: (string): A summary message indicating how many labels were created.

3月11日

版本注释

v19
fix bugs

3月11日

版本注释

v20
Fixing the bug in previousState

3月11日

版本注释

v21

3月11日

版本注释

v22

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prev_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)

3月11日

版本注释

v23

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prior_bar_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)

3月11日

版本注释

v24

3月13日

版本注释

v25 update wasConditionMetOnBar

3月17日

版本注释

v26

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_processed_bar (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prior_bar_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)

3月18日

版本注释

v27

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_processed_bar (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prior_bar_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)
    just_changed_flag (series bool)

3月21日

版本注释

v28

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_processed_bar (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prior_bar_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)
    just_changed_flag (series bool)
    lastTrueConditionState (series int)

3月21日

版本注释

v29

Added:
method visualizeStateTransition(this, labelPrefix)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    labelPrefix (string)

method debugStateTransition(this, expectedFromState, expectedToState)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    expectedFromState (int)
    expectedToState (int)

Updated:
method didWeChangeFromTo(this, fromState, toState, within_bars)
  Namespace types: StateMachine
  Parameters:
    this (StateMachine)
    fromState (int): (int): The state expected before the transition
    toState (int): (int): The state expected after the transition
    within_bars (int): (int): Number of bars within which the transition must have occurred
  Returns: (bool): True if the specific transition occurred recently, else False
Enhanced version of didWeChangeFromTo with more robust checking

3月21日

版本注释

v30 fix bug

5月14日

版本注释

v31

5月20日

版本注释

v32

Updated:
StateMachine
  Fields:
    state (series int)
    neutral (series int)
    enabled (series bool)
    reset_counter (series int)
    last_processed_bar (series int)
    last_change_bar (series int)
    last_condition_bar (series int)
    prior_bar_state (series int)
    previous_distinct_state (series int)
    transitions_this_bar (series int)
    stateHistory (array<StateRecord>)
    stateNames (array<string>)
    overlapList (array<StateOverlap>)
    just_changed_flag (series bool)
    lastTrueConditionState (series int)
    offset (series int)

5月20日

版本注释

v33

5月31日

版本注释

v34