View source: R/summarise_observed_activity.R
| summarise_observed_activity | R Documentation |
summarise_observed_activity() summarises observed file-level
modification evidence by time period and structural grouping.
The function is intended as a temporal contextualisation step. It does not infer archival Activities, Events, Record Sets, or provenance relations. Instead, it produces candidate activity summaries that may support later human review, semantic stabilisation, or RiC-aligned modelling.
summarise_observed_activity(
df,
extensions = c("r", "bak"),
path_col = "rel_path",
time_unit = c("week", "month", "day", "year"),
max_files = 20
)
summarize_observed_activity(
df,
extensions = c("r", "bak"),
path_col = "rel_path",
time_unit = c("week", "month", "day", "year"),
max_files = 20
)
df |
A
If present, |
extensions |
Character vector of file extensions to include, without leading dots. Matching is case-insensitive. |
path_col |
Character scalar. Name of the column containing
paths used to derive structural groupings. Defaults to |
time_unit |
Character scalar. One of |
max_files |
Integer. Maximum number of file names displayed in each summary row. |
Aggregates filesystem observations into reproducible temporal summaries grouped by structural path context.
The function derives:
period, a time bucket derived from file modification times
(mtime);
group_path, a structural grouping key derived from the selected
path column.
It then summarises observations within each
period x group_path combination.
Modification times are treated as observational evidence of change. They are not interpreted as complete editing histories or confirmed archival events.
Structural grouping is deterministic and based on path structure.
It is intended for aggregation, review, and reporting, not for
file identity. Use rel_path for file-level identity.
Typical uses include:
identifying temporal clusters of filesystem activity;
reviewing candidate Activities before semantic stabilisation;
comparing activity across structural contexts;
supporting archival recontextualisation workflows;
preparing analytical or audit summaries.
Files under .Trash are excluded.
A data.frame with one row per period and group_path
combination.
The returned columns include:
Time bucket identifier.
Structural grouping key derived from path_col.
Earliest observed modification date in the group.
Latest observed modification date in the group.
Pipe-separated sample of observed file names.
Number of file observations in the group.
Number of distinct paths in the group.
Number of observations not tracked by Git, when git_tracked
is available; otherwise NA_integer_.
data("fscontextdemo_snapshot_02")
summarise_observed_activity(
fscontextdemo_snapshot_02,
time_unit = "month"
)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.