XZ_SD_Research_Dashboard

Library "XZ_SD_Research_Dashboard"
XZ S&D Research Dashboard v1. Memory-bounded observer and presentation backend for already-determined XZ Supply & Demand engine events. v9 turns All Sections into a dual-panel full-width Research dashboard while individual sections remain single-table.

newState(retentionPerBucket)
Creates one empty persistent S&D Research observer state with bounded retention per side/source bucket.
Parameters:
retentionPerBucket (simple int): Maximum newest records retained for each Supply/Demand x Primary/Secondary bucket.
Returns: Empty memory-bounded ResearchState.

clearState(state)
Clears all retained Research records and cumulative loaded-zone counts.
Parameters:
state (ResearchState)

recordCount(state)
Number of Research zone records currently retained.
Parameters:
state (ResearchState)

observeEvent(state, event)
Observes one already-decided protected-engine event. It never derives or re-decides S&D authority.
Parameters:
state (ResearchState)
event (ResearchEvent)

snapshot(state, sourceFilter, nowTime, sampleLimit, statistic, includeChronology, includePathways)
Builds one bounded snapshot. Baseline metrics always calculate. Event Chronology calculates only when includeChronology is true, using one metric-at-a-time scratch buffers to minimize peak runtime memory.
Parameters:
state (ResearchState)
sourceFilter (simple string)
nowTime (int)
sampleLimit (simple int)
statistic (simple string)
includeChronology (bool)
includePathways (bool)

renderLab(state, showLab, source, section, statistic, tablePosition, textSizeName, bgColor, textColor, accentColor, showLines, lineColor, supplyColor, demandColor, primaryTimeframe, secondaryTimeframe, secondaryEnabled, secondaryConfigured, secondaryIsHigher, nowTime, sampleLimit, sessionStandard, sessionShowSydney, sessionShowTokyo, sessionShowLondon, sessionShowNewYork, sessionCustomOpen, sessionCustomClose, sessionCustomTimezone, sessionCustomWeekdaysOnly, symbolTimezone)
Renders or removes the complete XZ S&D Research Lab using already-observed bounded ResearchState facts. Presentation only; this function cannot decide S&D lifecycle or structure.
Parameters:
state (ResearchState)
showLab (bool)
source (simple string)
section (simple string)
statistic (simple string)
tablePosition (simple string)
textSizeName (simple string)
bgColor (color)
textColor (color)
accentColor (color)
showLines (bool)
lineColor (color)
supplyColor (color)
demandColor (color)
primaryTimeframe (simple string)
secondaryTimeframe (simple string)
secondaryEnabled (bool)
secondaryConfigured (bool)
secondaryIsHigher (bool)
nowTime (int)
sampleLimit (simple int)
sessionStandard (simple string)
sessionShowSydney (simple bool)
sessionShowTokyo (simple bool)
sessionShowLondon (simple bool)
sessionShowNewYork (simple bool)
sessionCustomOpen (simple string)
sessionCustomClose (simple string)
sessionCustomTimezone (simple string)
sessionCustomWeekdaysOnly (simple bool)
symbolTimezone (simple string)

renderAdaptiveLab(state, showLab, source, section, statistic, tablePosition, textSizeName, bgColor, textColor, accentColor, showLines, lineColor, supplyColor, demandColor, primaryTimeframe, secondaryTimeframe, secondaryEnabled, secondaryConfigured, secondaryIsHigher, nowTime, sampleLimit, sessionStandard, sessionShowSydney, sessionShowTokyo, sessionShowLondon, sessionShowNewYork, sessionCustomOpen, sessionCustomClose, sessionCustomTimezone, sessionCustomWeekdaysOnly, symbolTimezone)
Keeps individual Research sections as one table, but automatically turns All Sections into two coordinated bottom-corner dashboard panels.
Parameters:
state (ResearchState)
showLab (bool)
source (simple string)
section (simple string)
statistic (simple string)
tablePosition (simple string)
textSizeName (simple string)
bgColor (color)
textColor (color)
accentColor (color)
showLines (bool)
lineColor (color)
supplyColor (color)
demandColor (color)
primaryTimeframe (simple string)
secondaryTimeframe (simple string)
secondaryEnabled (bool)
secondaryConfigured (bool)
secondaryIsHigher (bool)
nowTime (int)
sampleLimit (simple int)
sessionStandard (simple string)
sessionShowSydney (simple bool)
sessionShowTokyo (simple bool)
sessionShowLondon (simple bool)
sessionShowNewYork (simple bool)
sessionCustomOpen (simple string)
sessionCustomClose (simple string)
sessionCustomTimezone (simple string)
sessionCustomWeekdaysOnly (simple bool)
symbolTimezone (simple string)

