electronics

hktkzyx_toolbox.electronics

hktkzyx_toolbox.electronics.ESeriesValue

E series preferred value.

Follow the standard IEC 60063:2015. The preferred number is rounded by the following equation:

\[ V_n=10^{n/m} \]

where n is the series exponent, m is the series group size.

Parameters:

Name	Type	Description	Default
series_exponent	int	Series exponent.	required
series_size	int	Series size.	required
exponent	int	Exponent base on 10.	required
positive	bool	Non-negetive or not, by default True.	True

create(value: float, series: str = 'E96', round: str = 'nearest') -> ESeriesValue classmethod

Create a instance from float.

to_scalar(self)

Convert to scalar value.

hktkzyx_toolbox.electronics.LED

The LED electronic component.

Parameters:

Name	Type	Description	Default
name	str	Name of the LED.	required
id	Optional[Union[str, int]]	ID in LCSC. By default None.	None
voltage_current_relation	tuple[npt.ArrayLike, npt.ArrayLike]	The voltage current relation of LED. (voltages, currents) where voltages is the array_like of float and currents is the corresponding array_like of float.	required

cal_current(self, voltage: npt.ArrayLike) -> np.ndarray

Return current at given voltage.

Parameters:

Name	Type	Description	Default
voltage	npt.ArrayLike	Voltage in volts.	required

Returns:

Type	Description
np.ndarray	Return np.nan if voltage out of range.

cal_divider_resistance(self, power_voltage: npt.ArrayLike, work_current: npt.ArrayLike)

Return divider resistance.

Parameters:

Name	Type	Description	Default
power_voltage	npt.ArrayLike	Power voltage in volts.	required
work_current	npt.ArrayLike	Work current in amps.	required

cal_divider_resistance_range_if_power_supplied(self, power_voltage: npt.ArrayLike)

Return the divider resistance range.

power_voltage : array_like of float Power voltage in volts.

cal_voltage(self, current: npt.ArrayLike) -> np.ndarray

Return LED corresponding voltage at given current.

Parameters:

Name	Type	Description	Default
current	npt.ArrayLike	Current in amps.	required

Returns:

Type	Description
np.ndarray	Return np.nan if current out of range.

cal_work_current(self, power_voltage: npt.ArrayLike, divider_resistance: npt.ArrayLike)

Return divider resistance.

Parameters:

Name	Type	Description	Default
power_voltage	npt.ArrayLike	Power voltage in volts.	required
divider_resistance	npt.ArrayLike	Divider resistance in ohms.	required

cal_work_current_range_if_power_supplied(self, power_voltage: npt.ArrayLike)

Return the work current range.

power_voltage : array_like of float Power voltage in volt.

get_id(self)

Return store number.

get_name(self)

Return LED name.

is_current_valid(self, current: npt.ArrayLike) -> np.ndarray

Return whether current is valid.

is_power_voltage_enough(self, power_voltage: npt.ArrayLike) -> np.ndarray

Return whether power voltage is large enough.

is_voltage_valid(self, voltage: npt.ArrayLike) -> np.ndarray

Return whether voltage is valid.

query_least_power_voltage(self)

Return least power voltage.

validate_power_voltage(self, power_voltage: npt.ArrayLike)

Validate power voltage.

hktkzyx_toolbox.electronics.cal_significand_and_exponent(value: npt.ArrayLike)

Return significand and exponent of the value.

Examples:

(array(3.3), array(9))