rollup_mass_props_unc: Roll up mass properties uncertainties

In massProps: Calculate Mass Properties and Uncertainties of Tree Structures

Roll up mass properties uncertainties

Description

rollup_mass_props_unc() rolls up mass properties uncertainties in a data frame such that the uncertainties of each non-leaf vertex element is the aggregation of the mass properties and uncertainties of its child elements.

The difference between rollup_mass_props_unc() and rollup_mass_props_and_unc() is that rollup_mass_props_unc() expects the mass properties in its input to have been rolled up, whereas rollup_mass_props_and_unc() performs the mass properties rollup itself.

Usage

rollup_mass_props_unc(
  tree,
  df,
  validate_df = validate_mass_props_and_unc_table,
  ...
)

Arguments

tree	An 'igraph' tree whose vertices are named as the values of the id column of df and whose directed edges point from child id to parent id.
df	A data frame with (at least) these columns: id, mass, Cx, Cy, Cz, Ixx, Iyy, Izz, Ixy, Ixz, Iyz, POIconv, Ipoint.
validate_df	A validator for the tree and table, default validate_mass_props_and_unc_table()
...	Other parameters passed to rollupTree::rollup()

Value

The updated data frame

Examples

mp_ru <- rollup_mass_props(mp_tree_small, mp_table_small)
rollup_mass_props_unc(mp_tree_small, mp_ru)

massProps documentation built on April 4, 2025, 1:45 a.m.