re_viewer 0.4.0

The Rerun viewer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use re_arrow_store::{LatestAtQuery, TimeInt};
use re_data_store::{EntityPath, LogDb, Timeline};
use re_log_types::{
    component_types::{
        Box3D, LineStrip2D, LineStrip3D, Point2D, Point3D, Rect2D, Scalar, Tensor, TensorTrait,
        TextEntry,
    },
    Arrow3D, Component, Mesh3D, Transform,
};
use re_query::query_entity_with_primary;

#[derive(
    Debug, Default, PartialOrd, Ord, enumset::EnumSetType, serde::Deserialize, serde::Serialize,
)]
pub enum ViewCategory {
    // Ordered by dimensionality
    //
    /// Text log view (text over time)
    Text,

    /// Time series plot (scalar over time)
    TimeSeries,

    /// Bar-chart plots made from 1D tensor data
    BarChart,

    /// 2D or 3D view
    #[default]
    Spatial,

    /// High-dimensional tensor view
    Tensor,
}

impl ViewCategory {
    pub fn icon(self) -> &'static re_ui::Icon {
        match self {
            ViewCategory::Text => &re_ui::icons::SPACE_VIEW_TEXT,
            ViewCategory::TimeSeries => &re_ui::icons::SPACE_VIEW_SCATTERPLOT,
            ViewCategory::BarChart => &re_ui::icons::SPACE_VIEW_HISTOGRAM,
            ViewCategory::Spatial => &re_ui::icons::SPACE_VIEW_3D,
            ViewCategory::Tensor => &re_ui::icons::SPACE_VIEW_TENSOR,
        }
    }
}

impl std::fmt::Display for ViewCategory {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(match self {
            ViewCategory::Text => "Text",
            ViewCategory::TimeSeries => "Time Series",
            ViewCategory::BarChart => "Bar Chart",
            ViewCategory::Spatial => "Spatial",
            ViewCategory::Tensor => "Tensor",
        })
    }
}

pub type ViewCategorySet = enumset::EnumSet<ViewCategory>;

// TODO(cmc): these `categorize_*` functions below are pretty dangerous: make sure you've covered
// all possible `ViewCategory` values, or you're in for a bad time..!

pub fn categorize_entity_path(
    timeline: Timeline,
    log_db: &LogDb,
    entity_path: &EntityPath,
) -> ViewCategorySet {
    crate::profile_function!();

    let mut set = ViewCategorySet::default();

    for component in log_db
        .entity_db
        .data_store
        .all_components(&timeline, entity_path)
        .unwrap_or_default()
    {
        if component == TextEntry::name() {
            set.insert(ViewCategory::Text);
        } else if component == Scalar::name() {
            set.insert(ViewCategory::TimeSeries);
        } else if component == Point2D::name()
            || component == Point3D::name()
            || component == Rect2D::name()
            || component == Box3D::name()
            || component == LineStrip2D::name()
            || component == LineStrip3D::name()
            || component == Mesh3D::name()
            || component == Arrow3D::name()
            || component == Transform::name()
        {
            set.insert(ViewCategory::Spatial);
        } else if component == Tensor::name() {
            let timeline_query = LatestAtQuery::new(timeline, TimeInt::MAX);

            if let Ok(entity_view) = query_entity_with_primary::<Tensor>(
                &log_db.entity_db.data_store,
                &timeline_query,
                entity_path,
                &[],
            ) {
                if let Ok(iter) = entity_view.iter_primary() {
                    for tensor in iter.flatten() {
                        if tensor.is_vector() {
                            set.insert(ViewCategory::BarChart);
                        } else if tensor.is_shaped_like_an_image() {
                            set.insert(ViewCategory::Spatial);
                        } else {
                            set.insert(ViewCategory::Tensor);
                        }
                    }
                }
            }
        }
    }

    set
}