From c985ffba27d8f524559b3dc39e0f3570d57f826f Mon Sep 17 00:00:00 2001
From: stedif <stefano.difrischia@inaf.it>
Date: Thu, 9 Mar 2023 09:49:44 +0100
Subject: [PATCH] L2SS-1200: improve docs

---
 .../tangostationcontrol/devices/antennafield.py             | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tangostationcontrol/tangostationcontrol/devices/antennafield.py b/tangostationcontrol/tangostationcontrol/devices/antennafield.py
index 761448827..6eac0d142 100644
--- a/tangostationcontrol/tangostationcontrol/devices/antennafield.py
+++ b/tangostationcontrol/tangostationcontrol/devices/antennafield.py
@@ -1747,19 +1747,25 @@ class AntennaToRecvMapper(object):
 
         mapped_values = numpy.array(default_values)
 
+        # If mapping is based on only one map, then insert the value
+        # provided by the map
         if len(value_mapping) == 1:
             for idx, mapping in enumerate(value_mapping[0]):
                 recv = mapping[0]
                 rcu = mapping[1]
                 if recv > 0:
                     mapped_values[idx] = recv_results[recv - 1][rcu]
+        # If mapping is based on both power and control maps
         if len(value_mapping) == 2:
             # Assuming mapper lists are always in the following order:
             # [Control_Mapping, Power_Mapping]
             [control_mapping, power_mapping] = value_mapping
             for idx, mapping in enumerate(control_mapping):
+                # Store index and values of both mappings
                 [recv_control, rcu_control] = mapping
                 [recv_power, rcu_power] = power_mapping[idx]
+                # Insert the two values in the mapped array
+                # as (rcu_control_val, rcu_power_val)
                 if recv_control > 0:
                     mapped_values[idx][0] = recv_results[recv_control - 1][rcu_control]
                 if recv_power > 0:
-- 
GitLab