Coverage for src / tracekit / exploratory / __init__.py: 100%

1"""Exploratory analysis for unknown and legacy signals. 

2 

3This package provides tools for analyzing signals from unknown systems, 

4legacy hardware, and corrupted or noisy data. 

5 

6- UNKNOWN-001: Binary Field Detection 

7- UNKNOWN-002: Protocol Auto-Detection with Fuzzy Matching 

8- UNKNOWN-003: Unknown Signal Characterization 

9- UNKNOWN-004: Pattern Frequency Analysis 

10- UNKNOWN-005: Reverse Engineering Workflow 

11""" 

12 

13from tracekit.exploratory.error_recovery import ( 

14 ErrorContext, 

15 partial_decode, 

16 recover_corrupted_data, 

17 retry_with_adjustment, 

18) 

19from tracekit.exploratory.fuzzy import ( 

20 fuzzy_pattern_match, 

21 fuzzy_protocol_detect, 

22 fuzzy_timing_match, 

23) 

24from tracekit.exploratory.fuzzy_advanced import ( 

25 AlignmentResult, 

26 PositionAnalysis, 

27 VariantCharacterization, 

28 align_sequences, 

29 align_two_sequences, 

30 characterize_variants, 

31 compute_conservation_scores, 

32) 

33from tracekit.exploratory.legacy import ( 

34 assess_signal_quality, 

35 characterize_test_points, 

36 cross_correlate_multi_reference, 

37 detect_logic_families_multi_channel, 

38) 

39from tracekit.exploratory.parse import ( 

40 DecodedFrame, 

41 ErrorTolerance, 

42 TimestampCorrection, 

43 correct_timestamp_jitter, 

44 decode_with_error_tolerance, 

45) 

46from tracekit.exploratory.recovery import ( 

47 ErrorAnalysis, 

48 ErrorPattern, 

49 analyze_bit_errors, 

50 generate_error_visualization_data, 

51) 

52from tracekit.exploratory.sync import ( 

53 PacketParseResult, 

54 RecoveryStrategy, 

55 SyncMatch, 

56 fuzzy_sync_search, 

57 parse_variable_length_packets, 

58) 

59from tracekit.exploratory.unknown import ( 

60 analyze_pattern_frequency, 

61 characterize_unknown_signal, 

62 detect_binary_fields, 

63 reverse_engineer_protocol, 

64) 

65 

66__all__ = [ 

67 # Advanced fuzzy (FUZZY-004, FUZZY-005) 

68 "AlignmentResult", 

69 "DecodedFrame", 

70 "ErrorAnalysis", 

71 # Error recovery 

72 "ErrorContext", 

73 # DAQ - Bit error analysis (DAQ-005) 

74 "ErrorPattern", 

75 # DAQ - Error-tolerant parsing (DAQ-003, DAQ-004) 

76 "ErrorTolerance", 

77 "PacketParseResult", 

78 "PositionAnalysis", 

79 "RecoveryStrategy", 

80 # DAQ - Fuzzy sync search (DAQ-001, DAQ-002) 

81 "SyncMatch", 

82 "TimestampCorrection", 

83 "VariantCharacterization", 

84 "align_sequences", 

85 "align_two_sequences", 

86 "analyze_bit_errors", 

87 # Unknown signal analysis 

88 "analyze_pattern_frequency", 

89 # Legacy analysis 

90 "assess_signal_quality", 

91 "characterize_test_points", 

92 "characterize_unknown_signal", 

93 "characterize_variants", 

94 "compute_conservation_scores", 

95 "correct_timestamp_jitter", 

96 "cross_correlate_multi_reference", 

97 "decode_with_error_tolerance", 

98 "detect_binary_fields", 

99 "detect_logic_families_multi_channel", 

100 # Fuzzy matching 

101 "fuzzy_pattern_match", 

102 "fuzzy_protocol_detect", 

103 "fuzzy_sync_search", 

104 "fuzzy_timing_match", 

105 "generate_error_visualization_data", 

106 "parse_variable_length_packets", 

107 "partial_decode", 

108 "recover_corrupted_data", 

109 "retry_with_adjustment", 

110 "reverse_engineer_protocol", 

111]