From 1871a6a097c46a20b0c2a97bc3e9ba719313d699 Mon Sep 17 00:00:00 2001
From: Jacan Chaplais <jacan.chaplais@gmail.com>
Date: Fri, 1 Mar 2024 11:16:09 +0000
Subject: [PATCH] cached computed Graphicle.final #174

---
 graphicle/data.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/graphicle/data.py b/graphicle/data.py
index d8a4690..50504cd 100644
--- a/graphicle/data.py
+++ b/graphicle/data.py
@@ -2748,11 +2748,16 @@ def hard_mask(self) -> MaskGroup:
         """
         return self.particles.status.hard_mask
 
-    @property
+    @fn.cached_property
     def final(self) -> MaskArray:
         """Boolean array indicating final state in particle set."""
         data = self.particles.final
         if (not data) and self.adj:
+            warnings.warn(
+                "Explicit final mask missing. Computing from adjacency. "
+                "This result will be cached for the Graphicle object, but not "
+                "the underlying ParticleSet."
+            )
             return self.adj.leaves
         return data