From bd62f76a0fc3417b9d7a1699250ca7f8d739d04b Mon Sep 17 00:00:00 2001
From: GitHub Actions <actions@github.com>
Date: Wed, 15 May 2024 19:28:41 +0000
Subject: [PATCH] cli-12730-2465

---
 dev/LICENSE.html                              |   2 +-
 dev/articles/admiraldev.html                  |   7 +-
 dev/articles/git_usage.html                   |   2 +-
 dev/articles/index.html                       |   2 +-
 dev/articles/package_extensions.html          |   2 +-
 dev/articles/pr_review_guidance.html          |   2 +-
 dev/articles/programming_strategy.html        |   2 +-
 dev/articles/rcmd_issues.html                 |   2 +-
 dev/articles/release_strategy.html            |   2 +-
 dev/articles/test_data_guidance.html          |   2 +-
 dev/articles/unit_test_format_tests.png       | Bin 54985 -> 281332 bytes
 dev/articles/unit_test_guidance.html          | 114 ++++++++++--------
 dev/articles/writing_vignettes.html           |   2 +-
 dev/authors.html                              |   6 +-
 dev/index.html                                |   2 +-
 dev/news/index.html                           |   3 +-
 dev/pkgdown.yml                               |   2 +-
 dev/reference/add_suffix_to_vars.html         |   2 +-
 dev/reference/admiraldev-package.html         |   2 +-
 dev/reference/arg_name.html                   |   2 +-
 dev/reference/assert_atomic_vector.html       |   2 +-
 dev/reference/assert_character_scalar.html    |   2 +-
 dev/reference/assert_character_vector.html    |   2 +-
 dev/reference/assert_data_frame.html          |   2 +-
 dev/reference/assert_date_var.html            |   2 +-
 dev/reference/assert_date_vector.html         |   2 +-
 dev/reference/assert_expr.html                |   2 +-
 dev/reference/assert_expr_list.html           |   2 +-
 dev/reference/assert_filter_cond.html         |   2 +-
 dev/reference/assert_function.html            |   2 +-
 dev/reference/assert_function_param.html      |   2 +-
 dev/reference/assert_has_variables.html       |   2 +-
 dev/reference/assert_integer_scalar.html      |   2 +-
 dev/reference/assert_list_element.html        |   2 +-
 dev/reference/assert_list_of.html             |   2 +-
 dev/reference/assert_logical_scalar.html      |   2 +-
 dev/reference/assert_named.html               |   2 +-
 dev/reference/assert_named_exprs.html         |   2 +-
 dev/reference/assert_numeric_vector.html      |   2 +-
 dev/reference/assert_one_to_one.html          |   2 +-
 .../assert_param_does_not_exist.html          |   2 +-
 dev/reference/assert_s3_class.html            |   2 +-
 dev/reference/assert_same_type.html           |   2 +-
 dev/reference/assert_symbol.html              |   2 +-
 dev/reference/assert_unit.html                |   2 +-
 dev/reference/assert_vars.html                |   2 +-
 dev/reference/assert_varval_list.html         |   2 +-
 dev/reference/backquote.html                  |   2 +-
 dev/reference/contains_vars.html              |   2 +-
 dev/reference/convert_dtm_to_dtc.html         |   2 +-
 dev/reference/dataset_vignette.html           |   2 +-
 dev/reference/dquote.html                     |   2 +-
 dev/reference/enumerate.html                  |   2 +-
 dev/reference/expect_dfs_equal.html           |   2 +-
 dev/reference/expr_c.html                     |   2 +-
 dev/reference/extract_vars.html               |   2 +-
 dev/reference/filter_if.html                  |   2 +-
 dev/reference/friendly_type_of.html           |   2 +-
 dev/reference/get_constant_vars.html          |   2 +-
 dev/reference/get_dataset.html                |   2 +-
 dev/reference/get_duplicates.html             |   2 +-
 dev/reference/get_new_tmp_var.html            |   2 +-
 dev/reference/get_source_vars.html            |   2 +-
 dev/reference/grapes-notin-grapes.html        |   2 +-
 dev/reference/grapes-or-grapes.html           |   2 +-
 dev/reference/index.html                      |   2 +-
 dev/reference/is_auto.html                    |   2 +-
 dev/reference/is_order_vars.html              |   2 +-
 dev/reference/is_valid_dtc.html               |   2 +-
 dev/reference/joins.html                      |   2 +-
 dev/reference/process_set_values_to.html      |   2 +-
 dev/reference/remove_tmp_vars.html            |   2 +-
 dev/reference/replace_symbol_in_expr.html     |   2 +-
 dev/reference/replace_values_by_names.html    |   2 +-
 dev/reference/squote.html                     |   2 +-
 dev/reference/suppress_warning.html           |   2 +-
 dev/reference/valid_time_units.html           |   2 +-
 dev/reference/vars2chr.html                   |   2 +-
 dev/reference/warn_if_incomplete_dtc.html     |   2 +-
 dev/reference/warn_if_inconsistent_list.html  |   2 +-
 dev/reference/warn_if_invalid_dtc.html        |   2 +-
 dev/reference/warn_if_vars_exist.html         |   2 +-
 dev/reference/what_is_it.html                 |   2 +-
 dev/search.json                               |   2 +-
 84 files changed, 149 insertions(+), 139 deletions(-)
 mode change 100755 => 100644 dev/articles/unit_test_format_tests.png

diff --git a/dev/LICENSE.html b/dev/LICENSE.html
index 5c2966d1..1b1ccd2e 100644
--- a/dev/LICENSE.html
+++ b/dev/LICENSE.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/admiraldev.html b/dev/articles/admiraldev.html
index 9226622e..c6fedccc 100644
--- a/dev/articles/admiraldev.html
+++ b/dev/articles/admiraldev.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -115,9 +115,8 @@ <h2 id="dear-developers">Dear Developers<a class="anchor" aria-label="anchor" hr
 but generally fit into three categories: datasets, variables and
 arguments. Most of the functions start with <code>assert_</code>,
 <code>is_</code> or <code>get_</code>.</p></li>
-<li><p>Addins and utility functions that help with documentation,
-testing and checking on health of the code base in all admiral
-packages.</p></li>
+<li><p>Utility functions that help with documentation, testing and
+checking on health of the code base in all admiral packages.</p></li>
 <li><p>Vignettes on working on <a href="https://pharmaverse.github.io/admiral/" class="external-link">admiral</a> functions,
 developing unit testing, releases process, vignette writing and other
 documentation needs. These vignettes are intended for use across all
diff --git a/dev/articles/git_usage.html b/dev/articles/git_usage.html
index 4b6919a1..83ee21d2 100644
--- a/dev/articles/git_usage.html
+++ b/dev/articles/git_usage.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/index.html b/dev/articles/index.html
index 350eb00d..8ccdc3e9 100644
--- a/dev/articles/index.html
+++ b/dev/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/package_extensions.html b/dev/articles/package_extensions.html
index 00da1306..e09d70de 100644
--- a/dev/articles/package_extensions.html
+++ b/dev/articles/package_extensions.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/pr_review_guidance.html b/dev/articles/pr_review_guidance.html
index 3b9ad356..ab80d298 100644
--- a/dev/articles/pr_review_guidance.html
+++ b/dev/articles/pr_review_guidance.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/programming_strategy.html b/dev/articles/programming_strategy.html
index 72964222..1d9b87d6 100644
--- a/dev/articles/programming_strategy.html
+++ b/dev/articles/programming_strategy.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/rcmd_issues.html b/dev/articles/rcmd_issues.html
index 36f19aa0..885cb7d4 100644
--- a/dev/articles/rcmd_issues.html
+++ b/dev/articles/rcmd_issues.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/release_strategy.html b/dev/articles/release_strategy.html
index 098bd08c..8328af48 100644
--- a/dev/articles/release_strategy.html
+++ b/dev/articles/release_strategy.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/test_data_guidance.html b/dev/articles/test_data_guidance.html
index fc2f06f0..f61a9490 100644
--- a/dev/articles/test_data_guidance.html
+++ b/dev/articles/test_data_guidance.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/articles/unit_test_format_tests.png b/dev/articles/unit_test_format_tests.png
old mode 100755
new mode 100644
index 8d2c4336495a627c495c1c5fab7b2b503e88656d..e1b4f1798267bf7285d72f8e76e725b721a0c390
GIT binary patch
literal 281332
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%0D#Gea{bne`d7l
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
R*LV)RV7hRfVlCV7{{f#Ran1k$

literal 54985
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%0AMQ
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%0DDr_})d$hY#HS
zCni$k{h@@+c|qDjffcs{2Cpe6Z3VN)5i=YjTuhY>hvupgapP{@wz|&#GK&=q!uW(u
zv<o6i2oK6>HoK76Af5T)2=TWqB2;U=W*sCANCXulO#_FL7+M4xI8DGlq@(I}w8+RV
zJ+dQD%cDK>?7&y?H7WSrB`kWLmou;_OO<(xWFwpPT9?7TzPXF=r}vFgUB=qa2-%Ae
zxapo?04zt(H>RqK6@ZR++LB!naJ{<UaBKI5EfX!s!Yu&#WGof13cw*(><^cvhvPeU
z#k#2g>dZ=d5-NFFlWez>d&NxA*}?!?bkN*@dhbJ|H)-erw_j^Gy!s7}N8zp>0k12$
zbvYuj+DTmx|L@6vZS2#l-=pW@wH?vnCB{sQqU$+6o_l*(rR%n$_*1rL{&q2*Z_p-7
zYfOXEH*Vkq*RTKd0{a@7eqV}A2m0Pz#Z`jHi+PA_Bk)Ui0ql?g6@-|K^Qv~3jSy8~
zOH78-0sWc#Z)isv`<}|~x9%TNu;3s53;@@wxW41dUf?Yt^tqx8x<^?J48A)N7`rCz
f^|0a5<D#{V1gnmEe(4lPA{ZTPTu)XU54iRhL|GE5

diff --git a/dev/articles/unit_test_guidance.html b/dev/articles/unit_test_guidance.html
index 5f240f7d..515deedc 100644
--- a/dev/articles/unit_test_guidance.html
+++ b/dev/articles/unit_test_guidance.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -328,14 +328,24 @@ <h3 id="set-up-the-test-script">Set up the Test Script<a class="anchor" aria-lab
 <p><img src="unit_test_toc.png" width="120%"></p>
 </div>
 <div class="section level3">
-<h3 id="addin-admiraldevformat_test_that_file">Addin <code>admiraldev::format_test_that_file()</code><a class="anchor" aria-label="anchor" href="#addin-admiraldevformat_test_that_file"></a>
+<h3 id="addin-pharmaverse4devsformat_test_that_file">Addin <code>pharmaverse4devs::format_test_that_file()</code><a class="anchor" aria-label="anchor" href="#addin-pharmaverse4devsformat_test_that_file"></a>
 </h3>
 <p>To ease the burden on developers for writing and adding tests we have
 developed an Addin for formatting test_that test files according to
 admiral programming standards. The Addin will add and update comments as
-well as number or re-numbers the tests. Just use the Addin button and
-select the “Format test_that test file” as seen in the image. Be sure to
-have the test-file open and selected when calling the Addin.</p>
+well as number or re-numbers the tests. To access the Addin, be sure to
+install the {pharmaverse4devs} from Github.</p>
+<p>To install the latest development version of the package directly
+from GitHub use the following code:</p>
+<div class="sourceCode" id="cb5"><pre class="downlit sourceCode r">
+<code class="sourceCode R"><span>    <span class="kw">if</span> <span class="op">(</span><span class="op">!</span><span class="fu"><a href="https://rdrr.io/r/base/ns-load.html" class="external-link">requireNamespace</a></span><span class="op">(</span><span class="st">"remotes"</span>, quietly <span class="op">=</span> <span class="cn">TRUE</span><span class="op">)</span><span class="op">)</span> <span class="op">{</span></span>
+<span>      <span class="fu"><a href="https://rdrr.io/r/utils/install.packages.html" class="external-link">install.packages</a></span><span class="op">(</span><span class="st">"remotes"</span><span class="op">)</span></span>
+<span>    <span class="op">}</span></span>
+<span></span>
+<span>    <span class="fu">remotes</span><span class="fu">::</span><span class="fu"><a href="https://remotes.r-lib.org/reference/install_github.html" class="external-link">install_github</a></span><span class="op">(</span><span class="st">"pharmaverse/pharmaverse4devs"</span><span class="op">)</span></span></code></pre></div>
+<p>Then use the Addin button and select the “Format test_that test file”
+as seen in the image. Be sure to have the test-file open and selected
+when calling the Addin.</p>
 <p><img src="unit_test_format_tests.png" width="120%"></p>
 <p>The Addin will perform the following:</p>
 <ul>
@@ -355,54 +365,54 @@ <h3 id="addin-admiraldevformat_test_that_file">Addin <code>admiraldev::format_te
 <p>When writing new unit tests, just provide a description in the
 <code>test_that()</code> call and if necessary the function name in a
 <code># &lt;function name&gt; ----</code> comment:</p>
