Resonant Frequency & Electrical Impedance

electronics/electrical_impedance.py

@@ -0,0 +1,46 @@
+"""Electrical impedance is the measure of the opposition that a
+circuit presents to a current when a voltage is applied.
+Impedance extends the concept of resistance to alternating current (AC) circuits.
+Source: https://en.wikipedia.org/wiki/Electrical_impedance
+"""
+
+from __future__ import annotations
+
+from math import pow, sqrt
+
+
+def electrical_impedance(
+    resistance: float, reactance: float, impedance: float
+) -> dict[str, float]:
+    """
+    Apply Electrical Impedance formula, on any two given electrical values,
+    which can be resistance, reactance, and impedance, and then in a Python dict
+    return name/value pair of the zero value.
+
+    >>> electrical_impedance(3,4,0)
+    {'impedance': 5.0}
+    >>> electrical_impedance(0,4,5)
+    {'resistance': 3.0}
+    >>> electrical_impedance(3,0,5)
+    {'reactance': 4.0}
+    >>> electrical_impedance(3,4,5)
+    Traceback (most recent call last):
+      ...
+    ValueError: One and only one argument must be 0
+    """
+    if (resistance, reactance, impedance).count(0) != 1:
+        raise ValueError("One and only one argument must be 0")
+    if resistance == 0:
+        return {"resistance": sqrt(pow(impedance, 2) - pow(reactance, 2))}
+    elif reactance == 0:
+        return {"reactance": sqrt(pow(impedance, 2) - pow(resistance, 2))}
+    elif impedance == 0:
+        return {"impedance": sqrt(pow(resistance, 2) + pow(reactance, 2))}
+    else:
+        raise ValueError("Exactly one argument must be 0")
+
+
+if __name__ == "__main__":
+    import doctest
+
+    doctest.testmod()

electronics/resonant_frequency.py

@@ -0,0 +1,50 @@
+# https://en.wikipedia.org/wiki/LC_circuit
+
+"""An LC circuit, also called a resonant circuit, tank circuit, or tuned circuit,
+is an electric circuit consisting of an inductor, represented by the letter L,
+and a capacitor, represented by the letter C, connected together.
+The circuit can act as an electrical resonator, an electrical analogue of a
+tuning fork, storing energy oscillating at the circuit's resonant frequency.
+Source: https://en.wikipedia.org/wiki/LC_circuit
+"""
+
+from __future__ import annotations
+
+from math import pi, sqrt
+
+
+def resonant_frequency(inductance: float, capacitance: float) -> tuple:
+    """
+    This function can calculate the resonant frequency of LC circuit,
+    for the given value of inductance and capacitnace.
+
+    Examples are given below:
+    >>> resonant_frequency(inductance=10, capacitance=5)
+    ('Resonant frequency', 0.022507907903927652)
+    >>> resonant_frequency(inductance=0, capacitance=5)
+    Traceback (most recent call last):
+      ...
+    ValueError: Inductance cannot be 0 or negative
+    >>> resonant_frequency(inductance=10, capacitance=0)
+    Traceback (most recent call last):
+      ...
+    ValueError: Capacitance cannot be 0 or negative
+    """
+
+    if inductance <= 0:
+        raise ValueError("Inductance cannot be 0 or negative")
+
+    elif capacitance <= 0:
+        raise ValueError("Capacitance cannot be 0 or negative")
+
+    else:
+        return (
+            "Resonant frequency",
+            float(1 / (2 * pi * (sqrt(inductance * capacitance)))),
+        )
+
+
+if __name__ == "__main__":
+    import doctest
+
+    doctest.testmod()