List archived covariate search scenarios.

Dispatches on the type of x to discover archived covariate-search run folders and returns one row per scenario, sorted by timestamp descending (latest first). This function discovers only stepwise_* and shotgun_* folders, not transient SCM_* directories.

Usage

listSCMRuns(x)

Arguments

x

One of:

• A search-result data frame (from shotgunSearch() / stepwiseSearch()) with a searchRunDir attribute. Lists scenarios for that single archived run.

• An NlmePmlModel. Scans the model's working directory for all archived covariate-search run folders.

• A character path to an archived run folder (contains scenario_index.csv). Lists scenarios for that single run.

• A character path to a working directory. Scans for all child stepwise_* and shotgun_* run folders.

Value

A data frame with one row per scenario. Columns: searchType, SCMFolder (path to the archived run folder; name kept for compatibility), runFolder, Scenario, enableFlags, status, timestamp, runId, overallFile, stepwiseFile. Returns an empty data frame if no runs are found.

Archived run folders

Archived folders are created when shotgunSearch() or stepwiseSearch() is run with archiveResults = TRUE. During the engine run, NLME8 writes scenario outputs under a temporary SCM_<runId>/ directory in the model working directory (runId is a wall-clock timestamp, optionally suffixed with runLabel). After the engine finishes, collectJob() materialises the search result and the package renames that tree into a durable folder named stepwise_<runId> or shotgun_<runId> (on remote hosts the bundle SCM_<runId>.tar.gz is extracted first, then the bundle and any loose SCM_<runId>/ copy are removed). The final folder holds scenario_index.csv, per-scenario subfolders, Overall.csv, optional stepwise logs, and rsnlme_run.rds.

See also

shotgunSearch, stepwiseSearch, summary(), print(), getSCMResults