← Back to all sparks
A

admiralophtha

ANALYTICS
Velocity0.0

Ophthalmology package extension of admiral

Ophthalmology ADaM support is migrating its derivations upstream into admiral core.

ophthalmologyadampharmaversedeprecationtemplatesclinical-trials
Current state
admiralophtha supplies ophthalmology-specific ADaM templates and vignettes — ADBCVA, ADOE, ADVFQ — on top of admiral. Releases arrive roughly twice a year and are dominated by template and vignette modernisation plus a long, deliberate deprecation of the package's own criterion-flag helper in favour of admiral::derive_vars_crit_flag(). The 1.5.0 release advances that deprecation to its warning phase and adds a template explorer.
Where it's heading
The arc is consolidation: functions the package invented are being retired as admiral core grows generic equivalents, leaving admiralophtha as the place where ophthalmology conventions are documented. Recent releases spend their weight on templates and vignettes — VFQ guidance alignment, IOP parameter mapping, subject-key options — rather than new exported code. Deprecations are run on a fixed six-month, one-release-per-phase clock, which makes the migration path unusually legible.
Prediction
derive_var_bcvacritxfl() should reach its error phase and then removal over the next two releases, with the accompanying work being ADBCVA vignette and template edits rather than new functions.

Recent moves

  1. 2mo ago

    Criterion-flag deprecation reaches its warning phase

    derive_var_bcvacritxfl() moves from message to warning, keeping the six-month migration clock running toward admiral::derive_vars_crit_flag(). The rest is documentation: a night mode toggle, navbar tooltips, and a template explorer vignette.

    View source ↗
  2. 7mo ago

    Criterion-flag deprecation starts; ADVFQ template modernised

    The deprecation of derive_var_bcvacritxfl() formally begins, and the ADVFQ template and vignette are reworked to match current VFQ guidance. The kapa.ai "Ask AI" widget is an ecosystem-wide docs rollout rather than anything specific to this package.

    View source ↗
  3. 1y ago

    ADBCVA and ADOE templates show richer derivation patterns

    Templates and vignettes are reworked to demonstrate restrict_derivation() combined with call_derivation() for criterion flags, and ADOE gains IOP parameter mapping including pre/post-dose differences. Guidance quality, not new API.

    View source ↗
  4. 1y ago

    Criterion flags switch to the generic admiral helper

    ADBCVA templates and vignettes drop derive_var_bcvacrtixfl() for admiral::derive_vars_crit_flag(), and adopt derive_vars_cat() for the AVALCAT derivations. This is the release that starts the handover of ophthalmology logic to admiral core.

    View source ↗
  5. 1y ago

    derive_var_afeye() arguments enter final deprecation

    The dataset_occ and lat_vals arguments reach the last phase of their deprecation, and every vignette and template switches to the admiral subject-keys option instead of hard-coding STUDYID and USUBJID. Small edits, but they standardise the package on ecosystem conventions.

    View source ↗
  6. 2y ago

    1.0 release realigns templates with current admiral APIs

    The stability milestone is spent absorbing upstream admiral changes: derive_param_computed() loses analysis_value, derive_summary_records() gains filter_add and an explicit dataset_add. Declaring maturity here mostly meant tracking admiral closely.

    View source ↗