new snippets

docs/snippets/all/reference/dataframe_query.rs

@@ -1,7 +1,5 @@
 //! Query and display the first 10 rows of a recording.
 
-#![allow(clippy::unwrap_used)]
-
 use rerun::{
     dataframe::{QueryCache, QueryEngine, QueryExpression, SparseFillStrategy, Timeline},
     ChunkStore, ChunkStoreConfig, VersionPolicy,
@@ -18,7 +16,9 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
         path_to_rrd,
         VersionPolicy::Warn,
     )?;
-    let (_, store) = stores.first_key_value().unwrap();
+    let Some((_, store)) = stores.first_key_value() else {
+        return Ok(());
+    };
 
     let query_cache = QueryCache::new(store);
     let query_engine = QueryEngine {

docs/snippets/all/reference/dataframe_save_blueprint.py

@@ -0,0 +1,17 @@
+"""Craft a blueprint with the python API and save it to a file for future use."""
+
+import sys
+
+import rerun.blueprint as rrb
+
+path_to_rbl = sys.argv[1]
+
+rrb.Blueprint(
+    rrb.DataframeView(
+        origin="/",
+        query=rrb.archetypes.DataframeQuery(
+            timeline="log_time",
+            apply_latest_at=True,
+        ),
+    ),
+).save("rerun_example_dataframe_view_query", path_to_rbl)

docs/snippets/all/reference/dataframe_view_query.py

@@ -0,0 +1,24 @@
+"""Query and display the first 10 rows of a recording in a dataframe view."""
+
+import sys
+
+import rerun as rr
+import rerun.blueprint as rrb
+
+path_to_rrd = sys.argv[1]
+
+rr.init("rerun_example_dataframe_view_query", spawn=True)
+
+rr.log_file_from_path(path_to_rrd)
+
+blueprint = rrb.Blueprint(
+    rrb.DataframeView(
+        origin="/",
+        query=rrb.archetypes.DataframeQuery(
+            timeline="log_time",
+            apply_latest_at=True,
+        ),
+    ),
+)
+
+rr.send_blueprint(blueprint)

docs/snippets/all/reference/dataframe_view_query_external.cpp

@@ -0,0 +1,27 @@
+//! Query and display the first 10 rows of a recording in a dataframe view.
+//!
+//! The blueprint is being loaded from an existing blueprint recording file.
+
+// ./dataframe_view_query_external /tmp/dna.rrd /tmp/dna.rbl
+
+#include <string>
+
+#include <rerun.hpp>
+
+int main(int argc, char** argv) {
+    if (argc < 3) {
+        return 1;
+    }
+
+    std::string path_to_rrd = argv[1];
+    std::string path_to_rbl = argv[2];
+
+    const auto rec = rerun::RecordingStream("rerun_example_dataframe_view_query_external");
+    rec.spawn().exit_on_failure();
+
+    // Log the files
+    rec.log_file_from_path(path_to_rrd);
+    rec.log_file_from_path(path_to_rbl);
+
+    return 0;
+}

docs/snippets/all/reference/dataframe_view_query_external.py

@@ -0,0 +1,19 @@
+"""
+Query and display the first 10 rows of a recording in a dataframe view.
+
+The blueprint is being loaded from an existing blueprint recording file.
+"""
+
+# python dataframe_view_query_external.py /tmp/dna.rrd /tmp/dna.rbl
+
+import sys
+
+import rerun as rr
+
+path_to_rrd = sys.argv[1]
+path_to_rbl = sys.argv[2]
+
+rr.init("rerun_example_dataframe_view_query_external", spawn=True)
+
+rr.log_file_from_path(path_to_rrd)
+rr.log_file_from_path(path_to_rbl)

docs/snippets/all/reference/dataframe_view_query_external.rs

@@ -0,0 +1,20 @@
+//! Query and display the first 10 rows of a recording in a dataframe view.
+//!
+//! The blueprint is being loaded from an existing blueprint recording file.
+
+// cargo r -p snippets -- dataframe_view_query_external /tmp/dna.rrd /tmp/dna.rbl
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let args = std::env::args().collect::<Vec<_>>();
+
+    let path_to_rrd = &args[1];
+    let path_to_rbl = &args[2];
+
+    let rec = rerun::RecordingStreamBuilder::new("rerun_example_dataframe_view_query_external")
+        .spawn()?;
+
+    rec.log_file_from_path(path_to_rrd, None /* prefix */, false /* static */)?;
+    rec.log_file_from_path(path_to_rbl, None /* prefix */, false /* static */)?;
+
+    Ok(())
+}

docs/snippets/snippets.toml

@@ -42,7 +42,22 @@ views = [
   "rust",
   "py",
 ]
-"reference/dataframe_query" = [ # Requires RRD files, which are unstable
+"reference/dataframe_query" = [ # No output
+  "cpp",
+  "rust",
+  "py",
+]
+"reference/dataframe_save_blueprint" = [ # No output
+  "cpp",
+  "rust",
+  "py",
+]
+"reference/dataframe_view_query" = [ # No output
+  "cpp",
+  "rust",
+  "py",
+]
+"reference/dataframe_view_query_external" = [ # No output
   "cpp",
   "rust",
   "py",