Archetype: A list of edges in a graph. More...

#include <rerun/archetypes/graph_edges.hpp>

Public Member Functions
	GraphEdges (GraphEdges &&other)=default

	GraphEdges (const GraphEdges &other)=default

GraphEdges &	operator= (const GraphEdges &other)=default

GraphEdges &	operator= (GraphEdges &&other)=default

	GraphEdges (Collection< rerun::components::GraphEdge > _edges)

GraphEdges	with_edges (const Collection< rerun::components::GraphEdge > &_edges) &&
	A list of node tuples.

GraphEdges	with_graph_type (const rerun::components::GraphType &_graph_type) &&
	Specifies if the graph is directed or undirected.

GraphEdges	with_many_graph_type (const Collection< rerun::components::GraphType > &_graph_type) &&
	This method makes it possible to pack multiple `graph_type` in a single component batch.

Collection< ComponentColumn >	columns (const Collection< uint32_t > &lengths_)
	Partitions the component data into multiple sub-batches.

Collection< ComponentColumn >	columns ()
	Partitions the component data into unit-length sub-batches.

Static Public Member Functions
static GraphEdges	update_fields ()
	Update only some specific fields of a `GraphEdges`.

static GraphEdges	clear_fields ()
	Clear all the fields of a `GraphEdges`.

Public Attributes
std::optional< ComponentBatch >	edges
	A list of node tuples.

std::optional< ComponentBatch >	graph_type
	Specifies if the graph is directed or undirected.

Static Public Attributes
static constexpr const char	ArchetypeName [] = "rerun.archetypes.GraphEdges"
	The name of the archetype as used in `ComponentDescriptor`s.

static constexpr auto	Descriptor_edges
	`ComponentDescriptor` for the `edges` field.

static constexpr auto	Descriptor_graph_type
	`ComponentDescriptor` for the `graph_type` field.

Detailed Description

Archetype: A list of edges in a graph.

By default, edges are undirected.

Example

Simple directed graph

#include <rerun.hpp>
 
int main() {
    const auto rec = rerun::RecordingStream("rerun_example_graph_directed");
    rec.spawn().exit_on_failure();
 
    rec.log(
        "simple",
        rerun::GraphNodes({"a", "b", "c"})
            .with_positions({{0.0, 100.0}, {-100.0, 0.0}, {100.0, 0.0}})
            .with_labels({"A", "B", "C"}),
        rerun::GraphEdges({{"a", "b"}, {"b", "c"}, {"c", "a"}})
            // Graphs are undirected by default.
            .with_graph_type(rerun::components::GraphType::Directed)
    );
}

Member Function Documentation

◆ with_graph_type()

GraphEdges rerun::archetypes::GraphEdges::with_graph_type ( const rerun::components::GraphType & _graph_type ) &&

inline

Specifies if the graph is directed or undirected.

If no components::GraphType is provided, the graph is assumed to be undirected.

◆ with_many_graph_type()

GraphEdges rerun::archetypes::GraphEdges::with_many_graph_type ( const Collection< rerun::components::GraphType > & _graph_type ) &&

inline

This method makes it possible to pack multiple graph_type in a single component batch.

This only makes sense when used in conjunction with columns. with_graph_type should be used when logging a single row's worth of data.

◆ columns() [1/2]

Collection< ComponentColumn > rerun::archetypes::GraphEdges::columns ( const Collection< uint32_t > & lengths_ )

Partitions the component data into multiple sub-batches.

Specifically, this transforms the existing ComponentBatch data into ComponentColumns instead, via ComponentBatch::partitioned.

This makes it possible to use RecordingStream::send_columns to send columnar data directly into Rerun.

The specified lengths must sum to the total length of the component batch.

◆ columns() [2/2]

Collection< ComponentColumn > rerun::archetypes::GraphEdges::columns ( )

Partitions the component data into unit-length sub-batches.

This is semantically similar to calling columns with std::vector<uint32_t>(n, 1), where n is automatically guessed.

Member Data Documentation

◆ graph_type

std::optional<ComponentBatch> rerun::archetypes::GraphEdges::graph_type

Specifies if the graph is directed or undirected.

If no components::GraphType is provided, the graph is assumed to be undirected.

◆ Descriptor_edges

constexpr auto rerun::archetypes::GraphEdges::Descriptor_edges

staticconstexpr

Initial value:

= ComponentDescriptor(
            ArchetypeName, "GraphEdges:edges", Loggable<rerun::components::GraphEdge>::ComponentType
        )

ComponentDescriptor for the edges field.

◆ Descriptor_graph_type

constexpr auto rerun::archetypes::GraphEdges::Descriptor_graph_type