Coverage for src / tracekit / analyzers / power / __init__.py: 100%

1"""Power analysis module for TraceKit. 

2 

3Provides comprehensive power analysis capabilities including: 

4- Basic power measurements (instantaneous, average, RMS, peak) 

5- AC power analysis (reactive, apparent, power factor) 

6- Switching loss analysis for power electronics 

7- Safe Operating Area (SOA) analysis 

8- Ripple measurement 

9- Efficiency calculations 

10 

11 

12Example: 

13 >>> from tracekit.analyzers.power import instantaneous_power, power_statistics 

14 >>> power_trace = instantaneous_power(voltage_trace, current_trace) 

15 >>> stats = power_statistics(power_trace) 

16 >>> print(f"Average power: {stats['average']:.2f} W") 

17""" 

18 

19from tracekit.analyzers.power.ac_power import ( 

20 apparent_power, 

21 displacement_power_factor, 

22 distortion_power_factor, 

23 phase_angle, 

24 power_factor, 

25 reactive_power, 

26 total_harmonic_distortion_power, 

27) 

28from tracekit.analyzers.power.basic import ( 

29 average_power, 

30 energy, 

31 instantaneous_power, 

32 peak_power, 

33 power_statistics, 

34 rms_power, 

35) 

36from tracekit.analyzers.power.conduction import ( 

37 conduction_loss, 

38 duty_cycle_weighted_loss, 

39 forward_voltage, 

40 mosfet_conduction_loss, 

41 on_resistance, 

42) 

43from tracekit.analyzers.power.efficiency import ( 

44 efficiency, 

45 multi_output_efficiency, 

46 power_conversion_efficiency, 

47) 

48from tracekit.analyzers.power.ripple import ( 

49 extract_ripple, 

50 ripple, 

51 ripple_frequency, 

52 ripple_percentage, 

53 ripple_statistics, 

54) 

55from tracekit.analyzers.power.soa import ( 

56 SOALimit, 

57 check_soa_violations, 

58 create_mosfet_soa, 

59 plot_soa, 

60 soa_analysis, 

61) 

62from tracekit.analyzers.power.switching import ( 

63 switching_energy, 

64 switching_frequency, 

65 switching_loss, 

66 total_switching_loss, 

67 turn_off_loss, 

68 turn_on_loss, 

69) 

70 

71__all__ = [ 

72 "SOALimit", 

73 "apparent_power", 

74 "average_power", 

75 "check_soa_violations", 

76 # Conduction 

77 "conduction_loss", 

78 "create_mosfet_soa", 

79 "displacement_power_factor", 

80 "distortion_power_factor", 

81 "duty_cycle_weighted_loss", 

82 # Efficiency 

83 "efficiency", 

84 "energy", 

85 "extract_ripple", 

86 "forward_voltage", 

87 # Basic power 

88 "instantaneous_power", 

89 "mosfet_conduction_loss", 

90 "multi_output_efficiency", 

91 "on_resistance", 

92 "peak_power", 

93 "phase_angle", 

94 "plot_soa", 

95 "power_conversion_efficiency", 

96 "power_factor", 

97 "power_statistics", 

98 # AC power 

99 "reactive_power", 

100 # Ripple 

101 "ripple", 

102 "ripple_frequency", 

103 "ripple_percentage", 

104 "ripple_statistics", 

105 "rms_power", 

106 # SOA 

107 "soa_analysis", 

108 "switching_energy", 

109 "switching_frequency", 

110 # Switching 

111 "switching_loss", 

112 "total_harmonic_distortion_power", 

113 "total_switching_loss", 

114 "turn_off_loss", 

115 "turn_on_loss", 

116]