Inspect completed RRP assessments

Read retained assessment rows and their run context without sourcing or invoking project-authored analytical functions. Both optional filters use exact identifier matching and may be combined.

Usage

rrp_inspect_history(path, run_id = NULL, episode_id = NULL)

Arguments

path

Path to an existing RRP project with initialized state.

run_id

Optional single nonblank run ID to select.

episode_id

Optional single nonblank episode ID to select.

Value

An ordinary data frame with assessment identity run_id, episode_id, patient_id, and index_encounter_id; UTC times admission_time, discharge_time, and followup_window_end; outcome disposition and probability; provider failure_kind and failure_reason; selected event terminal_event_id, terminal_event_type, terminal_occurred_at, and terminal_available_at; and run context project_id, UTC as_of_time, UTC created_at, source_mapping_script, and risk_provider_script. A probability is present for accepted outcomes; failure and event fields are missing when inapplicable. Empty or unmatched filtered results retain the same columns and types, including UTC POSIXct timestamps.

Details

Initialize state with rrp_state_init() before inspecting history. Rows are ordered by run creation time, run ID, and episode ID. Reads use a read-only connection and never create state or modify history. A completed run with zero episodes contributes no assessment row. rrp_run() adds completed assessments; rrp_refresh_products() derives CSVs from history.

Examples

project <- tempfile("rrp-inspect-")
rrp_project_init(project, "example-rrp")
rrp_state_init(project)
#> duckdb keeps downloaded extensions and secrets in a temporary directory:
#> ℹ /tmp/RtmpgH9k2A/duckdb
#> This is removed when the R session ends.
#> • Extensions are re-downloaded each session.
#> • Secrets are lost.
#> ℹ Run duckdb(shared_home = TRUE) (or create ~/.duckdb) to keep them (suitable for most users).
#> ℹ Run duckdb(shared_home = FALSE) to accept the temporary directory (and silence this message).
#> ℹ See ?duckdb_storage for details and alternatives.
rrp_inspect_history(project)
#> duckdb keeps downloaded extensions and secrets in a temporary directory:
#> ℹ /tmp/RtmpgH9k2A/duckdb
#> This is removed when the R session ends.
#> • Extensions are re-downloaded each session.
#> • Secrets are lost.
#> ℹ Run duckdb(shared_home = TRUE) (or create ~/.duckdb) to keep them (suitable for most users).
#> ℹ Run duckdb(shared_home = FALSE) to accept the temporary directory (and silence this message).
#> ℹ See ?duckdb_storage for details and alternatives.
#>  [1] run_id                episode_id            patient_id           
#>  [4] index_encounter_id    admission_time        discharge_time       
#>  [7] followup_window_end   disposition           probability          
#> [10] failure_kind          failure_reason        terminal_event_id    
#> [13] terminal_event_type   terminal_occurred_at  terminal_available_at
#> [16] project_id            as_of_time            created_at           
#> [19] source_mapping_script risk_provider_script 
#> <0 rows> (or 0-length row.names)
unlink(project, recursive = TRUE)