From 3e36aa1b05a1f421d49ea1100e9465b81843bca5 Mon Sep 17 00:00:00 2001
From: Robert Moerland <r.moerland@lumicks.com>
Date: Mon, 4 Nov 2024 22:13:29 +0100
Subject: [PATCH] add docstring to _set_farfield

---
 .../pyoptics/trapping/plane_wave_field_calculation.py    | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/lumicks/pyoptics/trapping/plane_wave_field_calculation.py b/src/lumicks/pyoptics/trapping/plane_wave_field_calculation.py
index 0bc81d2..6d6d6e8 100644
--- a/src/lumicks/pyoptics/trapping/plane_wave_field_calculation.py
+++ b/src/lumicks/pyoptics/trapping/plane_wave_field_calculation.py
@@ -16,9 +16,9 @@
 
 
 def _set_farfield(theta: float, phi: float, polarization: Tuple[float, float], k: float):
-    # Create a FarFieldData object that contains a single pixel == single
-    # plane wave with angles theta and phi and with amplitude and
-    # polarization (E_theta, E_phi) given by `polarization`
+    """Create a FarFieldData object that contains a single pixel (= single
+    plane wave) with angles `theta` and `phi`, and with amplitude and polarization (E_theta, E_phi)
+    given by `polarization`"""
     cos_theta = np.atleast_2d(np.cos(theta))
     sin_theta = np.atleast_2d(np.sin(theta))
     cos_phi = np.atleast_2d(np.cos(phi))
@@ -51,9 +51,6 @@ def _plane_wave_field_factory(
     local_coordinates: LocalBeadCoordinates,
     internal: bool,
 ):
-
-    n_orders = n_orders
-
     local_coordinates = (
         InternalBeadCoordinates(local_coordinates)
         if internal