chore: import upstream snapshot with attribution

examples/python/incremental_logging/incremental_logging.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+"""Showcases how to incrementally log data belonging to the same archetype, and re-use some or all of it across frames."""
+
+from __future__ import annotations
+
+import argparse
+
+from numpy.random import default_rng
+
+import rerun as rr
+
+parser = argparse.ArgumentParser(description="Showcases how to incrementally log data belonging to the same archetype.")
+rr.script_add_args(parser)
+args = parser.parse_args()
+
+
+README = """\
+# Incremental Logging
+
+This example showcases how to incrementally log data belonging to the same archetype, and re-use some or all of it across frames.
+
+It was logged with the following code:
+```python
+# Only log colors and radii once.
+# Logging as static would also work (i.e. `static=True`).
+rr.set_time("frame_nr", sequence=0)
+rr.log("points", rr.Points3D.from_fields(colors=0xFF0000FF, radii=0.1))
+
+rng = default_rng(12345)
+
+# Then log only the points themselves each frame.
+#
+# They will automatically re-use the colors and radii logged at the beginning.
+for i in range(10):
+    rr.set_time("frame_nr", sequence=i)
+    rr.log("points", rr.Points3D.from_fields(positions=rng.uniform(-5, 5, size=[10, 3])))
+```
+
+Move the time cursor around, and notice how the colors and radii from frame 0 are still picked up by later frames, while the points themselves keep changing every frame.
+"""
+
+# ---
+
+rr.script_setup(args, "rerun_example_incremental_logging")
+
+rr.log("readme", rr.TextDocument(README, media_type=rr.MediaType.MARKDOWN), static=True)
+
+# Only log colors and radii once.
+# Logging as static would also work (i.e. `static=True`).
+rr.set_time("frame_nr", sequence=0)
+rr.log("points", rr.Points3D.from_fields(colors=0xFF0000FF, radii=0.1))
+
+rng = default_rng(12345)
+
+# Then log only the points themselves each frame.
+#
+# They will automatically re-use the colors and radii logged at the beginning.
+for i in range(10):
+    rr.set_time("frame_nr", sequence=i)
+    rr.log("points", rr.Points3D.from_fields(positions=rng.uniform(-5, 5, size=[10, 3])))
+
+rr.script_teardown(args)