efind Namespace Reference

Do a quick, sequential, numerical (not symbolic) exploration of some electronic component values to propose solutions that use standard, inexpensive parts. More...

Classes
class	CalculateCall
	A callable with any number of floating-point arguments, returning a float. More...
class	Capacitor
class	Component
	A component, without knowledge of its value - only bounds and defining formula. More...
class	ComponentValue
	A value associated with a component - to track approximated values. More...
class	Output
	A calculated parameter - potentially but not necessarily a circuit output - to be calculated and checked for error in the solution ranking process. More...
class	Resistor
class	Solver
	Basic recursive solver class that does a brute-force search through some component values. More...

Functions
int	bisect_lower (Sequence[float] a, float x)
	Run bisect, but use one index before the return value of bisect_left More...
tuple[Optional[int], float]	approximate (float x, Sequence[float] series)
	Approximate a value by using the given series. More...
str	fmt_eng (float x, str unit, int sig=2)
	Format a number in engineering (SI) notation. More...

Variables
tuple	E3 = (1.0, 2.2, 4.7)
tuple	E6 = (1.0, 1.5, 2.2, 3.3, 4.7, 6.8)
tuple	E12 = (1.0, 1.2, 1.5, 1.8, 2.2, 2.7, 3.3, 3.9, 4.7, 5.6, 6.8, 8.2)
tuple	E24
tuple	E48
tuple	E96

Detailed Description

Do a quick, sequential, numerical (not symbolic) exploration of some electronic component values to propose solutions that use standard, inexpensive parts.

Function Documentation

approximate()

tuple[Optional[int], float] efind.approximate	(	float	x,
		Sequence[float]	series
	)

Approximate a value by using the given series.

Parameters

x	Any positive value
series	Any of E3 through E96

Returns

An integer index into the series for the element lesser than or equal to the value's mantissa, and the value's decade - a power of ten

Definition at line 69 of file efind.py.

bisect_lower()

int efind.bisect_lower	(	Sequence[float]	a,
		float	x
	)

Run bisect, but use one index before the return value of bisect_left

Parameters

a	The sorted haystack
x	The needle

Returns

The index of the array element that equals or is lesser than x

Definition at line 53 of file efind.py.

fmt_eng()

str efind.fmt_eng	(	float	x,
		str	unit,
		int	sig = 2
	)

Format a number in engineering (SI) notation.

Parameters

x	Any number
unit	The quantity unit (Hz, A, etc.)
sig	Number of significant digits to show

Returns

The formatted string

Definition at line 88 of file efind.py.

Variable Documentation

E12

tuple efind.E12 = (1.0, 1.2, 1.5, 1.8, 2.2, 2.7, 3.3, 3.9, 4.7, 5.6, 6.8, 8.2)

Definition at line 27 of file efind.py.

E24

tuple efind.E24

Initial value:

=  (
    1.0, 1.1, 1.2, 1.3, 1.5, 1.6, 1.8, 2.0, 2.2, 2.4, 2.7, 3.0,
    3.3, 3.6, 3.9, 4.3, 4.7, 5.1, 5.6, 6.2, 6.8, 7.5, 8.2, 9.1,
)

Definition at line 29 of file efind.py.

E3

tuple efind.E3 = (1.0, 2.2, 4.7)

Definition at line 23 of file efind.py.

E48

tuple efind.E48

Initial value:

=  (
    1.00, 1.05, 1.10, 1.15, 1.21, 1.27, 1.33, 1.40, 1.47, 1.54, 1.62, 1.69,
    1.78, 1.87, 1.96, 2.05, 2.15, 2.26, 2.37, 2.49, 2.61, 2.74, 2.87, 3.01,
    3.16, 3.32, 3.48, 3.65, 3.83, 4.02, 4.22, 4.42, 4.64, 4.87, 5.11, 5.36,
    5.62, 5.90, 6.19, 6.49, 6.81, 7.15, 7.50, 7.87, 8.25, 8.66, 9.09, 9.53,
)

Definition at line 34 of file efind.py.

E6

tuple efind.E6 = (1.0, 1.5, 2.2, 3.3, 4.7, 6.8)

Definition at line 25 of file efind.py.

E96

tuple efind.E96

Initial value:

=  (
    1.00, 1.02, 1.05, 1.07, 1.10, 1.13, 1.15, 1.18, 1.21, 1.24, 1.27, 1.30,
    1.33, 1.37, 1.40, 1.43, 1.47, 1.50, 1.54, 1.58, 1.62, 1.65, 1.69, 1.74,
    1.78, 1.82, 1.87, 1.91, 1.96, 2.00, 2.05, 2.10, 2.15, 2.21, 2.26, 2.32,
    2.37, 2.43, 2.49, 2.55, 2.61, 2.67, 2.74, 2.80, 2.87, 2.94, 3.01, 3.09,
    3.16, 3.24, 3.32, 3.40, 3.48, 3.57, 3.65, 3.74, 3.83, 3.92, 4.02, 4.12,
    4.22, 4.32, 4.42, 4.53, 4.64, 4.75, 4.87, 4.99, 5.11, 5.23, 5.36, 5.49,
    5.62, 5.76, 5.90, 6.04, 6.19, 6.34, 6.49, 6.65, 6.81, 6.98, 7.15, 7.32,
    7.50, 7.68, 7.87, 8.06, 8.25, 8.45, 8.66, 8.87, 9.09, 9.31, 9.53, 9.76,
)

Definition at line 41 of file efind.py.