-<pre><code><span><span class="co"># arg_name ----</span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"arg_name works"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="fu"><a href="https://rlang.r-lib.org/reference/sym.html" class="external-link">sym</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span><span class="op">)</span>, <span class="st">"a"</span><span class="op">)</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/call.html" class="external-link">call</a></span><span class="op">(</span><span class="st">"enquo"</span>, <span class="fu"><a href="https://rlang.r-lib.org/reference/sym.html" class="external-link">sym</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span><span class="op">)</span><span class="op">)</span>, <span class="st">"a"</span><span class="op">)</span></span>
-<span>  <span class="fu">expect_error</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span>, <span class="st">"Could not extract argument name from"</span><span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span>
-<span></span>
-<span><span class="co"># convert_dtm_to_dtc ----</span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"works if dtm is in correct format"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span></span>
-<span>    <span class="fu"><a href="../reference/convert_dtm_to_dtc.html">convert_dtm_to_dtc</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/as.POSIXlt.html" class="external-link">as.POSIXct</a></span><span class="op">(</span><span class="st">"2022-04-05 15:34:07 UTC"</span><span class="op">)</span><span class="op">)</span>,</span>
-<span>    <span class="st">"2022-04-05T15:34:07"</span></span>
-<span>  <span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span>
-<span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"Error is thrown if dtm is not in correct format"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_error</span><span class="op">(</span></span>
-<span>    <span class="fu"><a href="../reference/convert_dtm_to_dtc.html">convert_dtm_to_dtc</a></span><span class="op">(</span><span class="st">"2022-04-05T15:26:14"</span><span class="op">)</span>,</span>
-<span>    <span class="st">"lubridate::is.instant(dtm) is not TRUE"</span>,</span>
-<span>    fixed <span class="op">=</span> <span class="cn">TRUE</span></span>
-<span>  <span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span></code></pre>
+<pre><code># derive_vars_merged ----
+test_that( "works if it merges all variables", {
+  actual &lt;- derive_vars_merged(advs,
+    dataset_add = adsl,
+    by_vars = exprs(STUDYID, USUBJID)
+  )
+
+# convert_dtm_to_dtc ----
+test_that("works if dtm is in correct format", {
+  expect_equal(
+    convert_dtm_to_dtc(as.POSIXct("2022-04-05 15:34:07 UTC")),
+    "2022-04-05T15:34:07"
+  )
+})
+
+test_that("Error is thrown if dtm is not in correct format", {
+  expect_error(
+    convert_dtm_to_dtc("2022-04-05T15:26:14"),
+    "lubridate::is.instant(dtm) is not TRUE",
+    fixed = TRUE
+  )
+})</code></pre>
 <p>Call the addin and get:</p>
-<pre><code><span><span class="co"># arg_name ----</span></span>
-<span><span class="co">## Test 1: arg_name works ----</span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"arg_name Test 1: arg_name works"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="fu"><a href="https://rlang.r-lib.org/reference/sym.html" class="external-link">sym</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span><span class="op">)</span>, <span class="st">"a"</span><span class="op">)</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/call.html" class="external-link">call</a></span><span class="op">(</span><span class="st">"enquo"</span>, <span class="fu"><a href="https://rlang.r-lib.org/reference/sym.html" class="external-link">sym</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span><span class="op">)</span><span class="op">)</span>, <span class="st">"a"</span><span class="op">)</span></span>
-<span>  <span class="fu">expect_error</span><span class="op">(</span><span class="fu"><a href="../reference/arg_name.html">arg_name</a></span><span class="op">(</span><span class="st">"a"</span><span class="op">)</span>, <span class="st">"Could not extract argument name from"</span><span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span>
-<span></span>
-<span><span class="co"># convert_dtm_to_dtc ----</span></span>
-<span><span class="co">## Test 2: works if dtm is in correct format ----</span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"convert_dtm_to_dtc Test 2: works if dtm is in correct format"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_equal</span><span class="op">(</span></span>
-<span>    <span class="fu"><a href="../reference/convert_dtm_to_dtc.html">convert_dtm_to_dtc</a></span><span class="op">(</span><span class="fu"><a href="https://rdrr.io/r/base/as.POSIXlt.html" class="external-link">as.POSIXct</a></span><span class="op">(</span><span class="st">"2022-04-05 15:34:07 UTC"</span><span class="op">)</span><span class="op">)</span>,</span>
-<span>    <span class="st">"2022-04-05T15:34:07"</span></span>
-<span>  <span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span>
-<span></span>
-<span><span class="co">## Test 3: Error is thrown if dtm is not in correct format ----</span></span>
-<span><span class="fu">test_that</span><span class="op">(</span><span class="st">"convert_dtm_to_dtc Test 3: Error is thrown if dtm is not in correct format"</span>, <span class="op">{</span></span>
-<span>  <span class="fu">expect_error</span><span class="op">(</span></span>
-<span>    <span class="fu"><a href="../reference/convert_dtm_to_dtc.html">convert_dtm_to_dtc</a></span><span class="op">(</span><span class="st">"2022-04-05T15:26:14"</span><span class="op">)</span>,</span>
-<span>    <span class="st">"lubridate::is.instant(dtm) is not TRUE"</span>,</span>
-<span>    fixed <span class="op">=</span> <span class="cn">TRUE</span></span>
-<span>  <span class="op">)</span></span>
-<span><span class="op">}</span><span class="op">)</span></span></code></pre>
+<pre><code># derive_vars_merged ----
+## Test 1: derive_vars_merged ----
+test_that( "derive_vars_merged Test 1: it merges all variables", {
+  actual &lt;- derive_vars_merged(advs,
+    dataset_add = adsl,
+    by_vars = exprs(STUDYID, USUBJID)
+  )
+
+# convert_dtm_to_dtc ----
+## Test 2: works if dtm is in correct format ----
+test_that("convert_dtm_to_dtc Test 2: works if dtm is in correct format", {
+  expect_equal(
+    convert_dtm_to_dtc(as.POSIXct("2022-04-05 15:34:07 UTC")),
+    "2022-04-05T15:34:07"
+  )
+})
+
+## Test 3: Error is thrown if dtm is not in correct format ----
+test_that("convert_dtm_to_dtc Test 3: Error is thrown if dtm is not in correct format", {
+  expect_error(
+    convert_dtm_to_dtc("2022-04-05T15:26:14"),
+    "lubridate::is.instant(dtm) is not TRUE",
+    fixed = TRUE
+  )
+})</code></pre>
 <p>Once you have tested your unit test program, you can run all unit
 tests from the console, as follows.</p>
 <pre><code><span><span class="fu">devtools</span><span class="fu">::</span><span class="fu"><a href="https://devtools.r-lib.org/reference/test.html" class="external-link">test</a></span><span class="op">(</span><span class="op">)</span></span></code></pre>
diff --git a/dev/articles/writing_vignettes.html b/dev/articles/writing_vignettes.html
index be29e9d1..0082862a 100644
--- a/dev/articles/writing_vignettes.html
+++ b/dev/articles/writing_vignettes.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/authors.html b/dev/authors.html
index adb3ad5b..fb330b80 100644
--- a/dev/authors.html
+++ b/dev/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -131,14 +131,14 @@ <h2 id="citation">Citation</h2>
 
       <p>Straub B, Bundfuss S, Dickinson J, Farrugia R, Kumari P, Mancini E, Mascary S, Zhu Z (2024).
 <em>admiraldev: Utility Functions and Development Tools for the Admiral Package Family</em>.
-R package version 1.0.0.9025, 
+R package version 1.0.0.9026, 
 https://github.com/pharmaverse/admiraldev/, <a href="https://pharmaverse.github.io/admiraldev/">https://pharmaverse.github.io/admiraldev/</a>. 
 </p>
       <pre>@Manual{,
   title = {admiraldev: Utility Functions and Development Tools for the Admiral Package Family},
   author = {Ben Straub and Stefan Bundfuss and Jeffrey Dickinson and Ross Farrugia and Pooja Kumari and Edoardo Mancini and Sadchla Mascary and Zelos Zhu},
   year = {2024},
-  note = {R package version 1.0.0.9025, 
+  note = {R package version 1.0.0.9026, 
 https://github.com/pharmaverse/admiraldev/},
   url = {https://pharmaverse.github.io/admiraldev/},
 }</pre>
diff --git a/dev/index.html b/dev/index.html
index 189eb88a..261a62e4 100644
--- a/dev/index.html
+++ b/dev/index.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/news/index.html b/dev/news/index.html
index d91c98b0..b1081875 100644
--- a/dev/news/index.html
+++ b/dev/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -91,6 +91,7 @@ <h3 id="documentation-development-version">Documentation<a class="anchor" aria-l
 <h3 id="other-development-version">Other<a class="anchor" aria-label="anchor" href="#other-development-version"></a></h3>
 <ul><li><p>Removed dependencies not needed to build package or package documentation. (<a href="https://github.com/pharmaverse/admiraldev/issues/426" class="external-link">#426</a>)</p></li>
 <li><p>Increased minimum R version required to 4.0 to match {admiral}. (<a href="https://github.com/pharmaverse/admiraldev/issues/382" class="external-link">#382</a>)</p></li>
+<li><p><code>addin_format_testthat</code> addin has been moved to <code>{pharmaverse4devs}</code> package. (<a href="https://github.com/pharmaverse/admiraldev/issues/419" class="external-link">#419</a>)</p></li>
 </ul></div>
 </div>
     <div class="section level2">
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml
index 348cf2df..a81be7fb 100644
--- a/dev/pkgdown.yml
+++ b/dev/pkgdown.yml
@@ -12,7 +12,7 @@ articles:
   test_data_guidance: test_data_guidance.html
   unit_test_guidance: unit_test_guidance.html
   writing_vignettes: writing_vignettes.html
-last_built: 2024-04-29T12:56Z
+last_built: 2024-05-15T19:28Z
 urls:
   reference: https://pharmaverse.github.io/admiraldev/reference
   article: https://pharmaverse.github.io/admiraldev/articles
diff --git a/dev/reference/add_suffix_to_vars.html b/dev/reference/add_suffix_to_vars.html
index 8d3de43f..473c7347 100644
--- a/dev/reference/add_suffix_to_vars.html
+++ b/dev/reference/add_suffix_to_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/admiraldev-package.html b/dev/reference/admiraldev-package.html
index 692d9f72..d996269a 100644
--- a/dev/reference/admiraldev-package.html
+++ b/dev/reference/admiraldev-package.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/arg_name.html b/dev/reference/arg_name.html
index 6183d7d1..b451d954 100644
--- a/dev/reference/arg_name.html
+++ b/dev/reference/arg_name.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_atomic_vector.html b/dev/reference/assert_atomic_vector.html
index 66100d9d..a3f58d11 100644
--- a/dev/reference/assert_atomic_vector.html
+++ b/dev/reference/assert_atomic_vector.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_character_scalar.html b/dev/reference/assert_character_scalar.html
index a5b6e96d..7272dc3c 100644
--- a/dev/reference/assert_character_scalar.html
+++ b/dev/reference/assert_character_scalar.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_character_vector.html b/dev/reference/assert_character_vector.html
index ce12999d..6f7517c5 100644
--- a/dev/reference/assert_character_vector.html
+++ b/dev/reference/assert_character_vector.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_data_frame.html b/dev/reference/assert_data_frame.html
index 33eb4c34..c10813c1 100644
--- a/dev/reference/assert_data_frame.html
+++ b/dev/reference/assert_data_frame.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_date_var.html b/dev/reference/assert_date_var.html
index c97f6eed..87780f03 100644
--- a/dev/reference/assert_date_var.html
+++ b/dev/reference/assert_date_var.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_date_vector.html b/dev/reference/assert_date_vector.html
index 241980e5..403fa3d1 100644
--- a/dev/reference/assert_date_vector.html
+++ b/dev/reference/assert_date_vector.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_expr.html b/dev/reference/assert_expr.html
index 411990c4..eb25a875 100644
--- a/dev/reference/assert_expr.html
+++ b/dev/reference/assert_expr.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_expr_list.html b/dev/reference/assert_expr_list.html
index cc5dcd24..113fbe4c 100644
--- a/dev/reference/assert_expr_list.html
+++ b/dev/reference/assert_expr_list.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_filter_cond.html b/dev/reference/assert_filter_cond.html
index 109380b1..08048bcb 100644
--- a/dev/reference/assert_filter_cond.html
+++ b/dev/reference/assert_filter_cond.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_function.html b/dev/reference/assert_function.html
index 358dcce9..3525358b 100644
--- a/dev/reference/assert_function.html
+++ b/dev/reference/assert_function.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_function_param.html b/dev/reference/assert_function_param.html
index 3b515dad..ef7d6450 100644
--- a/dev/reference/assert_function_param.html
+++ b/dev/reference/assert_function_param.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_has_variables.html b/dev/reference/assert_has_variables.html
index 7094591b..ae31e36c 100644
--- a/dev/reference/assert_has_variables.html
+++ b/dev/reference/assert_has_variables.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_integer_scalar.html b/dev/reference/assert_integer_scalar.html
index a183b2cc..99c549cb 100644
--- a/dev/reference/assert_integer_scalar.html
+++ b/dev/reference/assert_integer_scalar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_list_element.html b/dev/reference/assert_list_element.html
index b391b0ca..10ef2906 100644
--- a/dev/reference/assert_list_element.html
+++ b/dev/reference/assert_list_element.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_list_of.html b/dev/reference/assert_list_of.html
index 7bcd1555..ffcff378 100644
--- a/dev/reference/assert_list_of.html
+++ b/dev/reference/assert_list_of.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_logical_scalar.html b/dev/reference/assert_logical_scalar.html
index 80619c95..12afb56e 100644
--- a/dev/reference/assert_logical_scalar.html
+++ b/dev/reference/assert_logical_scalar.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_named.html b/dev/reference/assert_named.html
index e7bce17d..3edc0d01 100644
--- a/dev/reference/assert_named.html
+++ b/dev/reference/assert_named.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_named_exprs.html b/dev/reference/assert_named_exprs.html
index 34ac30da..e1a63131 100644
--- a/dev/reference/assert_named_exprs.html
+++ b/dev/reference/assert_named_exprs.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_numeric_vector.html b/dev/reference/assert_numeric_vector.html
index c1a4864e..8b3eefa6 100644
--- a/dev/reference/assert_numeric_vector.html
+++ b/dev/reference/assert_numeric_vector.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_one_to_one.html b/dev/reference/assert_one_to_one.html
index 7559830b..fdbf9e04 100644
--- a/dev/reference/assert_one_to_one.html
+++ b/dev/reference/assert_one_to_one.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_param_does_not_exist.html b/dev/reference/assert_param_does_not_exist.html
index ea66a125..96f3f545 100644
--- a/dev/reference/assert_param_does_not_exist.html
+++ b/dev/reference/assert_param_does_not_exist.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_s3_class.html b/dev/reference/assert_s3_class.html
index 9790ea3d..66368287 100644
--- a/dev/reference/assert_s3_class.html
+++ b/dev/reference/assert_s3_class.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_same_type.html b/dev/reference/assert_same_type.html
index 3640801a..5725afab 100644
--- a/dev/reference/assert_same_type.html
+++ b/dev/reference/assert_same_type.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_symbol.html b/dev/reference/assert_symbol.html
index 4f38bbe1..0da5ced4 100644
--- a/dev/reference/assert_symbol.html
+++ b/dev/reference/assert_symbol.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_unit.html b/dev/reference/assert_unit.html
index 2320794b..ff397c77 100644
--- a/dev/reference/assert_unit.html
+++ b/dev/reference/assert_unit.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_vars.html b/dev/reference/assert_vars.html
index c770e650..5bccce49 100644
--- a/dev/reference/assert_vars.html
+++ b/dev/reference/assert_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/assert_varval_list.html b/dev/reference/assert_varval_list.html
index dbe1ae29..151b91b6 100644
--- a/dev/reference/assert_varval_list.html
+++ b/dev/reference/assert_varval_list.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/backquote.html b/dev/reference/backquote.html
index 1380ca9d..79d19602 100644
--- a/dev/reference/backquote.html
+++ b/dev/reference/backquote.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/contains_vars.html b/dev/reference/contains_vars.html
index 622baa9d..6cc34b1b 100644
--- a/dev/reference/contains_vars.html
+++ b/dev/reference/contains_vars.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/convert_dtm_to_dtc.html b/dev/reference/convert_dtm_to_dtc.html
index 5c3710c8..de71c99d 100644
--- a/dev/reference/convert_dtm_to_dtc.html
+++ b/dev/reference/convert_dtm_to_dtc.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/dataset_vignette.html b/dev/reference/dataset_vignette.html
index bf11c60c..f30a39cb 100644
--- a/dev/reference/dataset_vignette.html
+++ b/dev/reference/dataset_vignette.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/dquote.html b/dev/reference/dquote.html
index dc4bbe1d..d24d8500 100644
--- a/dev/reference/dquote.html
+++ b/dev/reference/dquote.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/enumerate.html b/dev/reference/enumerate.html
index 89d42f9e..2eb91020 100644
--- a/dev/reference/enumerate.html
+++ b/dev/reference/enumerate.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/expect_dfs_equal.html b/dev/reference/expect_dfs_equal.html
index 13edf0c3..36606a5e 100644
--- a/dev/reference/expect_dfs_equal.html
+++ b/dev/reference/expect_dfs_equal.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/expr_c.html b/dev/reference/expr_c.html
index 782f64a5..7bc02c94 100644
--- a/dev/reference/expr_c.html
+++ b/dev/reference/expr_c.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/extract_vars.html b/dev/reference/extract_vars.html
index 80d6e010..c3043412 100644
--- a/dev/reference/extract_vars.html
+++ b/dev/reference/extract_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/filter_if.html b/dev/reference/filter_if.html
index b42b9a72..ecfa0c9b 100644
--- a/dev/reference/filter_if.html
+++ b/dev/reference/filter_if.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/friendly_type_of.html b/dev/reference/friendly_type_of.html
index c1bc8a36..866d2d69 100644
--- a/dev/reference/friendly_type_of.html
+++ b/dev/reference/friendly_type_of.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/get_constant_vars.html b/dev/reference/get_constant_vars.html
index e1401bb9..2807dd0b 100644
--- a/dev/reference/get_constant_vars.html
+++ b/dev/reference/get_constant_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/get_dataset.html b/dev/reference/get_dataset.html
index f57b043f..41f8bbe7 100644
--- a/dev/reference/get_dataset.html
+++ b/dev/reference/get_dataset.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/get_duplicates.html b/dev/reference/get_duplicates.html
index 4b834acb..f44995d7 100644
--- a/dev/reference/get_duplicates.html
+++ b/dev/reference/get_duplicates.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/get_new_tmp_var.html b/dev/reference/get_new_tmp_var.html
index d7cf758e..02e5c9cc 100644
--- a/dev/reference/get_new_tmp_var.html
+++ b/dev/reference/get_new_tmp_var.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/get_source_vars.html b/dev/reference/get_source_vars.html
index 29f6da20..c4ec11b9 100644
--- a/dev/reference/get_source_vars.html
+++ b/dev/reference/get_source_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/grapes-notin-grapes.html b/dev/reference/grapes-notin-grapes.html
index 4904cbe1..f2a2487d 100644
--- a/dev/reference/grapes-notin-grapes.html
+++ b/dev/reference/grapes-notin-grapes.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/grapes-or-grapes.html b/dev/reference/grapes-or-grapes.html
index a2b8fd08..d800392d 100644
--- a/dev/reference/grapes-or-grapes.html
+++ b/dev/reference/grapes-or-grapes.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/index.html b/dev/reference/index.html
index 158ab111..a4238249 100644
--- a/dev/reference/index.html
+++ b/dev/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/is_auto.html b/dev/reference/is_auto.html
index 7c9fe571..e72c84e6 100644
--- a/dev/reference/is_auto.html
+++ b/dev/reference/is_auto.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/is_order_vars.html b/dev/reference/is_order_vars.html
index 9a5450a9..6c84525f 100644
--- a/dev/reference/is_order_vars.html
+++ b/dev/reference/is_order_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/is_valid_dtc.html b/dev/reference/is_valid_dtc.html
index faa7e895..471c41a5 100644
--- a/dev/reference/is_valid_dtc.html
+++ b/dev/reference/is_valid_dtc.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/joins.html b/dev/reference/joins.html
index 7c30302c..f93ad35c 100644
--- a/dev/reference/joins.html
+++ b/dev/reference/joins.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/process_set_values_to.html b/dev/reference/process_set_values_to.html
index 92a94a2b..a951e435 100644
--- a/dev/reference/process_set_values_to.html
+++ b/dev/reference/process_set_values_to.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/remove_tmp_vars.html b/dev/reference/remove_tmp_vars.html
index 5d82ea29..82318355 100644
--- a/dev/reference/remove_tmp_vars.html
+++ b/dev/reference/remove_tmp_vars.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/replace_symbol_in_expr.html b/dev/reference/replace_symbol_in_expr.html
index ed424d1d..9deab18b 100644
--- a/dev/reference/replace_symbol_in_expr.html
+++ b/dev/reference/replace_symbol_in_expr.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/replace_values_by_names.html b/dev/reference/replace_values_by_names.html
index c1a76cf3..0603a87d 100644
--- a/dev/reference/replace_values_by_names.html
+++ b/dev/reference/replace_values_by_names.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/squote.html b/dev/reference/squote.html
index 1a471736..4a20187e 100644
--- a/dev/reference/squote.html
+++ b/dev/reference/squote.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/suppress_warning.html b/dev/reference/suppress_warning.html
index 85894f7a..a138b316 100644
--- a/dev/reference/suppress_warning.html
+++ b/dev/reference/suppress_warning.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/valid_time_units.html b/dev/reference/valid_time_units.html
index 6ec8b7f5..78a4442e 100644
--- a/dev/reference/valid_time_units.html
+++ b/dev/reference/valid_time_units.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/vars2chr.html b/dev/reference/vars2chr.html
index ea508078..ab1f3608 100644
--- a/dev/reference/vars2chr.html
+++ b/dev/reference/vars2chr.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/warn_if_incomplete_dtc.html b/dev/reference/warn_if_incomplete_dtc.html
index 4f11d63e..cef73a16 100644
--- a/dev/reference/warn_if_incomplete_dtc.html
+++ b/dev/reference/warn_if_incomplete_dtc.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/warn_if_inconsistent_list.html b/dev/reference/warn_if_inconsistent_list.html
index b0d99100..bf6ee949 100644
--- a/dev/reference/warn_if_inconsistent_list.html
+++ b/dev/reference/warn_if_inconsistent_list.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/warn_if_invalid_dtc.html b/dev/reference/warn_if_invalid_dtc.html
index 8c7d515b..d390a378 100644
--- a/dev/reference/warn_if_invalid_dtc.html
+++ b/dev/reference/warn_if_invalid_dtc.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/warn_if_vars_exist.html b/dev/reference/warn_if_vars_exist.html
index 6d84229c..d7e218c7 100644
--- a/dev/reference/warn_if_vars_exist.html
+++ b/dev/reference/warn_if_vars_exist.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/reference/what_is_it.html b/dev/reference/what_is_it.html
index bee0947d..a7dc26de 100644
--- a/dev/reference/what_is_it.html
+++ b/dev/reference/what_is_it.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">admiraldev</a>
 
-    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9025</small>
+    <small class="nav-text text-danger me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="In-development version">1.0.0.9026</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/dev/search.json b/dev/search.json
index def3c30b..99bed1bf 100644
--- a/dev/search.json
+++ b/dev/search.json
@@ -1 +1 @@
-[{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"Apache License","title":"Apache License","text":"Version 2.0, January 2004 <http://www.apache.org/licenses/>","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_1-definitions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"1. Definitions","title":"Apache License","text":"“License” shall mean terms conditions use, reproduction, distribution defined Sections 1 9 document. “Licensor” shall mean copyright owner entity authorized copyright owner granting License. “Legal Entity” shall mean union acting entity entities control, controlled , common control entity. purposes definition, “control” means () power, direct indirect, cause direction management entity, whether contract otherwise, (ii) ownership fifty percent (50%) outstanding shares, (iii) beneficial ownership entity. “” (“”) shall mean individual Legal Entity exercising permissions granted License. “Source” form shall mean preferred form making modifications, including limited software source code, documentation source, configuration files. “Object” form shall mean form resulting mechanical transformation translation Source form, including limited compiled object code, generated documentation, conversions media types. “Work” shall mean work authorship, whether Source Object form, made available License, indicated copyright notice included attached work (example provided Appendix ). “Derivative Works” shall mean work, whether Source Object form, based (derived ) Work editorial revisions, annotations, elaborations, modifications represent, whole, original work authorship. purposes License, Derivative Works shall include works remain separable , merely link (bind name) interfaces , Work Derivative Works thereof. “Contribution” shall mean work authorship, including original version Work modifications additions Work Derivative Works thereof, intentionally submitted Licensor inclusion Work copyright owner individual Legal Entity authorized submit behalf copyright owner. purposes definition, “submitted” means form electronic, verbal, written communication sent Licensor representatives, including limited communication electronic mailing lists, source code control systems, issue tracking systems managed , behalf , Licensor purpose discussing improving Work, excluding communication conspicuously marked otherwise designated writing copyright owner “Contribution.” “Contributor” shall mean Licensor individual Legal Entity behalf Contribution received Licensor subsequently incorporated within Work.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_2-grant-of-copyright-license","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"2. Grant of Copyright License","title":"Apache License","text":"Subject terms conditions License, Contributor hereby grants perpetual, worldwide, non-exclusive, -charge, royalty-free, irrevocable copyright license reproduce, prepare Derivative Works , publicly display, publicly perform, sublicense, distribute Work Derivative Works Source Object form.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_3-grant-of-patent-license","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"3. Grant of Patent License","title":"Apache License","text":"Subject terms conditions License, Contributor hereby grants perpetual, worldwide, non-exclusive, -charge, royalty-free, irrevocable (except stated section) patent license make, made, use, offer sell, sell, import, otherwise transfer Work, license applies patent claims licensable Contributor necessarily infringed Contribution(s) alone combination Contribution(s) Work Contribution(s) submitted. institute patent litigation entity (including cross-claim counterclaim lawsuit) alleging Work Contribution incorporated within Work constitutes direct contributory patent infringement, patent licenses granted License Work shall terminate date litigation filed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_4-redistribution","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"4. Redistribution","title":"Apache License","text":"may reproduce distribute copies Work Derivative Works thereof medium, without modifications, Source Object form, provided meet following conditions: () must give recipients Work Derivative Works copy License; (b) must cause modified files carry prominent notices stating changed files; (c) must retain, Source form Derivative Works distribute, copyright, patent, trademark, attribution notices Source form Work, excluding notices pertain part Derivative Works; (d) Work includes “NOTICE” text file part distribution, Derivative Works distribute must include readable copy attribution notices contained within NOTICE file, excluding notices pertain part Derivative Works, least one following places: within NOTICE text file distributed part Derivative Works; within Source form documentation, provided along Derivative Works; , within display generated Derivative Works, wherever third-party notices normally appear. contents NOTICE file informational purposes modify License. may add attribution notices within Derivative Works distribute, alongside addendum NOTICE text Work, provided additional attribution notices construed modifying License. may add copyright statement modifications may provide additional different license terms conditions use, reproduction, distribution modifications, Derivative Works whole, provided use, reproduction, distribution Work otherwise complies conditions stated License.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_5-submission-of-contributions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"5. Submission of Contributions","title":"Apache License","text":"Unless explicitly state otherwise, Contribution intentionally submitted inclusion Work Licensor shall terms conditions License, without additional terms conditions. Notwithstanding , nothing herein shall supersede modify terms separate license agreement may executed Licensor regarding Contributions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_6-trademarks","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"6. Trademarks","title":"Apache License","text":"License grant permission use trade names, trademarks, service marks, product names Licensor, except required reasonable customary use describing origin Work reproducing content NOTICE file.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_7-disclaimer-of-warranty","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"7. Disclaimer of Warranty","title":"Apache License","text":"Unless required applicable law agreed writing, Licensor provides Work (Contributor provides Contributions) “” BASIS, WITHOUT WARRANTIES CONDITIONS KIND, either express implied, including, without limitation, warranties conditions TITLE, NON-INFRINGEMENT, MERCHANTABILITY, FITNESS PARTICULAR PURPOSE. solely responsible determining appropriateness using redistributing Work assume risks associated exercise permissions License.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_8-limitation-of-liability","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"8. Limitation of Liability","title":"Apache License","text":"event legal theory, whether tort (including negligence), contract, otherwise, unless required applicable law (deliberate grossly negligent acts) agreed writing, shall Contributor liable damages, including direct, indirect, special, incidental, consequential damages character arising result License use inability use Work (including limited damages loss goodwill, work stoppage, computer failure malfunction, commercial damages losses), even Contributor advised possibility damages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_9-accepting-warranty-or-additional-liability","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"9. Accepting Warranty or Additional Liability","title":"Apache License","text":"redistributing Work Derivative Works thereof, may choose offer, charge fee , acceptance support, warranty, indemnity, liability obligations /rights consistent License. However, accepting obligations, may act behalf sole responsibility, behalf Contributor, agree indemnify, defend, hold Contributor harmless liability incurred , claims asserted , Contributor reason accepting warranty additional liability. END TERMS CONDITIONS","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"appendix-how-to-apply-the-apache-license-to-your-work","dir":"","previous_headings":"","what":"APPENDIX: How to apply the Apache License to your work","title":"Apache License","text":"apply Apache License work, attach following boilerplate notice, fields enclosed brackets [] replaced identifying information. (Don’t include brackets!) text enclosed appropriate comment syntax file format. also recommend file class name description purpose included “printed page” copyright notice easier identification within third-party archives.","code":"Copyright 2021 F. Hoffmann-La Roche AG and GlaxoSmithKline LLC  Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at    http://www.apache.org/licenses/LICENSE-2.0  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"dear-developers","dir":"Articles","previous_headings":"","what":"Dear Developers","title":"Get Started","text":"admiraldev set tools intended , developer, help make developing within admiral family easier, consistently robust across packages maybe even fun! Tools loosely defined follows: Utility Functions used admiral admiral extension functions custom checks providing custom messages, warnings errors. custom messages, warnings errors succinct, helpful messaging around function expects inputs. inputs admiral functions many, generally fit three categories: datasets, variables arguments. functions start assert_, is_ get_. Addins utility functions help documentation, testing checking health code base admiral packages. Vignettes working admiral functions, developing unit testing, releases process, vignette writing documentation needs. vignettes intended use across admiral packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"why-have-a-separate-development-package","dir":"Articles","previous_headings":"","what":"Why have a separate development package?","title":"Get Started","text":"admiral package function base grown decided create extension packages use within companies specific TAs help specific problems. intended extension packages follow processes admiral core, e.g. Unit Testing, Roxygen Documentation, Function Design. standalone development package allows us keep date development process developers across family. also feel lot developer functions user-specific gives us freedom create release utility tools specific family packages reduces non-user facing functions within admiral family packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"how-to-add-new-tools-to-admiraldev","dir":"Articles","previous_headings":"","what":"How to add new tools to {admiraldev}?","title":"Get Started","text":"Just like admiral, follow procedures adding issues discuss feature requests, bugs documentation updates. develop issues branches Pull Request Code Review. Experimental tools highly encouraged help reduce repetitive patterns automating boring stuff.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"scenario-one-admiral-core","dir":"Articles","previous_headings":"When to add a function to {admiraldev}?","what":"Scenario One: {admiral} core","title":"Get Started","text":"developer working admiral core implements new type derivation function BDS-Findings ADaM dataset. new derivation function two new assert custom checking functions inputs well helper function. Loose guidelines: derivation function always live admiral core. helper function looked see made available within admiraldev extension packages needs reduce repetitive coding across family admiral. generalized, remain admiral. assert custom checking functions always live within admiraldev stay family assertion functions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"scenario-two-admiral-extension","dir":"Articles","previous_headings":"When to add a function to {admiraldev}?","what":"Scenario Two: {admiral} extension","title":"Get Started","text":"developer working admiralonco implements new type derivation function adding certain parameters oncology specific ADaM dataset. new derivation function one new assert custom checking function. Loose guidelines: derivation function closely looked see can generalized ADaM datasets. case, moved admiral core. function specific oncology needs, remain admiralonco. assert custom checking functions follow similar principle - can generalized therapeutic areas move admiraldev, whereas specific oncology needs, remain admiralonco.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Guidance for git and GitHub Usage","text":"article give overview admiral project utilizing version-control software git website GitHub working RStudio. go primary branches house source code admiral project well use Feature branches address Issues. Issues can range bugs enhancements identified requested developers, users testers. also provide bare minimum git commands needed get running. Please refer Resource section -depth guidance using git GitHub.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"branches","dir":"Articles","previous_headings":"","what":"Branches","title":"Guidance for git and GitHub Usage","text":"main branch contains latest development version package. can find released versions gh-pages branches contains code used render R package websites - looking right now! patch branch reserved special hot fixes address bugs rarely used. info Hot Fix Release main, gh-pages, patch branches protection. try push changes branches get error unless administrator. Feature branches actual development related specific issue happens. Feature branches merged main pull request merged. Check Pull Request Review Guidance guidance merging main.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"working-with-feature-branches","dir":"Articles","previous_headings":"","what":"Working with Feature Branches","title":"Guidance for git and GitHub Usage","text":"Feature Branches developers work addressing Issues.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"implementing-an-issue","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Implementing an Issue","title":"Guidance for git and GitHub Usage","text":"feature branch must related issue. encourage new developers work one issue time.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"naming-branches","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Naming Branches","title":"Guidance for git and GitHub Usage","text":"name branch must prefixed issue number, followed short meaningful description. example, given issue #94 “Program function derive LSTALVDT”, branch name 94_derive_var_lstalvdt.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"create-a-new-feature-branch-from-the-terminal-from-main","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Create a New Feature Branch from the Terminal (from main)","title":"Guidance for git and GitHub Usage","text":"Checkout main branch: git checkout main Pull latest changes GitHub: git pull Create new branch main branch switch : git checkout -b <new_branch_name>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"create-a-new-feature-branch-from-github-from-main","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Create a New Feature Branch from GitHub (from main)","title":"Guidance for git and GitHub Usage","text":"can also create feature branch GitHub. Switch main branch Type new feature branch name Click Create branch: <your_branch_name>@main main Sure Pull newly created branch RStudio","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commits-from-the-terminal-in-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commits from the Terminal in RStudio","title":"Guidance for git and GitHub Usage","text":"start commit process, need tell git move changes staging area. Use git add <your_file> move changes <your_file> staging area wait next commit. can use git add . move files worked staging area. Next can commit, takes snapshot staged changes. committing, prefix message issue number add meaningful message git commit –m '#94 last alive date implementation'. Lastly, push changes GitHub using git push origin <branch name>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commits-from-the-git-tab-in-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commits from the Git Tab in RStudio","title":"Guidance for git and GitHub Usage","text":"can also make use Git Tab within RStudio commit changes. benefit using Tab able see changes file red green highlighting. Just like terminal, start message issue number add meaningful succinct sentence. Hit Commit button Push GitHub.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commit-message-etiquette","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commit Message Etiquette","title":"Guidance for git and GitHub Usage","text":"require developers insert issue number commit message. Placing issue number commit message allows reviewers quickly find discussion surrounding issue. pushed GitHub issue number hyperlinked issue tracker, powerful tool discussion traceability, think valuable highly regulated industry like Pharma. styles commit messaging permitted:","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-1","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 1:","title":"Guidance for git and GitHub Usage","text":"feat: #94 skeleton function developed chore: #94 styler lintr update docs: #94 parameters details sections compelted","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-2","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 2:","title":"Guidance for git and GitHub Usage","text":"#94 skeleton function developed #94 styler lintr update #94 parameters details sections compelted","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-3","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 3:","title":"Guidance for git and GitHub Usage","text":"skeleton function developed (#94) styler lintr update (#94) parameters details sections compelted (#94)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"pull-request","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Pull request","title":"Guidance for git and GitHub Usage","text":"recommend thorough read articles, Pull Request Review Guidance Programming Strategy -depth discussions proper Pull Request.Pull Request authors benefit shorter review times closely following guidance provided two articles. discuss simple git commands terminal GitHub Pull Request. recommend Pull Request GitHub terminal. changes committed, push updated branch GitHub:git push -u origin <branch_name> GitHub, Pull requests, user either “Compare pull request” button /“Create Pull Request”. first button created GitHub detects recent changes made. branch merge must main branch (base = main) compare branch new branch merge - shown picture. Please pay close attention branch merging !  issue must linked pull request “Development” field Pull Request. cases, linkage automatically close issue move Done column project board.  completed Pull Request see committed changes available reviewer. reviewer must specified Pull Request. recommended write brief summary reviewers can quickly come speed Pull Request. Images updates nice , easy GitHub! Use Screen Capture software Copy Paste summary.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"reviewingclosing-an-issue","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Reviewing/Closing an Issue","title":"Guidance for git and GitHub Usage","text":"least one reviewer must approve Pull Request. Please review Pull Request Review Guidance, provides depth guidance proper Pull Request. reviewer must ensure function follows programming strategy recommendations. comment/question/discussion must addressed documented GitHub Pull Request merged review completed, reviewer merge Pull Request feature branch automatically deleted. merging Pull Request please check corresponding moved done column Project Board. Also, please make sure issue closed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"solving-merge-conflicts-in-the-terminal-on-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Solving Merge Conflicts in the Terminal on RStudio","title":"Guidance for git and GitHub Usage","text":"Merge conflict situation git decide changes apply since multiple updates part file. typically happens multiple people update part code. conflicts always need handled manually (code updates may required): provides list files conflicts file conflicts conflicting sections marked <<<<<<<, =======, >>>>>>>. code markers must updated markers removed. Source files need updated manually. Generated files like NAMESPACE generated documentation files updated manually recreated source files updated. make changes available call:","code":"git checkout main git pull git checkout <feature_branch>   git merge main git add <file with conflict>  git commit -m \"<insert_message>\" git push"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"solving-merge-conflicts-in-github","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Solving Merge Conflicts in GitHub","title":"Guidance for git and GitHub Usage","text":"simple merge conflicts, developers can make use GitHub interface solve . GitHub show number conflicts two branches. image, GitHub found 3 conflicts, display first one. Just like terminal, GitHub make use <<<<<<<, =======, >>>>>>> highlight conflicting sections. need make decision whether keep code base feature branch. decided, go code remove section longer wish keep. sure remove <<<<<<<, =======, >>>>>>> well! work conflicts mark Resolved Commit changes. recommended pull branch back RStudio make sure untoward effects happen branch.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"useful-git-commands","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Useful git Commands","title":"Guidance for git and GitHub Usage","text":"merging: git merge <my_branch> - merge my_branch current branch stashing commands useful one wants go back clean directory git stash - stash (store) current changes restore clean directory git stash pop - put back (restore) stashed changes git revert also helpful ? Using code unmerged branches Checkout unmerged branch want use: git checkout <unmerged_branch> Pull latest committed changes unmerged branch: git pull Check feature branch: git checkout <my_branch> Merge unmerged branch : git merge <unmerged_branch>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"github_resources","dir":"Articles","previous_headings":"","what":"Resources on using git, GitHub and RStudio","title":"Guidance for git and GitHub Usage","text":"GitHub RStudio Happy Git GitHub useR","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Package Extensions","text":"admiral made family packages foresee growing time cover specific areas TA (Therapeutic Area) package extensions, wider range companies individuals getting board join development efforts. step--step guidance talks recommendations new development teams go creating package extensions. critical guidance followed, users need feel consistent experience working across admiral packages. admiral package extension doesn’t follow conventions wouldn’t include pharmaverse part admiral family.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"step-by-step-guidance-to-create-a-package-extension","dir":"Articles","previous_headings":"","what":"Step-by-step Guidance to Create a Package Extension","title":"Package Extensions","text":"Note: ordering numbers suggested don’t need strictly followed sequence. Raise need new admiral package extension admiral Slack channel, directly admiral package maintainer. naming convention needs {admiralxxx} request scope targeted overly narrow, example instead package extension HIV ’d prefer one across virology. Otherwise number packages may become unmanageable. agreed, reach company contacts working similar areas see collaborative development can achieved. recommendation always target least 2 companies start implementation remains robust protect going company-specific route. However, consider 4 5 companies get involved early may slow decision-making. companies agree co-develop, identify lead . One company act driver overall package extension put forward product owner technical lead ultimately final say contentious decisions. product owner cover project decisions (e.g. around scope priorities), whereas technical lead cover technical decisions (e.g. around design implementation). technical lead either: ) already significantly involved admiral core development team developer/contributor, b) join core development team simultaneously. ensure design kept true manifesto consistent style quality respect admiral standards. Agree charter expectations company, e.g. usually ask least 3 developers least 25% capacity mix R, GitHub TA experience. Within charter make sure scope timelines clear. important try boil ocean. Focus first common endpoints required foundation package can build via contributions co-development companies also wider across-industry admiral community. useful, admiralonco charter shared guide. company start identify required developer resources. developer required complete {admiral} dummy issue onboarding, well reading admiraldev documentation, - especially developer guides, need followed package extensions. Optionally can useful host kick-meeting decide team work, recommend agile/scrum practices. Set “admiralxxx_dev” channel Slack add team members informal team chat, agree way share working documents across co-development team. recommend use new folder pharmaverse MS Teams - Michael Rimler (michael.s.rimler@gsk.com) help rep PHUSE board. useful starter development activity look pharmaversesdtm check test data sufficient TA needs, e.g. admiralonco generate new test data SDTM domains RS TU. Note personal data used (even anonymized) important keep data generated -line CDISC pilot data use , .e. use USUBJIDs DM etc. Optionally draft, agree sign collaboration agreement collaborating companies wish, useful protecting secondary IP company standard specifications may shared within team. example stored , work Legal teams required. Share company-specific implementations specifications able harmonize design strategy package extension. important remain pragmatic consider higher perspective one company. Engage company standards representatives find discrepancies across company approaches question really need things differently (health authorities patients benefit ?). Also consider always expect level company-specifics covered internal company package extensions. Set new public GitHub repo pharmaverse org using admiraltemplate - includes set-pieces (CI/CD checks issue/PR templates) enable package stay consistent others admiral family, well core package dependencies versions. See {admiraltemplate} Quick Start Guide Note step requires org member access granted pharmaverse council reps, admins org. Also free add additional package dependencies needed assuming reliable packages used, must depend newer versions packages (always reply “” updates suggested installation). repo available technical lead granted admin access repo set GitHub team name package extension assign required access co-development team members. require write access, may choose give leads admin access well never bottle-neck waiting one person. Update template license file repo adding co-development company names place Roche & GSK - admiral package extensions use Apache 2.0, preferred permissive license. Agree co-development companies required extra wording copyright/IP section. Set project board, , help manage backlog. Assuming work agile/scrum, create product backlog, prioritize make sprint plan. intention always re-use much possible admiral core package. find anything additional needed package extension, first question whether might common need TAs consider instead raising issue admiral core. designing new functions always try stay aligned Programming Strategy. Start development foundational first release 0.1.0. Follow consistent Development Process admiral. Line testers companies others set expectations around believe stable version available user testing. can use admiral Slack community raise interest get involved. Add pharmaverse badge README: https://pharmaverse.org/contribute/badges/ - needs support pharmaverse council rep. Raise admiral repo issue ensure package extension site linked core admiral site .` important admiral family packages keep similar release schedule cadence, order ease adoption users give clear expectations. admiral core package cadence releases one every quarter fixed schedule (every first Monday last month quarter - March, June, September, December). core package set release schedule package extensions follow, .e. admiral releases ’d expect package extension releases targeted within 2 week window. releases communicated via Slack channel well quarterly user community meetings. happy package extension well tested sufficient state make submission CRAN. technical lead named maintainer. CRAN release, advertise via Slack & LinkedIn. Plan future enhancements make issues. team feels ready can open development contributions wider community - see page. Please use good first issue (ideal new starters) & help wanted (ideal experienced contributors) issue labels. Note: core admiral team carry periodic reviews extension package contents ensure nothing duplicated ensure standards best practices followed. frequency reviews agreed upon technical leads core extension packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"lessons-learned","dir":"Articles","previous_headings":"","what":"Lessons Learned","title":"Package Extensions","text":"lessons learned previous package extensions: Since ADaM conceived TA-agnostic, TA standards can widely differ across companies, TA package extensions shouldn’t contain many new functions. , functionality required create ADaM present admiral, localized limited exceptions truly TA-specific variables/endpoints. , R folder package extensions relatively lean! Connected , package extension just R functions - also vignettes examples template programs. fact, just important R functions , users turn guidance. Making sure package always --date respect new admiral releases (e.g. due deprecation functions) crucial task. Maintaining package long-term way ensure success. Beware developing just sake developing! may find reach point stasis extension package journey, much need new development. case, vital avoid working tangential tasks. Instead, focus ensuring existing fit--purpose possible.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Pull Request Review Guidance","text":"document intended guidance creators reviewers pull requests (PRs) admiral package family. PR authors benefit shorter review times closely following guidance provided . pull request main branch signifies issue “addressed”. issue might bug, feature request documentation update. Pull Request merged main branch, issue(s) can closed. Closely following guidance ensure “addressed” issues auto-close merge main.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"review-criteria","dir":"Articles","previous_headings":"","what":"Review Criteria","title":"Pull Request Review Guidance","text":"pull request merged main needs pass automated CI checks appear bottom Pull Request. addition, PR creator reviewer make sure Programming Strategy Development Process followed function ADaM IG compliant function intended (described header corresponding issue) function header properly explains intention function, expected inputs (incl. permitted values parameters) output produced; reading documentation reader able predict output function without read source code function accompanying set unit tests; derivations unit test code coverage least 90%; whole package coverage >= 80% implemented derivation scope admiral, e.g. expect company specific input hard-code company-specific rules meaningful error warning messages issued input invalid documentation created/updated running devtools::document() functions supposed exported listed NAMESPACE file; requires @export tag function header examples print relevant source variables newly created variables /records output NEWS.md file updated entry explains new features changes change user-specific warrants mention development milestone files affected implemented changes, e.g. vignettes templates, updated","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"codeowners-and-pr-guidance","dir":"Articles","previous_headings":"Review Criteria","what":"Codeowners and PR Guidance","title":"Pull Request Review Guidance","text":"creator PR, assignment reviewer can unclear. PRs, feel free select members core development team. individuals scan repository regular basis well may provide /review even originally included selected reviewer. Sometimes, development function vignette falls specific-topic, e.g. labs PK/PD. Please ensure include appropriate reviewer modifying files rely domain-expertise. try maintain active list domain-specific topics automatically tag appropriate reviewer using CODEOWNERS file, located .github folder. interested codeowner, reach development team.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"so-much-red-tape","dir":"Articles","previous_headings":"","what":"So much Red Tape!","title":"Pull Request Review Guidance","text":"admiral development team aware sympathetic great many checks, processes documents needed work order compliant Pull Request. task-list-completed GitHub workflow created help reduce burden contributors providing standardized checklist compiles information Pull Request Review Guidance, Programming Strategy Development Process vignettes. next three sections give high-level overview contributor faces opening PR, contributor interacts task-list-completed workflow PR.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"open-a-pull-request","dir":"Articles","previous_headings":"So much Red Tape!","what":"Open a Pull Request","title":"Pull Request Review Guidance","text":"contributor opens PR lengthy standard text inserted comment section. Please alter automated text. need manually add Closes #<insert_issue_number> title Pull Request. can use Edit button top right forget step start Pull Request. Besides free add additional textual information, screenshots, etc. bottom automated text needed clarify contribute discussion around PR.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"create-a-pull-request","dir":"Articles","previous_headings":"So much Red Tape!","what":"Create a Pull Request","title":"Pull Request Review Guidance","text":"click green Create pull request button automated text inserted turned checklist Pull Request. check box drawn previously mentioned vignettes presented recommended sequence. check boxes meant helpful aid ensuring created compliant Pull Request.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"complete-the-pull-request-checklist","dir":"Articles","previous_headings":"So much Red Tape!","what":"Complete the Pull Request checklist","title":"Pull Request Review Guidance","text":"check boxes linked task-list-completed workflow. need check box acknowledgment done due diligence creating compliant Pull Request. GitHub refresh Pull Request trigger task-list-completed workflow completed task. PR can merged main contributor checked check box items.  Please don’t hesitate reach admiral team Slack GitHub Issues tracker think checklist needs amended clarity needed check box item. Note Reviewers: recommend use Squash Merge merging Pull Request. create clean commit history.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"github-actionsci-workflows","dir":"Articles","previous_headings":"","what":"GitHub Actions/CI Workflows","title":"Pull Request Review Guidance","text":"task-list-completed workflow one several workflows/actions used within admiral. workflows live .github/workflows folder important understand use remedy workflow fails. Workflows defined responsible assuring high package quality standards without compromising performance, security, reproducibility.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"a-synopsis-of-admirals-workflows","dir":"Articles","previous_headings":"GitHub Actions/CI Workflows","what":"A synopsis of admiral’s workflows","title":"Pull Request Review Guidance","text":"recommend checking README admiralci repository gain understanding workflows/actions used admiral.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Programming Strategy","text":"admiral intended contributed user community, article meant developers want either expand admiral functionalities build top admiral. order keep framework robust across whole community, defined programming strategy followed cases. contributions include, example, company specific derivations ADaM datasets.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"functional-workflow","dir":"Articles","previous_headings":"","what":"Functional Workflow","title":"Programming Strategy","text":"Overall programming follow functional approach. mandate use tidyverse (e.g. dplyr) similar functionality existing base R ADaM dataset built set functions free flow code. ADaM dataset specific programming workflow. function specific purpose supports ADaM Dataset programming workflow. admiral function company specific function. Admiral functions can re-used company specific functions. function belongs one category defined keywords/family. function used derive one multiple variable(s) required unit tested. Functions standard naming convention. Double coding used QC method (absolutely necessary). ADaMs created readable, submission-ready code.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-design","dir":"Articles","previous_headings":"Functions in R","what":"Function Design","title":"Programming Strategy","text":"Firstly, important explain decide need new derivation functions. derivation rule algorithm common highly similar across different variables/parameters (e.g. study day duration) provide generic function can used satisfy times may needed across different ADaMs. Similarly, feel certain derivation useful beyond single purpose also provide generic function (e.g. instead last known alive date function, extreme date function user find last date selection, example first). Otherwise, feel derivation rule unique need sufficiently complex justify opt dedicated function specific variable/parameter (e.g. treatment-emergent flag AEs). certain variables closely connected (e.g. imputed date corresponding imputation flag) single function provide variables. something needed ADaM achieved simply via existing tidyverse function, wrap admiral function, add unnecessary extra layer users. following principles key designing new function: Modularity - code follows modular approach, .e. steps must clearly separated dedicated purpose. applies scripts creating dataset module create single variable parameter. also complex derivations several steps. Commenting steps key readability. Avoid Copy Paste - similar code used multiple times, put separate function. improves readability maintainability makes unit testing easier. done every simple programming step tidyverse can used. rather computational functions data checks. However, also consider nest many functions. Checks - Whenever function fails, meaningful error message must provided clear reference input caused failure. users dig detailed code want apply function. meaningful error message supports usability. Flexibility - Functions flexible possible long reduce usability. example: source variables newly created variables conditions selecting observations hard-coded. useful argument triggers optional steps, e.g. filter argument specified, input dataset restricted, otherwise step skipped. However, arguments trigger completely different algorithms. example BNRIND derived based BASE based ANRIND. implemented within one function algorithms completely different. BASE used, values categorized ANRIND used, values merged baseline observation.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"input-output-and-side-effects","dir":"Articles","previous_headings":"Functions in R","what":"Input, Output, and Side-effects","title":"Programming Strategy","text":"behavior function determined input, global object, .e. input like datasets, variable names, options, … must provided function arguments. expected input datasets grouped. grouped, function must issue error. function requires grouping, function must provide by_vars argument. output dataset must ungrouped. functions sort (arrange) output dataset end. function needs create temporary variables input dataset, names variables must generated get_new_tmp_var() avoid variables input dataset accidentally overwritten. temporary variables must removed output dataset calling remove_tmp_vars(). developers find need use create environment objects achieve flexibility, use admiral_environment environment object created admiral_environment.R. objects stored environment must documented admiral_environment.R. equivalent environment object .R file exist admiraldev well. details environments work, see relevant sections environments R Packages Advanced R textbooks. general, function must side-effects like creating modifying global objects, printing, writing files, …","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"admiral-options","dir":"Articles","previous_headings":"Functions in R","what":"Admiral Options","title":"Programming Strategy","text":"exception made admiral options, see get_admiral_option() set_admiral_options(), certain pre-defined defaults added flexibility allow user-defined defaults commonly used function arguments e.g. subject_keys currently pre-defined exprs(STUDYID, USUBJID), can modified using set_admiral_options(subject_keys = exprs(...)) top script. reasoning behind relieve user repeatedly changing aforementioned commonly used function arguments multiple times script, may called across many admiral functions. additional flexibility needs added another commonly used function argument e.g. future_input set exprs(...) can added admiral option. function formals define future_input = get_admiral_option(\"future_input\") proceed modify body roxygen documentation set_admiral_options().","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-names","dir":"Articles","previous_headings":"Functions in R","what":"Function Names","title":"Programming Strategy","text":"Function names start verb use snake case, e.g. derive_var_base(). Please note appropriate var/vars prefix used cases function creates variable(s), regardless presence new_var argument function call. Oftentimes creating new derive_var derive_param function may sort non-trivial calculation involved may want write customized function . creating compute_ function becomes appropriate, calculation portion contained one step part overall derive_ function, reducing clutter main function body assisting debugging. addition, compute_ function implemented calculation used one derivation. example compute_bmi() used derive baseline BMI variable ADSL (based baseline weight baseline height variables) also used derive BMI parameter ADVS (based weight height parameters). Please see compute_age_years() derive_var_age_years() another example.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-arguments","dir":"Articles","previous_headings":"Functions in R","what":"Function Arguments","title":"Programming Strategy","text":"default value optional arguments NULL. recommended argument order contributors asked adhere (order keep consistency across functions): dataset (additional datasets denoted dataset_*) by_vars order new_var (related new_var_* arguments) filter (additional filters denoted filter_*) Make sure always mention start_date end_date (related). Names variables inside dataset passed symbols rather strings, .e. AVAL rather \"AVAL\". argument accepts one variables expressions input variables expressions wrapped inside exprs(). example: new_var = TEMPBL by_vars = exprs(PARAMCD, AVISIT) filter = PARAMCD == \"TEMP\" order = exprs(AVISIT, desc(AESEV)) new_vars = exprs(LDOSE = EXDOSE, LDOSEDT = convert_dtc_to_dt(EXSTDTC)) function argument needs tested assert_ type function. expression needs tested following (many utility functions admiral available contributor): whether expression (list expressions, depending function) whether valid expression (.e. whether evaluates without error)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"common-function-arguments-naming-convention","dir":"Articles","previous_headings":"Functions in R","what":"Common Function Arguments Naming Convention","title":"Programming Strategy","text":"first argument derive_ functions input dataset named dataset. one input dataset required, input dataset start dataset_, e.g., dataset_ex. Arguments specifying items add start new_. variable added, second part argument name var, parameter added, param. example: new_var, new_var_unit, new_param. Arguments expect boolean boolean vector must start verb, e.g., is_imputed impute_date. Arguments expect one value variable name must singular version word(s), e.g., missing_value new_var. Arguments expect several values variable names (list, expressions, etc.) must plural version word(s), e.g., missing_values new_vars.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"source-code-formatting","dir":"Articles","previous_headings":"Functions in R","what":"Source Code Formatting","title":"Programming Strategy","text":"source code formatted according tidyverse style guide. lintr styler packages used check enforce .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"comments","dir":"Articles","previous_headings":"Functions in R","what":"Comments","title":"Programming Strategy","text":"Comments added help readers author understand code. two main cases: intention chunk code clear, comment added. comment rephrase code provide additional information. Bad Good long functions (>100 lines) comments can added structure code simplify navigation. case comment end ---- add entry document outline RStudio. example: formatting comments must follow tidyverse style guide. .e., comment start single # space. decoration (except outline entries) must added. Bad Good","code":"# If AVAL equals zero, set it to 0.0001. Otherwise, do not change it   mutate(dataset, AVAL = if_else(AVAL == 0, 0.0001, AVAL)) # AVAL is to be displayed on a logarithmic scale.   # Thus replace zeros by a small value to avoid gaps.   mutate(dataset, AVAL = if_else(AVAL == 0, 0.0001, AVAL)) # Check arguments ---- # This is a comment #  ########################### # This is another comment # ###########################  #+++++++++++++++++++++++++++++++ # This is a section comment ---- #+++++++++++++++++++++++++++++++ # This is a comment  # This is another comment  # This is a section comment ----"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"input-checking","dir":"Articles","previous_headings":"Functions in R","what":"Input Checking","title":"Programming Strategy","text":"line fail-fast design principle, function inputs checked validity , ’s invalid input, function stop immediately error. exception case variable added function already exists input dataset: warning displayed function continue executing. Inputs checked using custom assertion functions defined R/assertions.R. custom assertion functions either return error case invalid input return nothing. common types input arguments like single variable, list variables, dataset, … functions checking available (see assertions). Arguments expect keywords handle case-insensitive manner, e.g., date_imputation = \"FIRST\" date_imputation = \"first\" accepted. assert_character_scalar() function helps handling arguments case-insensitive manner. argument checked outer function argument name inner function. rule applicable functions part admiral.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-header-documentation","dir":"Articles","previous_headings":"Functions in R","what":"Function Header (Documentation)","title":"Programming Strategy","text":"Every function exported package must accompanying header formatted according roxygen2 convention. addition standard roxygen2 tags, @family @keywords tags also used. family/keywords used categorize function, used website internal package help pages. Please see section Categorization functions. example given : following fields mandatory: @param: One entry per function argument. following attributes described: expected data type (e.g. data.frame, logical, numeric etc.), permitted values (applicable), optionality (.e. required argument). expected input dataset required variables clearly stated. Describing default value becomes difficult maintain subject manual error already declared function arguments. description permitted values written separate line italicizing phrase “Permitted Values”, example : @details: natural-language description derivation used inside function. @keyword: One applicable tag function - identical family. @family: One applicable tag function - identical keyword. @return: description return value function. newly added variable(-s) mentioned . @examples: fully self-contained example use function. Self-contained means , code executed new R session, run without errors. means packages need loaded library() datasets needed either created directly inside example code loaded using data(). dataset created example, done using function tribble() (specify library(dplyr) calling function). functions called example, please specify library(pkg_name) refer respective function fun() opposed preferred pkg_name::fun() notation specified Unit Test Guidance. Make sure align columns ensures quick code readability. Copying descriptions avoided makes documentation hard maintain. example argument description used one function, argument described one function functions use @inheritParams <function name argument described>. Please note @inheritParams func_first used header func_second() function, argument descriptions func_first() included documentation func_second() argument offered func_second() @param tag argument included header func_second(). order @param tags function definition. @inheritParams tags @param. affect order argument description rendered documentation makes easier maintain headers. Variable names, expressions, functions, code must enclosed backticks. render code. functions derive specific CDISC variable, title must state label variable without variable name. variable stated description.","code":"#' Derive Relative Day Variables #' #' Adds relative day variables (`--DY`) to the dataset, e.g., `ASTDY` and #' `AENDY`. #' #' @param dataset Input dataset #' #'   The columns specified by the `reference_date` and the `source_vars` #'   argument are expected. #' #' @param reference_date The start date column, e.g., date of first treatment #' #'   A date or date-time object column is expected. #' #'   Refer to `derive_var_dt()` to impute and derive a date from a date #'   character vector to a date object. #' #' @param source_vars A list of datetime or date variables created using #'   `exprs()` from which dates are to be extracted. This can either be a list of #'   date(time) variables or named `--DY` variables and corresponding --DT(M) #'   variables e.g. `exprs(TRTSDTM, ASTDTM, AENDT)` or `exprs(TRTSDT, ASTDTM, #'   AENDT, DEATHDY = DTHDT)`. If the source variable does not end in --DT(M), a #'   name for the resulting `--DY` variable must be provided. #' #' @details The relative day is derived as number of days from the reference #'   date to the end date. If it is nonnegative, one is added. I.e., the #'   relative day of the reference date is 1. Unless a name is explicitly #'   specified, the name of the resulting relative day variable is generated #'   from the source variable name by replacing DT (or DTM as appropriate) with #'   DY. #' #' @return The input dataset with `--DY` corresponding to the `--DTM` or `--DT` #'   source variable(s) added #' #' @keywords der_date_time #' @family der_date_time #' #' @export #' #' @examples #' library(lubridate) #' library(dplyr, warn.conflicts = FALSE) #' #' datain <- tribble( #'   ~TRTSDTM,              ~ASTDTM,               ~AENDT, #'   \"2014-01-17T23:59:59\", \"2014-01-18T13:09:O9\", \"2014-01-20\" #' ) %>% #'   mutate( #'     TRTSDTM = as_datetime(TRTSDTM), #'     ASTDTM = as_datetime(ASTDTM), #'     AENDT = ymd(AENDT) #'   ) #' #' derive_vars_dy( #'   datain, #'   reference_date = TRTSDTM, #'   source_vars = exprs(TRTSDTM, ASTDTM, AENDT) #' ) #'   *Permitted Values*: example description of permitted values here"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"categorization-of-functions","dir":"Articles","previous_headings":"Functions in R","what":"Categorization of Functions","title":"Programming Strategy","text":"functions categorized keywords families within roxygen header. Categorization important admiral user-facing functions base totals 125 growing! However, ease burden developers, decided keywords families identical roxygen header, specified via @keywords @family fields. reiterate, function must use keyword family. Also, please note keywords families case-sensitive.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"keywords","dir":"Articles","previous_headings":"Functions in R > Categorization of Functions","what":"@keywords","title":"Programming Strategy","text":"keywords allows reference page easily organized using certain pgkdown functions. example, using function has_keyword(der_bds_gen) _pkgdown.yml file building website collect BDS General Derivation functions display alphabetical order Reference Page section called BDS-Specific.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"family","dir":"Articles","previous_headings":"Functions in R > Categorization of Functions","what":"@family","title":"Programming Strategy","text":"families allow similar functions displayed See Also section function’s documentation. example, user looking derive_vars_dy() function documentation might interested Date/Time functions. Using @family tag der_date_time display Date/Time functions available admiral user See Also section derive_vars_dy() function documentation. Please take look function documentation derive_vars_dy() see family tag action. list available keyword/family tags used admiral functions. think additional keyword/family tag added, please add issue GitHub discussion. NOTE: strongly encouraged @keyword @family identical. eases burden development maintenance admiral functions. need use multiple keywords families, please reach core development team discussion.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"missing-values","dir":"Articles","previous_headings":"","what":"Missing values","title":"Programming Strategy","text":"Missing values (NAs) need explicitly shown. Regarding character vectors converted SAS files: SAS treats missing character values blank. imported R empty strings (\"\") although nature missing values (NA). empty strings originate like need converted proper R missing values NA.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"file-structuring","dir":"Articles","previous_headings":"","what":"File Structuring","title":"Programming Strategy","text":"Organizing functions files art science. Thus, hard rules just recommendations. First foremost, two extremes avoided: putting function file putting functions single file. Apart following recommendations taken consideration deciding upon file structuring: function long (together documentation), store separate file functions documented together, put one file functions sort commonality relevance one another (like dplyr::bind_rows() dplyr::bind_cols()), put one file Store functions together helpers methods 1000 lines single file, unless necessary (exceptions , example, classes methods) responsibility author new function reviewer ensure recommendations put practice.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"r-package-dependencies","dir":"Articles","previous_headings":"","what":"R Package Dependencies","title":"Programming Strategy","text":"Package dependencies documented DESCRIPTION file. package used examples /unit tests listed Suggests, otherwise Imports. Functions packages explicitly imported using @importFrom tag R/admiral-package.R file. import if_else() mutate() function dplyr following line included file: #' @importFrom dplyr if_else mutate. using @importFrom tag, easier track dependencies one place improves code readability. functions become critically important using admiral included export. applies functions frequently called within {admiral }function calls like rlang::exprs(), dplyr::desc() pipe operator dplyr::%>%. export functions, following R code included R/reexports.R file using format:","code":"#' @export pkg_name::fun"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"metadata","dir":"Articles","previous_headings":"","what":"Metadata","title":"Programming Strategy","text":"Functions perform derivation logic add kind metadata, e.g. labels.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"unit-testing","dir":"Articles","previous_headings":"","what":"Unit Testing","title":"Programming Strategy","text":"function requires set unit tests verify produces expected result. See Writing Unit Tests {admiral} details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"deprecation","dir":"Articles","previous_headings":"","what":"Deprecation","title":"Programming Strategy","text":"admiral still evolving, functions arguments may need removed replaced efficient options one release another. cases, relevant function argument must marked deprecated. deprecation done three phases release cycles. Phase 1: release identified function argument deprecated warning issued using function argument using deprecate_warn(). Phase 2: next release error thrown using deprecate_stop(). Phase 3: Finally 3rd release thereafter function removed package altogether. Information deprecation timelines must added warning/error message. Note deprecation cycle time function argument based current release schedule 6 months.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"documentation","dir":"Articles","previous_headings":"Deprecation","what":"Documentation","title":"Programming Strategy","text":"function argument removed, documentation must updated indicate function argument now deprecated new function/argument used instead. documentation updated : description level function, @keywords @family roxygen tags replaced deprecated @examples section removed. @param level argument.","code":"#' Title of the function #' #' @description #' `r lifecycle::badge(\"deprecated\")` #' #' This function is *deprecated*, please use `new_fun()` instead. #' . #' @family deprecated #' #' @keywords deprecated #' . @param old_param *Deprecated*, please use `new_param` instead."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"handling-of-warning-and-error","dir":"Articles","previous_headings":"Deprecation","what":"Handling of Warning and Error","title":"Programming Strategy","text":"function argument deprecated, function must updated issue warning error using deprecate_warn() deprecate_stop(), respectively, described . test case added test file function checks whether warning/error issued appropriate using deprecated function argument.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function","dir":"Articles","previous_headings":"Deprecation > Handling of Warning and Error","what":"Function","title":"Programming Strategy","text":"initial release function deprecated original function body must replaced call deprecate_warn() subsequently arguments passed new function. following release function body changed just include call deprecate_stop(). Finally, next release function removed package.","code":"fun_xxx <- function(dataset, some_param, other_param) {   deprecate_warn(\"x.y.z\", \"fun_xxx()\", \"new_fun_xxx()\")   new_fun_xxx(     dataset = dataset,     some_param = some_param,     other_param = other_param   ) } fun_xxx <- function(dataset, some_param, other_param) {   deprecate_stop(\"x.y.z\", \"fun_xxx()\", \"new_fun_xxx()\") }"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"argument","dir":"Articles","previous_headings":"Deprecation > Handling of Warning and Error","what":"Argument","title":"Programming Strategy","text":"argument removed replaced, error must generated: argument renamed replaced, warning must issued new argument takes value old argument next release. Note: arguments passed exprs() argument (e.g. new_var = VAR1 filter = AVAL >10) need quoted.","code":"### BEGIN DEPRECATION   if (!missing(old_param)) {     deprecate_stop(\"x.y.z\", \"fun_xxx(old_param = )\", \"fun_xxx(new_param = )\")   } ### END DEPRECATION ### BEGIN DEPRECATION   if (!missing(old_param)) {     deprecate_warn(\"x.y.z\", \"fun_xxx(old_param = )\", \"fun_xxx(new_param = )\")     # old_param is given using exprs()     new_param <- old_param     # old_param is NOT given using exprs()     new_param <- enexpr(old_param)   } ### END DEPRECATION"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"unit-testing-1","dir":"Articles","previous_headings":"Deprecation","what":"Unit Testing","title":"Programming Strategy","text":"Unit tests deprecated functions arguments must added test file 1 function ensure warning error issued. writing unit test, check error warning right class, .e., \"lifecycle_error_deprecated\" \"lifecycle_warning_deprecated\", respectively. unit-test follow corresponding format, per unit test guidance.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"for-deprecated-functions-that-issues-a-warning-phase-1","dir":"Articles","previous_headings":"Deprecation > Unit Testing","what":"For Deprecated Functions that Issues a Warning (Phase 1)","title":"Programming Strategy","text":"unit test like following must added. existing unit tests call deprecated function need enclosed suppress_warning(). example, regexpr argument must specified ensure deprecation warning suppressed.","code":"## Test #: deprecation warning if function is called ---- test_that(\"derive_var_example() Test #: deprecation warning if function is called\", {   expect_warning(     derive_var_example(),     class = \"lifecycle_warning_deprecated\"   ) }) actual <- suppress_warning(     derive_var_example(),     regexpr = \"was deprecated\"   )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"for-deprecated-functions-that-issues-an-error-phase-2","dir":"Articles","previous_headings":"Deprecation > Unit Testing","what":"For Deprecated Functions that Issues an Error (Phase 2)","title":"Programming Strategy","text":"unit test like following must added. unit tests deprecated function must removed.","code":"## Test #: error if function is called ---- test_that(\"derive_var_example() Test #: deprecation error if function is called\", {   expect_error(     derive_var_example(),     class = \"lifecycle_error_deprecated\"   ) })"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"best-practices-and-hints","dir":"Articles","previous_headings":"","what":"Best Practices and Hints","title":"Programming Strategy","text":"Please take following list recommendation try adhere rules possible. Arguments function calls named except first parameter (e.g. assert_data_frame(dataset, required_vars = exprs(var1, var2), optional = TRUE)). dplyr::if_else() used two conditions. Try always set missing argument whenever appropriate.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"how-quoting-is-used","dir":"Articles","previous_headings":"Best Practices and Hints","what":"How Quoting is used","title":"Programming Strategy","text":"admiral arguments require selecting one particular option like mode, e.g. mode = \"last\". Use quotation marks capture . expected assertion function corresponding arguments assert_character_scalar()/assert_character_vector(). Many admiral arguments require capturing expression, typically encased exprs() statement, evaluated later inside function body, see arguments like new_vars, e.g. new_vars = exprs(TRTSDTM = EXSTDTM). Oftentimes, assertion function corresponding assert_expr()/assert_expr_list(). arguments unquoted using !!!. admiral arguments like new_var filter expect single variable expression quoted call. function body, quoted using enexpr(). Usually combined assertion, e.g., new_var <- assert_symbol(enexpr(new_var)). arguments unquoted using !!. Keep mind !! one--one replacement !!! one--many replacement. Please see chapter Advanced R textbook details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"standardizing-text-used-to-label-and-describe-arguments","dir":"Articles","previous_headings":"Best Practices and Hints","what":"Standardizing Text Used to Label and Describe Arguments","title":"Programming Strategy","text":"following PR, find example function argument dataset able standardized Label Description said function argument aligned across codebase. Please see changes file derive_adeg_params.R details. benefits programmatic way write documentation changes need made, making modification corresponding function, case, roxygen_param_dataset(), scales across codebase, can tested, less prone user-error typos grammar mistakes. functions implemented roxygen2.R naming convention argument follows roxygen_param_xxx(), “xxx” replaced argument name.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"r-and-package-versions-for-development","dir":"Articles","previous_headings":"","what":"R and Package Versions for Development","title":"Programming Strategy","text":"choice R Version set stone. However, common development environment important establish working across multiple companies multiple developers. currently work earliest three latest R Versions. need common development environment also carries choice package versions. GitHub allows us Actions/Workflows test admiral several versions R well several versions dependent R packages needed admiral. Currently test admiral three latest R Versions closest snapshots packages R versions. can view workflow others admiralci GitHub Repository. common development allows us easily re-create bugs provide solutions issues developers encounter. Reviewers Pull Requests running code know environment identical initiator Pull Request. ensures faster review times higher quality Pull Request reviews. achieve common development environment using lockfile created renv package. New developers encounter suggested renv::restore() console revert move forward R version package versions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"common-r-cmd-check-issues","dir":"Articles","previous_headings":"","what":"Common R CMD Check Issues","title":"R CMD Issues","text":"R CMD check command line tool checks R packages standard set criteria. pull request pass check must issue notes, warnings errors. list common issues resolve .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"check-fails-only-on-one-version","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Check Fails Only on One Version","title":"R CMD Issues","text":"R CMD check workflow fails one two R versions can helpful reproduce testing environment locally. reproduce particular R version environment open admiral project corresponding R version, comment line source(\"renv/activate.R\") .Rprofile file, restart R session run following commands R console. ensure exact package versions use workflow installed hidden folder .library. way existing R packages overwritten.","code":"Sys.setenv(R_REMOTES_NO_ERRORS_FROM_WARNINGS = \"true\")  if (!dir.exists(\".library\")) {   dir.create(\".library\") }  base_recommended_pkgs <- row.names(installed.packages(priority = \"high\")) for (pkg in base_recommended_pkgs) {   path <- file.path(.Library, pkg)   cmd <- sprintf(\"cp -r %s .library\", path)   system(cmd) } assign(\".lib.loc\", \".library\", envir = environment(.libPaths))  r_version <- getRversion() if (grepl(\"^4.1\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2021-05-03/\") } else if (grepl(\"^4.2\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2022-01-03/\") } else if (grepl(\"^4.3\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2023-04-20/\") } else {   options(repos = \"https://cran.rstudio.com\") }  if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") } remotes::install_deps(dependencies = TRUE) remotes::install_github(\"pharmaverse/pharmaversesdtm\", ref = \"devel\") remotes::install_github(\"pharmaverse/admiraldev\", ref = \"devel\") rcmdcheck::rcmdcheck()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"package-dependencies","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Package Dependencies","title":"R CMD Issues","text":"Add pkg Imports Suggests field DESCRIPTION file. general, dependencies listed Imports field. However, package used inside vignettes unit tests listed Suggests admiral functions work without “soft” dependencies installed.","code":"> checking package dependencies ... ERROR   Namespace dependency not required: ‘pkg’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"global-variables","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Global Variables","title":"R CMD Issues","text":"Add some_var list “global” variables R/globals.R.","code":"❯ checking R code for possible problems ... NOTE   function_xyz: no visible binding for global variable ‘some_var’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"undocumented-function-parameter","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Undocumented Function Parameter","title":"R CMD Issues","text":"Add @param some_param section header function_xyz() run devtools::document() afterwards.","code":"❯ checking Rd \\usage sections ... WARNING   Undocumented arguments in documentation object 'function_xyz'     ‘some_param’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"outdated-documentation","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Outdated Documentation","title":"R CMD Issues","text":"name parameter changed function code yet header. Change @param old_param_name @param new_param_name run devtools::document(). reading recommend R-pkg manual r-cmd chapter","code":"❯ checking for code/documentation mismatches ... WARNING   Codoc mismatches from documentation object 'function_xyz':   ...   Argument names in code not in docs:     new_param_name   Argument names in docs not in code:     old_param_name   Mismatches in argument names:     Position: 6 Code: new_param_name Docs: old_param_name"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Release Strategy","text":"article explains package releases admiral across package extensions. includes details around planned/scheduled releases, well hotfixes.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"release-schedule","dir":"Articles","previous_headings":"","what":"Release Schedule","title":"Release Strategy","text":"release schedule maintained homepage.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"planning-releases","dir":"Articles","previous_headings":"","what":"Planning Releases","title":"Release Strategy","text":"past, whenever started looking towards future release, create new release issue label GitHub form release Q4-2022 prioritize issues. However, backlog minimal every issue considered Priority Issue. issue Priority, sent back Discussion Tab formed Priority issue. share advance users high level summary expected package updates via community meetings, especially anticipated breaking changes.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"package-release-process","dir":"Articles","previous_headings":"","what":"Package Release Process","title":"Release Strategy","text":"following important steps planned release hot fix release described. Depending package may helpful use usethis::use_release_issue() package-specific release_bullets() function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"planned-release","dir":"Articles","previous_headings":"Package Release Process","what":"Planned Release","title":"Release Strategy","text":"package release done following steps: Create release version: Create new feature branch main. Call usethis::use_version() update Versions: field DESCRIPTION file update NEWS.md (replace “(development version)” version released) Create PR main merge . title PR must contain “[skip vbump]”. Otherwise, vbump workflow sets version development version CRAN reject submission. Bundle main (devtools::build(manual = TRUE)) send CRAN. See chapter R Packages details. CRAN asks modifications, repeat steps 1-2 necessary. package accepted available CRAN, use release button GitHub “release” package onto GitHub, select main branch target, use tag form vX.Y.Z, e.g., v1.1.2 (see past admiral releases reference Releasing Github section details). releases onto Github archives version code within main branch, attaches News/Changelog file, bundles code tar.gz file makes validation report via GitHub action validation insightsengineering/validatoR. also builds website released version stores new vx.y.z folder gh-pages branch. Merge main patch prepared case needed hotfix. Create next development version: Create new feature branch main. Call usethis::use_dev_version() update NEWS.md (adds new section # admiral (development version)) update version DESCRIPTION file development version. Create PR main merge .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"hot-fix-release","dir":"Articles","previous_headings":"Package Release Process","what":"Hot Fix Release","title":"Release Strategy","text":"Rarely, may need release hot fix immediately address bug. majority cases, -cycle release can made directly main branch, bug fixes new features released earlier planned, thus avoiding patch branch release. hot fix release done following steps: Identify bugs need fixed hot fix release label “hotfix” label. Branches addressing bugs Pull Requests merged single patch branch main branch, patch branch created recent release package. , run following git commands: git checkout -b patch vX.Y.Z git push -u origin patch need use development versions. .e., first pull request set version DESCRIPTION version released corresponding heading added NEWS.md. naming branch follow naming conventions guide. PRs hot fix merged (patch), bundle patch (devtools::build(manual = TRUE)) send CRAN. See chapter R Packages details. CRAN asks modifications, repeat steps 1-4 necessary. package accepted available CRAN, , use release button GitHub “release” package onto GitHub, select patch branch target, use tag form vX.Y.Z, e.g., v1.1.2 (see past admiral releases reference Releasing Github section details). releases onto Github archives version code within patch branch, attaches News/Changelog file, bundles code tar.gz file makes validation report via GitHub action validation insightsengineering/validatoR. also builds website released version stores new vx.y.z folder gh-pages branch. hot fixes merged main branch additional Pull Request. Merging PR update version DESCRIPTION file development version. Create next development version: Create new feature branch main. Update NEWS.md (add new section # admiral (development version)) Create PR main merge .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"releasing-to-github","dir":"Articles","previous_headings":"","what":"Releasing to Github","title":"Release Strategy","text":"Releases section main repo, select Draft New Release. Proceed creating appropriate release tag header, denoted vX.X.X admiral X.X.X respectively, release:  Copy contents NEWS.md section release, paste release notes section:  upload box says, “Attach binaries dropping selecting ” upload appropriate admiral_X.X.X.tar.gz file available download CRAN website. Click Publish Release ’re done! NB: Occasionally, might need delete tag something done error. Deleting tag can done GitHub must done terminal. However, easy!! Just use: git push --delete origin tagname","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"release-tracking","dir":"Articles","previous_headings":"","what":"Release Tracking","title":"Release Strategy","text":"new package release submitted CRAN awaiting go-live, can track status searching within dashboard.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"communications","dir":"Articles","previous_headings":"","what":"Communications","title":"Release Strategy","text":"release, raise awareness via Slack channel LinkedIn.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-become-a-safety-net-for-developers","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Become a Safety Net for Developers","title":"Unit Test Guidance","text":"comprehensive suite unit tests can act safety net developers. frequently running tests, can assure recent modifications code haven’t broken anything. words, unit tests help prevent regressions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-can-contribute-to-higher-code-quality","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Can Contribute to Higher Code Quality","title":"Unit Test Guidance","text":"Since unit tests act safety net, developers become confident changing code. can refactor code without fear breaking things, driving general quality code base .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-can-contribute-to-better-application-architecture","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Can Contribute to Better Application Architecture","title":"Unit Test Guidance","text":"can add unit tests easily code base, ’s usually good sign regarding quality app’s architecture. , drive write testable code can incentive better architecture.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"detects-code-smells-in-your-codebase","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Detects Code Smells in your Codebase","title":"Unit Test Guidance","text":"ease adding unit tests code base good sign, opposite also true. hard time creating unit tests given piece code might sign code smells code—e.g. functions complex.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-fast","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Fast","title":"Unit Test Guidance","text":"’re slow, developers won’t run often . defeats whole purpose suite unit tests first place, boost developers’ confidence make changes code. tests can’t work safety net ’re run often.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-simple","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Simple","title":"Unit Test Guidance","text":"several techniques can apply high degree confidence correctness tests. One keep tests low cyclomatic complexity. Cyclomatic complexity code metric indicates number possible execution paths given method can follow. piece code lower complexity easier understand maintain, means developers less likely introduce bugs working . can measure cyclomatic complexity tests (using, instance, linter tool) best keep low.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"test-shouldnt-duplicate-implementation-logic","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Test Shouldn’t Duplicate Implementation Logic","title":"Unit Test Guidance","text":"person wrote test implementation, ’s possible made errors places. Since tests mirror implementation, might still pass, implementation wrong, tests might fool thinking otherwise. Resist urge make tests fancy, keep simple, testing suite better .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-readable","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Readable","title":"Unit Test Guidance","text":"best practice overlaps little bit one keeping tests simple. tests hard read, developers likely misunderstand introduce bugs. Test cases used form documentation, obviously need readable.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"running-unit-tests-part-of-the-build-process","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Running Unit Tests Part of the Build Process","title":"Unit Test Guidance","text":"Automate whole process running unit tests taking action fail. build process execute unit tests mark build broken tests fail.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"plan-your-unit-tests","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Plan your Unit Tests","title":"Unit Test Guidance","text":"Start considering derivation rule testing possible arguments/flexibilities function code. plan scenarios test. can either involve generating different input test cases feeding different calls function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"test-coverage","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Test coverage","title":"Unit Test Guidance","text":"Unit tests cover functionality function. another function g() called within function f(), unit tests f() test functionality g(). tested unit tests g(), .e. unit tests added lowest level.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-robust-to-cover-realistic-data-scenarios","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Tests Should be Robust to Cover Realistic Data Scenarios","title":"Unit Test Guidance","text":"generating input test cases, can helpful consider regular cases (expected common data scenarios), boundary cases (data points close equal), special cases (uncommon valid data scenarios, e.g. missing special characters). Although never cover every single eventuality possible input data (reliability testing method ever gives 100% certainty), need give confidence code robust enough work across data scenarios.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"testing-should-cover-possible-arguments","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Testing Should Cover Possible Arguments","title":"Unit Test Guidance","text":"different calls function, consider user might apply function test variety possible calls, whilst still remembering tips tests fast simple. needed cases complexity level flexibility function justifies , e.g. see test script: https://github.com/pharmaverse/admiral/blob/main/tests/testthat/test-derive_var_extreme_flag.R.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"exported-functions","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Exported Functions","title":"Unit Test Guidance","text":"Don’t forget add unit test exported function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"snapshot-testing","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Snapshot Testing","title":"Unit Test Guidance","text":"Standard unit tests always convenient record expected behavior code. challenges include: Output large, making painful define reference output, bloating size test file making hard navigate. Text output includes many characters like quotes newlines require special handling string. Binary formats like plots images, difficult describe code: .e. plot looks right, error message useful human, print method uses color effectively. situations, testthat provides alternative mechanism: snapshot tests. Snapshot tests record results separate human readable file records results, including output, messages, warnings, errors. Review {testthat} snapshot vignette details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"set-up-the-test-script","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Set up the Test Script","title":"Unit Test Guidance","text":"Within tests/testthat folder project, add script naming convention test-<script_containing_function>.R., unit test script can created console also, follows: testing framework used testthat following format : example, testing function called my_new_func contained script all_funcs.R console use: Open newly created file test-all_funcs.R use following format: Note: comparing datasets admiral use function expect_dfs_equal(). input expected output unit tests must follow following rules: Input output simple possible. Values hard-coded whenever possible. values need derived, unit tested functions can used. contrast Programming Strategy documentation function examples, test files include library(pkg_name) calls. dataset needs created testing purposes, done using function tribble() tibble package following command dplyr::tribble(<data >). Furthermore, functions need called, also done using pkg_name::fun()notation. Make sure align columns well. ensures quick code readability. Ensure give meaningful explanation test testthat call, compiled package validation report. name function test ID included title also help traceability. comments ending ---- create entries TOC RStudio.","code":"usethis::use_test(\"<script_containing_function>\") ## Test 1: <Explanation of the test> ---- test_that(\"<function_name> Test 1: <Explanation of the test>\", {      input <- dplyr::tribble(     ~inputvar1, ~inputvar2, ...     <Add Test Data Scenarios>     ...   )    expected_output <- mutate(input, outputvar = c(<Add Expected Outputs>))    expect_dfs_equal(<function name>(input), expected_output)    }) usethis::use_test(\"all_funcs\") # my_new_func ---- ## Test 1: <Explanation of the test> ---- test_that(\"my_new_func Test 1: <Explanation of the test>\", {      input <- dplyr::tribble(     ~inputvar1, ~inputvar2, ...     <Add Test Data Scenarios>     ...   )    expected_output <- mutate(input, outputvar = c(<Add Expected Outputs>))    expect_dfs_equal(<function name>(input), expected_output) })"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"addin-admiraldevformat_test_that_file","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Addin admiraldev::format_test_that_file()","title":"Unit Test Guidance","text":"ease burden developers writing adding tests developed Addin formatting test_that test files according admiral programming standards. Addin add update comments well number re-numbers tests. Just use Addin button select “Format test_that test file” seen image. sure test-file open selected calling Addin.  Addin perform following: Updates adds number tests comments test_that() call Updates comments based description provided test_that() call Updates function name test_that() call. function name extracted last # <function name> ---- comment test_that() call. test file tests one function, comments added first test function. test files tests single function , comments can omitted. case addin determines function name file name stripping “test-” prefix “.R” suffix. writing new unit tests, just provide description test_that() call necessary function name # <function name> ---- comment: Call addin get: tested unit test program, can run unit tests console, follows. running just tests current file call","code":"# arg_name ---- test_that(\"arg_name works\", {   expect_equal(arg_name(sym(\"a\")), \"a\")   expect_equal(arg_name(call(\"enquo\", sym(\"a\"))), \"a\")   expect_error(arg_name(\"a\"), \"Could not extract argument name from\") })  # convert_dtm_to_dtc ---- test_that(\"works if dtm is in correct format\", {   expect_equal(     convert_dtm_to_dtc(as.POSIXct(\"2022-04-05 15:34:07 UTC\")),     \"2022-04-05T15:34:07\"   ) })  test_that(\"Error is thrown if dtm is not in correct format\", {   expect_error(     convert_dtm_to_dtc(\"2022-04-05T15:26:14\"),     \"lubridate::is.instant(dtm) is not TRUE\",     fixed = TRUE   ) }) # arg_name ---- ## Test 1: arg_name works ---- test_that(\"arg_name Test 1: arg_name works\", {   expect_equal(arg_name(sym(\"a\")), \"a\")   expect_equal(arg_name(call(\"enquo\", sym(\"a\"))), \"a\")   expect_error(arg_name(\"a\"), \"Could not extract argument name from\") })  # convert_dtm_to_dtc ---- ## Test 2: works if dtm is in correct format ---- test_that(\"convert_dtm_to_dtc Test 2: works if dtm is in correct format\", {   expect_equal(     convert_dtm_to_dtc(as.POSIXct(\"2022-04-05 15:34:07 UTC\")),     \"2022-04-05T15:34:07\"   ) })  ## Test 3: Error is thrown if dtm is not in correct format ---- test_that(\"convert_dtm_to_dtc Test 3: Error is thrown if dtm is not in correct format\", {   expect_error(     convert_dtm_to_dtc(\"2022-04-05T15:26:14\"),     \"lubridate::is.instant(dtm) is not TRUE\",     fixed = TRUE   ) }) devtools::test() devtools::test_file()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"automation-of-unit-tests","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Automation of Unit Tests","title":"Unit Test Guidance","text":"user actions pull request {admiral} GitHub repo, unit tests automatically run pull request denied unit tests fail.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Writing Vignettes","text":"guidance ensures consistency across vignettes admiral package terms content, structure code execution. general rule, vignette workflow defined r-pkgs.org followed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"metadata","dir":"Articles","previous_headings":"","what":"Metadata","title":"Writing Vignettes","text":"vignette admiral start following metadata. <Title> vignette meaningful.","code":"--- title: \"<Title>\" output:  rmarkdown::html_vignette: vignette: >   %\\VignetteIndexEntry{<Title>}   %\\VignetteEngine{knitr::rmarkdown} ---"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"default-options","dir":"Articles","previous_headings":"Markdown","what":"Default Options","title":"Writing Vignettes","text":"chunks used within vignette, following options set metadata ensure chunks rendered consistently across vignettes.","code":"```{r setup, include=FALSE} knitr::opts_chunk$set(   collapse = TRUE,   comment = \"#>\" ) ```"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"table-of-contents","dir":"Articles","previous_headings":"Markdown > Format Sections","what":"Table of Contents","title":"Writing Vignettes","text":"Headings must title case start Heading 1: first section gives brief introduction vignette. last sub-section introduction describe packages required run admiral functions. admiral package described first. warning=FALSE message=FALSE options prevent usual messages: Attaching package: ‘xxxx’following objects masked ‘package:yyyyy’ fun1, fun2","code":"# Heading 1 This is the description of my first section.  ## Heading 1.1 This is the description of my first sub-section within my first section.  ## Heading 1.2 This is the description of my second sub-section within my first section. # Introduction  This is the introduction of my vignette.  ## Required Packages ```{r, warning=FALSE, message=FALSE} library(admiral) # <all packages used in the vignette> ```"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"general-conventions","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"General Conventions","title":"Writing Vignettes","text":"new vignette must added _pkgdown.yml file relevant section. variable name, dataset name, function, argument name must quoted backticks: e.g. Functions must also end (). Variables datasets name expected uppercase. codes must described, executed output result displayed code executed. Use: output created must clearly show function derived. least show variables/records used input function derived variables/records. dataset must displayed, formatted using dataset_vignette() function displayed consistently across vignettes.E.g. Description execution code used derive variable/record Output dataset formatted using dataset_vignette()… Note: call get formatted dataset : Displaying many big datasets vignette, may require long time load page may cause messages browser page responsive. case number displayed observations restricted either restricting source datasets beginning vignette call dataset_vignette() calls affected.","code":"The `date` parameter of the `derive_my_var()` function expects a date variable, e.g., `ADT`. ```{r} #<code> ``` vs1 <- vs %>%   derive_vars_dt(     new_vars_prefix = \"A\",     dtc = VSDTC,     date_imputation = \"first\"   ) ```r   dataset_vignette(     vs1,     display_vars = exprs(USUBJID, VSTESTCD, VISIT, VSDTC, ADT),     filter = VSTESTCD == \"WEIGHT\"   )   ```"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"using-footnotes","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"Using Footnotes","title":"Writing Vignettes","text":"Footnotes can useful add context without adding clutter primary subject matter vignette written. use footnotes, add caret identifier inside brackets e.g. ([^1]). identifiers can numbers words, can’t contain spaces tabs. following markdown text render follows: example 1","code":"Here is an example [^1]  [^1]: Cool note about the example."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"conventions-for-adam-workflow","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"Conventions for ADaM Workflow","title":"Writing Vignettes","text":"vignettes describing ADaM workflow, second section summarize programming workflow. first sub-section within workflow always describe data read demonstrate use admiral functions, sub-section within programming workflow tagged (e.g. [Step1] (#step)), user can go relevant section programming workflow (addition Table contents). Don’t use tag number use meaningful name (e.g. use (#link1), use (#this_action)) last section link template script. ADSL variables ADSL variables required derivation merged SDTM dataset first derivation. ADSL variables added -variables derivations add observations. ensures ADSL variables populated new observations. adsl_vars variable created beginning script added by_vars parameter derivations add observations. ADSL variables final dataset required derivation merged dataset last derivation.","code":"# Programming Workflow  * [Read in Data](#readdata) * [Derive/Impute End and Start Analysis Date/time and Relative Day](#datetime) * ... * [Assign `ASEQ`](#aseq)  ## Read in Data {#readdata} ## Derive/Impute End and Start Analysis Date/time and Relative Day {#datetime} ## ... ## Assign `ASEQ` {#aseq}  # Another Section  # Example Script ADaM | Sample Code ---- | -------------- ADxx | [ad_adxx.R](https://github.com/pharmaverse/admiral/blob/main/inst/templates/ad_adxx.R){target=\"_blank\"}"},{"path":"https://pharmaverse.github.io/admiraldev/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"define authors actively maintaining code base, contributors made significant contribution past. Ben Straub. Author, maintainer. Stefan Bundfuss. Author. Jeffrey Dickinson. Author. Ross Farrugia. Author. Pooja Kumari. Author. Edoardo Mancini. Author. Sadchla Mascary. Author. Zelos Zhu. Author. Ania Golab. Contributor. Samia Kabi. Contributor. Syed Mubasheer. Contributor. Thomas Neitmann. Contributor. Ondrej Slama. Contributor. F. Hoffmann-La Roche AG. Copyright holder, funder. GlaxoSmithKline LLC. Copyright holder, funder.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Straub B, Bundfuss S, Dickinson J, Farrugia R, Kumari P, Mancini E, Mascary S, Zhu Z (2024). admiraldev: Utility Functions Development Tools Admiral Package Family. R package version 1.0.0.9025,  https://github.com/pharmaverse/admiraldev/, https://pharmaverse.github.io/admiraldev/.","code":"@Manual{,   title = {admiraldev: Utility Functions and Development Tools for the Admiral Package Family},   author = {Ben Straub and Stefan Bundfuss and Jeffrey Dickinson and Ross Farrugia and Pooja Kumari and Edoardo Mancini and Sadchla Mascary and Zelos Zhu},   year = {2024},   note = {R package version 1.0.0.9025,  https://github.com/pharmaverse/admiraldev/},   url = {https://pharmaverse.github.io/admiraldev/}, }"},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"admiraldev-","dir":"","previous_headings":"","what":"Utility Functions and Development Tools for the Admiral Package Family","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"Utility Functions Development Tools Admiral Package Family","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"purpose","dir":"","previous_headings":"","what":"Purpose","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"Functions, tools documentation developing core admiral extension package functions. functions admiraldev around testing inputs going functions. also additional quality life functions/Addins assist developers admiral admiral extension packages, functions help rendering documentation, Developer Guides developing function using GitHub, GitHub Actions. NOTE: package intended standalone use rather central dependency admiral extension packages","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"package available CRAN can installed running install.packages(\"admiraldev\"). install latest development version package directly GitHub use following code:","code":"if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") }  remotes::install_github(\"pharmaverse/admiraldev\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"release-schedule","dir":"","previous_headings":"","what":"Release Schedule","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"admiraldev released CRAN time official release admiral. can find release schedule admiral packages .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"Add suffix variables list expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"","code":"add_suffix_to_vars(order, vars, suffix)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"order List expressions Permitted Values: list variables desc(<variable>) function calls created exprs(), e.g., exprs(ADT, desc(AVAL)) vars Variables change Permitted Values: list variables created exprs() suffix Suffix Permitted Values: character scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"list expression element suffix (suffix) added every symbol specified vars","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  add_suffix_to_vars(exprs(ADT, desc(AVAL), AVALC), vars = exprs(AVAL), suffix = \".join\") #> [[1]] #> ADT #>  #> [[2]] #> desc(AVAL.join) #>  #> [[3]] #> AVALC #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/admiraldev-package.html","id":null,"dir":"Reference","previous_headings":"","what":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","title":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","text":"Utility functions check data, variables conditions functions used 'admiral' 'admiral' extension packages. Additional utility helper functions assist developers maintaining documentation, testing general upkeep 'admiral' 'admiral' extension packages.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/admiraldev-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","text":"Maintainer: Ben Straub ben.x.straub@gsk.com Authors: Stefan Bundfuss Jeffrey Dickinson Ross Farrugia Pooja Kumari Edoardo Mancini Sadchla Mascary Zelos Zhu contributors: Ania Golab [contributor] Samia Kabi [contributor] Syed Mubasheer [contributor] Thomas Neitmann [contributor] Ondrej Slama [contributor] F. Hoffmann-La Roche AG [copyright holder, funder] GlaxoSmithKline LLC [copyright holder, funder]","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract Argument Name from an Expression — arg_name","title":"Extract Argument Name from an Expression — arg_name","text":"Extract Argument Name Expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract Argument Name from an Expression — arg_name","text":"","code":"arg_name(expr)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract Argument Name from an Expression — arg_name","text":"expr expression created inside function using substitute()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract Argument Name from an Expression — arg_name","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Atomic Vector? — assert_atomic_vector","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"Checks argument atomic vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"","code":"assert_atomic_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_atomic_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"function throws error arg atomic vector. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"","code":"example_fun <- function(x) {   assert_atomic_vector(x) }  example_fun(1:10)  try(example_fun(list(1, 2))) #> Error in example_fun(list(1, 2)) :  #>   Argument `x` must be an atomic vector, but is a list."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Character Scalar (String)? — assert_character_scalar","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"Checks argument character scalar (optionally) whether matches one provided values.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"","code":"assert_character_scalar(   arg,   values = NULL,   case_sensitive = TRUE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_character_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"arg function argument checked values character vector valid values arg. Values converted lower case vector case_sensitive = FALSE used. case_sensitive argument handled case-sensitive? set FALSE, argument converted lower case checking permitted values returning argument. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"function throws error arg character vector arg character vector length > 1 value one values specified. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"","code":"example_fun <- function(msg_type) {   assert_character_scalar(msg_type, values = c(\"warning\", \"error\")) }  example_fun(\"warning\")  try(example_fun(\"message\")) #> Error in example_fun(\"message\") :  #>   Argument `msg_type` must be equal to one of \"warning\" or \"error\".  try(example_fun(TRUE)) #> Error in example_fun(TRUE) :  #>   Argument `msg_type` must be a scalar of class <character>, but is #> `TRUE`.  # handling arguments case-insensitive example_fun2 <- function(msg_type) {   msg_type <- assert_character_scalar(     msg_type,     values = c(\"warning\", \"error\"),     case_sensitive = FALSE   )   if (msg_type == \"warning\") {     print(\"A warning was requested.\")   } }  example_fun2(\"Warning\") #> [1] \"A warning was requested.\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Character Vector? — assert_character_vector","title":"Is an Argument a Character Vector? — assert_character_vector","text":"Checks argument character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Character Vector? — assert_character_vector","text":"","code":"assert_character_vector(   arg,   values = NULL,   named = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_character_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Character Vector? — assert_character_vector","text":"arg function argument checked values character vector valid values arg named set TRUE, error issued elements vector named. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Character Vector? — assert_character_vector","text":"function throws error arg character vector element included list valid values. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Character Vector? — assert_character_vector","text":"","code":"example_fun <- function(chr) {   assert_character_vector(chr) }  example_fun(letters)  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `chr` must be <character>, but is an integer vector.  example_fun2 <- function(chr) {   assert_character_vector(chr, named = TRUE) }  try(example_fun2(c(alpha = \"a\", \"b\", gamma = \"c\"))) #> Error in example_fun2(c(alpha = \"a\", \"b\", gamma = \"c\")) :  #>   All elements of `chr` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Data Frame? — assert_data_frame","title":"Is an Argument a Data Frame? — assert_data_frame","text":"Checks argument data frame (optionally) whether contains set required variables","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Data Frame? — assert_data_frame","text":"","code":"assert_data_frame(   arg,   required_vars = NULL,   check_is_grouped = TRUE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_data_frame\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Data Frame? — assert_data_frame","text":"arg function argument checked required_vars list variables created using exprs() check_is_grouped Throw error dataset grouped? Defaults TRUE. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Data Frame? — assert_data_frame","text":"function throws error arg data frame arg data frame misses variable specified required_vars. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Data Frame? — assert_data_frame","text":"","code":"library(dplyr) library(rlang) dm <- tribble(   ~STUDYID, ~USUBJID,   \"XYZ\",    \"1\",   \"XYZ\",    \"2\" )  example_fun <- function(dataset) {   assert_data_frame(dataset, required_vars = exprs(STUDYID, USUBJID)) }  example_fun(dm)  try(example_fun(select(dm, -STUDYID))) #> Error in example_fun(select(dm, -STUDYID)) :  #>   Required variable `STUDYID` is missing in `dataset`  try(example_fun(\"Not a dataset\")) #> Error in example_fun(\"Not a dataset\") :  #>   Argument `dataset` must be class <data.frame>, but is a string.  try(example_fun(group_by(dm, USUBJID))) #> Error in example_fun(group_by(dm, USUBJID)) :  #>   Argument `dataset` must not be a grouped dataset, please `ungroup()` it."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":null,"dir":"Reference","previous_headings":"","what":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"Checks variable dataset date datetime variable","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"","code":"assert_date_var(   dataset,   var,   dataset_name = rlang::caller_arg(dataset),   var_name = rlang::caller_arg(var),   message = NULL,   class = \"assert_date_var\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"dataset dataset variable expected var variable check dataset_name name dataset. argument specified, specified name displayed error message. var_name name variable. argument specified, specified name displayed error message. message (string) string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"var_name\" \"dataset_name\", can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"function throws error var date datetime variable dataset returns input invisibly otherwise.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"","code":"library(lubridate) #>  #> Attaching package: ‘lubridate’ #> The following objects are masked from ‘package:base’: #>  #>     date, intersect, setdiff, union library(dplyr) library(rlang)  example_fun <- function(dataset, var) {   var <- assert_symbol(enexpr(var))   assert_date_var(dataset = dataset, var = !!var) }  my_data <- tribble(   ~USUBJID, ~ADT,   \"1\",      ymd(\"2020-12-06\"),   \"2\",      ymd(\"\") )  example_fun(   dataset = my_data,   var = ADT )  try(example_fun(   dataset = my_data,   var = USUBJID )) #> Error in example_fun(dataset = my_data, var = USUBJID) :  #>   Column \"USUBJID\" in dataset `dataset` must be a date or datetime, but is #> a character vector.  example_fun2 <- function(dataset, var) {   var <- assert_symbol(enexpr(var))   assert_date_var(     dataset = dataset,     var = !!var,     dataset_name = \"your_data\",     var_name = \"your_var\"   ) }  try(example_fun2(   dataset = my_data,   var = USUBJID )) #> Error in example_fun2(dataset = my_data, var = USUBJID) :  #>   Column \"your_var\" in dataset `your_data` must be a date or datetime, but #> is a character vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an object a date or datetime vector? — assert_date_vector","title":"Is an object a date or datetime vector? — assert_date_vector","text":"Check object/vector date datetime variable without needing dataset input","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an object a date or datetime vector? — assert_date_vector","text":"","code":"assert_date_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_date_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an object a date or datetime vector? — assert_date_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL function assert_date_vector exits early throw error. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an object a date or datetime vector? — assert_date_vector","text":"function returns error arg missing, date datetime variable otherwise returns invisible output.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an object a date or datetime vector? — assert_date_vector","text":"","code":"example_fun <- function(arg) {   assert_date_vector(arg) }  example_fun(   as.Date(\"2022-01-30\", tz = \"UTC\") ) try(example_fun(\"1993-07-14\")) #> Error in example_fun(\"1993-07-14\") :  #>   Argument `arg` must be a date or datetime, but is a string."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is an Expression — assert_expr","title":"Assert Argument is an Expression — assert_expr","text":"Assert Argument Expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is an Expression — assert_expr","text":"","code":"assert_expr(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_expr\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is an Expression — assert_expr","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is an Expression — assert_expr","text":"function throws error arg expression, .e. either symbol call, returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Expressions? — assert_expr_list","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"Checks argument list expressions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"","code":"assert_expr_list(   arg,   required_elements = NULL,   named = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_expr_list\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"arg function argument checked required_elements character vector names must present arg named set TRUE, error issued elements list named. optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"function throws error arg list expressions. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"","code":"library(rlang)  example_fun <- function(vars) {   assert_expr_list(vars) } example_fun(exprs(DTHDOM = \"AE\", DTHSEQ = AESEQ))  try(example_fun(exprs(\"AE\", DTSEQ = AESEQ, !!list(\"a\"), !!list(\"a\")))) #> Error in example_fun(exprs(\"AE\", DTSEQ = AESEQ, !!list(\"a\"), !!list(\"a\"))) :  #>   All elements of `vars` must be an expression. #> ℹ `vars[[3]]` = `list(\"a\")` is of type <list>, and `vars[[4]]` = `list(\"a\")` is #>   of type <list>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Filter Condition? — assert_filter_cond","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Argument Filter Condition?","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"","code":"assert_filter_cond(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_filter_cond\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"arg Quosure - filtering condition. optional Logical - argument optional? Defaults FALSE. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Performs necessary checks returns arg pass. Otherwise throws informative error.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Check arg suitable filtering condition used functions like subset dplyr::filter.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang) dm <- dplyr::tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID, ~AGE,   \"DM\",    \"STUDY X\", \"01-701-1015\",   64,   \"DM\",    \"STUDY X\", \"01-701-1016\",   65, )  # typical usage in a function as an argument check example_fun <- function(dat, x) {   x <- assert_filter_cond(enexpr(x), arg_name = \"x\")   filter(dat, !!x) }  example_fun(dm, AGE == 64) #> # A tibble: 1 × 4 #>   DOMAIN STUDYID USUBJID       AGE #>   <chr>  <chr>   <chr>       <dbl> #> 1 DM     STUDY X 01-701-1015    64  try(assert_filter_cond(mtcars)) #> Error in eval(expr, envir, enclos) :  #>   Argument `mtcars` must be a filter condition, but is a data frame"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":null,"dir":"Reference","previous_headings":"","what":"Is Argument a Function? — assert_function","title":"Is Argument a Function? — assert_function","text":"Checks argument function expected arguments provided function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is Argument a Function? — assert_function","text":"","code":"assert_function(   arg,   params = NULL,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_function\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is Argument a Function? — assert_function","text":"arg function function checked params character vector character vector expected argument names aforementioned function arg. ellipsis, ..., included function formals function arg, argument, params ignored, accepting values character vector. optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is Argument a Function? — assert_function","text":"function throws error argument function function provide arguments specified params argument (assuming ellipsis function formals)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is Argument a Function? — assert_function","text":"","code":"example_fun <- function(fun) {   assert_function(fun, params = c(\"x\")) }  example_fun(mean)  try(example_fun(1)) #> Error in example_fun(1) :  #>   Argument `fun` must be a function, but is a number.  try(example_fun(sum)) #> Error in example_fun(sum) :  #>   \"x\" is not an argument of the function specified for `fun`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Parameter of a Function — assert_function_param","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"function deprecated, please use assert_function() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"","code":"assert_function_param(arg, params)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"arg name function passed string params character vector function parameters","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"function throws error elements params argument function given arg","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":null,"dir":"Reference","previous_headings":"","what":"Does a Dataset Contain All Required Variables? — assert_has_variables","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"function deprecated, please use assert_data_frame() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"","code":"assert_has_variables(dataset, required_vars)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"dataset data.frame required_vars character vector variable names","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"function throws error required variables missing input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"Checks dataset contains required variables","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Integer Scalar? — assert_integer_scalar","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"Checks argument integer scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"","code":"assert_integer_scalar(   arg,   subset = \"none\",   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_integer_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"arg function argument checked subset subset integers arg part . one \"none\" (default), \"positive\", \"non-negative\" \"negative\". optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"function throws error arg integer belonging specified subset. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"","code":"example_fun <- function(num1, num2) {   assert_integer_scalar(num1, subset = \"positive\")   assert_integer_scalar(num2, subset = \"negative\") }  example_fun(1, -9)  try(example_fun(1.5, -9)) #> Error in example_fun(1.5, -9) :  #>   Argument `num1` must be a positive integer scalar.  try(example_fun(2, 0)) #> Error in example_fun(2, 0) :  #>   Argument `num2` must be a negative integer scalar.  try(example_fun(\"2\", 0)) #> Error in example_fun(\"2\", 0) :  #>   Argument `num1` must be a positive integer scalar."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"Checks elements list named lists/classes fulfill certain condition. , error issued elements list fulfilling condition listed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"","code":"assert_list_element(   list,   element,   condition,   message_text,   arg_name = rlang::caller_arg(list),   message = NULL,   class = \"assert_list_element\",   call = parent.frame(),   ... )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"list list checked list named lists classes expected. element name element lists/classes character scalar expected. condition Condition fulfilled condition evaluated element list. element lists/classes can referred name, e.g., censor == 0 check censor field class. message_text Text displayed error message listing values meet condition. text describe condition fulfilled, e.g., \"Error {arg_name}: censor values must zero.\". message argument specified, text displayed message_text ignored. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages. ... Objects required evaluate condition condition contains objects apart element, passed function. See second example .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"error condition met. input otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"Checks argument list objects inheriting S3 class type specified.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"","code":"assert_list_of(   arg,   cls,   named = FALSE,   optional = TRUE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_list_of\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"arg function argument checked cls S3 class type check named set TRUE, error issued elements list named. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"function throws error arg list arg list elements objects inheriting class type class. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"","code":"example_fun <- function(list) {   assert_list_of(list, \"data.frame\") }  example_fun(list(mtcars, iris))  try(example_fun(list(letters, 1:10))) #> Error in example_fun(list(letters, 1:10)) :  #>   Each element of the list in argument `list` must be class/type #> <data.frame>. #> ℹ But, element 1 is a character vector, and element 2 is an integer vector  try(example_fun(c(TRUE, FALSE))) #> Error in example_fun(c(TRUE, FALSE)) :  #>   Argument `list` must be class <list>, but is a logical vector.  example_fun2 <- function(list) {   assert_list_of(list, \"numeric\", named = TRUE) } try(example_fun2(list(1, 2, 3, d = 4))) #> Error in example_fun2(list(1, 2, 3, d = 4)) :  #>   All elements of `list` argument must be named. #> ℹ The indices of the unnamed elements are 1, 2, and 3"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"Checks argument logical scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"","code":"assert_logical_scalar(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_logical_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown. Otherwise, NULL considered valid value. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"function throws error arg neither TRUE FALSE. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"","code":"example_fun <- function(flag) {   assert_logical_scalar(flag) }  example_fun(FALSE)  try(example_fun(NA)) #> Error in example_fun(NA) :  #>   Argument `flag` must be either TRUE or FALSE, but is `NA`.  try(example_fun(c(TRUE, FALSE, FALSE))) #> Error in example_fun(c(TRUE, FALSE, FALSE)) :  #>   Argument `flag` must be either TRUE or FALSE, but is a logical vector.  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `flag` must be either TRUE or FALSE, but is an integer vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Named List or Vector — assert_named","title":"Assert Argument is a Named List or Vector — assert_named","text":"Assert elements argument named.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Named List or Vector — assert_named","text":"","code":"assert_named(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_named\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Named List or Vector — assert_named","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Named List or Vector — assert_named","text":"function throws error arg named list vector returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assert Argument is a Named List or Vector — assert_named","text":"","code":"example_fun <- function(varval_list) {   assert_named(varval_list) }  example_fun(list(var1 = 1, var2 = \"x\"))  try(example_fun(list(1, \"x\"))) #> Error in example_fun(list(1, \"x\")) :  #>   All elements of `varval_list` argument must be named. #> ℹ The indices of the unnamed elements are 1 and 2  try(example_fun(list(var = 1, \"x\"))) #> Error in example_fun(list(var = 1, \"x\")) :  #>   All elements of `varval_list` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Named List of Expressions — assert_named_exprs","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"function deprecated, please use assert_expr_list() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"","code":"assert_named_exprs(arg, optional = FALSE)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"function throws error arg named list expression returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Numeric Vector? — assert_numeric_vector","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"Checks argument numeric vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"","code":"assert_numeric_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_numeric_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"function throws error arg numeric vector. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"","code":"example_fun <- function(num) {   assert_numeric_vector(num) }  example_fun(1:10)  try(example_fun(letters)) #> Error in example_fun(letters) :  #>   Argument `num` must be a numeric vector, but it is a character vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":null,"dir":"Reference","previous_headings":"","what":"Is There a One to One Mapping between Variables? — assert_one_to_one","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"Checks one one mapping two lists variables.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"","code":"assert_one_to_one(   dataset,   vars1,   vars2,   dataset_name = rlang::caller_arg(dataset),   message = NULL,   class = \"assert_one_to_one\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"dataset Dataset checked variables specified vars1 vars2 expected. vars1 First list variables vars2 Second list variables dataset_name string indicating label/symbol object checked. Default rlang::caller_arg(dataset). message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"dataset_name\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"error condition meet. input otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"","code":"library(dplyr) library(rlang)  df <- tribble(   ~SPECIES, ~SPECIESN,   \"DOG\",           1L,   \"CAT\",           2L,   \"DOG\",           1L )  assert_one_to_one(df, vars1 = exprs(SPECIES), vars2 = exprs(SPECIESN))  df_many <- tribble(   ~SPECIES, ~SPECIESN,   \"DOG\",           1L,   \"CAT\",           2L,   \"DOG\",           3L )  try(   assert_one_to_one(df_many, vars1 = exprs(SPECIES), vars2 = exprs(SPECIESN)) ) #> Error in eval(expr, envir, enclos) :  #>   For some values of \"SPECIES\" there is more than one value of \"SPECIESN\" #> ℹ Call `admiral::get_one_to_many_dataset()` to get all one-to-many values.  try(   assert_one_to_one(df_many, vars1 = exprs(SPECIESN), vars2 = exprs(SPECIES)) ) #> Error in eval(expr, envir, enclos) :  #>   There is more than one value of \"SPECIESN\" for some values of \"SPECIES\" #> ℹ Call `admiral::get_many_to_one_dataset()` to get all many-to-one values."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"Checks parameter (PARAMCD) exist dataset.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"","code":"assert_param_does_not_exist(   dataset,   param,   arg_name = rlang::caller_arg(dataset),   message = NULL,   class = \"assert_param_does_not_exist\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"dataset data.frame param Parameter code check arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"function throws error parameter exists input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"","code":"library(dplyr)  advs <- tribble(   ~USUBJID, ~VSTESTCD, ~VSTRESN, ~VSSTRESU, ~PARAMCD, ~AVAL,   \"P01\",    \"WEIGHT\",      80.1, \"kg\",      \"WEIGHT\",  80.1,   \"P02\",    \"WEIGHT\",      85.7, \"kg\",      \"WEIGHT\",  85.7 ) assert_param_does_not_exist(advs, param = \"HR\") try(assert_param_does_not_exist(advs, param = \"WEIGHT\")) #> Error in eval(expr, envir, enclos) :  #>   The parameter code \"WEIGHT\" already exists in dataset `advs`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"Checks argument object inheriting S3 class specified.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"","code":"assert_s3_class(   arg,   cls,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_s3_class\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"arg function argument checked cls S3 class check optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"function throws error arg object inherit class. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"","code":"example_fun <- function(obj) {   assert_s3_class(obj, \"factor\") }  example_fun(as.factor(letters))  try(example_fun(letters)) #> Error in example_fun(letters) :  #>   Argument `obj` must be class <factor>, but is a character vector.  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `obj` must be class <factor>, but is an integer vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":null,"dir":"Reference","previous_headings":"","what":"Are All Argument of the Same Type? — assert_same_type","title":"Are All Argument of the Same Type? — assert_same_type","text":"Checks arguments type.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Are All Argument of the Same Type? — assert_same_type","text":"","code":"assert_same_type(   ...,   .message = c(\"Arguments {.arg {arg_names}} must be the same type.\", i =     paste(\"Argument types are\", paste0(\"{.arg \", arg_names, \"} {.cls \", types, \"}\",     collapse = \", \"))),   .class = \"assert_same_type\",   .call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Are All Argument of the Same Type? — assert_same_type","text":"... Arguments checked .message character vector passed cli_abort(message) assertion fails. .class character vector passed cli_abort(class) assertion fails. .call environment passed cli_abort(call) assertion fails.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Are All Argument of the Same Type? — assert_same_type","text":"function throws error arguments type.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Are All Argument of the Same Type? — assert_same_type","text":"","code":"example_fun <- function(true_value, false_value, missing_value) {   assert_same_type(true_value, false_value, missing_value) }  example_fun(   true_value = \"Y\",   false_value = \"N\",   missing_value = NA_character_ )  try(example_fun(   true_value = 1,   false_value = 0,   missing_value = \"missing\" )) #> Error in example_fun(true_value = 1, false_value = 0, missing_value = \"missing\") :  #>   Arguments `true_value`, `false_value`, and `missing_value` must be the #> same type. #> ℹ Argument types are `true_value` <double>, `false_value` <double>, #>   `missing_value` <character>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Symbol? — assert_symbol","title":"Is an Argument a Symbol? — assert_symbol","text":"Checks argument symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Symbol? — assert_symbol","text":"","code":"assert_symbol(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_symbol\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Symbol? — assert_symbol","text":"arg function argument checked. Must symbol. See examples. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Symbol? — assert_symbol","text":"function throws error arg symbol returns input invisibly otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Symbol? — assert_symbol","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang) dm <- dplyr::tribble(   ~DOMAIN,      ~USUBJID,   \"DM\",    \"01-701-1015\",   \"DM\",    \"01-701-1016\", ) example_fun <- function(dat, var) {   var <- assert_symbol(enexpr(var))   select(dat, !!var) }  example_fun(dm, USUBJID) #> # A tibble: 2 × 1 #>   USUBJID     #>   <chr>       #> 1 01-701-1015 #> 2 01-701-1016  try(example_fun(dm)) #> Error in example_fun(dm) :  #>   Argument `enexpr(var)` must be a <symbol>, but is missing.  try(example_fun(dm, \"USUBJID\")) #> Error in example_fun(dm, \"USUBJID\") :  #>   Argument `enexpr(var)` must be a <symbol>, but is a string.  try(example_fun(dm, toupper(PARAMCD))) #> Error in example_fun(dm, toupper(PARAMCD)) :  #>   Argument `enexpr(var)` must be a <symbol>, but is a call."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":null,"dir":"Reference","previous_headings":"","what":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"Checks parameter (PARAMCD) dataset provided expected unit.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"","code":"assert_unit(   dataset,   param,   required_unit,   get_unit_expr,   arg_name = rlang::caller_arg(required_unit),   message = NULL,   class = \"assert_unit\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"dataset data.frame param Parameter code parameter check required_unit Expected unit get_unit_expr Expression used provide unit param arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"function throws error unit variable differs unit observation parameter input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"","code":"library(dplyr)  advs <- tribble(   ~USUBJID, ~VSTESTCD, ~VSTRESN, ~VSSTRESU, ~PARAMCD, ~AVAL,   \"P01\",    \"WEIGHT\",      80.1, \"kg\",      \"WEIGHT\",  80.1,   \"P02\",    \"WEIGHT\",      85.7, \"kg\",      \"WEIGHT\",  85.7 )  assert_unit(advs, param = \"WEIGHT\", required_unit = \"kg\", get_unit_expr = VSSTRESU)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Variables? — assert_vars","title":"Is an Argument a List of Variables? — assert_vars","text":"Checks argument valid list symbols (e.g., created exprs())","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Variables? — assert_vars","text":"","code":"assert_vars(   arg,   expect_names = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_vars\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Variables? — assert_vars","text":"arg function argument checked expect_names argument set TRUE, checked variables named, e.g., exprs(APERSDT = APxxSDT, APEREDT = APxxEDT). optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Variables? — assert_vars","text":"function throws error arg list symbols (e.g., created exprs() returns input invisibly otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Variables? — assert_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  example_fun <- function(by_vars) {   assert_vars(by_vars) }  example_fun(exprs(USUBJID, PARAMCD))  try(example_fun(quos(USUBJID, PARAMCD))) #> Error in example_fun(quos(USUBJID, PARAMCD)) :  #>   Each element of the list in argument `by_vars` must be class/type #> <symbol>. #> ℹ But, element 1 is a <quosure> object, and element 2 is a <quosure> object  try(example_fun(c(\"USUBJID\", \"PARAMCD\", \"VISIT\"))) #> Error in example_fun(c(\"USUBJID\", \"PARAMCD\", \"VISIT\")) :  #>   Argument `by_vars` must be class <list>, but is a character vector.  try(example_fun(exprs(USUBJID, toupper(PARAMCD), desc(AVAL)))) #> Error in example_fun(exprs(USUBJID, toupper(PARAMCD), desc(AVAL))) :  #>   Each element of the list in argument `by_vars` must be class/type #> <symbol>. #> ℹ But, element 2 is a call, and element 3 is a call  example_fun_name <- function(by_vars) {   assert_vars(by_vars, expect_names = TRUE) }  example_fun_name(exprs(APERSDT = APxxSDT, APEREDT = APxxEDT))  try(example_fun_name(exprs(APERSDT = APxxSDT, APxxEDT))) #> Error in example_fun_name(exprs(APERSDT = APxxSDT, APxxEDT)) :  #>   All elements of `by_vars` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Variable-Value List? — assert_varval_list","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"Checks argument list expressions expressions variable-value pairs. value can symbol, string, numeric, expression, NA.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"","code":"assert_varval_list(   arg,   required_elements = NULL,   accept_expr = TRUE,   accept_var = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_varval_list\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"arg function argument checked required_elements character vector names must present arg accept_expr expressions right hand side accepted? accept_var unnamed variable names (e.g. exprs(USUBJID)) right hand side accepted? optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"function throws error arg list variable-value expressions. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  example_fun <- function(vars) {   assert_varval_list(vars) } example_fun(exprs(DTHDOM = \"AE\", DTHSEQ = AESEQ))  try(example_fun(exprs(\"AE\", DTSEQ = AESEQ))) #> Error in example_fun(exprs(\"AE\", DTSEQ = AESEQ)) :  #>   Argument `vars` must be a named list of expressions where each element #> is a symbol, character scalar, numeric scalar, an expression, or NA, but is a #> list. #> ℹ To create a list of expressions use `exprs()`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Backquotes — backquote","title":"Wrap a String in Backquotes — backquote","text":"Wrap String Backquotes","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Backquotes — backquote","text":"","code":"backquote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Backquotes — backquote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Backquotes — backquote","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"check argument contains valid variable(s) created exprs() Source Variables List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"","code":"contains_vars(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"arg function argument checked","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"TRUE variables valid variable","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"Helper Function Convert Date (Date-time) Objects Characters dtc Format (-DTC type variable)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"","code":"convert_dtm_to_dtc(dtm)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"dtm date date-time","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":null,"dir":"Reference","previous_headings":"","what":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"Output dataset vignette pre-specified admiral format.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"","code":"dataset_vignette(dataset, display_vars = NULL, filter = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"dataset Dataset output vignette display_vars Variables selected demonstrate outcome derivation Permitted Values: list variables Default NULL display_vars NULL, selected variables visible vignette variables hidden. can made visible clicking theChoose columns display button. filter Filter condition specified condition applied dataset displayed. Permitted Values: condition","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"HTML table","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Double Quotes — dquote","title":"Wrap a String in Double Quotes — dquote","text":"Wrap string double quotes, e.g., displaying character values messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Double Quotes — dquote","text":"","code":"dquote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Double Quotes — dquote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Double Quotes — dquote","text":"input NULL, text \"NULL\" returned. Otherwise, input double quotes returned.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":null,"dir":"Reference","previous_headings":"","what":"Enumerate Multiple Elements — enumerate","title":"Enumerate Multiple Elements — enumerate","text":"Enumerate multiple elements vector list.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Enumerate Multiple Elements — enumerate","text":"","code":"enumerate(x, quote_fun = backquote, conjunction = \"and\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Enumerate Multiple Elements — enumerate","text":"x vector list quote_fun Quoting function, defaults backquote. set NULL, elements quoted. conjunction Character used message, defaults \"\".","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Enumerate Multiple Elements — enumerate","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Enumerate Multiple Elements — enumerate","text":"","code":"enumerate(c(\"one\", \"two\", \"three\")) #> Warning: `enumerate()` was deprecated in admiraldev 1.1.0. #> ℹ This function was primarily used in error messaging, and can be replaced with #>   'cli' functionality: `cli::cli_abort('{.val {letters[1:3]}}')` #> [1] \"`one`, `two` and `three`\"  enumerate(c(1, 2, 3), quote_fun = NULL) #> [1] \"1, 2 and 3\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":null,"dir":"Reference","previous_headings":"","what":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"Uses diffdf::diffdf() compares 2 datasets differences. function can thought R-equivalent SAS proc compare useful tool unit testing well.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"","code":"expect_dfs_equal(base, compare, keys, ...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"base Input dataset compare Comparison dataset keys character vector variables define unique row base compare datasets ... Additional arguments passed onto diffdf::diffdf()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"error base compare match NULL invisibly ","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"","code":"library(dplyr, warn.conflicts = FALSE)  tbl1 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1001\", 18, \"M\",   \"1002\", 19, \"F\",   \"1003\", 20, \"M\",   \"1004\", 18, \"F\" )  tbl2 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1001\", 18, \"M\",   \"1002\", 18.9, \"F\",   \"1003\", 20, NA )  try(expect_dfs_equal(tbl1, tbl2, keys = \"USUBJID\")) #> Error : Differences found between the objects! #>  #> A summary is given below. #>  #> There are rows in BASE that are not in COMPARE !! #> All rows are shown in table below #>  #>   ========= #>    USUBJID  #>   --------- #>     1004    #>   --------- #>  #> Not all Values Compared Equal #> All rows are shown in table below #>  #>   ============================= #>    Variable  No of Differences  #>   ----------------------------- #>      AGE             1          #>      SEX             1          #>   ----------------------------- #>  #>  #> All rows are shown in table below #>  #>   ================================== #>    VARIABLE  USUBJID  BASE  COMPARE  #>   ---------------------------------- #>      AGE      1002     19    18.9    #>   ---------------------------------- #>  #>  #> All rows are shown in table below #>  #>   ================================== #>    VARIABLE  USUBJID  BASE  COMPARE  #>   ---------------------------------- #>      SEX      1003     M     <NA>    #>   ---------------------------------- #>   tlb3 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1004\", 18, \"F\",   \"1003\", 20, \"M\",   \"1002\", 19, \"F\",   \"1001\", 18, \"M\", )  # Note the sorting order of the keys is not required expect_dfs_equal(tbl1, tlb3, keys = \"USUBJID\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":null,"dir":"Reference","previous_headings":"","what":"Concatenate One or More Expressions — expr_c","title":"Concatenate One or More Expressions — expr_c","text":"Concatenate One Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Concatenate One or More Expressions — expr_c","text":"","code":"expr_c(...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Concatenate One or More Expressions — expr_c","text":"... One expressions list expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Concatenate One or More Expressions — expr_c","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract All Symbols from a List of Expressions — extract_vars","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"Extract Symbols List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"","code":"extract_vars(x, side = \"lhs\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"x R object side One \"lhs\" (default) \"rhs\" formulas","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"","code":"library(rlang) extract_vars(exprs(PARAMCD, (BASE - AVAL) / BASE + 100)) #> [[1]] #> PARAMCD #>  #> [[2]] #> BASE #>  #> [[3]] #> AVAL #>  extract_vars(AVAL ~ ARMCD + AGEGR1) #> [[1]] #> AVAL #>  extract_vars(AVAL ~ ARMCD + AGEGR1, side = \"rhs\") #> [[1]] #> ARMCD #>  #> [[2]] #> AGEGR1 #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":null,"dir":"Reference","previous_headings":"","what":"Optional Filter — filter_if","title":"Optional Filter — filter_if","text":"Filters input dataset provided expression NULL","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Optional Filter — filter_if","text":"","code":"filter_if(dataset, filter)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Optional Filter — filter_if","text":"dataset Input dataset filter filter condition. Must expression.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Optional Filter — filter_if","text":"data.frame containing rows dataset matching filter just dataset filter NULL","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":null,"dir":"Reference","previous_headings":"","what":"Return English-friendly messaging for object-types — friendly_type_of","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"Return English-friendly messaging object-types","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"","code":"friendly_type_of(x, value = TRUE, length = FALSE)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"x R object. value Whether describe value x. length Whether mention length vectors lists.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"string describing type. Starts indefinite article, e.g. \"integer vector\".","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"helper function aids us forming user-friendly messages gets called what_is_it(), often used assertion functions identify object-type user passed argument instead expected-type.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Constant Variables — get_constant_vars","title":"Get Constant Variables — get_constant_vars","text":"Get Constant Variables","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Constant Variables — get_constant_vars","text":"","code":"get_constant_vars(dataset, by_vars, ignore_vars = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Constant Variables — get_constant_vars","text":"dataset data frame. by_vars variables groups defined variables considered separately. .e., variable constant within group, returned. ignore_vars Variables ignore specified variables considered, .e., returned even constant (unless included variables). Permitted Values: list variable names selector function calls like starts_with(\"EX\")","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Constant Variables — get_constant_vars","text":"Variable vector.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"Retrieve Dataset admiraldev_environment environment","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"","code":"get_dataset(name)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"name name dataset retrieve","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"data.frame","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"Sometimes, developers may want provide information users fit warning error message. example, input dataset function contains unexpected records, can stored separate dataset, users can access investigate issue. achieve , R data structure known 'environment'. environment objects created build time, can populated values package loaded update values course R session. , establishment admiraldev_environment allows us create dynamic data/objects based user-inputs need modification. purpose get_dataset retrieve datasets contained inside admiraldev_environment. Currently support two datasets inside admiraldev_environment object: one_to_many many_to_one","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Duplicates From a Vector — get_duplicates","title":"Get Duplicates From a Vector — get_duplicates","text":"Get Duplicates Vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Duplicates From a Vector — get_duplicates","text":"","code":"get_duplicates(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Duplicates From a Vector — get_duplicates","text":"x atomic vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Duplicates From a Vector — get_duplicates","text":"vector type x contain duplicate values","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Duplicates From a Vector — get_duplicates","text":"","code":"get_duplicates(1:10) #> integer(0)  get_duplicates(c(\"a\", \"a\", \"b\", \"c\", \"d\", \"d\")) #> [1] \"a\" \"d\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"Get New Temporary Variable Name Dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"","code":"get_new_tmp_var(dataset, prefix = \"tmp_var\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"dataset input dataset prefix prefix new temporary variable name create","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"name new temporary variable symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"function returns new unique temporary variable name used inside dataset. temporary variable names structure prefix_n n integer, e.g. tmp_var_1. already variable inside datset given prefix suffix increased 1, e.g. tmp_var_1 already exists get_new_tmp_var() return tmp_var_2.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID,   \"DM\",    \"STUDY X\", \"01-701-1015\",   \"DM\",    \"STUDY X\", \"01-701-1016\", )  tmp_var <- get_new_tmp_var(dm) mutate(dm, !!tmp_var := NA) #> # A tibble: 2 × 4 #>   DOMAIN STUDYID USUBJID     tmp_var_1 #>   <chr>  <chr>   <chr>       <lgl>     #> 1 DM     STUDY X 01-701-1015 NA        #> 2 DM     STUDY X 01-701-1016 NA"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Source Variables from a List of Expressions — get_source_vars","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"Get Source Variables List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"","code":"get_source_vars(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"expressions list expressions quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":null,"dir":"Reference","previous_headings":"","what":"Negated Value Matching — %notin%","title":"Negated Value Matching — %notin%","text":"Returns logical vector indicating match left operand right operand.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Negated Value Matching — %notin%","text":"","code":"x %notin% table"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Negated Value Matching — %notin%","text":"x values matched table values matched ","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Negated Value Matching — %notin%","text":"logical vector","code":""},{"path":[]},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Or — %or%","text":"","code":"lhs %or% rhs"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Or — %or%","text":"lhs valid R expression rhs valid R expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Or — %or%","text":"Either result evaluating lhs, rhs error","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Or — %or%","text":"function evaluates expression lhs expression results error, catches error proceeds evaluating expression rhs returns result.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":null,"dir":"Reference","previous_headings":"","what":"Checks if the argument equals the auto keyword — is_auto","title":"Checks if the argument equals the auto keyword — is_auto","text":"Checks argument equals auto keyword","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Checks if the argument equals the auto keyword — is_auto","text":"","code":"is_auto(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Checks if the argument equals the auto keyword — is_auto","text":"arg argument check","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Checks if the argument equals the auto keyword — is_auto","text":"TRUE argument equals auto keyword, .e., expression symbol named auto.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Is order vars? — is_order_vars","title":"Is order vars? — is_order_vars","text":"Check inputs created using exprs() calls involving desc()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is order vars? — is_order_vars","text":"","code":"is_order_vars(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is order vars? — is_order_vars","text":"arg R object","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is order vars? — is_order_vars","text":"FALSE argument list order vars","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Is this string a valid DTC — is_valid_dtc","title":"Is this string a valid DTC — is_valid_dtc","text":"string valid DTC","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is this string a valid DTC — is_valid_dtc","text":"","code":"is_valid_dtc(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is this string a valid DTC — is_valid_dtc","text":"arg character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is this string a valid DTC — is_valid_dtc","text":"TRUE argument valid --DTC string, FALSE otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":null,"dir":"Reference","previous_headings":"","what":"Join Functions — anti_join","title":"Join Functions — anti_join","text":"*_join() functions {dplyr} without warning different attributes datasets.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join Functions — anti_join","text":"","code":"anti_join(x, y, by = NULL, copy = FALSE, ...)  inner_join(x, y, by = NULL, copy = FALSE, suffix = c(\".x\", \".y\"), ...)  left_join(x, y, by = NULL, copy = FALSE, suffix = c(\".x\", \".y\"), ...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join Functions — anti_join","text":"x data.frame y data.frame character vector copy logical ... Additional arguments suffix character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join Functions — anti_join","text":"data.frame","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":null,"dir":"Reference","previous_headings":"","what":"Process set_values_to Argument — process_set_values_to","title":"Process set_values_to Argument — process_set_values_to","text":"function creates variables specified set_values_to argument, catches errors, provides user friendly error messages, optionally checks type created variables.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Process set_values_to Argument — process_set_values_to","text":"","code":"process_set_values_to(dataset, set_values_to = NULL, expected_types = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Process set_values_to Argument — process_set_values_to","text":"dataset Input dataset set_values_to Variables set named list returned exprs() defining variables set, e.g. exprs(PARAMCD = \"OS\", PARAM = \"Overall Survival\") expected. values must symbols, character strings, numeric values, expressions, NA. expected_types argument specified, specified variables checked whether specified type matches type variables created set_values_to. Permitted Values: character vector values \"numeric\" \"character\"","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Process set_values_to Argument — process_set_values_to","text":"input dataset variables specified set_values_to added/updated","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Process set_values_to Argument — process_set_values_to","text":"","code":"library(dplyr) data <- tribble(   ~AVAL,   20 )  try(   process_set_values_to(     data,     set_values_to = exprs(       PARAMCD = BMI     )   ) ) #> Error in process_set_values_to(data, set_values_to = exprs(PARAMCD = BMI)) :  #>   Assigning variables failed! #> • `set_values_to = exprs(PARAMCD = BMI)` #> See error message below: #> ℹ In argument: `PARAMCD = BMI`. Caused by error: ! object 'BMI' not found  try(   process_set_values_to(     data,     set_values_to = exprs(       PARAMCD = 42     ),     expected_types = c(PARAMCD = \"character\")   ) ) #> Error in process_set_values_to(data, set_values_to = exprs(PARAMCD = 42),  :  #>   The following variables have an unexpected type: #> • PARAMCD: expected is <character>, but it is <numeric>."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"Remove Temporary Variables Created Within Current Function Environment","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"","code":"remove_tmp_vars(dataset)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"dataset input dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"input dataset temporary variables removed","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID,   \"DM\",    \"STUDY X\", \"01-701-1015\",   \"DM\",    \"STUDY X\", \"01-701-1016\", ) dm <- select(dm, USUBJID) tmp_var <- get_new_tmp_var(dm) dm <- mutate(dm, !!tmp_var := NA)  ## This function creates two new temporary variables which are removed when calling ## `remove_tmp_vars()`. Note that any temporary variable created outside this ## function is **not** removed do_something <- function(dataset) {   tmp_var_1 <- get_new_tmp_var(dm)   tmp_var_2 <- get_new_tmp_var(dm)   dm %>%     mutate(!!tmp_var_1 := NA, !!tmp_var_2 := NA) %>%     print() %>%     remove_tmp_vars() }  do_something(dm) #> # A tibble: 2 × 4 #>   USUBJID     tmp_var_1 tmp_var_2 tmp_var_3 #>   <chr>       <lgl>     <lgl>     <lgl>     #> 1 01-701-1015 NA        NA        NA        #> 2 01-701-1016 NA        NA        NA        #> # A tibble: 2 × 2 #>   USUBJID     tmp_var_1 #>   <chr>       <lgl>     #> 1 01-701-1015 NA        #> 2 01-701-1016 NA"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace Symbols in an Expression — replace_symbol_in_expr","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"Replace symbols expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"","code":"replace_symbol_in_expr(expression, target, replace)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"expression Expression target Target symbol replace Replacing symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"expression every occurrence symbol target replaced replace","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"Stefan Bundfuss","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"","code":"library(rlang)  replace_symbol_in_expr(expr(AVAL), target = AVAL, replace = AVAL.join) #> AVAL.join replace_symbol_in_expr(expr(AVALC), target = AVAL, replace = AVAL.join) #> AVALC replace_symbol_in_expr(expr(desc(AVAL)), target = AVAL, replace = AVAL.join) #> desc(AVAL.join)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace Expression Value with Name — replace_values_by_names","title":"Replace Expression Value with Name — replace_values_by_names","text":"Replace Expression Value Name","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace Expression Value with Name — replace_values_by_names","text":"","code":"replace_values_by_names(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace Expression Value with Name — replace_values_by_names","text":"expressions list expressions quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace Expression Value with Name — replace_values_by_names","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace Expression Value with Name — replace_values_by_names","text":"","code":"library(rlang) replace_values_by_names(exprs(AVAL, ADT = convert_dtc_to_dt(EXSTDTC))) #> [[1]] #> AVAL #>  #> $ADT #> ADT #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Single Quotes — squote","title":"Wrap a String in Single Quotes — squote","text":"Wrap String Single Quotes","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Single Quotes — squote","text":"","code":"squote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Single Quotes — squote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Single Quotes — squote","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":null,"dir":"Reference","previous_headings":"","what":"Suppress Specific Warnings — suppress_warning","title":"Suppress Specific Warnings — suppress_warning","text":"Suppress certain warnings issued expression.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Suppress Specific Warnings — suppress_warning","text":"","code":"suppress_warning(expr, regexpr)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Suppress Specific Warnings — suppress_warning","text":"expr Expression executed regexpr Regular expression matching warnings suppress","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Suppress Specific Warnings — suppress_warning","text":"Return value expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Suppress Specific Warnings — suppress_warning","text":"warnings issued expression match regular expression suppressed.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":null,"dir":"Reference","previous_headings":"","what":"Valid Time Units — valid_time_units","title":"Valid Time Units — valid_time_units","text":"Contains acceptable character vector valid time units","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Valid Time Units — valid_time_units","text":"","code":"valid_time_units()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Valid Time Units — valid_time_units","text":"character vector valid time units","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":null,"dir":"Reference","previous_headings":"","what":"Turn a List of Expressions into a Character Vector — vars2chr","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"Turn List Expressions Character Vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"","code":"vars2chr(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"expressions list expressions created using exprs() quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  vars2chr(exprs(USUBJID, AVAL)) #>                      #> \"USUBJID\"    \"AVAL\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn if incomplete dtc — warn_if_incomplete_dtc","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"Warn incomplete dtc","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"","code":"warn_if_incomplete_dtc(dtc, n)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"dtc character vector date-times ISO 8601 format n non-negative integer","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"warning dtc contains partial dates","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"Checks two list inputs names number elements issues warning otherwise.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"","code":"warn_if_inconsistent_list(base, compare, list_name, i = 2)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"base named list compare named list list_name string name list index id compare 2 lists","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"warning 2 lists different names length","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  # no warning warn_if_inconsistent_list(   base = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   compare = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   list_name = \"Test\" ) # warning warn_if_inconsistent_list(   base = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ, DTHVAR = \"text\"),   compare = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   list_name = \"Test\" ) #> Warning: The variables used for traceability in `Test` are not consistent, please check: #> source 1 , Variables are given as: DTHDOM DTHSEQ DTHVAR  #> source 2 , Variables are given as: DTHDOM DTHSEQ"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"Warn vector contains unknown datetime format \"2003-12-15T-:15:18\", \"2003-12-15T13:-:19\",\"--12-15\",\"-----T07:15\"","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"","code":"warn_if_invalid_dtc(dtc, is_valid = is_valid_dtc(dtc))"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"dtc character vector containing dates is_valid logical vector indicating whether elements dtc valid","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"return value, called side effects","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"","code":"## No warning as `dtc` is a valid date format warn_if_invalid_dtc(dtc = \"2021-04-06\")  ## Issues a warning warn_if_invalid_dtc(dtc = \"2021-04-06T-:30:30\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If a Variable Already Exists — warn_if_vars_exist","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"Warn variable already exists inside dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"","code":"warn_if_vars_exist(dataset, vars)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"dataset data.frame vars character vector columns check dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"return value, called side effects","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~USUBJID,           ~ARM,   \"01-701-1015\", \"Placebo\",   \"01-701-1016\", \"Placebo\", )  ## No warning as `AAGE` doesn't exist in `dm` warn_if_vars_exist(dm, \"AAGE\")  ## Issues a warning warn_if_vars_exist(dm, \"ARM\") #> Warning: Variable \"ARM\" already exists in the dataset."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":null,"dir":"Reference","previous_headings":"","what":"What Kind of Object is This? — what_is_it","title":"What Kind of Object is This? — what_is_it","text":"Returns string describing kind object input .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"What Kind of Object is This? — what_is_it","text":"","code":"what_is_it(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"What Kind of Object is This? — what_is_it","text":"x R object","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"What Kind of Object is This? — what_is_it","text":"character description type x","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"What Kind of Object is This? — what_is_it","text":"","code":"what_is_it(\"abc\") #> Warning: `what_is_it()` was deprecated in admiraldev 1.1.0. #> ℹ This function was primarily used in error messaging, and can be replaced with #>   'cli' functionality: `cli::cli_abort('{.obj_type_friendly {letters}}')`. #> [1] \"`\\\"abc\\\"`\" what_is_it(1L) #> [1] \"`1`\" what_is_it(1:10) #> [1] \"an integer vector\" what_is_it(mtcars) #> [1] \"a data frame\""},{"path":[]},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-development-version","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev (development version)","text":"Error messaging throughout package updated rlang::abort() cli::cli_abort(). part update, assert_*() functions new arguments assert_*(message, arg_name, call, class). (#367) Warning messaging also updated use cli messaging.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-development-version","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev (development version)","text":"renv related files removed. (#360) longer exporting is_named() function. (#401) pharmaversesdtm removed dependency. (#434) part error messaging update, following changes made. assert_s3_class(class) argument renamed assert_s3_class(cls). (#367) Functions arg_name(), enumerate(), what_is_it(), friendly_type_of() deprecated warning returned developer using functions. developer functions (opposed functions typical admiral users), use short deprecation cycle.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-development-version","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev (development version)","text":"“Release Strategy” vignette updated respect new branching strategy. (#353) “Release Strategy” vignette now contains short new “Release Tracking” section linking external dashboard CRAN packages awaiting release. (#358)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"other-development-version","dir":"Changelog","previous_headings":"","what":"Other","title":"admiraldev (development version)","text":"Removed dependencies needed build package package documentation. (#426) Increased minimum R version required 4.0 match {admiral}. (#382)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-100","dir":"Changelog","previous_headings":"","what":"admiraldev 1.0.0","title":"admiraldev 1.0.0","text":"CRAN release: 2023-12-15","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-1-0-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 1.0.0","text":"assert_function() now accepts function arguments ellipsis, ... function formals (#339)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-1-0-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 1.0.0","text":"assert_function_param() assert_named_expr() assert_has_variables()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-1-0-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 1.0.0","text":"New documentation programming strategy around quoting/expressions standardizing roxygen texts (#233, #332) New documentation use footnotes writing vignettes (#324) Updated language images adopt GitHub Flow Strategy (#349)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-050","dir":"Changelog","previous_headings":"","what":"admiraldev 0.5.0","title":"admiraldev 0.5.0","text":"CRAN release: 2023-09-11","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-5-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.5.0","text":"Calls admiral.test swapped pharmaversesdtm (#321) New vignette package writing extensions now available (#295, #312) New vignette creating test data now available (#282)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-5-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.5.0","text":"messaging warn_if_invalid_dtc() updated align date/datetime functions admiral currently . (#316)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-5-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.5.0","text":"assert_order_vars() quo_c() quo_not_missing() replace_symbol_in_quo() quosures argument replaced expressions argument replace_values_by_names(), get_source_vars(), vars2chr(). (#288) assert_function_param() deprecated favor assert_function(). (#264) assert_named_expr() deprecated favor assert_expr_list(). (#264) assert_has_variables() deprecated favor assert_data_frame(). (#264)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-5-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.5.0","text":"Guidance around issues merging updated (#286) Common R CMD troubleshooting made separate vignette (#286) Documentation get_dataset() improved. (#271) Minor updates programming strategy added (#213, #240, #260) Updated unit testing vignette snapshot testing guidance. (#302) Documentation friendly_type_of() provided (#22) Minor updates pull request review guidance added (#201, #292) Documentation singular versus plural function argument names added programming strategy vignette. Also documentation common arguments missing_value missing_values added. (#296) Documentation highlighting difference set_values_to keep_source_vars (#318) List common arguments updated (#306)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-040","dir":"Changelog","previous_headings":"","what":"admiraldev 0.4.0","title":"admiraldev 0.4.0","text":"CRAN release: 2023-06-06","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-4-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.4.0","text":"New function assert_named() check elements argument named (#241) New function assert_expr_list() check argument list expressions (#241) Added Report bug link admiraldev website (#257)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-4-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.4.0","text":"assert_order_vars() deprecated favor assert_expr_list(). (#241) following functions deprecated previous admiral versions using next phase deprecation process: (#272) quo_c() quo_not_missing() replace_symbol_in_quo() quosures argument replaced expressions argument replace_values_by_names().","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-4-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.4.0","text":"deprecation strategy updated regarding unit tests deprecated functions/arguments phase 1. (#247) programming strategy updated regarding permitted values calling functions package dependencies (#72, #253)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-030","dir":"Changelog","previous_headings":"","what":"admiraldev 0.3.0","title":"admiraldev 0.3.0","text":"CRAN release: 2023-03-06","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-3-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.3.0","text":"New function process_set_values_to() creating variables specified set_value_to argument catching errors (#70)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-3-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.3.0","text":"Using testthat3e (testthat 3rd edition) unit testing. stricter messages must addressed deprecated functions throw errors. (#230) Slight boost test coverage dev_utilities (#102) Fix datatable styling documentation (#197) assert_character_vector() function gained named argument check elements vector named. (#70) assert_list_of() function gained named argument check elements list named. (#203) quote_fun argument enumerate() extended NULL can specified request quoting elements. (#203) assert_list_of() function enhanced also considers type element, e.g., check value list symbols. (#208)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-3-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.3.0","text":"default value optional argument assert_date_vector(), assert_list_of(), assert_s3_class() changed TRUE FALSE make default behavior consistent. (#87) quo_c() replace_symbol_in_quo() quosures argument get_source_vars(), replace_values_by_names(), vars2chr()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-3-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.3.0","text":"New section programming strategy regarding comments (#71) Removed requirement add @author tags code scripts programming strategy, tracking authors DESCRIPTION file. Authors removed function documentation line update. (#206, #210) Removed -boarding Issue Template (#225) Increased clarity scope package (#232)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-020","dir":"Changelog","previous_headings":"","what":"admiraldev 0.2.0","title":"admiraldev 0.2.0","text":"CRAN release: 2022-11-30","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-2-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.2.0","text":"Developer addin formatting tests admiral programming standards (#73) New functions replace_symbol_in_quo() add_suffix_to_vars() (#106) New function assert_atomic_vector() (#98) New keyword/family create_aux functions creating auxiliary datasets (#126) New function assert_date_vector() (#129) New function assert_same_type() (#176) Remove dependency {assertthat} (#149) Test coverage admiraldev increased 45% approximately 100% (#94, #95, #96, #98, #101, #103) Environment objects consolidated single admiraldev_environment object R/admiraldev_environment.R. (#179)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-2-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.2.0","text":"expect_names argument added assert_vars() check variables named (#117) Remove dplyr function exports migration user facing function negate_vars() admiral (#83)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-2-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.2.0","text":"longer compatible admiral (<0.9)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-2-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.2.0","text":"New vignette package release strategy (#79) Updated multiple roxygen headers (#116, #133, #134, #141, #145, #172) Description admiral options work certain function inputs, .e subject_keys (#133)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"various-0-2-0","dir":"Changelog","previous_headings":"","what":"Various","title":"admiraldev 0.2.0","text":"PR Checklist Template updated (#172) New authors/contributors (#158)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-010","dir":"Changelog","previous_headings":"","what":"admiraldev 0.1.0","title":"admiraldev 0.1.0","text":"CRAN release: 2022-08-26","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.1.0","text":"Developer specific functions brought admiral Developer specific vignettes brought admiral New admiraldev website created","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-1-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-1-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-1-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"various-0-1-0","dir":"Changelog","previous_headings":"","what":"Various","title":"admiraldev 0.1.0","text":"NA","code":""}]
+[{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"Apache License","title":"Apache License","text":"Version 2.0, January 2004 <http://www.apache.org/licenses/>","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_1-definitions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"1. Definitions","title":"Apache License","text":"“License” shall mean terms conditions use, reproduction, distribution defined Sections 1 9 document. “Licensor” shall mean copyright owner entity authorized copyright owner granting License. “Legal Entity” shall mean union acting entity entities control, controlled , common control entity. purposes definition, “control” means () power, direct indirect, cause direction management entity, whether contract otherwise, (ii) ownership fifty percent (50%) outstanding shares, (iii) beneficial ownership entity. “” (“”) shall mean individual Legal Entity exercising permissions granted License. “Source” form shall mean preferred form making modifications, including limited software source code, documentation source, configuration files. “Object” form shall mean form resulting mechanical transformation translation Source form, including limited compiled object code, generated documentation, conversions media types. “Work” shall mean work authorship, whether Source Object form, made available License, indicated copyright notice included attached work (example provided Appendix ). “Derivative Works” shall mean work, whether Source Object form, based (derived ) Work editorial revisions, annotations, elaborations, modifications represent, whole, original work authorship. purposes License, Derivative Works shall include works remain separable , merely link (bind name) interfaces , Work Derivative Works thereof. “Contribution” shall mean work authorship, including original version Work modifications additions Work Derivative Works thereof, intentionally submitted Licensor inclusion Work copyright owner individual Legal Entity authorized submit behalf copyright owner. purposes definition, “submitted” means form electronic, verbal, written communication sent Licensor representatives, including limited communication electronic mailing lists, source code control systems, issue tracking systems managed , behalf , Licensor purpose discussing improving Work, excluding communication conspicuously marked otherwise designated writing copyright owner “Contribution.” “Contributor” shall mean Licensor individual Legal Entity behalf Contribution received Licensor subsequently incorporated within Work.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_2-grant-of-copyright-license","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"2. Grant of Copyright License","title":"Apache License","text":"Subject terms conditions License, Contributor hereby grants perpetual, worldwide, non-exclusive, -charge, royalty-free, irrevocable copyright license reproduce, prepare Derivative Works , publicly display, publicly perform, sublicense, distribute Work Derivative Works Source Object form.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_3-grant-of-patent-license","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"3. Grant of Patent License","title":"Apache License","text":"Subject terms conditions License, Contributor hereby grants perpetual, worldwide, non-exclusive, -charge, royalty-free, irrevocable (except stated section) patent license make, made, use, offer sell, sell, import, otherwise transfer Work, license applies patent claims licensable Contributor necessarily infringed Contribution(s) alone combination Contribution(s) Work Contribution(s) submitted. institute patent litigation entity (including cross-claim counterclaim lawsuit) alleging Work Contribution incorporated within Work constitutes direct contributory patent infringement, patent licenses granted License Work shall terminate date litigation filed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_4-redistribution","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"4. Redistribution","title":"Apache License","text":"may reproduce distribute copies Work Derivative Works thereof medium, without modifications, Source Object form, provided meet following conditions: () must give recipients Work Derivative Works copy License; (b) must cause modified files carry prominent notices stating changed files; (c) must retain, Source form Derivative Works distribute, copyright, patent, trademark, attribution notices Source form Work, excluding notices pertain part Derivative Works; (d) Work includes “NOTICE” text file part distribution, Derivative Works distribute must include readable copy attribution notices contained within NOTICE file, excluding notices pertain part Derivative Works, least one following places: within NOTICE text file distributed part Derivative Works; within Source form documentation, provided along Derivative Works; , within display generated Derivative Works, wherever third-party notices normally appear. contents NOTICE file informational purposes modify License. may add attribution notices within Derivative Works distribute, alongside addendum NOTICE text Work, provided additional attribution notices construed modifying License. may add copyright statement modifications may provide additional different license terms conditions use, reproduction, distribution modifications, Derivative Works whole, provided use, reproduction, distribution Work otherwise complies conditions stated License.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_5-submission-of-contributions","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"5. Submission of Contributions","title":"Apache License","text":"Unless explicitly state otherwise, Contribution intentionally submitted inclusion Work Licensor shall terms conditions License, without additional terms conditions. Notwithstanding , nothing herein shall supersede modify terms separate license agreement may executed Licensor regarding Contributions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_6-trademarks","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"6. Trademarks","title":"Apache License","text":"License grant permission use trade names, trademarks, service marks, product names Licensor, except required reasonable customary use describing origin Work reproducing content NOTICE file.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_7-disclaimer-of-warranty","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"7. Disclaimer of Warranty","title":"Apache License","text":"Unless required applicable law agreed writing, Licensor provides Work (Contributor provides Contributions) “” BASIS, WITHOUT WARRANTIES CONDITIONS KIND, either express implied, including, without limitation, warranties conditions TITLE, NON-INFRINGEMENT, MERCHANTABILITY, FITNESS PARTICULAR PURPOSE. solely responsible determining appropriateness using redistributing Work assume risks associated exercise permissions License.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_8-limitation-of-liability","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"8. Limitation of Liability","title":"Apache License","text":"event legal theory, whether tort (including negligence), contract, otherwise, unless required applicable law (deliberate grossly negligent acts) agreed writing, shall Contributor liable damages, including direct, indirect, special, incidental, consequential damages character arising result License use inability use Work (including limited damages loss goodwill, work stoppage, computer failure malfunction, commercial damages losses), even Contributor advised possibility damages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"id_9-accepting-warranty-or-additional-liability","dir":"","previous_headings":"Terms and Conditions for use, reproduction, and distribution","what":"9. Accepting Warranty or Additional Liability","title":"Apache License","text":"redistributing Work Derivative Works thereof, may choose offer, charge fee , acceptance support, warranty, indemnity, liability obligations /rights consistent License. However, accepting obligations, may act behalf sole responsibility, behalf Contributor, agree indemnify, defend, hold Contributor harmless liability incurred , claims asserted , Contributor reason accepting warranty additional liability. END TERMS CONDITIONS","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/LICENSE.html","id":"appendix-how-to-apply-the-apache-license-to-your-work","dir":"","previous_headings":"","what":"APPENDIX: How to apply the Apache License to your work","title":"Apache License","text":"apply Apache License work, attach following boilerplate notice, fields enclosed brackets [] replaced identifying information. (Don’t include brackets!) text enclosed appropriate comment syntax file format. also recommend file class name description purpose included “printed page” copyright notice easier identification within third-party archives.","code":"Copyright 2021 F. Hoffmann-La Roche AG and GlaxoSmithKline LLC  Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at    http://www.apache.org/licenses/LICENSE-2.0  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"dear-developers","dir":"Articles","previous_headings":"","what":"Dear Developers","title":"Get Started","text":"admiraldev set tools intended , developer, help make developing within admiral family easier, consistently robust across packages maybe even fun! Tools loosely defined follows: Utility Functions used admiral admiral extension functions custom checks providing custom messages, warnings errors. custom messages, warnings errors succinct, helpful messaging around function expects inputs. inputs admiral functions many, generally fit three categories: datasets, variables arguments. functions start assert_, is_ get_. Utility functions help documentation, testing checking health code base admiral packages. Vignettes working admiral functions, developing unit testing, releases process, vignette writing documentation needs. vignettes intended use across admiral packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"why-have-a-separate-development-package","dir":"Articles","previous_headings":"","what":"Why have a separate development package?","title":"Get Started","text":"admiral package function base grown decided create extension packages use within companies specific TAs help specific problems. intended extension packages follow processes admiral core, e.g. Unit Testing, Roxygen Documentation, Function Design. standalone development package allows us keep date development process developers across family. also feel lot developer functions user-specific gives us freedom create release utility tools specific family packages reduces non-user facing functions within admiral family packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"how-to-add-new-tools-to-admiraldev","dir":"Articles","previous_headings":"","what":"How to add new tools to {admiraldev}?","title":"Get Started","text":"Just like admiral, follow procedures adding issues discuss feature requests, bugs documentation updates. develop issues branches Pull Request Code Review. Experimental tools highly encouraged help reduce repetitive patterns automating boring stuff.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"scenario-one-admiral-core","dir":"Articles","previous_headings":"When to add a function to {admiraldev}?","what":"Scenario One: {admiral} core","title":"Get Started","text":"developer working admiral core implements new type derivation function BDS-Findings ADaM dataset. new derivation function two new assert custom checking functions inputs well helper function. Loose guidelines: derivation function always live admiral core. helper function looked see made available within admiraldev extension packages needs reduce repetitive coding across family admiral. generalized, remain admiral. assert custom checking functions always live within admiraldev stay family assertion functions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/admiraldev.html","id":"scenario-two-admiral-extension","dir":"Articles","previous_headings":"When to add a function to {admiraldev}?","what":"Scenario Two: {admiral} extension","title":"Get Started","text":"developer working admiralonco implements new type derivation function adding certain parameters oncology specific ADaM dataset. new derivation function one new assert custom checking function. Loose guidelines: derivation function closely looked see can generalized ADaM datasets. case, moved admiral core. function specific oncology needs, remain admiralonco. assert custom checking functions follow similar principle - can generalized therapeutic areas move admiraldev, whereas specific oncology needs, remain admiralonco.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Guidance for git and GitHub Usage","text":"article give overview admiral project utilizing version-control software git website GitHub working RStudio. go primary branches house source code admiral project well use Feature branches address Issues. Issues can range bugs enhancements identified requested developers, users testers. also provide bare minimum git commands needed get running. Please refer Resource section -depth guidance using git GitHub.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"branches","dir":"Articles","previous_headings":"","what":"Branches","title":"Guidance for git and GitHub Usage","text":"main branch contains latest development version package. can find released versions gh-pages branches contains code used render R package websites - looking right now! patch branch reserved special hot fixes address bugs rarely used. info Hot Fix Release main, gh-pages, patch branches protection. try push changes branches get error unless administrator. Feature branches actual development related specific issue happens. Feature branches merged main pull request merged. Check Pull Request Review Guidance guidance merging main.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"working-with-feature-branches","dir":"Articles","previous_headings":"","what":"Working with Feature Branches","title":"Guidance for git and GitHub Usage","text":"Feature Branches developers work addressing Issues.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"implementing-an-issue","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Implementing an Issue","title":"Guidance for git and GitHub Usage","text":"feature branch must related issue. encourage new developers work one issue time.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"naming-branches","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Naming Branches","title":"Guidance for git and GitHub Usage","text":"name branch must prefixed issue number, followed short meaningful description. example, given issue #94 “Program function derive LSTALVDT”, branch name 94_derive_var_lstalvdt.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"create-a-new-feature-branch-from-the-terminal-from-main","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Create a New Feature Branch from the Terminal (from main)","title":"Guidance for git and GitHub Usage","text":"Checkout main branch: git checkout main Pull latest changes GitHub: git pull Create new branch main branch switch : git checkout -b <new_branch_name>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"create-a-new-feature-branch-from-github-from-main","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Create a New Feature Branch from GitHub (from main)","title":"Guidance for git and GitHub Usage","text":"can also create feature branch GitHub. Switch main branch Type new feature branch name Click Create branch: <your_branch_name>@main main Sure Pull newly created branch RStudio","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commits-from-the-terminal-in-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commits from the Terminal in RStudio","title":"Guidance for git and GitHub Usage","text":"start commit process, need tell git move changes staging area. Use git add <your_file> move changes <your_file> staging area wait next commit. can use git add . move files worked staging area. Next can commit, takes snapshot staged changes. committing, prefix message issue number add meaningful message git commit –m '#94 last alive date implementation'. Lastly, push changes GitHub using git push origin <branch name>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commits-from-the-git-tab-in-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commits from the Git Tab in RStudio","title":"Guidance for git and GitHub Usage","text":"can also make use Git Tab within RStudio commit changes. benefit using Tab able see changes file red green highlighting. Just like terminal, start message issue number add meaningful succinct sentence. Hit Commit button Push GitHub.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"commit-message-etiquette","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Commit Message Etiquette","title":"Guidance for git and GitHub Usage","text":"require developers insert issue number commit message. Placing issue number commit message allows reviewers quickly find discussion surrounding issue. pushed GitHub issue number hyperlinked issue tracker, powerful tool discussion traceability, think valuable highly regulated industry like Pharma. styles commit messaging permitted:","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-1","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 1:","title":"Guidance for git and GitHub Usage","text":"feat: #94 skeleton function developed chore: #94 styler lintr update docs: #94 parameters details sections compelted","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-2","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 2:","title":"Guidance for git and GitHub Usage","text":"#94 skeleton function developed #94 styler lintr update #94 parameters details sections compelted","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"style-3","dir":"Articles","previous_headings":"Working with Feature Branches > Implementing an Issue","what":"Style 3:","title":"Guidance for git and GitHub Usage","text":"skeleton function developed (#94) styler lintr update (#94) parameters details sections compelted (#94)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"pull-request","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Pull request","title":"Guidance for git and GitHub Usage","text":"recommend thorough read articles, Pull Request Review Guidance Programming Strategy -depth discussions proper Pull Request.Pull Request authors benefit shorter review times closely following guidance provided two articles. discuss simple git commands terminal GitHub Pull Request. recommend Pull Request GitHub terminal. changes committed, push updated branch GitHub:git push -u origin <branch_name> GitHub, Pull requests, user either “Compare pull request” button /“Create Pull Request”. first button created GitHub detects recent changes made. branch merge must main branch (base = main) compare branch new branch merge - shown picture. Please pay close attention branch merging !  issue must linked pull request “Development” field Pull Request. cases, linkage automatically close issue move Done column project board.  completed Pull Request see committed changes available reviewer. reviewer must specified Pull Request. recommended write brief summary reviewers can quickly come speed Pull Request. Images updates nice , easy GitHub! Use Screen Capture software Copy Paste summary.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"reviewingclosing-an-issue","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Reviewing/Closing an Issue","title":"Guidance for git and GitHub Usage","text":"least one reviewer must approve Pull Request. Please review Pull Request Review Guidance, provides depth guidance proper Pull Request. reviewer must ensure function follows programming strategy recommendations. comment/question/discussion must addressed documented GitHub Pull Request merged review completed, reviewer merge Pull Request feature branch automatically deleted. merging Pull Request please check corresponding moved done column Project Board. Also, please make sure issue closed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"solving-merge-conflicts-in-the-terminal-on-rstudio","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Solving Merge Conflicts in the Terminal on RStudio","title":"Guidance for git and GitHub Usage","text":"Merge conflict situation git decide changes apply since multiple updates part file. typically happens multiple people update part code. conflicts always need handled manually (code updates may required): provides list files conflicts file conflicts conflicting sections marked <<<<<<<, =======, >>>>>>>. code markers must updated markers removed. Source files need updated manually. Generated files like NAMESPACE generated documentation files updated manually recreated source files updated. make changes available call:","code":"git checkout main git pull git checkout <feature_branch>   git merge main git add <file with conflict>  git commit -m \"<insert_message>\" git push"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"solving-merge-conflicts-in-github","dir":"Articles","previous_headings":"Working with Feature Branches > Pull request","what":"Solving Merge Conflicts in GitHub","title":"Guidance for git and GitHub Usage","text":"simple merge conflicts, developers can make use GitHub interface solve . GitHub show number conflicts two branches. image, GitHub found 3 conflicts, display first one. Just like terminal, GitHub make use <<<<<<<, =======, >>>>>>> highlight conflicting sections. need make decision whether keep code base feature branch. decided, go code remove section longer wish keep. sure remove <<<<<<<, =======, >>>>>>> well! work conflicts mark Resolved Commit changes. recommended pull branch back RStudio make sure untoward effects happen branch.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"useful-git-commands","dir":"Articles","previous_headings":"Working with Feature Branches","what":"Useful git Commands","title":"Guidance for git and GitHub Usage","text":"merging: git merge <my_branch> - merge my_branch current branch stashing commands useful one wants go back clean directory git stash - stash (store) current changes restore clean directory git stash pop - put back (restore) stashed changes git revert also helpful ? Using code unmerged branches Checkout unmerged branch want use: git checkout <unmerged_branch> Pull latest committed changes unmerged branch: git pull Check feature branch: git checkout <my_branch> Merge unmerged branch : git merge <unmerged_branch>","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/git_usage.html","id":"github_resources","dir":"Articles","previous_headings":"","what":"Resources on using git, GitHub and RStudio","title":"Guidance for git and GitHub Usage","text":"GitHub RStudio Happy Git GitHub useR","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Package Extensions","text":"admiral made family packages foresee growing time cover specific areas TA (Therapeutic Area) package extensions, wider range companies individuals getting board join development efforts. step--step guidance talks recommendations new development teams go creating package extensions. critical guidance followed, users need feel consistent experience working across admiral packages. admiral package extension doesn’t follow conventions wouldn’t include pharmaverse part admiral family.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"step-by-step-guidance-to-create-a-package-extension","dir":"Articles","previous_headings":"","what":"Step-by-step Guidance to Create a Package Extension","title":"Package Extensions","text":"Note: ordering numbers suggested don’t need strictly followed sequence. Raise need new admiral package extension admiral Slack channel, directly admiral package maintainer. naming convention needs {admiralxxx} request scope targeted overly narrow, example instead package extension HIV ’d prefer one across virology. Otherwise number packages may become unmanageable. agreed, reach company contacts working similar areas see collaborative development can achieved. recommendation always target least 2 companies start implementation remains robust protect going company-specific route. However, consider 4 5 companies get involved early may slow decision-making. companies agree co-develop, identify lead . One company act driver overall package extension put forward product owner technical lead ultimately final say contentious decisions. product owner cover project decisions (e.g. around scope priorities), whereas technical lead cover technical decisions (e.g. around design implementation). technical lead either: ) already significantly involved admiral core development team developer/contributor, b) join core development team simultaneously. ensure design kept true manifesto consistent style quality respect admiral standards. Agree charter expectations company, e.g. usually ask least 3 developers least 25% capacity mix R, GitHub TA experience. Within charter make sure scope timelines clear. important try boil ocean. Focus first common endpoints required foundation package can build via contributions co-development companies also wider across-industry admiral community. useful, admiralonco charter shared guide. company start identify required developer resources. developer required complete {admiral} dummy issue onboarding, well reading admiraldev documentation, - especially developer guides, need followed package extensions. Optionally can useful host kick-meeting decide team work, recommend agile/scrum practices. Set “admiralxxx_dev” channel Slack add team members informal team chat, agree way share working documents across co-development team. recommend use new folder pharmaverse MS Teams - Michael Rimler (michael.s.rimler@gsk.com) help rep PHUSE board. useful starter development activity look pharmaversesdtm check test data sufficient TA needs, e.g. admiralonco generate new test data SDTM domains RS TU. Note personal data used (even anonymized) important keep data generated -line CDISC pilot data use , .e. use USUBJIDs DM etc. Optionally draft, agree sign collaboration agreement collaborating companies wish, useful protecting secondary IP company standard specifications may shared within team. example stored , work Legal teams required. Share company-specific implementations specifications able harmonize design strategy package extension. important remain pragmatic consider higher perspective one company. Engage company standards representatives find discrepancies across company approaches question really need things differently (health authorities patients benefit ?). Also consider always expect level company-specifics covered internal company package extensions. Set new public GitHub repo pharmaverse org using admiraltemplate - includes set-pieces (CI/CD checks issue/PR templates) enable package stay consistent others admiral family, well core package dependencies versions. See {admiraltemplate} Quick Start Guide Note step requires org member access granted pharmaverse council reps, admins org. Also free add additional package dependencies needed assuming reliable packages used, must depend newer versions packages (always reply “” updates suggested installation). repo available technical lead granted admin access repo set GitHub team name package extension assign required access co-development team members. require write access, may choose give leads admin access well never bottle-neck waiting one person. Update template license file repo adding co-development company names place Roche & GSK - admiral package extensions use Apache 2.0, preferred permissive license. Agree co-development companies required extra wording copyright/IP section. Set project board, , help manage backlog. Assuming work agile/scrum, create product backlog, prioritize make sprint plan. intention always re-use much possible admiral core package. find anything additional needed package extension, first question whether might common need TAs consider instead raising issue admiral core. designing new functions always try stay aligned Programming Strategy. Start development foundational first release 0.1.0. Follow consistent Development Process admiral. Line testers companies others set expectations around believe stable version available user testing. can use admiral Slack community raise interest get involved. Add pharmaverse badge README: https://pharmaverse.org/contribute/badges/ - needs support pharmaverse council rep. Raise admiral repo issue ensure package extension site linked core admiral site .` important admiral family packages keep similar release schedule cadence, order ease adoption users give clear expectations. admiral core package cadence releases one every quarter fixed schedule (every first Monday last month quarter - March, June, September, December). core package set release schedule package extensions follow, .e. admiral releases ’d expect package extension releases targeted within 2 week window. releases communicated via Slack channel well quarterly user community meetings. happy package extension well tested sufficient state make submission CRAN. technical lead named maintainer. CRAN release, advertise via Slack & LinkedIn. Plan future enhancements make issues. team feels ready can open development contributions wider community - see page. Please use good first issue (ideal new starters) & help wanted (ideal experienced contributors) issue labels. Note: core admiral team carry periodic reviews extension package contents ensure nothing duplicated ensure standards best practices followed. frequency reviews agreed upon technical leads core extension packages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/package_extensions.html","id":"lessons-learned","dir":"Articles","previous_headings":"","what":"Lessons Learned","title":"Package Extensions","text":"lessons learned previous package extensions: Since ADaM conceived TA-agnostic, TA standards can widely differ across companies, TA package extensions shouldn’t contain many new functions. , functionality required create ADaM present admiral, localized limited exceptions truly TA-specific variables/endpoints. , R folder package extensions relatively lean! Connected , package extension just R functions - also vignettes examples template programs. fact, just important R functions , users turn guidance. Making sure package always --date respect new admiral releases (e.g. due deprecation functions) crucial task. Maintaining package long-term way ensure success. Beware developing just sake developing! may find reach point stasis extension package journey, much need new development. case, vital avoid working tangential tasks. Instead, focus ensuring existing fit--purpose possible.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Pull Request Review Guidance","text":"document intended guidance creators reviewers pull requests (PRs) admiral package family. PR authors benefit shorter review times closely following guidance provided . pull request main branch signifies issue “addressed”. issue might bug, feature request documentation update. Pull Request merged main branch, issue(s) can closed. Closely following guidance ensure “addressed” issues auto-close merge main.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"review-criteria","dir":"Articles","previous_headings":"","what":"Review Criteria","title":"Pull Request Review Guidance","text":"pull request merged main needs pass automated CI checks appear bottom Pull Request. addition, PR creator reviewer make sure Programming Strategy Development Process followed function ADaM IG compliant function intended (described header corresponding issue) function header properly explains intention function, expected inputs (incl. permitted values parameters) output produced; reading documentation reader able predict output function without read source code function accompanying set unit tests; derivations unit test code coverage least 90%; whole package coverage >= 80% implemented derivation scope admiral, e.g. expect company specific input hard-code company-specific rules meaningful error warning messages issued input invalid documentation created/updated running devtools::document() functions supposed exported listed NAMESPACE file; requires @export tag function header examples print relevant source variables newly created variables /records output NEWS.md file updated entry explains new features changes change user-specific warrants mention development milestone files affected implemented changes, e.g. vignettes templates, updated","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"codeowners-and-pr-guidance","dir":"Articles","previous_headings":"Review Criteria","what":"Codeowners and PR Guidance","title":"Pull Request Review Guidance","text":"creator PR, assignment reviewer can unclear. PRs, feel free select members core development team. individuals scan repository regular basis well may provide /review even originally included selected reviewer. Sometimes, development function vignette falls specific-topic, e.g. labs PK/PD. Please ensure include appropriate reviewer modifying files rely domain-expertise. try maintain active list domain-specific topics automatically tag appropriate reviewer using CODEOWNERS file, located .github folder. interested codeowner, reach development team.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"so-much-red-tape","dir":"Articles","previous_headings":"","what":"So much Red Tape!","title":"Pull Request Review Guidance","text":"admiral development team aware sympathetic great many checks, processes documents needed work order compliant Pull Request. task-list-completed GitHub workflow created help reduce burden contributors providing standardized checklist compiles information Pull Request Review Guidance, Programming Strategy Development Process vignettes. next three sections give high-level overview contributor faces opening PR, contributor interacts task-list-completed workflow PR.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"open-a-pull-request","dir":"Articles","previous_headings":"So much Red Tape!","what":"Open a Pull Request","title":"Pull Request Review Guidance","text":"contributor opens PR lengthy standard text inserted comment section. Please alter automated text. need manually add Closes #<insert_issue_number> title Pull Request. can use Edit button top right forget step start Pull Request. Besides free add additional textual information, screenshots, etc. bottom automated text needed clarify contribute discussion around PR.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"create-a-pull-request","dir":"Articles","previous_headings":"So much Red Tape!","what":"Create a Pull Request","title":"Pull Request Review Guidance","text":"click green Create pull request button automated text inserted turned checklist Pull Request. check box drawn previously mentioned vignettes presented recommended sequence. check boxes meant helpful aid ensuring created compliant Pull Request.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"complete-the-pull-request-checklist","dir":"Articles","previous_headings":"So much Red Tape!","what":"Complete the Pull Request checklist","title":"Pull Request Review Guidance","text":"check boxes linked task-list-completed workflow. need check box acknowledgment done due diligence creating compliant Pull Request. GitHub refresh Pull Request trigger task-list-completed workflow completed task. PR can merged main contributor checked check box items.  Please don’t hesitate reach admiral team Slack GitHub Issues tracker think checklist needs amended clarity needed check box item. Note Reviewers: recommend use Squash Merge merging Pull Request. create clean commit history.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"github-actionsci-workflows","dir":"Articles","previous_headings":"","what":"GitHub Actions/CI Workflows","title":"Pull Request Review Guidance","text":"task-list-completed workflow one several workflows/actions used within admiral. workflows live .github/workflows folder important understand use remedy workflow fails. Workflows defined responsible assuring high package quality standards without compromising performance, security, reproducibility.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/pr_review_guidance.html","id":"a-synopsis-of-admirals-workflows","dir":"Articles","previous_headings":"GitHub Actions/CI Workflows","what":"A synopsis of admiral’s workflows","title":"Pull Request Review Guidance","text":"recommend checking README admiralci repository gain understanding workflows/actions used admiral.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Programming Strategy","text":"admiral intended contributed user community, article meant developers want either expand admiral functionalities build top admiral. order keep framework robust across whole community, defined programming strategy followed cases. contributions include, example, company specific derivations ADaM datasets.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"functional-workflow","dir":"Articles","previous_headings":"","what":"Functional Workflow","title":"Programming Strategy","text":"Overall programming follow functional approach. mandate use tidyverse (e.g. dplyr) similar functionality existing base R ADaM dataset built set functions free flow code. ADaM dataset specific programming workflow. function specific purpose supports ADaM Dataset programming workflow. admiral function company specific function. Admiral functions can re-used company specific functions. function belongs one category defined keywords/family. function used derive one multiple variable(s) required unit tested. Functions standard naming convention. Double coding used QC method (absolutely necessary). ADaMs created readable, submission-ready code.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-design","dir":"Articles","previous_headings":"Functions in R","what":"Function Design","title":"Programming Strategy","text":"Firstly, important explain decide need new derivation functions. derivation rule algorithm common highly similar across different variables/parameters (e.g. study day duration) provide generic function can used satisfy times may needed across different ADaMs. Similarly, feel certain derivation useful beyond single purpose also provide generic function (e.g. instead last known alive date function, extreme date function user find last date selection, example first). Otherwise, feel derivation rule unique need sufficiently complex justify opt dedicated function specific variable/parameter (e.g. treatment-emergent flag AEs). certain variables closely connected (e.g. imputed date corresponding imputation flag) single function provide variables. something needed ADaM achieved simply via existing tidyverse function, wrap admiral function, add unnecessary extra layer users. following principles key designing new function: Modularity - code follows modular approach, .e. steps must clearly separated dedicated purpose. applies scripts creating dataset module create single variable parameter. also complex derivations several steps. Commenting steps key readability. Avoid Copy Paste - similar code used multiple times, put separate function. improves readability maintainability makes unit testing easier. done every simple programming step tidyverse can used. rather computational functions data checks. However, also consider nest many functions. Checks - Whenever function fails, meaningful error message must provided clear reference input caused failure. users dig detailed code want apply function. meaningful error message supports usability. Flexibility - Functions flexible possible long reduce usability. example: source variables newly created variables conditions selecting observations hard-coded. useful argument triggers optional steps, e.g. filter argument specified, input dataset restricted, otherwise step skipped. However, arguments trigger completely different algorithms. example BNRIND derived based BASE based ANRIND. implemented within one function algorithms completely different. BASE used, values categorized ANRIND used, values merged baseline observation.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"input-output-and-side-effects","dir":"Articles","previous_headings":"Functions in R","what":"Input, Output, and Side-effects","title":"Programming Strategy","text":"behavior function determined input, global object, .e. input like datasets, variable names, options, … must provided function arguments. expected input datasets grouped. grouped, function must issue error. function requires grouping, function must provide by_vars argument. output dataset must ungrouped. functions sort (arrange) output dataset end. function needs create temporary variables input dataset, names variables must generated get_new_tmp_var() avoid variables input dataset accidentally overwritten. temporary variables must removed output dataset calling remove_tmp_vars(). developers find need use create environment objects achieve flexibility, use admiral_environment environment object created admiral_environment.R. objects stored environment must documented admiral_environment.R. equivalent environment object .R file exist admiraldev well. details environments work, see relevant sections environments R Packages Advanced R textbooks. general, function must side-effects like creating modifying global objects, printing, writing files, …","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"admiral-options","dir":"Articles","previous_headings":"Functions in R","what":"Admiral Options","title":"Programming Strategy","text":"exception made admiral options, see get_admiral_option() set_admiral_options(), certain pre-defined defaults added flexibility allow user-defined defaults commonly used function arguments e.g. subject_keys currently pre-defined exprs(STUDYID, USUBJID), can modified using set_admiral_options(subject_keys = exprs(...)) top script. reasoning behind relieve user repeatedly changing aforementioned commonly used function arguments multiple times script, may called across many admiral functions. additional flexibility needs added another commonly used function argument e.g. future_input set exprs(...) can added admiral option. function formals define future_input = get_admiral_option(\"future_input\") proceed modify body roxygen documentation set_admiral_options().","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-names","dir":"Articles","previous_headings":"Functions in R","what":"Function Names","title":"Programming Strategy","text":"Function names start verb use snake case, e.g. derive_var_base(). Please note appropriate var/vars prefix used cases function creates variable(s), regardless presence new_var argument function call. Oftentimes creating new derive_var derive_param function may sort non-trivial calculation involved may want write customized function . creating compute_ function becomes appropriate, calculation portion contained one step part overall derive_ function, reducing clutter main function body assisting debugging. addition, compute_ function implemented calculation used one derivation. example compute_bmi() used derive baseline BMI variable ADSL (based baseline weight baseline height variables) also used derive BMI parameter ADVS (based weight height parameters). Please see compute_age_years() derive_var_age_years() another example.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-arguments","dir":"Articles","previous_headings":"Functions in R","what":"Function Arguments","title":"Programming Strategy","text":"default value optional arguments NULL. recommended argument order contributors asked adhere (order keep consistency across functions): dataset (additional datasets denoted dataset_*) by_vars order new_var (related new_var_* arguments) filter (additional filters denoted filter_*) Make sure always mention start_date end_date (related). Names variables inside dataset passed symbols rather strings, .e. AVAL rather \"AVAL\". argument accepts one variables expressions input variables expressions wrapped inside exprs(). example: new_var = TEMPBL by_vars = exprs(PARAMCD, AVISIT) filter = PARAMCD == \"TEMP\" order = exprs(AVISIT, desc(AESEV)) new_vars = exprs(LDOSE = EXDOSE, LDOSEDT = convert_dtc_to_dt(EXSTDTC)) function argument needs tested assert_ type function. expression needs tested following (many utility functions admiral available contributor): whether expression (list expressions, depending function) whether valid expression (.e. whether evaluates without error)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"common-function-arguments-naming-convention","dir":"Articles","previous_headings":"Functions in R","what":"Common Function Arguments Naming Convention","title":"Programming Strategy","text":"first argument derive_ functions input dataset named dataset. one input dataset required, input dataset start dataset_, e.g., dataset_ex. Arguments specifying items add start new_. variable added, second part argument name var, parameter added, param. example: new_var, new_var_unit, new_param. Arguments expect boolean boolean vector must start verb, e.g., is_imputed impute_date. Arguments expect one value variable name must singular version word(s), e.g., missing_value new_var. Arguments expect several values variable names (list, expressions, etc.) must plural version word(s), e.g., missing_values new_vars.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"source-code-formatting","dir":"Articles","previous_headings":"Functions in R","what":"Source Code Formatting","title":"Programming Strategy","text":"source code formatted according tidyverse style guide. lintr styler packages used check enforce .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"comments","dir":"Articles","previous_headings":"Functions in R","what":"Comments","title":"Programming Strategy","text":"Comments added help readers author understand code. two main cases: intention chunk code clear, comment added. comment rephrase code provide additional information. Bad Good long functions (>100 lines) comments can added structure code simplify navigation. case comment end ---- add entry document outline RStudio. example: formatting comments must follow tidyverse style guide. .e., comment start single # space. decoration (except outline entries) must added. Bad Good","code":"# If AVAL equals zero, set it to 0.0001. Otherwise, do not change it   mutate(dataset, AVAL = if_else(AVAL == 0, 0.0001, AVAL)) # AVAL is to be displayed on a logarithmic scale.   # Thus replace zeros by a small value to avoid gaps.   mutate(dataset, AVAL = if_else(AVAL == 0, 0.0001, AVAL)) # Check arguments ---- # This is a comment #  ########################### # This is another comment # ###########################  #+++++++++++++++++++++++++++++++ # This is a section comment ---- #+++++++++++++++++++++++++++++++ # This is a comment  # This is another comment  # This is a section comment ----"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"input-checking","dir":"Articles","previous_headings":"Functions in R","what":"Input Checking","title":"Programming Strategy","text":"line fail-fast design principle, function inputs checked validity , ’s invalid input, function stop immediately error. exception case variable added function already exists input dataset: warning displayed function continue executing. Inputs checked using custom assertion functions defined R/assertions.R. custom assertion functions either return error case invalid input return nothing. common types input arguments like single variable, list variables, dataset, … functions checking available (see assertions). Arguments expect keywords handle case-insensitive manner, e.g., date_imputation = \"FIRST\" date_imputation = \"first\" accepted. assert_character_scalar() function helps handling arguments case-insensitive manner. argument checked outer function argument name inner function. rule applicable functions part admiral.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function-header-documentation","dir":"Articles","previous_headings":"Functions in R","what":"Function Header (Documentation)","title":"Programming Strategy","text":"Every function exported package must accompanying header formatted according roxygen2 convention. addition standard roxygen2 tags, @family @keywords tags also used. family/keywords used categorize function, used website internal package help pages. Please see section Categorization functions. example given : following fields mandatory: @param: One entry per function argument. following attributes described: expected data type (e.g. data.frame, logical, numeric etc.), permitted values (applicable), optionality (.e. required argument). expected input dataset required variables clearly stated. Describing default value becomes difficult maintain subject manual error already declared function arguments. description permitted values written separate line italicizing phrase “Permitted Values”, example : @details: natural-language description derivation used inside function. @keyword: One applicable tag function - identical family. @family: One applicable tag function - identical keyword. @return: description return value function. newly added variable(-s) mentioned . @examples: fully self-contained example use function. Self-contained means , code executed new R session, run without errors. means packages need loaded library() datasets needed either created directly inside example code loaded using data(). dataset created example, done using function tribble() (specify library(dplyr) calling function). functions called example, please specify library(pkg_name) refer respective function fun() opposed preferred pkg_name::fun() notation specified Unit Test Guidance. Make sure align columns ensures quick code readability. Copying descriptions avoided makes documentation hard maintain. example argument description used one function, argument described one function functions use @inheritParams <function name argument described>. Please note @inheritParams func_first used header func_second() function, argument descriptions func_first() included documentation func_second() argument offered func_second() @param tag argument included header func_second(). order @param tags function definition. @inheritParams tags @param. affect order argument description rendered documentation makes easier maintain headers. Variable names, expressions, functions, code must enclosed backticks. render code. functions derive specific CDISC variable, title must state label variable without variable name. variable stated description.","code":"#' Derive Relative Day Variables #' #' Adds relative day variables (`--DY`) to the dataset, e.g., `ASTDY` and #' `AENDY`. #' #' @param dataset Input dataset #' #'   The columns specified by the `reference_date` and the `source_vars` #'   argument are expected. #' #' @param reference_date The start date column, e.g., date of first treatment #' #'   A date or date-time object column is expected. #' #'   Refer to `derive_var_dt()` to impute and derive a date from a date #'   character vector to a date object. #' #' @param source_vars A list of datetime or date variables created using #'   `exprs()` from which dates are to be extracted. This can either be a list of #'   date(time) variables or named `--DY` variables and corresponding --DT(M) #'   variables e.g. `exprs(TRTSDTM, ASTDTM, AENDT)` or `exprs(TRTSDT, ASTDTM, #'   AENDT, DEATHDY = DTHDT)`. If the source variable does not end in --DT(M), a #'   name for the resulting `--DY` variable must be provided. #' #' @details The relative day is derived as number of days from the reference #'   date to the end date. If it is nonnegative, one is added. I.e., the #'   relative day of the reference date is 1. Unless a name is explicitly #'   specified, the name of the resulting relative day variable is generated #'   from the source variable name by replacing DT (or DTM as appropriate) with #'   DY. #' #' @return The input dataset with `--DY` corresponding to the `--DTM` or `--DT` #'   source variable(s) added #' #' @keywords der_date_time #' @family der_date_time #' #' @export #' #' @examples #' library(lubridate) #' library(dplyr, warn.conflicts = FALSE) #' #' datain <- tribble( #'   ~TRTSDTM,              ~ASTDTM,               ~AENDT, #'   \"2014-01-17T23:59:59\", \"2014-01-18T13:09:O9\", \"2014-01-20\" #' ) %>% #'   mutate( #'     TRTSDTM = as_datetime(TRTSDTM), #'     ASTDTM = as_datetime(ASTDTM), #'     AENDT = ymd(AENDT) #'   ) #' #' derive_vars_dy( #'   datain, #'   reference_date = TRTSDTM, #'   source_vars = exprs(TRTSDTM, ASTDTM, AENDT) #' ) #'   *Permitted Values*: example description of permitted values here"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"categorization-of-functions","dir":"Articles","previous_headings":"Functions in R","what":"Categorization of Functions","title":"Programming Strategy","text":"functions categorized keywords families within roxygen header. Categorization important admiral user-facing functions base totals 125 growing! However, ease burden developers, decided keywords families identical roxygen header, specified via @keywords @family fields. reiterate, function must use keyword family. Also, please note keywords families case-sensitive.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"keywords","dir":"Articles","previous_headings":"Functions in R > Categorization of Functions","what":"@keywords","title":"Programming Strategy","text":"keywords allows reference page easily organized using certain pgkdown functions. example, using function has_keyword(der_bds_gen) _pkgdown.yml file building website collect BDS General Derivation functions display alphabetical order Reference Page section called BDS-Specific.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"family","dir":"Articles","previous_headings":"Functions in R > Categorization of Functions","what":"@family","title":"Programming Strategy","text":"families allow similar functions displayed See Also section function’s documentation. example, user looking derive_vars_dy() function documentation might interested Date/Time functions. Using @family tag der_date_time display Date/Time functions available admiral user See Also section derive_vars_dy() function documentation. Please take look function documentation derive_vars_dy() see family tag action. list available keyword/family tags used admiral functions. think additional keyword/family tag added, please add issue GitHub discussion. NOTE: strongly encouraged @keyword @family identical. eases burden development maintenance admiral functions. need use multiple keywords families, please reach core development team discussion.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"missing-values","dir":"Articles","previous_headings":"","what":"Missing values","title":"Programming Strategy","text":"Missing values (NAs) need explicitly shown. Regarding character vectors converted SAS files: SAS treats missing character values blank. imported R empty strings (\"\") although nature missing values (NA). empty strings originate like need converted proper R missing values NA.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"file-structuring","dir":"Articles","previous_headings":"","what":"File Structuring","title":"Programming Strategy","text":"Organizing functions files art science. Thus, hard rules just recommendations. First foremost, two extremes avoided: putting function file putting functions single file. Apart following recommendations taken consideration deciding upon file structuring: function long (together documentation), store separate file functions documented together, put one file functions sort commonality relevance one another (like dplyr::bind_rows() dplyr::bind_cols()), put one file Store functions together helpers methods 1000 lines single file, unless necessary (exceptions , example, classes methods) responsibility author new function reviewer ensure recommendations put practice.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"r-package-dependencies","dir":"Articles","previous_headings":"","what":"R Package Dependencies","title":"Programming Strategy","text":"Package dependencies documented DESCRIPTION file. package used examples /unit tests listed Suggests, otherwise Imports. Functions packages explicitly imported using @importFrom tag R/admiral-package.R file. import if_else() mutate() function dplyr following line included file: #' @importFrom dplyr if_else mutate. using @importFrom tag, easier track dependencies one place improves code readability. functions become critically important using admiral included export. applies functions frequently called within {admiral }function calls like rlang::exprs(), dplyr::desc() pipe operator dplyr::%>%. export functions, following R code included R/reexports.R file using format:","code":"#' @export pkg_name::fun"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"metadata","dir":"Articles","previous_headings":"","what":"Metadata","title":"Programming Strategy","text":"Functions perform derivation logic add kind metadata, e.g. labels.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"unit-testing","dir":"Articles","previous_headings":"","what":"Unit Testing","title":"Programming Strategy","text":"function requires set unit tests verify produces expected result. See Writing Unit Tests {admiral} details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"deprecation","dir":"Articles","previous_headings":"","what":"Deprecation","title":"Programming Strategy","text":"admiral still evolving, functions arguments may need removed replaced efficient options one release another. cases, relevant function argument must marked deprecated. deprecation done three phases release cycles. Phase 1: release identified function argument deprecated warning issued using function argument using deprecate_warn(). Phase 2: next release error thrown using deprecate_stop(). Phase 3: Finally 3rd release thereafter function removed package altogether. Information deprecation timelines must added warning/error message. Note deprecation cycle time function argument based current release schedule 6 months.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"documentation","dir":"Articles","previous_headings":"Deprecation","what":"Documentation","title":"Programming Strategy","text":"function argument removed, documentation must updated indicate function argument now deprecated new function/argument used instead. documentation updated : description level function, @keywords @family roxygen tags replaced deprecated @examples section removed. @param level argument.","code":"#' Title of the function #' #' @description #' `r lifecycle::badge(\"deprecated\")` #' #' This function is *deprecated*, please use `new_fun()` instead. #' . #' @family deprecated #' #' @keywords deprecated #' . @param old_param *Deprecated*, please use `new_param` instead."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"handling-of-warning-and-error","dir":"Articles","previous_headings":"Deprecation","what":"Handling of Warning and Error","title":"Programming Strategy","text":"function argument deprecated, function must updated issue warning error using deprecate_warn() deprecate_stop(), respectively, described . test case added test file function checks whether warning/error issued appropriate using deprecated function argument.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"function","dir":"Articles","previous_headings":"Deprecation > Handling of Warning and Error","what":"Function","title":"Programming Strategy","text":"initial release function deprecated original function body must replaced call deprecate_warn() subsequently arguments passed new function. following release function body changed just include call deprecate_stop(). Finally, next release function removed package.","code":"fun_xxx <- function(dataset, some_param, other_param) {   deprecate_warn(\"x.y.z\", \"fun_xxx()\", \"new_fun_xxx()\")   new_fun_xxx(     dataset = dataset,     some_param = some_param,     other_param = other_param   ) } fun_xxx <- function(dataset, some_param, other_param) {   deprecate_stop(\"x.y.z\", \"fun_xxx()\", \"new_fun_xxx()\") }"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"argument","dir":"Articles","previous_headings":"Deprecation > Handling of Warning and Error","what":"Argument","title":"Programming Strategy","text":"argument removed replaced, error must generated: argument renamed replaced, warning must issued new argument takes value old argument next release. Note: arguments passed exprs() argument (e.g. new_var = VAR1 filter = AVAL >10) need quoted.","code":"### BEGIN DEPRECATION   if (!missing(old_param)) {     deprecate_stop(\"x.y.z\", \"fun_xxx(old_param = )\", \"fun_xxx(new_param = )\")   } ### END DEPRECATION ### BEGIN DEPRECATION   if (!missing(old_param)) {     deprecate_warn(\"x.y.z\", \"fun_xxx(old_param = )\", \"fun_xxx(new_param = )\")     # old_param is given using exprs()     new_param <- old_param     # old_param is NOT given using exprs()     new_param <- enexpr(old_param)   } ### END DEPRECATION"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"unit-testing-1","dir":"Articles","previous_headings":"Deprecation","what":"Unit Testing","title":"Programming Strategy","text":"Unit tests deprecated functions arguments must added test file 1 function ensure warning error issued. writing unit test, check error warning right class, .e., \"lifecycle_error_deprecated\" \"lifecycle_warning_deprecated\", respectively. unit-test follow corresponding format, per unit test guidance.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"for-deprecated-functions-that-issues-a-warning-phase-1","dir":"Articles","previous_headings":"Deprecation > Unit Testing","what":"For Deprecated Functions that Issues a Warning (Phase 1)","title":"Programming Strategy","text":"unit test like following must added. existing unit tests call deprecated function need enclosed suppress_warning(). example, regexpr argument must specified ensure deprecation warning suppressed.","code":"## Test #: deprecation warning if function is called ---- test_that(\"derive_var_example() Test #: deprecation warning if function is called\", {   expect_warning(     derive_var_example(),     class = \"lifecycle_warning_deprecated\"   ) }) actual <- suppress_warning(     derive_var_example(),     regexpr = \"was deprecated\"   )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"for-deprecated-functions-that-issues-an-error-phase-2","dir":"Articles","previous_headings":"Deprecation > Unit Testing","what":"For Deprecated Functions that Issues an Error (Phase 2)","title":"Programming Strategy","text":"unit test like following must added. unit tests deprecated function must removed.","code":"## Test #: error if function is called ---- test_that(\"derive_var_example() Test #: deprecation error if function is called\", {   expect_error(     derive_var_example(),     class = \"lifecycle_error_deprecated\"   ) })"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"best-practices-and-hints","dir":"Articles","previous_headings":"","what":"Best Practices and Hints","title":"Programming Strategy","text":"Please take following list recommendation try adhere rules possible. Arguments function calls named except first parameter (e.g. assert_data_frame(dataset, required_vars = exprs(var1, var2), optional = TRUE)). dplyr::if_else() used two conditions. Try always set missing argument whenever appropriate.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"how-quoting-is-used","dir":"Articles","previous_headings":"Best Practices and Hints","what":"How Quoting is used","title":"Programming Strategy","text":"admiral arguments require selecting one particular option like mode, e.g. mode = \"last\". Use quotation marks capture . expected assertion function corresponding arguments assert_character_scalar()/assert_character_vector(). Many admiral arguments require capturing expression, typically encased exprs() statement, evaluated later inside function body, see arguments like new_vars, e.g. new_vars = exprs(TRTSDTM = EXSTDTM). Oftentimes, assertion function corresponding assert_expr()/assert_expr_list(). arguments unquoted using !!!. admiral arguments like new_var filter expect single variable expression quoted call. function body, quoted using enexpr(). Usually combined assertion, e.g., new_var <- assert_symbol(enexpr(new_var)). arguments unquoted using !!. Keep mind !! one--one replacement !!! one--many replacement. Please see chapter Advanced R textbook details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"standardizing-text-used-to-label-and-describe-arguments","dir":"Articles","previous_headings":"Best Practices and Hints","what":"Standardizing Text Used to Label and Describe Arguments","title":"Programming Strategy","text":"following PR, find example function argument dataset able standardized Label Description said function argument aligned across codebase. Please see changes file derive_adeg_params.R details. benefits programmatic way write documentation changes need made, making modification corresponding function, case, roxygen_param_dataset(), scales across codebase, can tested, less prone user-error typos grammar mistakes. functions implemented roxygen2.R naming convention argument follows roxygen_param_xxx(), “xxx” replaced argument name.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/programming_strategy.html","id":"r-and-package-versions-for-development","dir":"Articles","previous_headings":"","what":"R and Package Versions for Development","title":"Programming Strategy","text":"choice R Version set stone. However, common development environment important establish working across multiple companies multiple developers. currently work earliest three latest R Versions. need common development environment also carries choice package versions. GitHub allows us Actions/Workflows test admiral several versions R well several versions dependent R packages needed admiral. Currently test admiral three latest R Versions closest snapshots packages R versions. can view workflow others admiralci GitHub Repository. common development allows us easily re-create bugs provide solutions issues developers encounter. Reviewers Pull Requests running code know environment identical initiator Pull Request. ensures faster review times higher quality Pull Request reviews. achieve common development environment using lockfile created renv package. New developers encounter suggested renv::restore() console revert move forward R version package versions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"common-r-cmd-check-issues","dir":"Articles","previous_headings":"","what":"Common R CMD Check Issues","title":"R CMD Issues","text":"R CMD check command line tool checks R packages standard set criteria. pull request pass check must issue notes, warnings errors. list common issues resolve .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"check-fails-only-on-one-version","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Check Fails Only on One Version","title":"R CMD Issues","text":"R CMD check workflow fails one two R versions can helpful reproduce testing environment locally. reproduce particular R version environment open admiral project corresponding R version, comment line source(\"renv/activate.R\") .Rprofile file, restart R session run following commands R console. ensure exact package versions use workflow installed hidden folder .library. way existing R packages overwritten.","code":"Sys.setenv(R_REMOTES_NO_ERRORS_FROM_WARNINGS = \"true\")  if (!dir.exists(\".library\")) {   dir.create(\".library\") }  base_recommended_pkgs <- row.names(installed.packages(priority = \"high\")) for (pkg in base_recommended_pkgs) {   path <- file.path(.Library, pkg)   cmd <- sprintf(\"cp -r %s .library\", path)   system(cmd) } assign(\".lib.loc\", \".library\", envir = environment(.libPaths))  r_version <- getRversion() if (grepl(\"^4.1\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2021-05-03/\") } else if (grepl(\"^4.2\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2022-01-03/\") } else if (grepl(\"^4.3\", r_version)) {   options(repos = \"https://packagemanager.posit.co/cran/2023-04-20/\") } else {   options(repos = \"https://cran.rstudio.com\") }  if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") } remotes::install_deps(dependencies = TRUE) remotes::install_github(\"pharmaverse/pharmaversesdtm\", ref = \"devel\") remotes::install_github(\"pharmaverse/admiraldev\", ref = \"devel\") rcmdcheck::rcmdcheck()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"package-dependencies","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Package Dependencies","title":"R CMD Issues","text":"Add pkg Imports Suggests field DESCRIPTION file. general, dependencies listed Imports field. However, package used inside vignettes unit tests listed Suggests admiral functions work without “soft” dependencies installed.","code":"> checking package dependencies ... ERROR   Namespace dependency not required: ‘pkg’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"global-variables","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Global Variables","title":"R CMD Issues","text":"Add some_var list “global” variables R/globals.R.","code":"❯ checking R code for possible problems ... NOTE   function_xyz: no visible binding for global variable ‘some_var’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"undocumented-function-parameter","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Undocumented Function Parameter","title":"R CMD Issues","text":"Add @param some_param section header function_xyz() run devtools::document() afterwards.","code":"❯ checking Rd \\usage sections ... WARNING   Undocumented arguments in documentation object 'function_xyz'     ‘some_param’"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/rcmd_issues.html","id":"outdated-documentation","dir":"Articles","previous_headings":"Common R CMD Check Issues","what":"Outdated Documentation","title":"R CMD Issues","text":"name parameter changed function code yet header. Change @param old_param_name @param new_param_name run devtools::document(). reading recommend R-pkg manual r-cmd chapter","code":"❯ checking for code/documentation mismatches ... WARNING   Codoc mismatches from documentation object 'function_xyz':   ...   Argument names in code not in docs:     new_param_name   Argument names in docs not in code:     old_param_name   Mismatches in argument names:     Position: 6 Code: new_param_name Docs: old_param_name"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Release Strategy","text":"article explains package releases admiral across package extensions. includes details around planned/scheduled releases, well hotfixes.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"release-schedule","dir":"Articles","previous_headings":"","what":"Release Schedule","title":"Release Strategy","text":"release schedule maintained homepage.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"planning-releases","dir":"Articles","previous_headings":"","what":"Planning Releases","title":"Release Strategy","text":"past, whenever started looking towards future release, create new release issue label GitHub form release Q4-2022 prioritize issues. However, backlog minimal every issue considered Priority Issue. issue Priority, sent back Discussion Tab formed Priority issue. share advance users high level summary expected package updates via community meetings, especially anticipated breaking changes.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"package-release-process","dir":"Articles","previous_headings":"","what":"Package Release Process","title":"Release Strategy","text":"following important steps planned release hot fix release described. Depending package may helpful use usethis::use_release_issue() package-specific release_bullets() function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"planned-release","dir":"Articles","previous_headings":"Package Release Process","what":"Planned Release","title":"Release Strategy","text":"package release done following steps: Create release version: Create new feature branch main. Call usethis::use_version() update Versions: field DESCRIPTION file update NEWS.md (replace “(development version)” version released) Create PR main merge . title PR must contain “[skip vbump]”. Otherwise, vbump workflow sets version development version CRAN reject submission. Bundle main (devtools::build(manual = TRUE)) send CRAN. See chapter R Packages details. CRAN asks modifications, repeat steps 1-2 necessary. package accepted available CRAN, use release button GitHub “release” package onto GitHub, select main branch target, use tag form vX.Y.Z, e.g., v1.1.2 (see past admiral releases reference Releasing Github section details). releases onto Github archives version code within main branch, attaches News/Changelog file, bundles code tar.gz file makes validation report via GitHub action validation insightsengineering/validatoR. also builds website released version stores new vx.y.z folder gh-pages branch. Merge main patch prepared case needed hotfix. Create next development version: Create new feature branch main. Call usethis::use_dev_version() update NEWS.md (adds new section # admiral (development version)) update version DESCRIPTION file development version. Create PR main merge .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"hot-fix-release","dir":"Articles","previous_headings":"Package Release Process","what":"Hot Fix Release","title":"Release Strategy","text":"Rarely, may need release hot fix immediately address bug. majority cases, -cycle release can made directly main branch, bug fixes new features released earlier planned, thus avoiding patch branch release. hot fix release done following steps: Identify bugs need fixed hot fix release label “hotfix” label. Branches addressing bugs Pull Requests merged single patch branch main branch, patch branch created recent release package. , run following git commands: git checkout -b patch vX.Y.Z git push -u origin patch need use development versions. .e., first pull request set version DESCRIPTION version released corresponding heading added NEWS.md. naming branch follow naming conventions guide. PRs hot fix merged (patch), bundle patch (devtools::build(manual = TRUE)) send CRAN. See chapter R Packages details. CRAN asks modifications, repeat steps 1-4 necessary. package accepted available CRAN, , use release button GitHub “release” package onto GitHub, select patch branch target, use tag form vX.Y.Z, e.g., v1.1.2 (see past admiral releases reference Releasing Github section details). releases onto Github archives version code within patch branch, attaches News/Changelog file, bundles code tar.gz file makes validation report via GitHub action validation insightsengineering/validatoR. also builds website released version stores new vx.y.z folder gh-pages branch. hot fixes merged main branch additional Pull Request. Merging PR update version DESCRIPTION file development version. Create next development version: Create new feature branch main. Update NEWS.md (add new section # admiral (development version)) Create PR main merge .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"releasing-to-github","dir":"Articles","previous_headings":"","what":"Releasing to Github","title":"Release Strategy","text":"Releases section main repo, select Draft New Release. Proceed creating appropriate release tag header, denoted vX.X.X admiral X.X.X respectively, release:  Copy contents NEWS.md section release, paste release notes section:  upload box says, “Attach binaries dropping selecting ” upload appropriate admiral_X.X.X.tar.gz file available download CRAN website. Click Publish Release ’re done! NB: Occasionally, might need delete tag something done error. Deleting tag can done GitHub must done terminal. However, easy!! Just use: git push --delete origin tagname","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"release-tracking","dir":"Articles","previous_headings":"","what":"Release Tracking","title":"Release Strategy","text":"new package release submitted CRAN awaiting go-live, can track status searching within dashboard.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/release_strategy.html","id":"communications","dir":"Articles","previous_headings":"","what":"Communications","title":"Release Strategy","text":"release, raise awareness via Slack channel LinkedIn.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-become-a-safety-net-for-developers","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Become a Safety Net for Developers","title":"Unit Test Guidance","text":"comprehensive suite unit tests can act safety net developers. frequently running tests, can assure recent modifications code haven’t broken anything. words, unit tests help prevent regressions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-can-contribute-to-higher-code-quality","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Can Contribute to Higher Code Quality","title":"Unit Test Guidance","text":"Since unit tests act safety net, developers become confident changing code. can refactor code without fear breaking things, driving general quality code base .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"unit-tests-can-contribute-to-better-application-architecture","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Unit Tests Can Contribute to Better Application Architecture","title":"Unit Test Guidance","text":"can add unit tests easily code base, ’s usually good sign regarding quality app’s architecture. , drive write testable code can incentive better architecture.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"detects-code-smells-in-your-codebase","dir":"Articles","previous_headings":"Why Write Unit Tests?","what":"Detects Code Smells in your Codebase","title":"Unit Test Guidance","text":"ease adding unit tests code base good sign, opposite also true. hard time creating unit tests given piece code might sign code smells code—e.g. functions complex.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-fast","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Fast","title":"Unit Test Guidance","text":"’re slow, developers won’t run often . defeats whole purpose suite unit tests first place, boost developers’ confidence make changes code. tests can’t work safety net ’re run often.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-simple","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Simple","title":"Unit Test Guidance","text":"several techniques can apply high degree confidence correctness tests. One keep tests low cyclomatic complexity. Cyclomatic complexity code metric indicates number possible execution paths given method can follow. piece code lower complexity easier understand maintain, means developers less likely introduce bugs working . can measure cyclomatic complexity tests (using, instance, linter tool) best keep low.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"test-shouldnt-duplicate-implementation-logic","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Test Shouldn’t Duplicate Implementation Logic","title":"Unit Test Guidance","text":"person wrote test implementation, ’s possible made errors places. Since tests mirror implementation, might still pass, implementation wrong, tests might fool thinking otherwise. Resist urge make tests fancy, keep simple, testing suite better .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-readable","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Tests Should Be Readable","title":"Unit Test Guidance","text":"best practice overlaps little bit one keeping tests simple. tests hard read, developers likely misunderstand introduce bugs. Test cases used form documentation, obviously need readable.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"running-unit-tests-part-of-the-build-process","dir":"Articles","previous_headings":"Writing Good Unit Tests","what":"Running Unit Tests Part of the Build Process","title":"Unit Test Guidance","text":"Automate whole process running unit tests taking action fail. build process execute unit tests mark build broken tests fail.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"plan-your-unit-tests","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Plan your Unit Tests","title":"Unit Test Guidance","text":"Start considering derivation rule testing possible arguments/flexibilities function code. plan scenarios test. can either involve generating different input test cases feeding different calls function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"test-coverage","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Test coverage","title":"Unit Test Guidance","text":"Unit tests cover functionality function. another function g() called within function f(), unit tests f() test functionality g(). tested unit tests g(), .e. unit tests added lowest level.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"tests-should-be-robust-to-cover-realistic-data-scenarios","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Tests Should be Robust to Cover Realistic Data Scenarios","title":"Unit Test Guidance","text":"generating input test cases, can helpful consider regular cases (expected common data scenarios), boundary cases (data points close equal), special cases (uncommon valid data scenarios, e.g. missing special characters). Although never cover every single eventuality possible input data (reliability testing method ever gives 100% certainty), need give confidence code robust enough work across data scenarios.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"testing-should-cover-possible-arguments","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Testing Should Cover Possible Arguments","title":"Unit Test Guidance","text":"different calls function, consider user might apply function test variety possible calls, whilst still remembering tips tests fast simple. needed cases complexity level flexibility function justifies , e.g. see test script: https://github.com/pharmaverse/admiral/blob/main/tests/testthat/test-derive_var_extreme_flag.R.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"exported-functions","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Exported Functions","title":"Unit Test Guidance","text":"Don’t forget add unit test exported function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"snapshot-testing","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Snapshot Testing","title":"Unit Test Guidance","text":"Standard unit tests always convenient record expected behavior code. challenges include: Output large, making painful define reference output, bloating size test file making hard navigate. Text output includes many characters like quotes newlines require special handling string. Binary formats like plots images, difficult describe code: .e. plot looks right, error message useful human, print method uses color effectively. situations, testthat provides alternative mechanism: snapshot tests. Snapshot tests record results separate human readable file records results, including output, messages, warnings, errors. Review {testthat} snapshot vignette details.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"set-up-the-test-script","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Set up the Test Script","title":"Unit Test Guidance","text":"Within tests/testthat folder project, add script naming convention test-<script_containing_function>.R., unit test script can created console also, follows: testing framework used testthat following format : example, testing function called my_new_func contained script all_funcs.R console use: Open newly created file test-all_funcs.R use following format: Note: comparing datasets admiral use function expect_dfs_equal(). input expected output unit tests must follow following rules: Input output simple possible. Values hard-coded whenever possible. values need derived, unit tested functions can used. contrast Programming Strategy documentation function examples, test files include library(pkg_name) calls. dataset needs created testing purposes, done using function tribble() tibble package following command dplyr::tribble(<data >). Furthermore, functions need called, also done using pkg_name::fun()notation. Make sure align columns well. ensures quick code readability. Ensure give meaningful explanation test testthat call, compiled package validation report. name function test ID included title also help traceability. comments ending ---- create entries TOC RStudio.","code":"usethis::use_test(\"<script_containing_function>\") ## Test 1: <Explanation of the test> ---- test_that(\"<function_name> Test 1: <Explanation of the test>\", {      input <- dplyr::tribble(     ~inputvar1, ~inputvar2, ...     <Add Test Data Scenarios>     ...   )    expected_output <- mutate(input, outputvar = c(<Add Expected Outputs>))    expect_dfs_equal(<function name>(input), expected_output)    }) usethis::use_test(\"all_funcs\") # my_new_func ---- ## Test 1: <Explanation of the test> ---- test_that(\"my_new_func Test 1: <Explanation of the test>\", {      input <- dplyr::tribble(     ~inputvar1, ~inputvar2, ...     <Add Test Data Scenarios>     ...   )    expected_output <- mutate(input, outputvar = c(<Add Expected Outputs>))    expect_dfs_equal(<function name>(input), expected_output) })"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"addin-pharmaverse4devsformat_test_that_file","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Addin pharmaverse4devs::format_test_that_file()","title":"Unit Test Guidance","text":"ease burden developers writing adding tests developed Addin formatting test_that test files according admiral programming standards. Addin add update comments well number re-numbers tests. access Addin, sure install {pharmaverse4devs} Github. install latest development version package directly GitHub use following code: use Addin button select “Format test_that test file” seen image. sure test-file open selected calling Addin.  Addin perform following: Updates adds number tests comments test_that() call Updates comments based description provided test_that() call Updates function name test_that() call. function name extracted last # <function name> ---- comment test_that() call. test file tests one function, comments added first test function. test files tests single function , comments can omitted. case addin determines function name file name stripping “test-” prefix “.R” suffix. writing new unit tests, just provide description test_that() call necessary function name # <function name> ---- comment: Call addin get: tested unit test program, can run unit tests console, follows. running just tests current file call","code":"if (!requireNamespace(\"remotes\", quietly = TRUE)) {       install.packages(\"remotes\")     }      remotes::install_github(\"pharmaverse/pharmaverse4devs\") # derive_vars_merged ---- test_that( \"works if it merges all variables\", {   actual <- derive_vars_merged(advs,     dataset_add = adsl,     by_vars = exprs(STUDYID, USUBJID)   )  # convert_dtm_to_dtc ---- test_that(\"works if dtm is in correct format\", {   expect_equal(     convert_dtm_to_dtc(as.POSIXct(\"2022-04-05 15:34:07 UTC\")),     \"2022-04-05T15:34:07\"   ) })  test_that(\"Error is thrown if dtm is not in correct format\", {   expect_error(     convert_dtm_to_dtc(\"2022-04-05T15:26:14\"),     \"lubridate::is.instant(dtm) is not TRUE\",     fixed = TRUE   ) }) # derive_vars_merged ---- ## Test 1: derive_vars_merged ---- test_that( \"derive_vars_merged Test 1: it merges all variables\", {   actual <- derive_vars_merged(advs,     dataset_add = adsl,     by_vars = exprs(STUDYID, USUBJID)   )  # convert_dtm_to_dtc ---- ## Test 2: works if dtm is in correct format ---- test_that(\"convert_dtm_to_dtc Test 2: works if dtm is in correct format\", {   expect_equal(     convert_dtm_to_dtc(as.POSIXct(\"2022-04-05 15:34:07 UTC\")),     \"2022-04-05T15:34:07\"   ) })  ## Test 3: Error is thrown if dtm is not in correct format ---- test_that(\"convert_dtm_to_dtc Test 3: Error is thrown if dtm is not in correct format\", {   expect_error(     convert_dtm_to_dtc(\"2022-04-05T15:26:14\"),     \"lubridate::is.instant(dtm) is not TRUE\",     fixed = TRUE   ) }) devtools::test() devtools::test_file()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/unit_test_guidance.html","id":"automation-of-unit-tests","dir":"Articles","previous_headings":"Writing Unit Tests in {admiral}","what":"Automation of Unit Tests","title":"Unit Test Guidance","text":"user actions pull request {admiral} GitHub repo, unit tests automatically run pull request denied unit tests fail.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Writing Vignettes","text":"guidance ensures consistency across vignettes admiral package terms content, structure code execution. general rule, vignette workflow defined r-pkgs.org followed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"metadata","dir":"Articles","previous_headings":"","what":"Metadata","title":"Writing Vignettes","text":"vignette admiral start following metadata. <Title> vignette meaningful.","code":"--- title: \"<Title>\" output:  rmarkdown::html_vignette: vignette: >   %\\VignetteIndexEntry{<Title>}   %\\VignetteEngine{knitr::rmarkdown} ---"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"default-options","dir":"Articles","previous_headings":"Markdown","what":"Default Options","title":"Writing Vignettes","text":"chunks used within vignette, following options set metadata ensure chunks rendered consistently across vignettes.","code":"```{r setup, include=FALSE} knitr::opts_chunk$set(   collapse = TRUE,   comment = \"#>\" ) ```"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"table-of-contents","dir":"Articles","previous_headings":"Markdown > Format Sections","what":"Table of Contents","title":"Writing Vignettes","text":"Headings must title case start Heading 1: first section gives brief introduction vignette. last sub-section introduction describe packages required run admiral functions. admiral package described first. warning=FALSE message=FALSE options prevent usual messages: Attaching package: ‘xxxx’following objects masked ‘package:yyyyy’ fun1, fun2","code":"# Heading 1 This is the description of my first section.  ## Heading 1.1 This is the description of my first sub-section within my first section.  ## Heading 1.2 This is the description of my second sub-section within my first section. # Introduction  This is the introduction of my vignette.  ## Required Packages ```{r, warning=FALSE, message=FALSE} library(admiral) # <all packages used in the vignette> ```"},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"general-conventions","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"General Conventions","title":"Writing Vignettes","text":"new vignette must added _pkgdown.yml file relevant section. variable name, dataset name, function, argument name must quoted backticks: e.g. Functions must also end (). Variables datasets name expected uppercase. codes must described, executed output result displayed code executed. Use: output created must clearly show function derived. least show variables/records used input function derived variables/records. dataset must displayed, formatted using dataset_vignette() function displayed consistently across vignettes.E.g. Description execution code used derive variable/record Output dataset formatted using dataset_vignette()… Note: call get formatted dataset : Displaying many big datasets vignette, may require long time load page may cause messages browser page responsive. case number displayed observations restricted either restricting source datasets beginning vignette call dataset_vignette() calls affected.","code":"The `date` parameter of the `derive_my_var()` function expects a date variable, e.g., `ADT`. ```{r} #<code> ``` vs1 <- vs %>%   derive_vars_dt(     new_vars_prefix = \"A\",     dtc = VSDTC,     date_imputation = \"first\"   ) ```r   dataset_vignette(     vs1,     display_vars = exprs(USUBJID, VSTESTCD, VISIT, VSDTC, ADT),     filter = VSTESTCD == \"WEIGHT\"   )   ```"},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"using-footnotes","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"Using Footnotes","title":"Writing Vignettes","text":"Footnotes can useful add context without adding clutter primary subject matter vignette written. use footnotes, add caret identifier inside brackets e.g. ([^1]). identifiers can numbers words, can’t contain spaces tabs. following markdown text render follows: example 1","code":"Here is an example [^1]  [^1]: Cool note about the example."},{"path":"https://pharmaverse.github.io/admiraldev/dev/articles/writing_vignettes.html","id":"conventions-for-adam-workflow","dir":"Articles","previous_headings":"Markdown > Format Sections > Conventions","what":"Conventions for ADaM Workflow","title":"Writing Vignettes","text":"vignettes describing ADaM workflow, second section summarize programming workflow. first sub-section within workflow always describe data read demonstrate use admiral functions, sub-section within programming workflow tagged (e.g. [Step1] (#step)), user can go relevant section programming workflow (addition Table contents). Don’t use tag number use meaningful name (e.g. use (#link1), use (#this_action)) last section link template script. ADSL variables ADSL variables required derivation merged SDTM dataset first derivation. ADSL variables added -variables derivations add observations. ensures ADSL variables populated new observations. adsl_vars variable created beginning script added by_vars parameter derivations add observations. ADSL variables final dataset required derivation merged dataset last derivation.","code":"# Programming Workflow  * [Read in Data](#readdata) * [Derive/Impute End and Start Analysis Date/time and Relative Day](#datetime) * ... * [Assign `ASEQ`](#aseq)  ## Read in Data {#readdata} ## Derive/Impute End and Start Analysis Date/time and Relative Day {#datetime} ## ... ## Assign `ASEQ` {#aseq}  # Another Section  # Example Script ADaM | Sample Code ---- | -------------- ADxx | [ad_adxx.R](https://github.com/pharmaverse/admiral/blob/main/inst/templates/ad_adxx.R){target=\"_blank\"}"},{"path":"https://pharmaverse.github.io/admiraldev/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"define authors actively maintaining code base, contributors made significant contribution past. Ben Straub. Author, maintainer. Stefan Bundfuss. Author. Jeffrey Dickinson. Author. Ross Farrugia. Author. Pooja Kumari. Author. Edoardo Mancini. Author. Sadchla Mascary. Author. Zelos Zhu. Author. Ania Golab. Contributor. Samia Kabi. Contributor. Syed Mubasheer. Contributor. Thomas Neitmann. Contributor. Ondrej Slama. Contributor. F. Hoffmann-La Roche AG. Copyright holder, funder. GlaxoSmithKline LLC. Copyright holder, funder.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Straub B, Bundfuss S, Dickinson J, Farrugia R, Kumari P, Mancini E, Mascary S, Zhu Z (2024). admiraldev: Utility Functions Development Tools Admiral Package Family. R package version 1.0.0.9026,  https://github.com/pharmaverse/admiraldev/, https://pharmaverse.github.io/admiraldev/.","code":"@Manual{,   title = {admiraldev: Utility Functions and Development Tools for the Admiral Package Family},   author = {Ben Straub and Stefan Bundfuss and Jeffrey Dickinson and Ross Farrugia and Pooja Kumari and Edoardo Mancini and Sadchla Mascary and Zelos Zhu},   year = {2024},   note = {R package version 1.0.0.9026,  https://github.com/pharmaverse/admiraldev/},   url = {https://pharmaverse.github.io/admiraldev/}, }"},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"admiraldev-","dir":"","previous_headings":"","what":"Utility Functions and Development Tools for the Admiral Package Family","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"Utility Functions Development Tools Admiral Package Family","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"purpose","dir":"","previous_headings":"","what":"Purpose","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"Functions, tools documentation developing core admiral extension package functions. functions admiraldev around testing inputs going functions. also additional quality life functions/Addins assist developers admiral admiral extension packages, functions help rendering documentation, Developer Guides developing function using GitHub, GitHub Actions. NOTE: package intended standalone use rather central dependency admiral extension packages","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"package available CRAN can installed running install.packages(\"admiraldev\"). install latest development version package directly GitHub use following code:","code":"if (!requireNamespace(\"remotes\", quietly = TRUE)) {   install.packages(\"remotes\") }  remotes::install_github(\"pharmaverse/admiraldev\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/index.html","id":"release-schedule","dir":"","previous_headings":"","what":"Release Schedule","title":"Utility Functions and Development Tools for the Admiral Package Family","text":"admiraldev released CRAN time official release admiral. can find release schedule admiral packages .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"Add suffix variables list expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"","code":"add_suffix_to_vars(order, vars, suffix)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"order List expressions Permitted Values: list variables desc(<variable>) function calls created exprs(), e.g., exprs(ADT, desc(AVAL)) vars Variables change Permitted Values: list variables created exprs() suffix Suffix Permitted Values: character scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"list expression element suffix (suffix) added every symbol specified vars","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/add_suffix_to_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a Suffix to Variables in a List of Expressions — add_suffix_to_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  add_suffix_to_vars(exprs(ADT, desc(AVAL), AVALC), vars = exprs(AVAL), suffix = \".join\") #> [[1]] #> ADT #>  #> [[2]] #> desc(AVAL.join) #>  #> [[3]] #> AVALC #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/admiraldev-package.html","id":null,"dir":"Reference","previous_headings":"","what":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","title":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","text":"Utility functions check data, variables conditions functions used 'admiral' 'admiral' extension packages. Additional utility helper functions assist developers maintaining documentation, testing general upkeep 'admiral' 'admiral' extension packages.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/admiraldev-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"admiraldev: Utility Functions and Development Tools for the Admiral Package Family — admiraldev-package","text":"Maintainer: Ben Straub ben.x.straub@gsk.com Authors: Stefan Bundfuss Jeffrey Dickinson Ross Farrugia Pooja Kumari Edoardo Mancini Sadchla Mascary Zelos Zhu contributors: Ania Golab [contributor] Samia Kabi [contributor] Syed Mubasheer [contributor] Thomas Neitmann [contributor] Ondrej Slama [contributor] F. Hoffmann-La Roche AG [copyright holder, funder] GlaxoSmithKline LLC [copyright holder, funder]","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract Argument Name from an Expression — arg_name","title":"Extract Argument Name from an Expression — arg_name","text":"Extract Argument Name Expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract Argument Name from an Expression — arg_name","text":"","code":"arg_name(expr)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract Argument Name from an Expression — arg_name","text":"expr expression created inside function using substitute()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/arg_name.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract Argument Name from an Expression — arg_name","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Atomic Vector? — assert_atomic_vector","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"Checks argument atomic vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"","code":"assert_atomic_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_atomic_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"function throws error arg atomic vector. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_atomic_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Atomic Vector? — assert_atomic_vector","text":"","code":"example_fun <- function(x) {   assert_atomic_vector(x) }  example_fun(1:10)  try(example_fun(list(1, 2))) #> Error in example_fun(list(1, 2)) :  #>   Argument `x` must be an atomic vector, but is a list."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Character Scalar (String)? — assert_character_scalar","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"Checks argument character scalar (optionally) whether matches one provided values.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"","code":"assert_character_scalar(   arg,   values = NULL,   case_sensitive = TRUE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_character_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"arg function argument checked values character vector valid values arg. Values converted lower case vector case_sensitive = FALSE used. case_sensitive argument handled case-sensitive? set FALSE, argument converted lower case checking permitted values returning argument. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"function throws error arg character vector arg character vector length > 1 value one values specified. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Character Scalar (String)? — assert_character_scalar","text":"","code":"example_fun <- function(msg_type) {   assert_character_scalar(msg_type, values = c(\"warning\", \"error\")) }  example_fun(\"warning\")  try(example_fun(\"message\")) #> Error in example_fun(\"message\") :  #>   Argument `msg_type` must be equal to one of \"warning\" or \"error\".  try(example_fun(TRUE)) #> Error in example_fun(TRUE) :  #>   Argument `msg_type` must be a scalar of class <character>, but is #> `TRUE`.  # handling arguments case-insensitive example_fun2 <- function(msg_type) {   msg_type <- assert_character_scalar(     msg_type,     values = c(\"warning\", \"error\"),     case_sensitive = FALSE   )   if (msg_type == \"warning\") {     print(\"A warning was requested.\")   } }  example_fun2(\"Warning\") #> [1] \"A warning was requested.\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Character Vector? — assert_character_vector","title":"Is an Argument a Character Vector? — assert_character_vector","text":"Checks argument character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Character Vector? — assert_character_vector","text":"","code":"assert_character_vector(   arg,   values = NULL,   named = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_character_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Character Vector? — assert_character_vector","text":"arg function argument checked values character vector valid values arg named set TRUE, error issued elements vector named. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Character Vector? — assert_character_vector","text":"function throws error arg character vector element included list valid values. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_character_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Character Vector? — assert_character_vector","text":"","code":"example_fun <- function(chr) {   assert_character_vector(chr) }  example_fun(letters)  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `chr` must be <character>, but is an integer vector.  example_fun2 <- function(chr) {   assert_character_vector(chr, named = TRUE) }  try(example_fun2(c(alpha = \"a\", \"b\", gamma = \"c\"))) #> Error in example_fun2(c(alpha = \"a\", \"b\", gamma = \"c\")) :  #>   All elements of `chr` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Data Frame? — assert_data_frame","title":"Is an Argument a Data Frame? — assert_data_frame","text":"Checks argument data frame (optionally) whether contains set required variables","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Data Frame? — assert_data_frame","text":"","code":"assert_data_frame(   arg,   required_vars = NULL,   check_is_grouped = TRUE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_data_frame\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Data Frame? — assert_data_frame","text":"arg function argument checked required_vars list variables created using exprs() check_is_grouped Throw error dataset grouped? Defaults TRUE. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Data Frame? — assert_data_frame","text":"function throws error arg data frame arg data frame misses variable specified required_vars. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_data_frame.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Data Frame? — assert_data_frame","text":"","code":"library(dplyr) library(rlang) dm <- tribble(   ~STUDYID, ~USUBJID,   \"XYZ\",    \"1\",   \"XYZ\",    \"2\" )  example_fun <- function(dataset) {   assert_data_frame(dataset, required_vars = exprs(STUDYID, USUBJID)) }  example_fun(dm)  try(example_fun(select(dm, -STUDYID))) #> Error in example_fun(select(dm, -STUDYID)) :  #>   Required variable `STUDYID` is missing in `dataset`  try(example_fun(\"Not a dataset\")) #> Error in example_fun(\"Not a dataset\") :  #>   Argument `dataset` must be class <data.frame>, but is a string.  try(example_fun(group_by(dm, USUBJID))) #> Error in example_fun(group_by(dm, USUBJID)) :  #>   Argument `dataset` must not be a grouped dataset, please `ungroup()` it."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":null,"dir":"Reference","previous_headings":"","what":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"Checks variable dataset date datetime variable","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"","code":"assert_date_var(   dataset,   var,   dataset_name = rlang::caller_arg(dataset),   var_name = rlang::caller_arg(var),   message = NULL,   class = \"assert_date_var\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"dataset dataset variable expected var variable check dataset_name name dataset. argument specified, specified name displayed error message. var_name name variable. argument specified, specified name displayed error message. message (string) string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"var_name\" \"dataset_name\", can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"function throws error var date datetime variable dataset returns input invisibly otherwise.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_var.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is a Variable in a Dataset a Date or Datetime Variable? — assert_date_var","text":"","code":"library(lubridate) #>  #> Attaching package: ‘lubridate’ #> The following objects are masked from ‘package:base’: #>  #>     date, intersect, setdiff, union library(dplyr) library(rlang)  example_fun <- function(dataset, var) {   var <- assert_symbol(enexpr(var))   assert_date_var(dataset = dataset, var = !!var) }  my_data <- tribble(   ~USUBJID, ~ADT,   \"1\",      ymd(\"2020-12-06\"),   \"2\",      ymd(\"\") )  example_fun(   dataset = my_data,   var = ADT )  try(example_fun(   dataset = my_data,   var = USUBJID )) #> Error in example_fun(dataset = my_data, var = USUBJID) :  #>   Column \"USUBJID\" in dataset `dataset` must be a date or datetime, but is #> a character vector.  example_fun2 <- function(dataset, var) {   var <- assert_symbol(enexpr(var))   assert_date_var(     dataset = dataset,     var = !!var,     dataset_name = \"your_data\",     var_name = \"your_var\"   ) }  try(example_fun2(   dataset = my_data,   var = USUBJID )) #> Error in example_fun2(dataset = my_data, var = USUBJID) :  #>   Column \"your_var\" in dataset `your_data` must be a date or datetime, but #> is a character vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an object a date or datetime vector? — assert_date_vector","title":"Is an object a date or datetime vector? — assert_date_vector","text":"Check object/vector date datetime variable without needing dataset input","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an object a date or datetime vector? — assert_date_vector","text":"","code":"assert_date_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_date_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an object a date or datetime vector? — assert_date_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL function assert_date_vector exits early throw error. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an object a date or datetime vector? — assert_date_vector","text":"function returns error arg missing, date datetime variable otherwise returns invisible output.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_date_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an object a date or datetime vector? — assert_date_vector","text":"","code":"example_fun <- function(arg) {   assert_date_vector(arg) }  example_fun(   as.Date(\"2022-01-30\", tz = \"UTC\") ) try(example_fun(\"1993-07-14\")) #> Error in example_fun(\"1993-07-14\") :  #>   Argument `arg` must be a date or datetime, but is a string."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is an Expression — assert_expr","title":"Assert Argument is an Expression — assert_expr","text":"Assert Argument Expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is an Expression — assert_expr","text":"","code":"assert_expr(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_expr\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is an Expression — assert_expr","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is an Expression — assert_expr","text":"function throws error arg expression, .e. either symbol call, returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Expressions? — assert_expr_list","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"Checks argument list expressions.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"","code":"assert_expr_list(   arg,   required_elements = NULL,   named = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_expr_list\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"arg function argument checked required_elements character vector names must present arg named set TRUE, error issued elements list named. optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"function throws error arg list expressions. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_expr_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Expressions? — assert_expr_list","text":"","code":"library(rlang)  example_fun <- function(vars) {   assert_expr_list(vars) } example_fun(exprs(DTHDOM = \"AE\", DTHSEQ = AESEQ))  try(example_fun(exprs(\"AE\", DTSEQ = AESEQ, !!list(\"a\"), !!list(\"a\")))) #> Error in example_fun(exprs(\"AE\", DTSEQ = AESEQ, !!list(\"a\"), !!list(\"a\"))) :  #>   All elements of `vars` must be an expression. #> ℹ `vars[[3]]` = `list(\"a\")` is of type <list>, and `vars[[4]]` = `list(\"a\")` is #>   of type <list>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Filter Condition? — assert_filter_cond","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Argument Filter Condition?","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"","code":"assert_filter_cond(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_filter_cond\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"arg Quosure - filtering condition. optional Logical - argument optional? Defaults FALSE. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Performs necessary checks returns arg pass. Otherwise throws informative error.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"Check arg suitable filtering condition used functions like subset dplyr::filter.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_filter_cond.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Filter Condition? — assert_filter_cond","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang) dm <- dplyr::tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID, ~AGE,   \"DM\",    \"STUDY X\", \"01-701-1015\",   64,   \"DM\",    \"STUDY X\", \"01-701-1016\",   65, )  # typical usage in a function as an argument check example_fun <- function(dat, x) {   x <- assert_filter_cond(enexpr(x), arg_name = \"x\")   filter(dat, !!x) }  example_fun(dm, AGE == 64) #> # A tibble: 1 × 4 #>   DOMAIN STUDYID USUBJID       AGE #>   <chr>  <chr>   <chr>       <dbl> #> 1 DM     STUDY X 01-701-1015    64  try(assert_filter_cond(mtcars)) #> Error in eval(expr, envir, enclos) :  #>   Argument `mtcars` must be a filter condition, but is a data frame"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":null,"dir":"Reference","previous_headings":"","what":"Is Argument a Function? — assert_function","title":"Is Argument a Function? — assert_function","text":"Checks argument function expected arguments provided function.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is Argument a Function? — assert_function","text":"","code":"assert_function(   arg,   params = NULL,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_function\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is Argument a Function? — assert_function","text":"arg function function checked params character vector character vector expected argument names aforementioned function arg. ellipsis, ..., included function formals function arg, argument, params ignored, accepting values character vector. optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is Argument a Function? — assert_function","text":"function throws error argument function function provide arguments specified params argument (assuming ellipsis function formals)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is Argument a Function? — assert_function","text":"","code":"example_fun <- function(fun) {   assert_function(fun, params = c(\"x\")) }  example_fun(mean)  try(example_fun(1)) #> Error in example_fun(1) :  #>   Argument `fun` must be a function, but is a number.  try(example_fun(sum)) #> Error in example_fun(sum) :  #>   \"x\" is not an argument of the function specified for `fun`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Parameter of a Function — assert_function_param","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"function deprecated, please use assert_function() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"","code":"assert_function_param(arg, params)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"arg name function passed string params character vector function parameters","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_function_param.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Parameter of a Function — assert_function_param","text":"function throws error elements params argument function given arg","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":null,"dir":"Reference","previous_headings":"","what":"Does a Dataset Contain All Required Variables? — assert_has_variables","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"function deprecated, please use assert_data_frame() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"","code":"assert_has_variables(dataset, required_vars)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"dataset data.frame required_vars character vector variable names","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"function throws error required variables missing input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_has_variables.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Does a Dataset Contain All Required Variables? — assert_has_variables","text":"Checks dataset contains required variables","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Integer Scalar? — assert_integer_scalar","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"Checks argument integer scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"","code":"assert_integer_scalar(   arg,   subset = \"none\",   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_integer_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"arg function argument checked subset subset integers arg part . one \"none\" (default), \"positive\", \"non-negative\" \"negative\". optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"function throws error arg integer belonging specified subset. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_integer_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Integer Scalar? — assert_integer_scalar","text":"","code":"example_fun <- function(num1, num2) {   assert_integer_scalar(num1, subset = \"positive\")   assert_integer_scalar(num2, subset = \"negative\") }  example_fun(1, -9)  try(example_fun(1.5, -9)) #> Error in example_fun(1.5, -9) :  #>   Argument `num1` must be a positive integer scalar.  try(example_fun(2, 0)) #> Error in example_fun(2, 0) :  #>   Argument `num2` must be a negative integer scalar.  try(example_fun(\"2\", 0)) #> Error in example_fun(\"2\", 0) :  #>   Argument `num1` must be a positive integer scalar."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"Checks elements list named lists/classes fulfill certain condition. , error issued elements list fulfilling condition listed.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"","code":"assert_list_element(   list,   element,   condition,   message_text,   arg_name = rlang::caller_arg(list),   message = NULL,   class = \"assert_list_element\",   call = parent.frame(),   ... )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"list list checked list named lists classes expected. element name element lists/classes character scalar expected. condition Condition fulfilled condition evaluated element list. element lists/classes can referred name, e.g., censor == 0 check censor field class. message_text Text displayed error message listing values meet condition. text describe condition fulfilled, e.g., \"Error {arg_name}: censor values must zero.\". message argument specified, text displayed message_text ignored. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages. ... Objects required evaluate condition condition contains objects apart element, passed function. See second example .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_element.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Element of a List of Lists/Classes Fulfilling a Condition? — assert_list_element","text":"error condition met. input otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"Checks argument list objects inheriting S3 class type specified.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"","code":"assert_list_of(   arg,   cls,   named = FALSE,   optional = TRUE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_list_of\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"arg function argument checked cls S3 class type check named set TRUE, error issued elements list named. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"function throws error arg list arg list elements objects inheriting class type class. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_list_of.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Objects of a Specific S3 Class or Type? — assert_list_of","text":"","code":"example_fun <- function(list) {   assert_list_of(list, \"data.frame\") }  example_fun(list(mtcars, iris))  try(example_fun(list(letters, 1:10))) #> Error in example_fun(list(letters, 1:10)) :  #>   Each element of the list in argument `list` must be class/type #> <data.frame>. #> ℹ But, element 1 is a character vector, and element 2 is an integer vector  try(example_fun(c(TRUE, FALSE))) #> Error in example_fun(c(TRUE, FALSE)) :  #>   Argument `list` must be class <list>, but is a logical vector.  example_fun2 <- function(list) {   assert_list_of(list, \"numeric\", named = TRUE) } try(example_fun2(list(1, 2, 3, d = 4))) #> Error in example_fun2(list(1, 2, 3, d = 4)) :  #>   All elements of `list` argument must be named. #> ℹ The indices of the unnamed elements are 1, 2, and 3"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"Checks argument logical scalar","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"","code":"assert_logical_scalar(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_logical_scalar\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown. Otherwise, NULL considered valid value. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"function throws error arg neither TRUE FALSE. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_logical_scalar.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Logical Scalar (Boolean)? — assert_logical_scalar","text":"","code":"example_fun <- function(flag) {   assert_logical_scalar(flag) }  example_fun(FALSE)  try(example_fun(NA)) #> Error in example_fun(NA) :  #>   Argument `flag` must be either TRUE or FALSE, but is `NA`.  try(example_fun(c(TRUE, FALSE, FALSE))) #> Error in example_fun(c(TRUE, FALSE, FALSE)) :  #>   Argument `flag` must be either TRUE or FALSE, but is a logical vector.  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `flag` must be either TRUE or FALSE, but is an integer vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Named List or Vector — assert_named","title":"Assert Argument is a Named List or Vector — assert_named","text":"Assert elements argument named.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Named List or Vector — assert_named","text":"","code":"assert_named(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_named\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Named List or Vector — assert_named","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Named List or Vector — assert_named","text":"function throws error arg named list vector returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assert Argument is a Named List or Vector — assert_named","text":"","code":"example_fun <- function(varval_list) {   assert_named(varval_list) }  example_fun(list(var1 = 1, var2 = \"x\"))  try(example_fun(list(1, \"x\"))) #> Error in example_fun(list(1, \"x\")) :  #>   All elements of `varval_list` argument must be named. #> ℹ The indices of the unnamed elements are 1 and 2  try(example_fun(list(var = 1, \"x\"))) #> Error in example_fun(list(var = 1, \"x\")) :  #>   All elements of `varval_list` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":null,"dir":"Reference","previous_headings":"","what":"Assert Argument is a Named List of Expressions — assert_named_exprs","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"function deprecated, please use assert_expr_list() instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"","code":"assert_named_exprs(arg, optional = FALSE)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_named_exprs.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assert Argument is a Named List of Expressions — assert_named_exprs","text":"function throws error arg named list expression returns input invisibly otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Numeric Vector? — assert_numeric_vector","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"Checks argument numeric vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"","code":"assert_numeric_vector(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_numeric_vector\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"arg function argument checked optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"function throws error arg numeric vector. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_numeric_vector.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Numeric Vector? — assert_numeric_vector","text":"","code":"example_fun <- function(num) {   assert_numeric_vector(num) }  example_fun(1:10)  try(example_fun(letters)) #> Error in example_fun(letters) :  #>   Argument `num` must be a numeric vector, but it is a character vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":null,"dir":"Reference","previous_headings":"","what":"Is There a One to One Mapping between Variables? — assert_one_to_one","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"Checks one one mapping two lists variables.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"","code":"assert_one_to_one(   dataset,   vars1,   vars2,   dataset_name = rlang::caller_arg(dataset),   message = NULL,   class = \"assert_one_to_one\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"dataset Dataset checked variables specified vars1 vars2 expected. vars1 First list variables vars2 Second list variables dataset_name string indicating label/symbol object checked. Default rlang::caller_arg(dataset). message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"dataset_name\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"error condition meet. input otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_one_to_one.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is There a One to One Mapping between Variables? — assert_one_to_one","text":"","code":"library(dplyr) library(rlang)  df <- tribble(   ~SPECIES, ~SPECIESN,   \"DOG\",           1L,   \"CAT\",           2L,   \"DOG\",           1L )  assert_one_to_one(df, vars1 = exprs(SPECIES), vars2 = exprs(SPECIESN))  df_many <- tribble(   ~SPECIES, ~SPECIESN,   \"DOG\",           1L,   \"CAT\",           2L,   \"DOG\",           3L )  try(   assert_one_to_one(df_many, vars1 = exprs(SPECIES), vars2 = exprs(SPECIESN)) ) #> Error in eval(expr, envir, enclos) :  #>   For some values of \"SPECIES\" there is more than one value of \"SPECIESN\" #> ℹ Call `admiral::get_one_to_many_dataset()` to get all one-to-many values.  try(   assert_one_to_one(df_many, vars1 = exprs(SPECIESN), vars2 = exprs(SPECIES)) ) #> Error in eval(expr, envir, enclos) :  #>   There is more than one value of \"SPECIESN\" for some values of \"SPECIES\" #> ℹ Call `admiral::get_many_to_one_dataset()` to get all many-to-one values."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"Checks parameter (PARAMCD) exist dataset.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"","code":"assert_param_does_not_exist(   dataset,   param,   arg_name = rlang::caller_arg(dataset),   message = NULL,   class = \"assert_param_does_not_exist\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"dataset data.frame param Parameter code check arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"function throws error parameter exists input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_param_does_not_exist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Asserts That a Parameter Does Not Exist in the Dataset — assert_param_does_not_exist","text":"","code":"library(dplyr)  advs <- tribble(   ~USUBJID, ~VSTESTCD, ~VSTRESN, ~VSSTRESU, ~PARAMCD, ~AVAL,   \"P01\",    \"WEIGHT\",      80.1, \"kg\",      \"WEIGHT\",  80.1,   \"P02\",    \"WEIGHT\",      85.7, \"kg\",      \"WEIGHT\",  85.7 ) assert_param_does_not_exist(advs, param = \"HR\") try(assert_param_does_not_exist(advs, param = \"WEIGHT\")) #> Error in eval(expr, envir, enclos) :  #>   The parameter code \"WEIGHT\" already exists in dataset `advs`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"Checks argument object inheriting S3 class specified.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"","code":"assert_s3_class(   arg,   cls,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_s3_class\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"arg function argument checked cls S3 class check optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"function throws error arg object inherit class. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_s3_class.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument an Object of a Specific S3 Class? — assert_s3_class","text":"","code":"example_fun <- function(obj) {   assert_s3_class(obj, \"factor\") }  example_fun(as.factor(letters))  try(example_fun(letters)) #> Error in example_fun(letters) :  #>   Argument `obj` must be class <factor>, but is a character vector.  try(example_fun(1:10)) #> Error in example_fun(1:10) :  #>   Argument `obj` must be class <factor>, but is an integer vector."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":null,"dir":"Reference","previous_headings":"","what":"Are All Argument of the Same Type? — assert_same_type","title":"Are All Argument of the Same Type? — assert_same_type","text":"Checks arguments type.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Are All Argument of the Same Type? — assert_same_type","text":"","code":"assert_same_type(   ...,   .message = c(\"Arguments {.arg {arg_names}} must be the same type.\", i =     paste(\"Argument types are\", paste0(\"{.arg \", arg_names, \"} {.cls \", types, \"}\",     collapse = \", \"))),   .class = \"assert_same_type\",   .call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Are All Argument of the Same Type? — assert_same_type","text":"... Arguments checked .message character vector passed cli_abort(message) assertion fails. .class character vector passed cli_abort(class) assertion fails. .call environment passed cli_abort(call) assertion fails.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Are All Argument of the Same Type? — assert_same_type","text":"function throws error arguments type.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_same_type.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Are All Argument of the Same Type? — assert_same_type","text":"","code":"example_fun <- function(true_value, false_value, missing_value) {   assert_same_type(true_value, false_value, missing_value) }  example_fun(   true_value = \"Y\",   false_value = \"N\",   missing_value = NA_character_ )  try(example_fun(   true_value = 1,   false_value = 0,   missing_value = \"missing\" )) #> Error in example_fun(true_value = 1, false_value = 0, missing_value = \"missing\") :  #>   Arguments `true_value`, `false_value`, and `missing_value` must be the #> same type. #> ℹ Argument types are `true_value` <double>, `false_value` <double>, #>   `missing_value` <character>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Symbol? — assert_symbol","title":"Is an Argument a Symbol? — assert_symbol","text":"Checks argument symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Symbol? — assert_symbol","text":"","code":"assert_symbol(   arg,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_symbol\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Symbol? — assert_symbol","text":"arg function argument checked. Must symbol. See examples. optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Symbol? — assert_symbol","text":"function throws error arg symbol returns input invisibly otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_symbol.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Symbol? — assert_symbol","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang) dm <- dplyr::tribble(   ~DOMAIN,      ~USUBJID,   \"DM\",    \"01-701-1015\",   \"DM\",    \"01-701-1016\", ) example_fun <- function(dat, var) {   var <- assert_symbol(enexpr(var))   select(dat, !!var) }  example_fun(dm, USUBJID) #> # A tibble: 2 × 1 #>   USUBJID     #>   <chr>       #> 1 01-701-1015 #> 2 01-701-1016  try(example_fun(dm)) #> Error in example_fun(dm) :  #>   Argument `enexpr(var)` must be a <symbol>, but is missing.  try(example_fun(dm, \"USUBJID\")) #> Error in example_fun(dm, \"USUBJID\") :  #>   Argument `enexpr(var)` must be a <symbol>, but is a string.  try(example_fun(dm, toupper(PARAMCD))) #> Error in example_fun(dm, toupper(PARAMCD)) :  #>   Argument `enexpr(var)` must be a <symbol>, but is a call."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":null,"dir":"Reference","previous_headings":"","what":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"Checks parameter (PARAMCD) dataset provided expected unit.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"","code":"assert_unit(   dataset,   param,   required_unit,   get_unit_expr,   arg_name = rlang::caller_arg(required_unit),   message = NULL,   class = \"assert_unit\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"dataset data.frame param Parameter code parameter check required_unit Expected unit get_unit_expr Expression used provide unit param arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"function throws error unit variable differs unit observation parameter input dataset. Otherwise, dataset returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_unit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Asserts That a Parameter is Provided in the Expected Unit — assert_unit","text":"","code":"library(dplyr)  advs <- tribble(   ~USUBJID, ~VSTESTCD, ~VSTRESN, ~VSSTRESU, ~PARAMCD, ~AVAL,   \"P01\",    \"WEIGHT\",      80.1, \"kg\",      \"WEIGHT\",  80.1,   \"P02\",    \"WEIGHT\",      85.7, \"kg\",      \"WEIGHT\",  85.7 )  assert_unit(advs, param = \"WEIGHT\", required_unit = \"kg\", get_unit_expr = VSSTRESU)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a List of Variables? — assert_vars","title":"Is an Argument a List of Variables? — assert_vars","text":"Checks argument valid list symbols (e.g., created exprs())","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a List of Variables? — assert_vars","text":"","code":"assert_vars(   arg,   expect_names = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_vars\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a List of Variables? — assert_vars","text":"arg function argument checked expect_names argument set TRUE, checked variables named, e.g., exprs(APERSDT = APxxSDT, APEREDT = APxxEDT). optional checked argument optional? set FALSE arg NULL error thrown arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a List of Variables? — assert_vars","text":"function throws error arg list symbols (e.g., created exprs() returns input invisibly otherwise.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a List of Variables? — assert_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  example_fun <- function(by_vars) {   assert_vars(by_vars) }  example_fun(exprs(USUBJID, PARAMCD))  try(example_fun(quos(USUBJID, PARAMCD))) #> Error in example_fun(quos(USUBJID, PARAMCD)) :  #>   Each element of the list in argument `by_vars` must be class/type #> <symbol>. #> ℹ But, element 1 is a <quosure> object, and element 2 is a <quosure> object  try(example_fun(c(\"USUBJID\", \"PARAMCD\", \"VISIT\"))) #> Error in example_fun(c(\"USUBJID\", \"PARAMCD\", \"VISIT\")) :  #>   Argument `by_vars` must be class <list>, but is a character vector.  try(example_fun(exprs(USUBJID, toupper(PARAMCD), desc(AVAL)))) #> Error in example_fun(exprs(USUBJID, toupper(PARAMCD), desc(AVAL))) :  #>   Each element of the list in argument `by_vars` must be class/type #> <symbol>. #> ℹ But, element 2 is a call, and element 3 is a call  example_fun_name <- function(by_vars) {   assert_vars(by_vars, expect_names = TRUE) }  example_fun_name(exprs(APERSDT = APxxSDT, APEREDT = APxxEDT))  try(example_fun_name(exprs(APERSDT = APxxSDT, APxxEDT))) #> Error in example_fun_name(exprs(APERSDT = APxxSDT, APxxEDT)) :  #>   All elements of `by_vars` argument must be named. #> ℹ The indices of the unnamed elements are 2"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Is an Argument a Variable-Value List? — assert_varval_list","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"Checks argument list expressions expressions variable-value pairs. value can symbol, string, numeric, expression, NA.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"","code":"assert_varval_list(   arg,   required_elements = NULL,   accept_expr = TRUE,   accept_var = FALSE,   optional = FALSE,   arg_name = rlang::caller_arg(arg),   message = NULL,   class = \"assert_varval_list\",   call = parent.frame() )"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"arg function argument checked required_elements character vector names must present arg accept_expr expressions right hand side accepted? accept_var unnamed variable names (e.g. exprs(USUBJID)) right hand side accepted? optional checked argument optional? set FALSE arg NULL error thrown. arg_name string indicating label/symbol object checked. message string passed cli::cli_abort(message). NULL, default messaging used (see examples default messages). \"{arg_name}\" can used messaging. class Subclass condition. call execution environment currently running function, e.g. call = caller_env(). corresponding function call retrieved mentioned error messages source error. need supply call throwing condition helper function relevant mention message. Can also NULL defused function call respectively display call hard-code code display. information error calls, see Including function calls error messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"function throws error arg list variable-value expressions. Otherwise, input returned invisibly.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/assert_varval_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Is an Argument a Variable-Value List? — assert_varval_list","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  example_fun <- function(vars) {   assert_varval_list(vars) } example_fun(exprs(DTHDOM = \"AE\", DTHSEQ = AESEQ))  try(example_fun(exprs(\"AE\", DTSEQ = AESEQ))) #> Error in example_fun(exprs(\"AE\", DTSEQ = AESEQ)) :  #>   Argument `vars` must be a named list of expressions where each element #> is a symbol, character scalar, numeric scalar, an expression, or NA, but is a #> list. #> ℹ To create a list of expressions use `exprs()`."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Backquotes — backquote","title":"Wrap a String in Backquotes — backquote","text":"Wrap String Backquotes","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Backquotes — backquote","text":"","code":"backquote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Backquotes — backquote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/backquote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Backquotes — backquote","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"check argument contains valid variable(s) created exprs() Source Variables List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"","code":"contains_vars(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"arg function argument checked","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/contains_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"check that argument contains valid variable(s) created with exprs() or Source Variables from a List of Expressions — contains_vars","text":"TRUE variables valid variable","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"Helper Function Convert Date (Date-time) Objects Characters dtc Format (-DTC type variable)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"","code":"convert_dtm_to_dtc(dtm)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"dtm date date-time","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/convert_dtm_to_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Helper Function to Convert Date (or Date-time) Objects to Characters of dtc Format (-DTC type of variable) — convert_dtm_to_dtc","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":null,"dir":"Reference","previous_headings":"","what":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"Output dataset vignette pre-specified admiral format.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"","code":"dataset_vignette(dataset, display_vars = NULL, filter = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"dataset Dataset output vignette display_vars Variables selected demonstrate outcome derivation Permitted Values: list variables Default NULL display_vars NULL, selected variables visible vignette variables hidden. can made visible clicking theChoose columns display button. filter Filter condition specified condition applied dataset displayed. Permitted Values: condition","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dataset_vignette.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Output a Dataset in a Vignette in the admiral Format — dataset_vignette","text":"HTML table","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Double Quotes — dquote","title":"Wrap a String in Double Quotes — dquote","text":"Wrap string double quotes, e.g., displaying character values messages.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Double Quotes — dquote","text":"","code":"dquote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Double Quotes — dquote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/dquote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Double Quotes — dquote","text":"input NULL, text \"NULL\" returned. Otherwise, input double quotes returned.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":null,"dir":"Reference","previous_headings":"","what":"Enumerate Multiple Elements — enumerate","title":"Enumerate Multiple Elements — enumerate","text":"Enumerate multiple elements vector list.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Enumerate Multiple Elements — enumerate","text":"","code":"enumerate(x, quote_fun = backquote, conjunction = \"and\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Enumerate Multiple Elements — enumerate","text":"x vector list quote_fun Quoting function, defaults backquote. set NULL, elements quoted. conjunction Character used message, defaults \"\".","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Enumerate Multiple Elements — enumerate","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/enumerate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Enumerate Multiple Elements — enumerate","text":"","code":"enumerate(c(\"one\", \"two\", \"three\")) #> Warning: `enumerate()` was deprecated in admiraldev 1.1.0. #> ℹ This function was primarily used in error messaging, and can be replaced with #>   'cli' functionality: `cli::cli_abort('{.val {letters[1:3]}}')` #> [1] \"`one`, `two` and `three`\"  enumerate(c(1, 2, 3), quote_fun = NULL) #> [1] \"1, 2 and 3\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":null,"dir":"Reference","previous_headings":"","what":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"Uses diffdf::diffdf() compares 2 datasets differences. function can thought R-equivalent SAS proc compare useful tool unit testing well.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"","code":"expect_dfs_equal(base, compare, keys, ...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"base Input dataset compare Comparison dataset keys character vector variables define unique row base compare datasets ... Additional arguments passed onto diffdf::diffdf()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"error base compare match NULL invisibly ","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expect_dfs_equal.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Expectation: Are Two Datasets Equal? — expect_dfs_equal","text":"","code":"library(dplyr, warn.conflicts = FALSE)  tbl1 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1001\", 18, \"M\",   \"1002\", 19, \"F\",   \"1003\", 20, \"M\",   \"1004\", 18, \"F\" )  tbl2 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1001\", 18, \"M\",   \"1002\", 18.9, \"F\",   \"1003\", 20, NA )  try(expect_dfs_equal(tbl1, tbl2, keys = \"USUBJID\")) #> Error : Differences found between the objects! #>  #> A summary is given below. #>  #> There are rows in BASE that are not in COMPARE !! #> All rows are shown in table below #>  #>   ========= #>    USUBJID  #>   --------- #>     1004    #>   --------- #>  #> Not all Values Compared Equal #> All rows are shown in table below #>  #>   ============================= #>    Variable  No of Differences  #>   ----------------------------- #>      AGE             1          #>      SEX             1          #>   ----------------------------- #>  #>  #> All rows are shown in table below #>  #>   ================================== #>    VARIABLE  USUBJID  BASE  COMPARE  #>   ---------------------------------- #>      AGE      1002     19    18.9    #>   ---------------------------------- #>  #>  #> All rows are shown in table below #>  #>   ================================== #>    VARIABLE  USUBJID  BASE  COMPARE  #>   ---------------------------------- #>      SEX      1003     M     <NA>    #>   ---------------------------------- #>   tlb3 <- tribble(   ~USUBJID, ~AGE, ~SEX,   \"1004\", 18, \"F\",   \"1003\", 20, \"M\",   \"1002\", 19, \"F\",   \"1001\", 18, \"M\", )  # Note the sorting order of the keys is not required expect_dfs_equal(tbl1, tlb3, keys = \"USUBJID\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":null,"dir":"Reference","previous_headings":"","what":"Concatenate One or More Expressions — expr_c","title":"Concatenate One or More Expressions — expr_c","text":"Concatenate One Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Concatenate One or More Expressions — expr_c","text":"","code":"expr_c(...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Concatenate One or More Expressions — expr_c","text":"... One expressions list expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/expr_c.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Concatenate One or More Expressions — expr_c","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract All Symbols from a List of Expressions — extract_vars","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"Extract Symbols List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"","code":"extract_vars(x, side = \"lhs\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"x R object side One \"lhs\" (default) \"rhs\" formulas","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/extract_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract All Symbols from a List of Expressions — extract_vars","text":"","code":"library(rlang) extract_vars(exprs(PARAMCD, (BASE - AVAL) / BASE + 100)) #> [[1]] #> PARAMCD #>  #> [[2]] #> BASE #>  #> [[3]] #> AVAL #>  extract_vars(AVAL ~ ARMCD + AGEGR1) #> [[1]] #> AVAL #>  extract_vars(AVAL ~ ARMCD + AGEGR1, side = \"rhs\") #> [[1]] #> ARMCD #>  #> [[2]] #> AGEGR1 #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":null,"dir":"Reference","previous_headings":"","what":"Optional Filter — filter_if","title":"Optional Filter — filter_if","text":"Filters input dataset provided expression NULL","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Optional Filter — filter_if","text":"","code":"filter_if(dataset, filter)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Optional Filter — filter_if","text":"dataset Input dataset filter filter condition. Must expression.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/filter_if.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Optional Filter — filter_if","text":"data.frame containing rows dataset matching filter just dataset filter NULL","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":null,"dir":"Reference","previous_headings":"","what":"Return English-friendly messaging for object-types — friendly_type_of","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"Return English-friendly messaging object-types","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"","code":"friendly_type_of(x, value = TRUE, length = FALSE)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"x R object. value Whether describe value x. length Whether mention length vectors lists.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"string describing type. Starts indefinite article, e.g. \"integer vector\".","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/friendly_type_of.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return English-friendly messaging for object-types — friendly_type_of","text":"helper function aids us forming user-friendly messages gets called what_is_it(), often used assertion functions identify object-type user passed argument instead expected-type.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Constant Variables — get_constant_vars","title":"Get Constant Variables — get_constant_vars","text":"Get Constant Variables","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Constant Variables — get_constant_vars","text":"","code":"get_constant_vars(dataset, by_vars, ignore_vars = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Constant Variables — get_constant_vars","text":"dataset data frame. by_vars variables groups defined variables considered separately. .e., variable constant within group, returned. ignore_vars Variables ignore specified variables considered, .e., returned even constant (unless included variables). Permitted Values: list variable names selector function calls like starts_with(\"EX\")","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_constant_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Constant Variables — get_constant_vars","text":"Variable vector.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"Retrieve Dataset admiraldev_environment environment","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"","code":"get_dataset(name)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"name name dataset retrieve","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"data.frame","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_dataset.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Retrieve a Dataset from the admiraldev_environment environment — get_dataset","text":"Sometimes, developers may want provide information users fit warning error message. example, input dataset function contains unexpected records, can stored separate dataset, users can access investigate issue. achieve , R data structure known 'environment'. environment objects created build time, can populated values package loaded update values course R session. , establishment admiraldev_environment allows us create dynamic data/objects based user-inputs need modification. purpose get_dataset retrieve datasets contained inside admiraldev_environment. Currently support two datasets inside admiraldev_environment object: one_to_many many_to_one","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Duplicates From a Vector — get_duplicates","title":"Get Duplicates From a Vector — get_duplicates","text":"Get Duplicates Vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Duplicates From a Vector — get_duplicates","text":"","code":"get_duplicates(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Duplicates From a Vector — get_duplicates","text":"x atomic vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Duplicates From a Vector — get_duplicates","text":"vector type x contain duplicate values","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_duplicates.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get Duplicates From a Vector — get_duplicates","text":"","code":"get_duplicates(1:10) #> integer(0)  get_duplicates(c(\"a\", \"a\", \"b\", \"c\", \"d\", \"d\")) #> [1] \"a\" \"d\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"Get New Temporary Variable Name Dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"","code":"get_new_tmp_var(dataset, prefix = \"tmp_var\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"dataset input dataset prefix prefix new temporary variable name create","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"name new temporary variable symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"function returns new unique temporary variable name used inside dataset. temporary variable names structure prefix_n n integer, e.g. tmp_var_1. already variable inside datset given prefix suffix increased 1, e.g. tmp_var_1 already exists get_new_tmp_var() return tmp_var_2.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_new_tmp_var.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Get a New Temporary Variable Name for a Dataset — get_new_tmp_var","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID,   \"DM\",    \"STUDY X\", \"01-701-1015\",   \"DM\",    \"STUDY X\", \"01-701-1016\", )  tmp_var <- get_new_tmp_var(dm) mutate(dm, !!tmp_var := NA) #> # A tibble: 2 × 4 #>   DOMAIN STUDYID USUBJID     tmp_var_1 #>   <chr>  <chr>   <chr>       <lgl>     #> 1 DM     STUDY X 01-701-1015 NA        #> 2 DM     STUDY X 01-701-1016 NA"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Get Source Variables from a List of Expressions — get_source_vars","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"Get Source Variables List Expressions","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"","code":"get_source_vars(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"expressions list expressions quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/get_source_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get Source Variables from a List of Expressions — get_source_vars","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":null,"dir":"Reference","previous_headings":"","what":"Negated Value Matching — %notin%","title":"Negated Value Matching — %notin%","text":"Returns logical vector indicating match left operand right operand.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Negated Value Matching — %notin%","text":"","code":"x %notin% table"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Negated Value Matching — %notin%","text":"x values matched table values matched ","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-notin-grapes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Negated Value Matching — %notin%","text":"logical vector","code":""},{"path":[]},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Or — %or%","text":"","code":"lhs %or% rhs"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Or — %or%","text":"lhs valid R expression rhs valid R expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Or — %or%","text":"Either result evaluating lhs, rhs error","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/grapes-or-grapes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Or — %or%","text":"function evaluates expression lhs expression results error, catches error proceeds evaluating expression rhs returns result.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":null,"dir":"Reference","previous_headings":"","what":"Checks if the argument equals the auto keyword — is_auto","title":"Checks if the argument equals the auto keyword — is_auto","text":"Checks argument equals auto keyword","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Checks if the argument equals the auto keyword — is_auto","text":"","code":"is_auto(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Checks if the argument equals the auto keyword — is_auto","text":"arg argument check","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_auto.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Checks if the argument equals the auto keyword — is_auto","text":"TRUE argument equals auto keyword, .e., expression symbol named auto.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Is order vars? — is_order_vars","title":"Is order vars? — is_order_vars","text":"Check inputs created using exprs() calls involving desc()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is order vars? — is_order_vars","text":"","code":"is_order_vars(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is order vars? — is_order_vars","text":"arg R object","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_order_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is order vars? — is_order_vars","text":"FALSE argument list order vars","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Is this string a valid DTC — is_valid_dtc","title":"Is this string a valid DTC — is_valid_dtc","text":"string valid DTC","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Is this string a valid DTC — is_valid_dtc","text":"","code":"is_valid_dtc(arg)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Is this string a valid DTC — is_valid_dtc","text":"arg character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/is_valid_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Is this string a valid DTC — is_valid_dtc","text":"TRUE argument valid --DTC string, FALSE otherwise","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":null,"dir":"Reference","previous_headings":"","what":"Join Functions — anti_join","title":"Join Functions — anti_join","text":"*_join() functions {dplyr} without warning different attributes datasets.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Join Functions — anti_join","text":"","code":"anti_join(x, y, by = NULL, copy = FALSE, ...)  inner_join(x, y, by = NULL, copy = FALSE, suffix = c(\".x\", \".y\"), ...)  left_join(x, y, by = NULL, copy = FALSE, suffix = c(\".x\", \".y\"), ...)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Join Functions — anti_join","text":"x data.frame y data.frame character vector copy logical ... Additional arguments suffix character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/joins.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Join Functions — anti_join","text":"data.frame","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":null,"dir":"Reference","previous_headings":"","what":"Process set_values_to Argument — process_set_values_to","title":"Process set_values_to Argument — process_set_values_to","text":"function creates variables specified set_values_to argument, catches errors, provides user friendly error messages, optionally checks type created variables.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Process set_values_to Argument — process_set_values_to","text":"","code":"process_set_values_to(dataset, set_values_to = NULL, expected_types = NULL)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Process set_values_to Argument — process_set_values_to","text":"dataset Input dataset set_values_to Variables set named list returned exprs() defining variables set, e.g. exprs(PARAMCD = \"OS\", PARAM = \"Overall Survival\") expected. values must symbols, character strings, numeric values, expressions, NA. expected_types argument specified, specified variables checked whether specified type matches type variables created set_values_to. Permitted Values: character vector values \"numeric\" \"character\"","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Process set_values_to Argument — process_set_values_to","text":"input dataset variables specified set_values_to added/updated","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/process_set_values_to.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Process set_values_to Argument — process_set_values_to","text":"","code":"library(dplyr) data <- tribble(   ~AVAL,   20 )  try(   process_set_values_to(     data,     set_values_to = exprs(       PARAMCD = BMI     )   ) ) #> Error in process_set_values_to(data, set_values_to = exprs(PARAMCD = BMI)) :  #>   Assigning variables failed! #> • `set_values_to = exprs(PARAMCD = BMI)` #> See error message below: #> ℹ In argument: `PARAMCD = BMI`. Caused by error: ! object 'BMI' not found  try(   process_set_values_to(     data,     set_values_to = exprs(       PARAMCD = 42     ),     expected_types = c(PARAMCD = \"character\")   ) ) #> Error in process_set_values_to(data, set_values_to = exprs(PARAMCD = 42),  :  #>   The following variables have an unexpected type: #> • PARAMCD: expected is <character>, but it is <numeric>."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"Remove Temporary Variables Created Within Current Function Environment","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"","code":"remove_tmp_vars(dataset)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"dataset input dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"input dataset temporary variables removed","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/remove_tmp_vars.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Remove All Temporary Variables Created Within the Current Function Environment — remove_tmp_vars","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~DOMAIN,  ~STUDYID,      ~USUBJID,   \"DM\",    \"STUDY X\", \"01-701-1015\",   \"DM\",    \"STUDY X\", \"01-701-1016\", ) dm <- select(dm, USUBJID) tmp_var <- get_new_tmp_var(dm) dm <- mutate(dm, !!tmp_var := NA)  ## This function creates two new temporary variables which are removed when calling ## `remove_tmp_vars()`. Note that any temporary variable created outside this ## function is **not** removed do_something <- function(dataset) {   tmp_var_1 <- get_new_tmp_var(dm)   tmp_var_2 <- get_new_tmp_var(dm)   dm %>%     mutate(!!tmp_var_1 := NA, !!tmp_var_2 := NA) %>%     print() %>%     remove_tmp_vars() }  do_something(dm) #> # A tibble: 2 × 4 #>   USUBJID     tmp_var_1 tmp_var_2 tmp_var_3 #>   <chr>       <lgl>     <lgl>     <lgl>     #> 1 01-701-1015 NA        NA        NA        #> 2 01-701-1016 NA        NA        NA        #> # A tibble: 2 × 2 #>   USUBJID     tmp_var_1 #>   <chr>       <lgl>     #> 1 01-701-1015 NA        #> 2 01-701-1016 NA"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace Symbols in an Expression — replace_symbol_in_expr","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"Replace symbols expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"","code":"replace_symbol_in_expr(expression, target, replace)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"expression Expression target Target symbol replace Replacing symbol","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"expression every occurrence symbol target replaced replace","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"Stefan Bundfuss","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_symbol_in_expr.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace Symbols in an Expression — replace_symbol_in_expr","text":"","code":"library(rlang)  replace_symbol_in_expr(expr(AVAL), target = AVAL, replace = AVAL.join) #> AVAL.join replace_symbol_in_expr(expr(AVALC), target = AVAL, replace = AVAL.join) #> AVALC replace_symbol_in_expr(expr(desc(AVAL)), target = AVAL, replace = AVAL.join) #> desc(AVAL.join)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":null,"dir":"Reference","previous_headings":"","what":"Replace Expression Value with Name — replace_values_by_names","title":"Replace Expression Value with Name — replace_values_by_names","text":"Replace Expression Value Name","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replace Expression Value with Name — replace_values_by_names","text":"","code":"replace_values_by_names(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replace Expression Value with Name — replace_values_by_names","text":"expressions list expressions quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replace Expression Value with Name — replace_values_by_names","text":"list expressions","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/replace_values_by_names.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Replace Expression Value with Name — replace_values_by_names","text":"","code":"library(rlang) replace_values_by_names(exprs(AVAL, ADT = convert_dtc_to_dt(EXSTDTC))) #> [[1]] #> AVAL #>  #> $ADT #> ADT #>"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":null,"dir":"Reference","previous_headings":"","what":"Wrap a String in Single Quotes — squote","title":"Wrap a String in Single Quotes — squote","text":"Wrap String Single Quotes","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Wrap a String in Single Quotes — squote","text":"","code":"squote(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Wrap a String in Single Quotes — squote","text":"x character vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/squote.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Wrap a String in Single Quotes — squote","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":null,"dir":"Reference","previous_headings":"","what":"Suppress Specific Warnings — suppress_warning","title":"Suppress Specific Warnings — suppress_warning","text":"Suppress certain warnings issued expression.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Suppress Specific Warnings — suppress_warning","text":"","code":"suppress_warning(expr, regexpr)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Suppress Specific Warnings — suppress_warning","text":"expr Expression executed regexpr Regular expression matching warnings suppress","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Suppress Specific Warnings — suppress_warning","text":"Return value expression","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/suppress_warning.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Suppress Specific Warnings — suppress_warning","text":"warnings issued expression match regular expression suppressed.","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":null,"dir":"Reference","previous_headings":"","what":"Valid Time Units — valid_time_units","title":"Valid Time Units — valid_time_units","text":"Contains acceptable character vector valid time units","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Valid Time Units — valid_time_units","text":"","code":"valid_time_units()"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/valid_time_units.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Valid Time Units — valid_time_units","text":"character vector valid time units","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":null,"dir":"Reference","previous_headings":"","what":"Turn a List of Expressions into a Character Vector — vars2chr","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"Turn List Expressions Character Vector","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"","code":"vars2chr(expressions, quosures)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"expressions list expressions created using exprs() quosures Deprecated, please use expressions instead.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"character vector","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/vars2chr.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Turn a List of Expressions into a Character Vector — vars2chr","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  vars2chr(exprs(USUBJID, AVAL)) #>                      #> \"USUBJID\"    \"AVAL\""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn if incomplete dtc — warn_if_incomplete_dtc","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"Warn incomplete dtc","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"","code":"warn_if_incomplete_dtc(dtc, n)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"dtc character vector date-times ISO 8601 format n non-negative integer","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_incomplete_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn if incomplete dtc — warn_if_incomplete_dtc","text":"warning dtc contains partial dates","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"Checks two list inputs names number elements issues warning otherwise.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"","code":"warn_if_inconsistent_list(base, compare, list_name, i = 2)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"base named list compare named list list_name string name list index id compare 2 lists","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"warning 2 lists different names length","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_inconsistent_list.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If Two Lists are Inconsistent — warn_if_inconsistent_list","text":"","code":"library(dplyr, warn.conflicts = FALSE) library(rlang)  # no warning warn_if_inconsistent_list(   base = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   compare = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   list_name = \"Test\" ) # warning warn_if_inconsistent_list(   base = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ, DTHVAR = \"text\"),   compare = exprs(DTHDOM = \"DM\", DTHSEQ = DMSEQ),   list_name = \"Test\" ) #> Warning: The variables used for traceability in `Test` are not consistent, please check: #> source 1 , Variables are given as: DTHDOM DTHSEQ DTHVAR  #> source 2 , Variables are given as: DTHDOM DTHSEQ"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"Warn vector contains unknown datetime format \"2003-12-15T-:15:18\", \"2003-12-15T13:-:19\",\"--12-15\",\"-----T07:15\"","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"","code":"warn_if_invalid_dtc(dtc, is_valid = is_valid_dtc(dtc))"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"dtc character vector containing dates is_valid logical vector indicating whether elements dtc valid","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"return value, called side effects","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_invalid_dtc.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If a Vector Contains Unknown Datetime Format — warn_if_invalid_dtc","text":"","code":"## No warning as `dtc` is a valid date format warn_if_invalid_dtc(dtc = \"2021-04-06\")  ## Issues a warning warn_if_invalid_dtc(dtc = \"2021-04-06T-:30:30\")"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Warn If a Variable Already Exists — warn_if_vars_exist","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"Warn variable already exists inside dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"","code":"warn_if_vars_exist(dataset, vars)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"dataset data.frame vars character vector columns check dataset","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"return value, called side effects","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/warn_if_vars_exist.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Warn If a Variable Already Exists — warn_if_vars_exist","text":"","code":"library(dplyr, warn.conflicts = FALSE) dm <- tribble(   ~USUBJID,           ~ARM,   \"01-701-1015\", \"Placebo\",   \"01-701-1016\", \"Placebo\", )  ## No warning as `AAGE` doesn't exist in `dm` warn_if_vars_exist(dm, \"AAGE\")  ## Issues a warning warn_if_vars_exist(dm, \"ARM\") #> Warning: Variable \"ARM\" already exists in the dataset."},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":null,"dir":"Reference","previous_headings":"","what":"What Kind of Object is This? — what_is_it","title":"What Kind of Object is This? — what_is_it","text":"Returns string describing kind object input .","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"What Kind of Object is This? — what_is_it","text":"","code":"what_is_it(x)"},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"What Kind of Object is This? — what_is_it","text":"x R object","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"What Kind of Object is This? — what_is_it","text":"character description type x","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/reference/what_is_it.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"What Kind of Object is This? — what_is_it","text":"","code":"what_is_it(\"abc\") #> Warning: `what_is_it()` was deprecated in admiraldev 1.1.0. #> ℹ This function was primarily used in error messaging, and can be replaced with #>   'cli' functionality: `cli::cli_abort('{.obj_type_friendly {letters}}')`. #> [1] \"`\\\"abc\\\"`\" what_is_it(1L) #> [1] \"`1`\" what_is_it(1:10) #> [1] \"an integer vector\" what_is_it(mtcars) #> [1] \"a data frame\""},{"path":[]},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-development-version","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev (development version)","text":"Error messaging throughout package updated rlang::abort() cli::cli_abort(). part update, assert_*() functions new arguments assert_*(message, arg_name, call, class). (#367) Warning messaging also updated use cli messaging.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-development-version","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev (development version)","text":"renv related files removed. (#360) longer exporting is_named() function. (#401) pharmaversesdtm removed dependency. (#434) part error messaging update, following changes made. assert_s3_class(class) argument renamed assert_s3_class(cls). (#367) Functions arg_name(), enumerate(), what_is_it(), friendly_type_of() deprecated warning returned developer using functions. developer functions (opposed functions typical admiral users), use short deprecation cycle.","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-development-version","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev (development version)","text":"“Release Strategy” vignette updated respect new branching strategy. (#353) “Release Strategy” vignette now contains short new “Release Tracking” section linking external dashboard CRAN packages awaiting release. (#358)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"other-development-version","dir":"Changelog","previous_headings":"","what":"Other","title":"admiraldev (development version)","text":"Removed dependencies needed build package package documentation. (#426) Increased minimum R version required 4.0 match {admiral}. (#382) addin_format_testthat addin moved {pharmaverse4devs} package. (#419)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-100","dir":"Changelog","previous_headings":"","what":"admiraldev 1.0.0","title":"admiraldev 1.0.0","text":"CRAN release: 2023-12-15","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-1-0-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 1.0.0","text":"assert_function() now accepts function arguments ellipsis, ... function formals (#339)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-1-0-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 1.0.0","text":"assert_function_param() assert_named_expr() assert_has_variables()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-1-0-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 1.0.0","text":"New documentation programming strategy around quoting/expressions standardizing roxygen texts (#233, #332) New documentation use footnotes writing vignettes (#324) Updated language images adopt GitHub Flow Strategy (#349)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-050","dir":"Changelog","previous_headings":"","what":"admiraldev 0.5.0","title":"admiraldev 0.5.0","text":"CRAN release: 2023-09-11","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-5-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.5.0","text":"Calls admiral.test swapped pharmaversesdtm (#321) New vignette package writing extensions now available (#295, #312) New vignette creating test data now available (#282)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-5-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.5.0","text":"messaging warn_if_invalid_dtc() updated align date/datetime functions admiral currently . (#316)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-5-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.5.0","text":"assert_order_vars() quo_c() quo_not_missing() replace_symbol_in_quo() quosures argument replaced expressions argument replace_values_by_names(), get_source_vars(), vars2chr(). (#288) assert_function_param() deprecated favor assert_function(). (#264) assert_named_expr() deprecated favor assert_expr_list(). (#264) assert_has_variables() deprecated favor assert_data_frame(). (#264)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-5-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.5.0","text":"Guidance around issues merging updated (#286) Common R CMD troubleshooting made separate vignette (#286) Documentation get_dataset() improved. (#271) Minor updates programming strategy added (#213, #240, #260) Updated unit testing vignette snapshot testing guidance. (#302) Documentation friendly_type_of() provided (#22) Minor updates pull request review guidance added (#201, #292) Documentation singular versus plural function argument names added programming strategy vignette. Also documentation common arguments missing_value missing_values added. (#296) Documentation highlighting difference set_values_to keep_source_vars (#318) List common arguments updated (#306)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-040","dir":"Changelog","previous_headings":"","what":"admiraldev 0.4.0","title":"admiraldev 0.4.0","text":"CRAN release: 2023-06-06","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-4-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.4.0","text":"New function assert_named() check elements argument named (#241) New function assert_expr_list() check argument list expressions (#241) Added Report bug link admiraldev website (#257)","code":""},{"path":[]},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-4-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.4.0","text":"assert_order_vars() deprecated favor assert_expr_list(). (#241) following functions deprecated previous admiral versions using next phase deprecation process: (#272) quo_c() quo_not_missing() replace_symbol_in_quo() quosures argument replaced expressions argument replace_values_by_names().","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-4-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.4.0","text":"deprecation strategy updated regarding unit tests deprecated functions/arguments phase 1. (#247) programming strategy updated regarding permitted values calling functions package dependencies (#72, #253)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-030","dir":"Changelog","previous_headings":"","what":"admiraldev 0.3.0","title":"admiraldev 0.3.0","text":"CRAN release: 2023-03-06","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-3-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.3.0","text":"New function process_set_values_to() creating variables specified set_value_to argument catching errors (#70)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-3-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.3.0","text":"Using testthat3e (testthat 3rd edition) unit testing. stricter messages must addressed deprecated functions throw errors. (#230) Slight boost test coverage dev_utilities (#102) Fix datatable styling documentation (#197) assert_character_vector() function gained named argument check elements vector named. (#70) assert_list_of() function gained named argument check elements list named. (#203) quote_fun argument enumerate() extended NULL can specified request quoting elements. (#203) assert_list_of() function enhanced also considers type element, e.g., check value list symbols. (#208)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-3-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.3.0","text":"default value optional argument assert_date_vector(), assert_list_of(), assert_s3_class() changed TRUE FALSE make default behavior consistent. (#87) quo_c() replace_symbol_in_quo() quosures argument get_source_vars(), replace_values_by_names(), vars2chr()","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-3-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.3.0","text":"New section programming strategy regarding comments (#71) Removed requirement add @author tags code scripts programming strategy, tracking authors DESCRIPTION file. Authors removed function documentation line update. (#206, #210) Removed -boarding Issue Template (#225) Increased clarity scope package (#232)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-020","dir":"Changelog","previous_headings":"","what":"admiraldev 0.2.0","title":"admiraldev 0.2.0","text":"CRAN release: 2022-11-30","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-2-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.2.0","text":"Developer addin formatting tests admiral programming standards (#73) New functions replace_symbol_in_quo() add_suffix_to_vars() (#106) New function assert_atomic_vector() (#98) New keyword/family create_aux functions creating auxiliary datasets (#126) New function assert_date_vector() (#129) New function assert_same_type() (#176) Remove dependency {assertthat} (#149) Test coverage admiraldev increased 45% approximately 100% (#94, #95, #96, #98, #101, #103) Environment objects consolidated single admiraldev_environment object R/admiraldev_environment.R. (#179)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-2-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.2.0","text":"expect_names argument added assert_vars() check variables named (#117) Remove dplyr function exports migration user facing function negate_vars() admiral (#83)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-2-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.2.0","text":"longer compatible admiral (<0.9)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-2-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.2.0","text":"New vignette package release strategy (#79) Updated multiple roxygen headers (#116, #133, #134, #141, #145, #172) Description admiral options work certain function inputs, .e subject_keys (#133)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"various-0-2-0","dir":"Changelog","previous_headings":"","what":"Various","title":"admiraldev 0.2.0","text":"PR Checklist Template updated (#172) New authors/contributors (#158)","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"admiraldev-010","dir":"Changelog","previous_headings":"","what":"admiraldev 0.1.0","title":"admiraldev 0.1.0","text":"CRAN release: 2022-08-26","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"new-features-0-1-0","dir":"Changelog","previous_headings":"","what":"New Features","title":"admiraldev 0.1.0","text":"Developer specific functions brought admiral Developer specific vignettes brought admiral New admiraldev website created","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"updates-of-existing-functions-0-1-0","dir":"Changelog","previous_headings":"","what":"Updates of Existing Functions","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"breaking-changes-0-1-0","dir":"Changelog","previous_headings":"","what":"Breaking Changes","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"documentation-0-1-0","dir":"Changelog","previous_headings":"","what":"Documentation","title":"admiraldev 0.1.0","text":"NA","code":""},{"path":"https://pharmaverse.github.io/admiraldev/dev/news/index.html","id":"various-0-1-0","dir":"Changelog","previous_headings":"","what":"Various","title":"admiraldev 0.1.0","text":"NA","code":""}]