Skip to contents

Attach structural grouping heuristics to snapshot observations

add_structural_groups.Rd

Adds lightweight structural grouping variables derived from filesystem path structure.

Usage

add_structural_groups(df)

Arguments

df

A data.frame containing a rel_path column.

Value

The input data.frame with additional columns:

structural_group

Filesystem-based structural grouping heuristic derived from the first two path components.

component

Immediate structural subdivision within the grouping.

Details

The function appends deterministic analytical grouping projections based on rel_path, helping organise observational filesystem Instantiations into operationally meaningful structural clusters.

This is a convenience wrapper around derive_structural_groups() for use in analytical and reconstruction workflows.

The function does not construct authoritative RiC Record Sets.

Instead, it derives lightweight structural grouping heuristics that may:

  • support exploratory analysis

  • help identify operational project boundaries

  • assist reconstruction of distributed working environments

  • provide candidate structures for later Record Set construction

The derived groupings reflect filesystem organisation rather than authoritative documentary arrangement or curatorial interpretation.

In RiC-aligned operational terms:

  • rows in observational snapshots represent filesystem Instantiations

  • rel_path acts as an operational locator associated with observed filesystem occurrences

  • structural_group and component provide deterministic structural grouping heuristics that may later support provenance-aware Record Set construction

Future versions of the package may replace or extend this logic with more explicit provenance-aware Record Set construction workflows (for example via create_record_set()).

See also

derive_structural_groups()