ResearchEvent
One canonical already-decided S&D event transported from the protected engine.
Fields:
event_type (series string)
zone_id (series int)
side (series string)
source_context (series string)
source_timeframe (series string)
birth_time (series int)
confirmation_time (series int)
event_draw_time (series int)
event_time (series int)
source_bar (series int)
origin_event_time (series int)
confirmation_event_time (series int)
origin_source_bar (series int)
confirmation_source_bar (series int)
outer_boundary (series float)
original_inner_boundary (series float)
previous_inner_boundary (series float)
current_inner_boundary (series float)
event_price (series float)
penetration_pct (series float)
event_sequence (series int)
pivot_class (series string)
swing_family (series string)
lifecycle_state (series string)
pathway (series string)

ZoneRecord
Factual Research record for one engine-owned zone. Exported because it is stored inside ResearchState.
Fields:
zone_id (series int)
side (series string)
source_context (series string)
source_timeframe (series string)
birth_time (series int)
confirmation_time (series int)
origin_event_time (series int)
confirmation_event_time (series int)
origin_source_bar (series int)
confirmation_source_bar (series int)
outer_boundary (series float)
original_inner_boundary (series float)
current_inner_boundary (series float)
pivot_class (series string)
wick_test_count (series int)
max_wick_pct (series float)
first_wick_time (series int)
first_wick_source_bar (series int)
last_wick_time (series int)
last_wick_source_bar (series int)
partial_count (series int)
max_partial_pct (series float)
first_partial_time (series int)
first_partial_source_bar (series int)
deepest_partial_time (series int)
deepest_partial_source_bar (series int)
is_swing (series bool)
swing_family (series string)
swing_confirmation_time (series int)
swing_confirmation_source_bar (series int)
lifecycle_state_at_swing (series string)
partial_pct_at_swing (series float)
wick_tested_at_swing (series bool)
consumed (series bool)
consumed_draw_time (series int)
consumed_event_time (series int)
consumed_source_bar (series int)
terminal_close (series float)
pathway (series string)

ResearchState
Persistent memory-bounded observer state owned by the importing indicator instance.
Fields:
zones (array<ZoneRecord>): Retained newest records only. Old records outside the configured per-side/source Research window are pruned.
retention_per_bucket (series int): Maximum retained records for each side/source bucket.
primary_supply_created (series int): Cumulative Primary Supply zones observed since script start.
primary_demand_created (series int): Cumulative Primary Demand zones observed since script start.
secondary_supply_created (series int): Cumulative Secondary Supply zones observed since script start.
secondary_demand_created (series int): Cumulative Secondary Demand zones observed since script start.

SideSnapshot
One side of a baseline Research snapshot.
Fields:
loaded_zones (series int)
sampled_zones (series int)
active (series int)
fresh_active (series int)
wick_active (series int)
partial_active (series int)
consumed (series int)
ever_wick_tested (series int)
ever_partially_consumed (series int)
direct_path (series int)
untested_direct (series int)
tested_direct (series int)
partial_path (series int)
untested_direct_time_stat (series float)
untested_direct_time_n (series int)
tested_direct_time_stat (series float)
tested_direct_time_n (series int)
partial_path_time_stat (series float)
partial_path_time_n (series int)
tested_direct_wick_stat (series float)
tested_direct_wick_n (series int)
partial_path_depth_stat (series float)
partial_path_depth_n (series int)
swing_qualified (series int)
active_swing (series int)
consumed_swing (series int)
non_swing (series int)
consumed_non_swing (series int)
active_age_stat (series float)
active_age_n (series int)
consume_time_stat (series float)
consume_time_n (series int)
max_wick_depth_stat (series float)
max_wick_depth_n (series int)
max_partial_stat (series float)
max_partial_n (series int)
remaining_before_fill_stat (series float)
remaining_before_fill_n (series int)
swing_partial_stat (series float)
swing_partial_n (series int)
nonswing_partial_stat (series float)
nonswing_partial_n (series int)
swing_consume_time_stat (series float)
swing_consume_time_n (series int)
nonswing_consume_time_stat (series float)
nonswing_consume_time_n (series int)
pivot_h (series int)
pivot_hh (series int)
pivot_lh (series int)
pivot_l (series int)
pivot_hl (series int)
pivot_ll (series int)
trend_swing (series int)
chop_swing (series int)
swing_fresh_at_promotion (series int)
swing_wick_at_promotion (series int)
swing_partial_at_promotion (series int)
origin_confirm_hours_stat (series float)
origin_confirm_bars_stat (series float)
origin_confirm_n (series int)
confirm_wick_hours_stat (series float)
confirm_wick_bars_stat (series float)
confirm_wick_n (series int)
confirm_partial_hours_stat (series float)
confirm_partial_bars_stat (series float)
confirm_partial_n (series int)
confirm_swing_hours_stat (series float)
confirm_swing_bars_stat (series float)
confirm_swing_n (series int)
confirm_consume_hours_stat (series float)
confirm_consume_bars_stat (series float)
confirm_consume_n (series int)

