Skip to content

Update the book for PKNCA 0.13.0 - #6

Merged
billdenney merged 13 commits into
mainfrom
docs/pknca-0.13.0
Oct 26, 2026
Merged

billdenney merged 13 commits into
mainfrom
docs/pknca-0.13.0

Conversation

@billdenney

Copy link
Copy Markdown
Member

Summary

Updates the book for PKNCA 0.13.0 (the current development version). Against current PKNCA, 9 chapters no longer rendered, and a review of the development NEWS found most new features undocumented and 15 places where the book taught the old behavior.

  • New chapters
    • Automatic Intervals and Dosing Regimens
    • Secondary Parameters
    • Sparse AUC to Infinity and Its Uncertainty
    • Bioequivalence
    • Data Quality Checks
    • Date-Time Data and Time References
  • Rewritten: Sparse PK Sampling, now with the standard parameter names and their _se/_df companions, the start_conc0 requirement, the BLQ rule, summary with SE, and sparse_bootstrap().
  • Breaking changes taught correctly
    • the rebuilt automatic intervals (single dose → dose to Inf with start_predose_conc0; auto.interval.method = "legacy")
    • f → f.obs
    • dose-aware aucint, with the .dose variants retired
    • renal clearance in one run
  • Interval tools: pknca_interval_table(), presets, the parameter table, interval_add_*(), and impute columns of any name.
  • Options: all 27 options with verified defaults.
  • Other chapter updates: half-life point-selection controls and fit plotting; CDISC output with SDTM time references and PPGRPID; the add.interval.col() API; and the developer chapters.
  • Book-wide: all "(≥ 0.12.2)" tags become "(≥ 0.13.0)" (0.12.2 was never released); the What's new section, README, CLAUDE.md, CONTRIBUTING, and the chapter order are updated; the CI package list gains units, lme4, lmerTest, and emmeans.
  • Known package issues: examples affected by open PKNCA issues show a warning callout (the bioequivalence design classification, the clr.*.dn registration, half-life flags after imputation). Remove the callouts when those are fixed.

Testing

  • quarto render of the whole book against PKNCA main (0.12.1.9002): no errors, no broken internal links; the remaining warnings are deliberate and explained in the text.
  • Three review passes against the package source and the rendered output; all findings fixed in the last commit.

🤖 Generated with Claude Code

billdenney and others added 13 commits October 10, 2026 02:16
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…rposition, and time to steady state

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ravascular, and urine chapters

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…hapter

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t-processing, and units

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ers, validation, and developer chapters

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…I packages)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Corrections from a review against the package source and the rendered
output:  min.hl.r.squared is applied by the exclusion rule, not the fit;
duration-based samples are selected by collection start; the allowed
interval columns include tau, conc_above, and interval_time_kind; the
tau.choices default uses the nominal set; per-subject variability in the
multiple-dose simulation; the Tmax exclusion rules; PPSTRES appears only
with unit conversions; unexported assert_* functions removed; pk.nca()
uses a copy of the global options; the Tobit comparison drops BLQ points
from the OLS fit; a broken table, US spelling, and smaller wording fixes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PKNCA 0.13.0 depends on cdiscdata 0.2.0 or later, which is still in CRAN
review, so pak could not solve the book's dependencies; the workflow now
installs it from humanpred/cdiscdata before PKNCA.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
cdiscdata 0.2.0 is on CRAN, so the book's workflow installs it like the
other packages instead of from GitHub.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@billdenney
billdenney merged commit c46057f into main Oct 26, 2026
1 check passed
@billdenney
billdenney deleted the docs/pknca-0.13.0 branch October 26, 2026 02:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant