Files
2026-07-13 13:05:14 +08:00

63 lines
2.0 KiB
Python
Executable File

#!/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)