Snapshot
Supply and Demand snapshot for one source filter.
Fields:
source_filter (series string)
statistic (series string)
supply (SideSnapshot)
demand (SideSnapshot)

リリースノート

v2

Removed:
renderAdaptiveLab(state, showLab, source, section, statistic, tablePosition, textSizeName, bgColor, textColor, accentColor, showLines, lineColor, supplyColor, demandColor, primaryTimeframe, secondaryTimeframe, secondaryEnabled, secondaryConfigured, secondaryIsHigher, nowTime, sampleLimit, sessionStandard, sessionShowSydney, sessionShowTokyo, sessionShowLondon, sessionShowNewYork, sessionCustomOpen, sessionCustomClose, sessionCustomTimezone, sessionCustomWeekdaysOnly, symbolTimezone)
Keeps individual Research sections as one table, but automatically turns All Sections into two coordinated bottom-corner dashboard panels.

リリースノート

v3

Added:
ConfluenceSnapshot
Fields:
sampled (series int)
same_overlap (series int)
nested_in_other (series int)
contains_other (series int)
partial_same_overlap (series int)
opposing_conflict (series int)
standalone (series int)
same_consumed (series int)
same_wick_tested (series int)
same_partial (series int)
same_swing (series int)
conflict_consumed (series int)
standalone_consumed (series int)
max_coverage_stat (series float)
max_coverage_n (series int)

Updated:
ZoneRecord
Factual Research record for one engine-owned zone. Exported because it is stored inside ResearchState.
Fields:
zone_id (series int)
side (series string)
source_context (series string)
source_timeframe (series string)
birth_time (series int)
confirmation_time (series int)
origin_event_time (series int)
confirmation_event_time (series int)
origin_source_bar (series int)
confirmation_source_bar (series int)
outer_boundary (series float)
original_inner_boundary (series float)
current_inner_boundary (series float)
pivot_class (series string)
wick_test_count (series int)
max_wick_pct (series float)
first_wick_time (series int)
first_wick_source_bar (series int)
last_wick_time (series int)
last_wick_source_bar (series int)
partial_count (series int)
max_partial_pct (series float)
first_partial_time (series int)
first_partial_source_bar (series int)
deepest_partial_time (series int)
deepest_partial_source_bar (series int)
is_swing (series bool)
swing_family (series string)
swing_confirmation_time (series int)
swing_confirmation_source_bar (series int)
lifecycle_state_at_swing (series string)
partial_pct_at_swing (series float)
wick_tested_at_swing (series bool)
consumed (series bool)
consumed_draw_time (series int)
consumed_event_time (series int)
consumed_source_bar (series int)
terminal_close (series float)
pathway (series string)
ps_same_direction_overlap (series bool)
ps_nested_in_other (series bool)
ps_contains_other (series bool)
ps_partial_same_overlap (series bool)
ps_opposing_conflict (series bool)
ps_max_same_coverage_pct (series float)

リリースノート

v4

