IQLM: Installation Qualification (IQ) report to a pdf file

View source: R/IQLM.R

IQLMR Documentation

Installation Qualification (IQ) report to a pdf file

Description

Generate a self-contained PDF report documenting whether the sasLM package is correctly installed, intact, loadable, and operational in the user's own R environment. It is intended as Installation Qualification (IQ) evidence, in the spirit of commercial statistical-software validation. The report uses only base R and the package's own pdf helpers, so it requires no LaTeX, pandoc, or other external tools. The signature (approval) page is placed first and the report uses 1 inch margins on every side, with Letter paper in a United States locale and A4 elsewhere.

Usage

IQLM(fileName = "sasLM-IQ-Report.pdf", pkgs = "sasLM",
     functional = TRUE, performedBy = "", paper = "auto", sigField = FALSE)

Arguments

fileName

file name to save the PDF report.

pkgs

character vector of package names to qualify; defaults to "sasLM". Declared dependencies are checked automatically.

functional

if TRUE, run a small operational check: a known linear model (Goodnight 1976 p7, a balanced 2x2 factorial) is fitted with GLM and selected results (model and residual sums of squares, a Type I and a Type III sum of squares, and R-square) are compared with the SAS PROC GLM reference within a relative tolerance of 1e-3, plus two control tests that verify the comparator itself.

performedBy

name of the person performing the qualification, printed on the signature page. Defaults to the login name.

paper

paper size: "letter", "a4", or "auto" (the default; Letter in a United States locale, A4 elsewhere).

sigField

if TRUE, add Adobe Acrobat Reader signature fields to the finished report (via addSigFieldLM) so it can be signed with one click in Acrobat Reader.

Details

The report contains: the test environment (R version, platform, OS, locale, library paths); the installed package version, location and declared-dependency satisfaction; file integrity via checkMD5sums (PASS / FAIL / WARN when no manifest is present - see writeMD5LM); namespace load and core exports; an optional functional verification; an overall QUALIFIED / NOT QUALIFIED verdict; a sessionInfo appendix; and a per-file md5 checksum appendix.

Value

Invisibly, a list with fileName, qualified, paper, checks (a data frame of every check), and the counts nPass, nFail, nWarn. A PDF file is written to fileName.

Author(s)

Kyun-Seop Bae <k@acr.kr>

See Also

OQLM, writeMD5LM, GLM

Examples

#IQLM()
#res <- IQLM(performedBy = "Jane Doe"); res$qualified

sasLM documentation built on July 14, 2026, 5:06 p.m.