Merge pull request #778 from lsst-ts/tickets/DM-41802

Add quadrant property to M1M3 ForceActuator

doc/version-history.rst

@@ -4,6 +4,11 @@
 Version History
 ===============
 
+v21.0.0
+-------
+
+* Added qudrant property to M1M3 FATable.
+
 v20.1.0
 -------
 

python/lsst/ts/xml/tables/m1m3/fa_table.py

@@ -157,6 +157,16 @@ class ForceActuatorData:
     near_neighbors: list[int]
     far_neighbors: list[int]
 
+    @property
+    def quadrant(self) -> int:
+        """Returns actuator quadrant.
+        Returns
+        -------
+        quadrant : `int`
+            Actuator quadrant (1-4).
+        """
+        return self.actuator_id // 100
+
     def get_index(self, index_type: FAIndex) -> int | None:
         """Returns given index.
 

tests/test_Units.py

@@ -13,10 +13,13 @@
 # Enable colloquial Imperial units.
 astropy.units.imperial.enable()
 # Add rpm and gpm (gallon/min).
-rpm = astropy.units.def_unit('rpm', astropy.units.cycle / astropy.units.s)
-gpm = astropy.units.def_unit('gallon/min', astropy.units.imperial.gallon * 60 / astropy.units.s)
+rpm = astropy.units.def_unit("rpm", astropy.units.cycle / astropy.units.s)
+gpm = astropy.units.def_unit(
+    "gallon/min", astropy.units.imperial.gallon * 60 / astropy.units.s
+)
 astropy.units.add_enabled_units([rpm, gpm])
 
+
 def check_for_issues(csc: str, topic: str) -> str:
     jira = ""
     return jira

tests/test_tables_m1m3.py

@@ -50,6 +50,11 @@ def test_neighbors(self) -> None:
         self.assert_sorted(item2.near_neighbors_indices(FAIndex.X), [])
         self.assert_sorted(item2.only_far_neighbors_indices(FAIndex.X), [9])
 
+    def test_quadrant(self) -> None:
+        self.assertEqual(FATable[1].quadrant, 1)
+        self.assertEqual(FATable[45].quadrant, 2)
+        self.assertEqual(FATable[155].quadrant, 4)
+
 
 if __name__ == "__main__":
     unittest.main()