Updated:
SideSnapshot
One side of a baseline Research snapshot.
Fields:
loaded_zones (series int)
sampled_zones (series int)
active (series int)
fresh_active (series int)
wick_active (series int)
partial_active (series int)
consumed (series int)
ever_wick_tested (series int)
ever_partially_consumed (series int)
wick_test_count_stat (series float)
wick_test_count_n (series int)
partial_event_count_stat (series float)
partial_event_count_n (series int)
direct_path (series int)
untested_direct (series int)
tested_direct (series int)
partial_path (series int)
untested_direct_time_stat (series float)
untested_direct_time_n (series int)
tested_direct_time_stat (series float)
tested_direct_time_n (series int)
partial_path_time_stat (series float)
partial_path_time_n (series int)
tested_direct_wick_stat (series float)
tested_direct_wick_n (series int)
partial_path_depth_stat (series float)
partial_path_depth_n (series int)
swing_qualified (series int)
active_swing (series int)
consumed_swing (series int)
non_swing (series int)
consumed_non_swing (series int)
active_age_stat (series float)
active_age_n (series int)
consume_time_stat (series float)
consume_time_n (series int)
max_wick_depth_stat (series float)
max_wick_depth_n (series int)
max_partial_stat (series float)
max_partial_n (series int)
remaining_before_fill_stat (series float)
remaining_before_fill_n (series int)
swing_partial_stat (series float)
swing_partial_n (series int)
nonswing_partial_stat (series float)
nonswing_partial_n (series int)
swing_consume_time_stat (series float)
swing_consume_time_n (series int)
nonswing_consume_time_stat (series float)
nonswing_consume_time_n (series int)
pivot_h (series int)
pivot_hh (series int)
pivot_lh (series int)
pivot_l (series int)
pivot_hl (series int)
pivot_ll (series int)
trend_swing (series int)
chop_swing (series int)
swing_fresh_at_promotion (series int)
swing_wick_at_promotion (series int)
swing_partial_at_promotion (series int)
origin_confirm_hours_stat (series float)
origin_confirm_bars_stat (series float)
origin_confirm_n (series int)
confirm_wick_hours_stat (series float)
confirm_wick_bars_stat (series float)
confirm_wick_n (series int)
confirm_partial_hours_stat (series float)
confirm_partial_bars_stat (series float)
confirm_partial_n (series int)
confirm_swing_hours_stat (series float)
confirm_swing_bars_stat (series float)
confirm_swing_n (series int)
confirm_consume_hours_stat (series float)
confirm_consume_bars_stat (series float)
confirm_consume_n (series int)

リリースノート

v5

Updated:
renderLab(state, showLab, source, section, statistic, tablePosition, textSizeName, bgColor, textColor, accentColor, showLines, lineColor, supplyColor, demandColor, primaryTimeframe, secondaryTimeframe, secondaryEnabled, secondaryConfigured, secondaryIsHigher, nowTime, sampleLimit, sessionStandard, sessionShowSydney, sessionShowTokyo, sessionShowLondon, sessionShowNewYork, sessionCustomOpen, sessionCustomClose, sessionCustomTimezone, sessionCustomWeekdaysOnly, symbolTimezone)
Parameters:
state (ResearchState)
showLab (bool)
source (simple string)
section (simple string)
statistic (simple string)
tablePosition (simple string)
textSizeName (simple string)
bgColor (color)
textColor (color)
accentColor (color)
showLines (bool)
lineColor (color)
supplyColor (color)
demandColor (color)
primaryTimeframe (simple string)
secondaryTimeframe (simple string)
secondaryEnabled (bool)
secondaryConfigured (bool)
secondaryIsHigher (bool)
nowTime (int)
sampleLimit (simple int)
sessionStandard (simple string)
sessionShowSydney (simple bool)
sessionShowTokyo (simple bool)
sessionShowLondon (simple bool)
sessionShowNewYork (simple bool)
sessionCustomOpen (simple string)
sessionCustomClose (simple string)
sessionCustomTimezone (simple string)
sessionCustomWeekdaysOnly (simple bool)
symbolTimezone (simple string)

SideSnapshot
One side of a baseline Research snapshot.
Fields:
loaded_zones (series int)
sampled_zones (series int)
sample_span_hours (series float)
sample_span_n (series int)
active (series int)
fresh_active (series int)
wick_active (series int)
partial_active (series int)
consumed (series int)
ever_wick_tested (series int)
ever_partially_consumed (series int)
wick_test_count_stat (series float)
wick_test_count_n (series int)
partial_event_count_stat (series float)
partial_event_count_n (series int)
untested_direct (series int)
tested_direct (series int)
partial_path (series int)
untested_direct_time_stat (series float)
untested_direct_bars_stat (series float)
untested_direct_time_n (series int)
tested_direct_time_stat (series float)
tested_direct_bars_stat (series float)
tested_direct_time_n (series int)
partial_path_time_stat (series float)
partial_path_bars_stat (series float)
partial_path_time_n (series int)
tested_direct_wick_stat (series float)
tested_direct_wick_n (series int)
partial_path_depth_stat (series float)
partial_path_depth_n (series int)
swing_qualified (series int)
active_swing (series int)
consumed_swing (series int)
non_swing (series int)
consumed_non_swing (series int)
active_age_stat (series float)
active_age_n (series int)
consume_time_stat (series float)
consume_time_n (series int)
max_wick_depth_stat (series float)
max_wick_depth_n (series int)
max_partial_stat (series float)
max_partial_n (series int)
swing_partial_stat (series float)
swing_partial_n (series int)
nonswing_partial_stat (series float)
nonswing_partial_n (series int)
swing_consume_time_stat (series float)
swing_consume_time_n (series int)
nonswing_consume_time_stat (series float)
nonswing_consume_time_n (series int)
pivot_h (series int)
pivot_hh (series int)
pivot_lh (series int)
pivot_l (series int)
pivot_hl (series int)
pivot_ll (series int)
trend_swing (series int)
chop_swing (series int)
swing_fresh_at_promotion (series int)
swing_wick_at_promotion (series int)
swing_partial_at_promotion (series int)
origin_confirm_hours_stat (series float)
origin_confirm_bars_stat (series float)
origin_confirm_n (series int)
confirm_wick_hours_stat (series float)
confirm_wick_bars_stat (series float)
confirm_wick_n (series int)
confirm_partial_hours_stat (series float)
confirm_partial_bars_stat (series float)
confirm_partial_n (series int)
confirm_swing_hours_stat (series float)
confirm_swing_bars_stat (series float)
confirm_swing_n (series int)
confirm_consume_hours_stat (series float)
confirm_consume_bars_stat (series float)
confirm_consume_n (series int)

リリースノート

v6

Updated:
SideSnapshot
One side of a baseline Research snapshot.
Fields:
loaded_zones (series int)
sampled_zones (series int)
sample_span_hours (series float)
sample_span_n (series int)
active (series int)
fresh_active (series int)
wick_active (series int)
partial_active (series int)
consumed (series int)
ever_wick_tested (series int)
ever_partially_consumed (series int)
wick_test_count_stat (series float)
wick_test_count_n (series int)
partial_event_count_stat (series float)
partial_event_count_n (series int)
untested_direct (series int)
tested_direct (series int)
partial_path (series int)
untested_direct_time_stat (series float)
untested_direct_bars_stat (series float)
untested_direct_time_n (series int)
tested_direct_time_stat (series float)
tested_direct_bars_stat (series float)
tested_direct_time_n (series int)
partial_path_time_stat (series float)
partial_path_bars_stat (series float)
partial_path_time_n (series int)
tested_direct_wick_stat (series float)
tested_direct_wick_n (series int)
partial_path_depth_stat (series float)
partial_path_depth_n (series int)
swing_qualified (series int)
active_swing (series int)
consumed_swing (series int)
non_swing (series int)
consumed_non_swing (series int)
active_age_stat (series float)
active_age_n (series int)
consume_time_stat (series float)
consume_time_n (series int)
max_wick_depth_stat (series float)
max_wick_depth_n (series int)
max_partial_stat (series float)
max_partial_n (series int)
swing_partial_stat (series float)
swing_partial_n (series int)
nonswing_partial_stat (series float)
nonswing_partial_n (series int)
swing_consume_time_stat (series float)
swing_consume_time_n (series int)
nonswing_consume_time_stat (series float)
nonswing_consume_time_n (series int)
pivot_h (series int)
pivot_hh (series int)
pivot_lh (series int)
pivot_l (series int)
pivot_hl (series int)
pivot_ll (series int)
trend_swing (series int)
chop_swing (series int)
swing_fresh_at_promotion (series int)
swing_wick_at_promotion (series int)
swing_partial_at_promotion (series int)
swing_consumed_at_promotion (series int)
origin_confirm_hours_stat (series float)
origin_confirm_bars_stat (series float)
origin_confirm_n (series int)
confirm_wick_hours_stat (series float)
confirm_wick_bars_stat (series float)
confirm_wick_n (series int)
confirm_partial_hours_stat (series float)
confirm_partial_bars_stat (series float)
confirm_partial_n (series int)
confirm_swing_hours_stat (series float)
confirm_swing_bars_stat (series float)
confirm_swing_n (series int)
confirm_consume_hours_stat (series float)
confirm_consume_bars_stat (series float)
confirm_consume_n (series int)

免責事項

免責事項