From 5c6f93d165bb14b8cb6bc93e99dd3777ca3782f6 Mon Sep 17 00:00:00 2001
From: Patricia Zauchner <patricia.zauchner@gmx.at>
Date: Fri, 6 Dec 2024 18:26:25 +0100
Subject: [PATCH] version 1.3.1

---
 DESCRIPTION                          |   2 +-
 NEWS.md                              |   4 ++++
 cran-comments.md                     |   4 ++++
 docs/404.html                        |   2 +-
 docs/articles/codebook.html          |   2 +-
 docs/articles/index.html             |   2 +-
 docs/articles/intro_to_gmoTree.html  |   2 +-
 docs/authors.html                    |   6 +++---
 docs/impressum.html                  |   2 +-
 docs/index.html                      |   2 +-
 docs/news/index.html                 |   8 ++++++--
 docs/pkgdown.yml                     |   2 +-
 docs/reference/apptime.html          |   2 +-
 docs/reference/assignv.html          |   2 +-
 docs/reference/assignv_to_aaw.html   |   2 +-
 docs/reference/codebook.html         |   2 +-
 docs/reference/delete_cases.html     |   2 +-
 docs/reference/delete_dropouts.html  |   2 +-
 docs/reference/delete_duplicate.html |   2 +-
 docs/reference/delete_plabels.html   |   2 +-
 docs/reference/delete_sessions.html  |   2 +-
 docs/reference/extime.html           |   2 +-
 docs/reference/import_otree.html     |   2 +-
 docs/reference/index.html            |   2 +-
 docs/reference/make_ids.html         |   2 +-
 docs/reference/messy_chat.html       |   2 +-
 docs/reference/messy_time.html       |   2 +-
 docs/reference/oTree.html            |   2 +-
 docs/reference/pagesec.html          |   2 +-
 docs/reference/show_constant.html    |   2 +-
 docs/reference/show_dropouts.html    |   2 +-
 docs/search.json                     |   2 +-
 inst/CITATION                        |   4 ++--
 vignettes/{intro.PNG => intro.png}   | Bin
 vignettes/{title.PNG => title.png}   | Bin
 35 files changed, 47 insertions(+), 35 deletions(-)
 rename vignettes/{intro.PNG => intro.png} (100%)
 rename vignettes/{title.PNG => title.png} (100%)

diff --git a/DESCRIPTION b/DESCRIPTION
index 0f4c95f..2d7e4b2 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,6 +1,6 @@
 Package: gmoTree
 Title: Get and Modify 'oTree' Data
-Version: 1.3.0
+Version: 1.3.1
 Date: 2024-12-06
 Authors@R: 
     person("Patricia F.", "Zauchner", , "patricia.zauchner@gmx.at", role = c("aut", "trl", "cre", "cph"),
diff --git a/NEWS.md b/NEWS.md
index ad2efd8..b289e6b 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,5 +1,9 @@
 **Changes in CITATION file,  NEWS file are not documented.**
 
+# gmoTree 1.3.1 
+
+* Updated figure in vignette.
+
 # gmoTree 1.3.0
 
 * Changes in ```codebook()``` 
diff --git a/cran-comments.md b/cran-comments.md
index 435da6f..a5b8f5e 100644
--- a/cran-comments.md
+++ b/cran-comments.md
@@ -1,3 +1,7 @@
+# Version 1.3.1
+
+Updated figure in vignette
+
 # Version 1.3.0
 
 No comments. 
diff --git a/docs/404.html b/docs/404.html
index 0b8e823..864cf9b 100644
--- a/docs/404.html
+++ b/docs/404.html
@@ -28,7 +28,7 @@
 
     <a class="navbar-brand me-2" href="https://zauchnerp.github.io/gmoTree/index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/articles/codebook.html b/docs/articles/codebook.html
index 38d7ca6..06294f6 100644
--- a/docs/articles/codebook.html
+++ b/docs/articles/codebook.html
@@ -27,7 +27,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/articles/index.html b/docs/articles/index.html
index c77edc7..9441099 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/articles/intro_to_gmoTree.html b/docs/articles/intro_to_gmoTree.html
index 5aef2d1..bbbe6e3 100644
--- a/docs/articles/intro_to_gmoTree.html
+++ b/docs/articles/intro_to_gmoTree.html
@@ -27,7 +27,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/authors.html b/docs/authors.html
index b0d6a6b..b303352 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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">
@@ -48,12 +48,12 @@ <h2>Authors</h2>
       <h2 id="citation">Citation</h2>
       <p><small class="dont-index">Source: <a href="https://github.com/ZauchnerP/gmoTree/blob/HEAD/inst/CITATION" class="external-link"><code>inst/CITATION</code></a></small></p>
 
-      <p>Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.0, &lt;https://CRAN.R-project.org/package=gmoTree/&gt;.</p>
+      <p>Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.1, &lt;https://CRAN.R-project.org/package=gmoTree/&gt;.</p>
       <pre>@Manual{,
   title = {gmoTree: oTree Data Manipulation Tool},
   author = {Patricia F. Zauchner},
   year = {2024},
-  note = {R package version 1.3.0},
+  note = {R package version 1.3.1},
   url = {https://CRAN.R-project.org/package=gmoTree},
 }</pre>
     </div>
diff --git a/docs/impressum.html b/docs/impressum.html
index 8b1410b..b7f60ac 100644
--- a/docs/impressum.html
+++ b/docs/impressum.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/index.html b/docs/index.html
index b0c6037..24fcca4 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -30,7 +30,7 @@
 
     <a class="navbar-brand me-2" href="index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/news/index.html b/docs/news/index.html
index fc41e0b..9a75f50 100644
--- a/docs/news/index.html
+++ b/docs/news/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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">
@@ -37,7 +37,11 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="1.3.0" id="gmotree-130">gmoTree 1.3.0<a class="anchor" aria-label="anchor" href="#gmotree-130"></a></h2>
+<h2 class="pkg-version" data-toc-text="1.3.1" id="gmotree-131">gmoTree 1.3.1<a class="anchor" aria-label="anchor" href="#gmotree-131"></a></h2>
+<ul><li>Updated figure in vignette.</li>
+</ul></div>
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="1.3.0" id="gmotree-130">gmoTree 1.3.0<a class="anchor" aria-label="anchor" href="#gmotree-130"></a></h2><p class="text-muted">CRAN release: 2024-12-06</p>
 <ul><li>Changes in <code><a href="../reference/codebook.html">codebook()</a></code>
 <ul><li>Bug fixes
 <ul><li>Resolved an issue with <code>Constants</code> vector presentations in the output files</li>
diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml
index 6e2d61c..549fbe3 100644
--- a/docs/pkgdown.yml
+++ b/docs/pkgdown.yml
@@ -4,7 +4,7 @@ pkgdown_sha: ~
 articles:
   codebook: codebook.html
   intro_to_gmoTree: intro_to_gmoTree.html
-last_built: 2024-12-06T01:18Z
+last_built: 2024-12-06T17:23Z
 urls:
   reference: https://zauchnerp.github.io/gmoTree/reference
   article: https://zauchnerp.github.io/gmoTree/articles
diff --git a/docs/reference/apptime.html b/docs/reference/apptime.html
index a1b95db..21fbda6 100644
--- a/docs/reference/apptime.html
+++ b/docs/reference/apptime.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/assignv.html b/docs/reference/assignv.html
index 2e74636..feba55e 100644
--- a/docs/reference/assignv.html
+++ b/docs/reference/assignv.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/assignv_to_aaw.html b/docs/reference/assignv_to_aaw.html
index f1de32c..e402b7f 100644
--- a/docs/reference/assignv_to_aaw.html
+++ b/docs/reference/assignv_to_aaw.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/codebook.html b/docs/reference/codebook.html
index 13eaec7..5af94e5 100644
--- a/docs/reference/codebook.html
+++ b/docs/reference/codebook.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/delete_cases.html b/docs/reference/delete_cases.html
index 198d509..fca661b 100644
--- a/docs/reference/delete_cases.html
+++ b/docs/reference/delete_cases.html
@@ -31,7 +31,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/delete_dropouts.html b/docs/reference/delete_dropouts.html
index a10bf56..572af9a 100644
--- a/docs/reference/delete_dropouts.html
+++ b/docs/reference/delete_dropouts.html
@@ -31,7 +31,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/delete_duplicate.html b/docs/reference/delete_duplicate.html
index 5332a4e..59e182c 100644
--- a/docs/reference/delete_duplicate.html
+++ b/docs/reference/delete_duplicate.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/delete_plabels.html b/docs/reference/delete_plabels.html
index fe5adec..f6f4f91 100644
--- a/docs/reference/delete_plabels.html
+++ b/docs/reference/delete_plabels.html
@@ -21,7 +21,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/delete_sessions.html b/docs/reference/delete_sessions.html
index d6769fb..1c6f1b8 100644
--- a/docs/reference/delete_sessions.html
+++ b/docs/reference/delete_sessions.html
@@ -19,7 +19,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/extime.html b/docs/reference/extime.html
index e0272b0..8d3f3d9 100644
--- a/docs/reference/extime.html
+++ b/docs/reference/extime.html
@@ -11,7 +11,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/import_otree.html b/docs/reference/import_otree.html
index 2b6c2da..272c410 100644
--- a/docs/reference/import_otree.html
+++ b/docs/reference/import_otree.html
@@ -37,7 +37,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/index.html b/docs/reference/index.html
index 6f20106..734cf97 100644
--- a/docs/reference/index.html
+++ b/docs/reference/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/make_ids.html b/docs/reference/make_ids.html
index 8c19d2c..36a0efa 100644
--- a/docs/reference/make_ids.html
+++ b/docs/reference/make_ids.html
@@ -21,7 +21,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/messy_chat.html b/docs/reference/messy_chat.html
index c193224..e178e3a 100644
--- a/docs/reference/messy_chat.html
+++ b/docs/reference/messy_chat.html
@@ -19,7 +19,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/messy_time.html b/docs/reference/messy_time.html
index 419a315..3c54d09 100644
--- a/docs/reference/messy_time.html
+++ b/docs/reference/messy_time.html
@@ -19,7 +19,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/oTree.html b/docs/reference/oTree.html
index 4eb3c21..9cc819d 100644
--- a/docs/reference/oTree.html
+++ b/docs/reference/oTree.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/pagesec.html b/docs/reference/pagesec.html
index a361f08..6b5603e 100644
--- a/docs/reference/pagesec.html
+++ b/docs/reference/pagesec.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/show_constant.html b/docs/reference/show_constant.html
index ebc5b46..15d6010 100644
--- a/docs/reference/show_constant.html
+++ b/docs/reference/show_constant.html
@@ -17,7 +17,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/reference/show_dropouts.html b/docs/reference/show_dropouts.html
index d30069f..698e882 100644
--- a/docs/reference/show_dropouts.html
+++ b/docs/reference/show_dropouts.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">gmoTree</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">1.3.1</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/docs/search.json b/docs/search.json
index d4327cd..26c9424 100644
--- a/docs/search.json
+++ b/docs/search.json
@@ -1 +1 @@
-[{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"gmoTree Codebooks","text":"gmoTree package provides tools generating codebooks based data oTree (Chen et al., 2016) framework function codebook(). vignette introduces key features functionalities. Disclaimer: code tested custom implementations official oTree sample codes.1 However, due complexity oTree setups, may address variations. Please review output carefully, feel free open GitHub issue encounter problems.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"running-the-code","dir":"Articles","previous_headings":"","what":"Running the code","title":"gmoTree Codebooks","text":"simplest form, function requires path oTree code. following code reads contents oTree file, saves file containing codebook working directory, returns list named cbook, containing extracted information.","code":"cbook <- codebook(\"D:/pathtoyourproject/oTree_codes\")"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"codebook-structure-and-output","dir":"Articles","previous_headings":"","what":"Codebook structure and output","title":"gmoTree Codebooks","text":"output structured clear headings: Heading Level 1: Represents app oTree data. Heading Level 2: Group Player variables, categorized within app. Showing class Constants optional can turned using argument include_cons = FALSE.  example shows output cournot app, includes Constants, Group, Player variables. class contains information, heading still appear, along message “Empty class.”  Use output = \"list\" bypass file creation. option returns information list format, can used R Markdown design custom codebook. example list output looks like. (argument doc_info = FALSE suppresses messages missing variable documentation.)","code":"# Create the codebook list cbook <- codebook(path = system.file(path = \"extdata/ocode_new\",                                       package = \"gmoTree\"),                    output = \"list\",                    doc_info = FALSE)   str(cbook, 1)  # Show all apps ## List of 16 ##  $ settings            :List of 10 ##  $ bargaining          :List of 4 ##  $ bertrand            :List of 4 ##  $ common_value_auction:List of 4 ##  $ cournot             :List of 4 ##  $ dictator            :List of 4 ##  $ guess_two_thirds    :List of 4 ##  $ matching_pennies    :List of 4 ##  $ payment_info        :List of 4 ##  $ prisoner            :List of 4 ##  $ public_goods_simple :List of 3 ##  $ survey              :List of 3 ##  $ traveler_dilemma    :List of 4 ##  $ trust               :List of 3 ##  $ trust_simple        :List of 3 ##  $ volunteer_dilemma   :List of 4 print(cbook$cournot)  # Only show cournot app ## $doc ## [1] \"In Cournot competition, firms simultaneously decide the units of products to manufacture. The unit selling price depends on the total units produced. In this implementation, there are 2 firms competing for 1 period.\" ##  ## $Constants ## $Constants$NAME_IN_URL ## [1] \"cournot\" ##  ## $Constants$PLAYERS_PER_GROUP ## [1] 2 ##  ## $Constants$NUM_ROUNDS ## [1] 1 ##  ## $Constants$TOTAL_CAPACITY ## [1] 60 ##  ## $Constants$MAX_UNITS_PER_PLAYER ## [1] \"int(60 / 2)\" ##  ##  ## $Group ## $Group$unit_price ## $Group$unit_price$noargs ## [1] TRUE ##  ## $Group$unit_price$field ## [1] \"CurrencyField\" ##  ##  ## $Group$total_units ## $Group$total_units$noargs ## [1] FALSE ##  ## $Group$total_units$doc ## [1] \"Total units produced by all players\" ##  ## $Group$total_units$field ## [1] \"IntegerField\" ##  ##  ##  ## $Player ## $Player$units ## $Player$units$noargs ## [1] \"FALSE\" ##  ## $Player$units$min ## [1] \"0\" ##  ## $Player$units$max ## [1] \"int(60 / 2)\" ##  ## $Player$units$doc ## [1] \"Quantity of units to produce\" ##  ## $Player$units$label ## [1] \"How many units will you produce (from 0 to 30)?\" ##  ## $Player$units$field ## [1] \"IntegerField\""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"apps","dir":"Articles","previous_headings":"Choosing what to show","what":"Apps","title":"gmoTree Codebooks","text":"Per default, apps included codebook. generate codebook one app, use app argument. example, generate codebook cournot app: code returns list app-specific information. can also generate codebooks multiple apps specifying app argument. can also choose remove one apps. example removes app prisoner:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\",                      package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = \"cournot\")  str(cbook) ## List of 2 ##  $ settings:List of 10 ##   ..$ variable                : num 66 ##   ..$ PARTICIPANT_FIELDS      : list() ##   ..$ SESSION_FIELDS          : list() ##   ..$ LANGUAGE_CODE           : chr \"en\" ##   ..$ REAL_WORLD_CURRENCY_CODE: chr \"USD\" ##   ..$ USE_POINTS              : chr \"True\" ##   ..$ ADMIN_USERNAME          : chr \"admin\" ##   ..$ ADMIN_PASSWORD          : chr \"environ.get('OTREE_ADMIN_PASSWORD')\" ##   ..$ DEMO_PAGE_INTRO_HTML    : chr \"Here are some oTree games.\" ##   ..$ SECRET_KEY              : chr \"9356668094877\" ##  $ cournot :List of 4 ##   ..$ doc      : chr \"In Cournot competition, firms simultaneously decide the units of products to manufacture. The unit selling pric\"| __truncated__ ##   ..$ Constants:List of 5 ##   .. ..$ NAME_IN_URL         : chr \"cournot\" ##   .. ..$ PLAYERS_PER_GROUP   : num 2 ##   .. ..$ NUM_ROUNDS          : num 1 ##   .. ..$ TOTAL_CAPACITY      : num 60 ##   .. ..$ MAX_UNITS_PER_PLAYER: chr \"int(60 / 2)\" ##   ..$ Group    :List of 2 ##   .. ..$ unit_price :List of 2 ##   .. .. ..$ noargs: logi TRUE ##   .. .. ..$ field : chr \"CurrencyField\" ##   .. ..$ total_units:List of 3 ##   .. .. ..$ noargs: logi FALSE ##   .. .. ..$ doc   : chr \"Total units produced by all players\" ##   .. .. ..$ field : chr \"IntegerField\" ##   ..$ Player   :List of 1 ##   .. ..$ units:List of 6 ##   .. .. ..$ noargs: chr \"FALSE\" ##   .. .. ..$ min   : chr \"0\" ##   .. .. ..$ max   : chr \"int(60 / 2)\" ##   .. .. ..$ doc   : chr \"Quantity of units to produce\" ##   .. .. ..$ label : chr \"How many units will you produce (from 0 to 30)?\" ##   .. .. ..$ field : chr \"IntegerField\" cbook <- codebook(   path = system.file(\"extdata/ocode_new\",                      package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = c(\"cournot\", \"dictator\"))  str(cbook, 1) ## List of 3 ##  $ settings:List of 10 ##  $ cournot :List of 4 ##  $ dictator:List of 4 cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app_rm = \"prisoner\")  str(cbook, 1) ## List of 15 ##  $ settings            :List of 10 ##  $ bargaining          :List of 4 ##  $ bertrand            :List of 4 ##  $ common_value_auction:List of 4 ##  $ cournot             :List of 4 ##  $ dictator            :List of 4 ##  $ guess_two_thirds    :List of 4 ##  $ matching_pennies    :List of 4 ##  $ payment_info        :List of 4 ##  $ public_goods_simple :List of 3 ##  $ survey              :List of 3 ##  $ traveler_dilemma    :List of 4 ##  $ trust               :List of 3 ##  $ trust_simple        :List of 3 ##  $ volunteer_dilemma   :List of 4"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"otree-data-description","dir":"Articles","previous_headings":"Choosing what to show","what":"oTree data description","title":"gmoTree Codebooks","text":"setting preamb = TRUE parameter, predefined description oTree data inserted beginning codebook, explaining experimental data stored oTree.","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"customizing-the-codebook-titles-and-metadata","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Customizing the codebook titles and metadata","title":"gmoTree Codebooks","text":"can easily modify titles, subtitles, dates, author names codebooks using following arguments:","code":"codebook(     path = \"YouroTreePath\",  # Can be either absolute or relative!     title = \"Codebook\",     subtitle = \"Example Project\",     date = \"today\",     params = list(author = c(\"Max Mustermann\", \"John Doe\")) )"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"sorting-the-code","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Sorting the code","title":"gmoTree Codebooks","text":"can sort apps codebook specifying sort argument. example:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = c(\"cournot\", \"dictator\"),   sort = c(\"dictator\", \"cournot\"))  str(cbook, 1) ## List of 3 ##  $ settings:List of 10 ##  $ dictator:List of 4 ##  $ cournot :List of 4"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"referring-to-settings","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Referring to settings","title":"gmoTree Codebooks","text":"gmoTree package can automatically replace references variables settings.py values settings.py file. enable , set settings_replace = \"global\". can also choose replace references settings variables using settings_replace = NULL. also possible provide list variables replace settings variables argument user_settings. example:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = \"global\",   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] 66 cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = NULL,   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] \"settings.variable\" cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = \"user\",   user_settings = list(variable = \"someValue\"),   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] \"someValue\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"saving-your-codebook","dir":"Articles","previous_headings":"","what":"Saving your codebook","title":"gmoTree Codebooks","text":"choose output = \"file\" output = \"\", codebook saved professional document ready publication sharing.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"output-formats","dir":"Articles","previous_headings":"Saving your codebook","what":"Output formats","title":"gmoTree Codebooks","text":"argument output_format allows choose format exported codebook file. Available formats : html_document word_document latex_document odt_document rtf_document md_document pdf_document pdf_document_simple can choose format best suits needs, formats except PDF allowing easy post-generation editing. knitting PDF, make sure LaTex installed! recommended use output_format = pdf_document_simple. However, many non-Latin characters (e.g., Chinese characters) may work format. cases, can choose output_format = pdf_document, set use xelatex. Please note using xelatex gmoTree limitations: example, gmoTree currently handle long variable values result excessively long table cells. can cause PDF display improperly certain viewers, Nitro. address , carefully review file. necessary, consider using output_format = latex_document. Alternatively, open file PDF viewer can handle cases, save ensure displays correctly PDF viewers.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"output-files","dir":"Articles","previous_headings":"Saving your codebook","what":"Output files","title":"gmoTree Codebooks","text":"default, gmoTree codebooks saved working directory default file name codebook. can modify specifying custom file name directory path. example, save codebook different name, use following code: can also include file extension, although optional: can save file subfolder within current directory including absolute relative folder name output_file argument. example: can also specify absolute paths, either output_dir argument directly within file name specified output_file. example:","code":"codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"gmoTree_codebook\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"gmoTree_codebook.pdf\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"codebookfiles/gmoTree_codebook.pdf\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_dir  = \"C:/Users/username/folder/codebooks\",     output_file = \"mycodebook\")"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"gmoTree Codebooks","text":"vignette documents customize codebook generated codebook() function, including options content selection, formatting, exporting various formats. tools enable creation comprehensive tailored documentation experimental data.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"references","dir":"Articles","previous_headings":"","what":"References","title":"gmoTree Codebooks","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"background-information-on-the-data-downloaded-by-otree","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"Background information on the data downloaded by oTree","title":"Introduction to gmoTree","text":"oTree experiment structured around one modular units called “apps,” encompass one multiple “pages.” Data generated app can downloaded individually, offering flexibility analyze separate components experiment. -encompassing view experiment, data apps can also downloaded comprehensive file labeled “all_apps_wide.” addition aforementioned app data cumulative all_apps_wide file, oTree generates file time stamps every page. file documenting chat interactions also provided experiment includes one multiple chat rooms. newer oTree versions, also custom data can downloaded. oTree experiment run across different databases, set data files downloaded database. include individual app data files, all_apps_wide file, file time stamps every page, chat log file chat room used experiment. gmoTree package’s functionality lies ability load aggregate files ease.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"import_otree","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"import_otree()","title":"Introduction to gmoTree","text":"can import oTree data combine list data frames using import_otree() function. data frame named according associated app, function generates accompanying info list details essential information regarding imported files, deleted cases. information list updated use functions within package. worth noting even use one all_apps_wide file, still load data import_otree() want access functions within gmoTree package. Alternatively, reproduce structure created function hand. following example shows import oTree data, structure oTree list data frames importing data, information provided oTree$info. Caution: function works oTree data saved using typical oTree file pattern!","code":"# Get path to the package data path <- system.file(\"extdata/exp_data_5.4.0\", package = \"gmoTree\")  # Import without specifications # Import all oTree files in this folder and its subfolders otree <- import_otree(path = path) ## Warning in import_otree(path = path): You have stored all_apps_wide globally ## but also room-specific. This function will import both of them. (Globally, the ## files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All ## apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing ## is there twice! (Advice: You may use delete_duplicate() to remove duplicate ## rows of all oTree data frames.  # Check the structure of the oTree list of data frames str(otree, 1) ## List of 8 ##  $ all_apps_wide:'data.frame':   12 obs. of  60 variables: ##  $ info         :List of 2 ##  $ chatapp      :'data.frame':   8 obs. of  24 variables: ##  $ dictator     :'data.frame':   48 obs. of  25 variables: ##  $ start        :'data.frame':   8 obs. of  24 variables: ##  $ survey       :'data.frame':   8 obs. of  29 variables: ##  $ Time         :'data.frame':   77 obs. of  10 variables: ##  $ Chats        :'data.frame':   6 obs. of  7 variables:  # The initial info list otree$info ## $imported_files ## [1] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/ChatMessages-2023-05-16.csv\"  ## [2] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/PageTimes-2023-05-16.csv\"     ## [3] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/survey_2023-05-16.csv\"        ## [4] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/start_2023-05-16.csv\"         ## [5] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/dictator_2023-05-16.csv\"      ## [6] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/dictator_2023-05-00.csv\"      ## [7] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/chatapp_2023-05-16.csv\"       ## [8] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/all_apps_wide_2023-05-16.csv\" ## [9] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/all_apps_wide-2023-05-16.csv\" ##  ## $initial_n ## [1] 12"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_duplicate","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"delete_duplicate()","title":"Introduction to gmoTree","text":"Sometimes, data imported several times. happen several reasons. First, one data set might part another download temporarily stored data downloading final data frame. Second, room-specific global data imported, data $all_apps_wide data frame two times. Third, data stored several imported folders. function delete_duplicate() deletes duplicate data apps $all_apps_wide. , however, change $Time $Chats data frames. running function, let us first check number participant codes initial count executing delete_duplicate() function. imported $all_apps_wide data frame, 12 participant codes. However, among , 8 unique, indicates presence duplicate data. $info data frame suggests initially 12 entries. remove duplicates, employ delete_duplicate() function: Please note details deleted rows added list deleted cases. list might used analysis, function mainly focuses cleaning untidy data import. However, count $info$initial_n adjusted accordingly. deletion operation, find participant codes unique, count $info$initial_n matches number unique participant codes.","code":"# Initial check before deletion length(otree$all_apps_wide$participant.code) ## [1] 12 length(unique(otree$all_apps_wide$participant.code)) ## [1] 8 otree$info$initial_n ## [1] 12 # Delete duplicate cases otree <- delete_duplicate(otree) # Check participant codes and initial_n after deletion length(otree$all_apps_wide$participant.code) ## [1] 8 length(unique(otree$all_apps_wide$participant.code)) ## [1] 8 otree$info$initial_n ## [1] 8"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"dealing-with-messy-chats-and-time-data-frames","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"Dealing with messy Chats and Time data frames","title":"Introduction to gmoTree","text":"combine data experiments ran different versions oTree, might happen several variables referring attribute $Time $Chats data frames. functions messy_chat() messy_time() integrate corresponding variables used argument combine = TRUE. show example, let us first load data different versions oTree. Now can run functions messy_time() messy_chat(). warning messages part expected output, indicating precisely variables combined. need concern see . However, can also turn using info = FALSE.","code":"# Import data from different oTree versions otree_all <- import_otree(   path = system.file(\"extdata\", package = \"gmoTree\")) ## Warning in import_otree(path = system.file(\"extdata\", package = \"gmoTree\")): ## You have stored all_apps_wide globally but also room-specific. This function ## will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" ## Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") ## After importing the data, make sure nothing is there twice! (Advice: You may ## use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Check names of Time data frame names(otree_all$Time) ##  [1] \"session_code\"              \"participant_id_in_session\" ##  [3] \"participant_code\"          \"page_index\"                ##  [5] \"app_name\"                  \"page_name\"                 ##  [7] \"epoch_time_completed\"      \"round_number\"              ##  [9] \"timeout_happened\"          \"is_wait_page\"  # Check names of Chats data frame names(otree_all$Chats) ## [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          ## [5] \"nickname\"         \"body\"             \"timestamp\" otree_all <- messy_time(otree_all,                         combine = TRUE,                         info = TRUE) otree_all <- messy_chat(otree_all,                         combine = TRUE,                         info = TRUE) # Check names of Time data frame again names(otree_all$Time) ##  [1] \"session_code\"              \"participant_id_in_session\" ##  [3] \"participant_code\"          \"page_index\"                ##  [5] \"app_name\"                  \"page_name\"                 ##  [7] \"epoch_time_completed\"      \"round_number\"              ##  [9] \"timeout_happened\"          \"is_wait_page\"  # Check names of Chats data frame again names(otree_all$Chats) ## [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          ## [5] \"nickname\"         \"body\"             \"timestamp\""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"show_dropouts","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"show_dropouts()","title":"Introduction to gmoTree","text":"Sometimes, participants drop experiments. get overview dropouts, can use function show_dropouts(). creates three data frames/tables information participants finish () certain app(s) page(s). First, function show_dropouts() creates data frame $full provides specific information apps pages participants left experiment prematurely. Additionally, data frame indicates apps affected participants dropped . Second, function show_dropouts() also generates smaller data frame $unique includes information person . Third, function show_dropouts() furthermore creates table $all_end, contains information participants ended experiment. columns contain names pages experiment; rows contain names apps.","code":"# Show everyone that has not finished with the app \"survey\" dropout_list <- show_dropouts(otree, \"survey\")  head(dropout_list$full) ##   participant.code session.code  end_app        end_page ## 1         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 2         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 3         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 4         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 5         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6         dhgisush     2wlrl5kb dictator           Offer ##                                                reason ## 1 Experiment not completed. Noticed at: all_apps_wide ## 2       Experiment not completed. Noticed at: chatapp ## 3      Experiment not completed. Noticed at: dictator ## 4         Experiment not completed. Noticed at: start ## 5        Experiment not completed. Noticed at: survey ## 6 Experiment not completed. Noticed at: all_apps_wide dropout_list$unique ##    participant.code session.code  end_app        end_page ## 1          1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6          dhgisush     2wlrl5kb dictator           Offer ## 11         j2g9mcaf     jk9ekpl0 dictator    Introduction ## 16         p6m495xi     2wlrl5kb dictator    Introduction ##                      reason ## 1  Experiment not completed ## 6  Experiment not completed ## 11 Experiment not completed ## 16 Experiment not completed dropout_list$all_end ##            ##            Demographics Introduction Offer ResultsWaitPage ##   dictator            0            2     1               1 ##   survey              4            0     0               0"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_dropouts","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_dropouts()","title":"Introduction to gmoTree","text":"function delete_dropouts() removes data related participants prematurely terminated experiment data frames oTree list, exception data info list $Chats data frame. highly recommend manually delete chat data, can occasionally become unintelligible one person’s input removed. Therefore, function delete chat input participants dropped experiment. running example, let us first check row numbers data frames. run function delete_dropouts() check row numbers , see cases deleted data frame $Chats data frame. Just show_dropouts(), delete_dropouts() function also gives detailed information deleted cases. Caution: function delete data original CSV Excel files!","code":"# First, check some row numbers nrow(otree$all_apps_wide) ## [1] 8 nrow(otree$survey) ## [1] 8 nrow(otree$Time) ## [1] 77 nrow(otree$Chats) ## [1] 6 # Delete all cases that didn't end the experiment on the page \"Demographics\" # within the app \"survey\" otree2 <- delete_dropouts(otree,                          final_apps = \"survey\",                          final_pages = \"Demographics\",                          info = TRUE) ## 4 case(s) deleted ## Dropouts are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary!  # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 66 nrow(otree2$Chats) ## [1] 6 head(otree2$info$deleted_cases$full) ##   participant.code session.code  end_app        end_page ## 1         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 2         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 3         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 4         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 5         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6         dhgisush     2wlrl5kb dictator           Offer ##                           reason ## 1        ENC. Noticed at: survey ## 2         ENC. Noticed at: start ## 3      ENC. Noticed at: dictator ## 4       ENC. Noticed at: chatapp ## 5 ENC. Noticed at: all_apps_wide ## 6        ENC. Noticed at: survey  otree2$info$deleted_cases$unique ##    participant.code session.code  end_app        end_page reason ## 1          1k58kgm7     jk9ekpl0 dictator ResultsWaitPage    ENC ## 6          dhgisush     2wlrl5kb dictator           Offer    ENC ## 11         j2g9mcaf     jk9ekpl0 dictator    Introduction    ENC ## 16         p6m495xi     2wlrl5kb dictator    Introduction    ENC  otree2$info$deleted_cases$all_end ##            ##            Demographics Introduction Offer ResultsWaitPage ##   dictator            0            2     1               1 ##   survey              4            0     0               0"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_cases","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_cases()","title":"Introduction to gmoTree","text":"Sometimes, participants ask data deleted. delete_cases() function can delete person app’s data frame, $all_apps_wide, $Time data frame. , data $Chats data frame must deleted hand. function adds information deleted cases previously created information deleted cases. Caution: function delete data original CSV Excel files!","code":"# First, check some row numbers nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 66 nrow(otree2$Chats) ## [1] 6 # Delete one participant person <- otree2$all_apps_wide$participant.code[1] otree2 <- delete_cases(otree2,                        pcodes = person,                        reason = \"requested\",                        saved_vars = \"participant._index_in_pages\",                        info = TRUE) ## 1 case(s) deleted. Cases are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary! # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 3 nrow(otree2$survey) ## [1] 3 nrow(otree2$Time) ## [1] 48 nrow(otree2$Chats) ## [1] 6 # Check for all deleted cases (also dropouts): tail(otree2$info$deleted_cases$full) ##    participant.code session.code  end_app     end_page ## 16         p6m495xi     2wlrl5kb dictator Introduction ## 17         p6m495xi     2wlrl5kb dictator Introduction ## 18         p6m495xi     2wlrl5kb dictator Introduction ## 19         p6m495xi     2wlrl5kb dictator Introduction ## 20         p6m495xi     2wlrl5kb dictator Introduction ## 21         sdh9ar2m         <NA>                       ##                            reason  session participant._index_in_pages ## 16        ENC. Noticed at: survey     <NA>                          NA ## 17         ENC. Noticed at: start     <NA>                          NA ## 18      ENC. Noticed at: dictator     <NA>                          NA ## 19       ENC. Noticed at: chatapp     <NA>                          NA ## 20 ENC. Noticed at: all_apps_wide     <NA>                          NA ## 21                      requested jk9ekpl0                          18"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_sessions","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_sessions()","title":"Introduction to gmoTree","text":"certainly hope never becomes necessary, may instances entire session needs removed data set due unforeseen issues. However, occurs, can use function delete_sessions(). function removes sessions’ data apps, $all_apps_wide, $Time data frame also sessions’ chat data $Chats data frame chatting usually restricted within session. following, see row numbers deletion, application function, row numbers deletion. Apart functions, sessions’ entries $Chats data frame destroyed since chat data occurs just per session may thus eliminated without impacting comprehensibility chat data.","code":"# First, check some row numbers nrow(otree2$all_apps_wide) ## [1] 3 nrow(otree2$survey) ## [1] 3 nrow(otree2$Time) ## [1] 48 nrow(otree2$Chats) ## [1] 6 # Delete one session otree2 <- delete_sessions(otree,   scodes = \"jk9ekpl0\",   reason = \"Only tests\",   info = TRUE) ## 4 case(s) deleted # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 38 nrow(otree2$Chats) ## [1] 3"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_pabels","dir":"Articles","previous_headings":"Deleting sensitive information","what":"delete_pabels()","title":"Introduction to gmoTree","text":"uncommon participant.label variable contain sensitive information like MTurk worker ID. can raise serious privacy concerns. function delete_plabels() automatically removes variable data frames. Additionally, function option delete MTurk-related variables. following, see application delete_plabels() function, preceded information sensitive variables running function followed information sensitive variables running function. Caution: function delete variable original CSV Excel files!","code":"# Check variables head(otree2$all_apps_wide$participant.label) ## [1] \"\"        \"\"        \"Person1\" \"Person2\" head(otree2$all_apps_wide$participant.mturk_worker_id) ## [1] NA NA NA NA head(otree2$survey$participant.label) ## [1] \"\"        \"\"        \"Person1\" \"Person2\"  # Delete all participant labels otree2 <- delete_plabels(otree2, del_mturk = TRUE)  # Check variables head(otree2$all_apps_wide$participant.label) ## NULL head(otree2$all_apps_wide$participant.mturk_worker_id) ## NULL head(otree2$survey$participant.label) ## NULL"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"make_ids","dir":"Articles","previous_headings":"Making IDs","what":"make_ids()","title":"Introduction to gmoTree","text":"working oTree, participant codes, session codes, group IDs used identify cases. However, often, researchers prefer streamlined, consecutive numbering system spans sessions, beginning first participant, session, group concluding last. make_ids() function provides way achieve goal. using function, let us inspect underlying variables first. function returns following variables. prior example, Group IDs calculated group IDs must called specifically. Since group IDs per app data match (groups relevant dictator app), just using group_id = TRUE lead error message. cases group IDs vary among apps, can specified make_ids() app variable used extracting group information. instance, following syntax can used obtain group IDs variable dictator.1.group.id_in_subsession $all_apps_wide.","code":"# Check variables first otree2$all_apps_wide$participant.code ## [1] \"dhgisush\" \"p6m495xi\" \"c9inx5wl\" \"kr8yd7f3\" otree2$all_apps_wide$session.code ## [1] \"2wlrl5kb\" \"2wlrl5kb\" \"mz2r27bk\" \"mz2r27bk\" otree2$all_apps_wide$dictator.1.group.id_in_subsession ## [1] 1 1 1 1 # Make session IDs only otree2 <- make_ids(otree2) # Check variables otree2$all_apps_wide$participant_id ## [1] 1 2 3 4 otree2$all_apps_wide$session_id ## [1] 1 1 2 2 # Get IDs from \"from_variable\" in the data frame \"all_apps_wide\" otree2 <- make_ids(otree2,                    # gmake = TRUE,  # Not necessary if from_var is not NULL                    from_var = \"dictator.1.group.id_in_subsession\") ## Warning in make_ids(otree2, from_var = \"dictator.1.group.id_in_subsession\"): ## The group variable values are constant. Group IDs now correspond to session ## IDs. # Check variables otree2$all_apps_wide$participant_id ## [1] 1 2 3 4 otree2$all_apps_wide$group_id ## [1] 1 1 2 2 otree2$all_apps_wide$session_id ## [1] 1 1 2 2"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"apptime","dir":"Articles","previous_headings":"Measuring the time","what":"apptime()","title":"Introduction to gmoTree","text":"need determine much time participants spent specific app, apptime() function powerful tool can help. function calculates summary statistics mean, minimum, maximum time spent page, well detailed list durations participant app. following example shows much time participants spent app “survey” minutes. can also get time specific participants . Without specifying applications, get duration applications individually.","code":"# Calculate the time all participants spent on app \"survey\" apptime(otree2, apps = \"survey\", digits = 3) ## $mean_duration ## [1] 0.242 ##  ## $min_duration ## [1] 0.233 ##  ## $max_duration ## [1] 0.25 ##  ## $single_durations ##   participant  session duration ## 1    c9inx5wl mz2r27bk    0.250 ## 2    kr8yd7f3 mz2r27bk    0.233 ##  ## $messages ## [1] \"For some participants, no duration could be calculated. See list in $warnings.\" ##  ## $warnings ## [1] \"dhgisush\" \"p6m495xi\" # Calculate the time one participant spent on app \"dictator\" apptime(otree2, pcode = \"c9inx5wl\", digits = 3) ## $chatapp ## [1] 0.267 ##  ## $dictator ## [1] 0.5 ##  ## $start ## [1] 0.017 ##  ## $survey ## [1] 0.25"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"extime","dir":"Articles","previous_headings":"Measuring the time","what":"extime()","title":"Introduction to gmoTree","text":"need determine much time participants spent complete experiment, can use extime() function. function calculates summary statistics mean, minimum, maximum time spent experiment, well detailed list durations participant. (Note min, max, mean values two digits underlying data.) can also get duration just one participant.","code":"# Calculate the time that all participants spent on the experiment extime(otree2, digits = 3) ## $mean_duration ## [1] 0.525 ##  ## $min_duration ## [1] 0.05 ##  ## $max_duration ## [1] 1.033 ##  ## $single_durations ##   participant  session duration ## 2    p6m495xi 2wlrl5kb    0.050 ## 1    dhgisush 2wlrl5kb    0.117 ## 4    kr8yd7f3 mz2r27bk    0.900 ## 3    c9inx5wl mz2r27bk    1.033 # Calculate the time one participant spent on the experiment extime(otree2, pcode = \"c9inx5wl\", digits = 3) ## [1] 1.033"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"pagesec","dir":"Articles","previous_headings":"Measuring the time","what":"pagesec()","title":"Introduction to gmoTree","text":"older versions oTree included variable called seconds_on_page $Time data frame. Although good reason omit , sometimes want detailed information time spent one page. Therefore, created function pagesec() adds new variable seconds_on_page2 $Time data frame.","code":"# Create two new columns: seconds_on_page2 and minutes_on_page otree2 <- pagesec(otree2, rounded = TRUE, minutes = TRUE) tail(otree2$Time) ##    timeout_happened is_wait_page group_id session_id participant_id ## 72                0            0        2          2              3 ## 73                0            0        2          2              4 ## 74                0            0        2          2              4 ## 75                0            0        2          2              3 ## 76                0            0        2          2              4 ## 77                0            0        2          2              3 ##    session_code participant_id_in_session participant_code page_index app_name ## 72     mz2r27bk                         1         c9inx5wl         15   survey ## 73     mz2r27bk                         2         kr8yd7f3         15   survey ## 74     mz2r27bk                         2         kr8yd7f3         16   survey ## 75     mz2r27bk                         1         c9inx5wl         16   survey ## 76     mz2r27bk                         2         kr8yd7f3         17   survey ## 77     mz2r27bk                         1         c9inx5wl         17   survey ##                  page_name epoch_time_completed round_number minutes_on_page ## 72 CognitiveReflectionTest           1684258104            1            0.05 ## 73 CognitiveReflectionTest           1684258108            1            0.13 ## 74                   Offer           1684258109            1            0.02 ## 75                   Offer           1684258110            1            0.10 ## 76            Demographics           1684258114            1            0.08 ## 77            Demographics           1684258116            1            0.10"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"assignv","dir":"Articles","previous_headings":"Transferring variables between the apps","what":"assignv()","title":"Introduction to gmoTree","text":"function assignv() copies variable $all_apps_wide data frame data frames apps. following example, variable survey.1.player.gender copied $all_apps_wide app data frames; data frames, new variable named gender. also copies variable $all_apps_wide keep degree consistency.","code":"# Assign variable \"survey.1.player.gender\" and name it \"gender\" otree2 <- assignv(oTree = otree2,                  variable = \"survey.1.player.gender\",                  newvar = \"gender\") # Control otree2$dictator$gender ##  [1] \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       \"Female\" \"Male\"   ##  [9] \"Female\" \"Male\"   \"Female\" \"Male\" otree2$chatapp$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" # In app \"survey\", the variable is now twice because it is taken from here otree2$survey$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" otree2$survey$player.gender ## [1] \"\"       \"\"       \"Female\" \"Male\" # In app \"all_apps_wide,\" the variable is also there twice # (This can be avoided by calling the new variable the same # as the old variable) otree2$all_apps_wide$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" otree2$all_apps_wide$survey.1.player.gender ## [1] \"\"       \"\"       \"Female\" \"Male\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"assignv_to_aaw","dir":"Articles","previous_headings":"Transferring variables between the apps","what":"assignv_to_aaw()","title":"Introduction to gmoTree","text":"function assignv_to_aaw() copies variable one data frames $all_apps_wide data frame. following example, variable $survey data frame copied $all_apps_wide placed directly variable survey.1.player.age.","code":"# Create a new variable otree2$survey$younger30 <- ifelse(otree2$survey$player.age < 30, 1, 0)  # Get variable younger30 from survey to all_apps_wide # and put the new variable right behind the old age variable otree2 <- assignv_to_aaw(otree2,                         app = \"survey\",                         variable = \"younger30\",                         newvar = \"younger30\",                         resafter = \"survey.1.player.age\")  # Control otree2$all_apps_wide$survey.1.player.age ## [1] NA NA 66 33  # Check the position of the old age variable and the new variable match(\"survey.1.player.age\", colnames(otree2$all_apps_wide)) ## [1] 52 match(\"younger30\", colnames(otree2$all_apps_wide)) ## [1] 53"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"show_constant","dir":"Articles","previous_headings":"Before running the experiment","what":"show_constant()","title":"Introduction to gmoTree","text":"program experiments, frequently add variables turn useless later. forget remove , especially experiments numerous rounds, data frame becomes unreasonably huge. function show_constant(), may identify variables variation remove experiment. following example, variable named constant created, vary. function show_constant() shows us many variables also unchanging; however, delete oTree internal. Yet, prevent unreasonably large data frame, remove variable constant running experiment.","code":"# Make a constant column (this variable is usually created in oTree) otree2$dictator$constant <- 3  # Show all columns that contain columns containing only one specified value show_constant(oTree = otree2) ## $all_apps_wide ##  [1] \"participant._is_bot\"                          ##  [2] \"participant._max_page_index\"                  ##  [3] \"participant.visited\"                          ##  [4] \"session.label\"                                ##  [5] \"session.comment\"                              ##  [6] \"session.config.real_world_currency_per_point\" ##  [7] \"session.config.name\"                          ##  [8] \"session.config.participation_fee\"             ##  [9] \"start.1.player.role\"                          ## [10] \"start.1.player.payoff\"                        ## [11] \"start.1.group.id_in_subsession\"               ## [12] \"start.1.subsession.round_number\"              ## [13] \"dictator.1.player.role\"                       ## [14] \"dictator.1.group.id_in_subsession\"            ## [15] \"dictator.1.subsession.round_number\"           ## [16] \"dictator.2.player.role\"                       ## [17] \"dictator.2.group.id_in_subsession\"            ## [18] \"dictator.2.subsession.round_number\"           ## [19] \"dictator.3.player.role\"                       ## [20] \"dictator.3.group.id_in_subsession\"            ## [21] \"dictator.3.subsession.round_number\"           ## [22] \"chatapp.1.player.role\"                        ## [23] \"chatapp.1.player.payoff\"                      ## [24] \"chatapp.1.group.id_in_subsession\"             ## [25] \"chatapp.1.subsession.round_number\"            ## [26] \"survey.1.player.role\"                         ## [27] \"survey.1.player.payoff\"                       ## [28] \"survey.1.group.id_in_subsession\"              ## [29] \"survey.1.subsession.round_number\"             ##  ## $chatapp ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $dictator ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"group.id_in_subsession\"      ## [7] \"session.label\"               \"constant\"                    ##  ## $start ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $survey ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $Time ## character(0) ##  ## $Chats ## [1] \"group_id\"     \"session_id\"   \"session_code\" \"channel\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"codebook","dir":"Articles","previous_headings":"Before running the experiment","what":"codebook()","title":"Introduction to gmoTree","text":"Thorough documentation experiment essential. detailed guidance generating codebook oTree code, refer vignette gmoTree Codebooks. recommend creating codebook running experiment, can help identify incomplete documentation potential issues within code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"references","dir":"Articles","previous_headings":"","what":"References","title":"Introduction to gmoTree","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":"https://zauchnerp.github.io/gmoTree/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Patricia F. Zauchner. Author, translator, maintainer, copyright holder.            University Bremen","code":""},{"path":"https://zauchnerp.github.io/gmoTree/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.0, <https://CRAN.R-project.org/package=gmoTree/>.","code":"@Manual{,   title = {gmoTree: oTree Data Manipulation Tool},   author = {Patricia F. Zauchner},   year = {2024},   note = {R package version 1.3.0},   url = {https://CRAN.R-project.org/package=gmoTree}, }"},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":null,"dir":"","previous_headings":"","what":"Site notice","title":"Site notice","text":"website published Patricia Zauchner Universität Bremen SOCIUM Forschungszentrum Ungleichheit und Sozialpolitik Unicom-Gebäude Raum: 7.4460 Mary-Somerville-Straße 7 28359 Bremen Deutschland Telephone: +49 421 218-58555 E-Mail: patricia.zauchner [] uni-bremen.de Patricia Zauchner also responsible content accordance 55 Abs. 2 RStV.","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":"accountability-for-content","dir":"","previous_headings":"Disclaimer","what":"Accountability for content","title":"Site notice","text":"contents pages created utmost care. However, guarantee contents’ accuracy, completeness topicality. According statutory provisions, furthermore responsible content web pages. context, please note accordingly obliged monitor merely transmitted saved information third parties, investigate circumstances pointing illegal activity. obligations remove block use information generally applicable laws remain unaffected per §§ 8 10 Telemedia Act (TMG).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":"accountability-for-links","dir":"","previous_headings":"Disclaimer","what":"Accountability for links","title":"Site notice","text":"Responsibility content external links (web pages third parties) lies solely operators linked pages. violations evident time linking. legal infringement become known us, remove respective link immediately.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"gmotree--get-and-modify-otree-data","dir":"","previous_headings":"","what":"Get and Modify oTree Data","title":"Get and Modify oTree Data","text":"gmoTree R package developed importing, merging, efficiently managing data obtained running oTree (Chen et al., 2016) experiments. ’s particularly valuable dealing complex experimental designs span multiple sessions generate large number files need integrated.1","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Get and Modify oTree Data","text":"install CRAN version package, use following command: install.packages(\"gmoTree\") install development version: devtools::install_github(\"ZauchnerP/gmoTree\")","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"list-of-all-functions","dir":"","previous_headings":"","what":"List of all functions","title":"Get and Modify oTree Data","text":"See page Introduction gmoTree detailed overview functions. details package whole, visit  gmoTree website.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"importing-data","dir":"","previous_headings":"","what":"Importing data","title":"Get and Modify oTree Data","text":"import_otree(): Imports oTree data combines list data frames.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"cleaning-up-data","dir":"","previous_headings":"","what":"Cleaning up data","title":"Get and Modify oTree Data","text":"messy_chat(): Checks messy Chats data frame combines variables refer concept. messy_chat(): Checks messy Time data frame combines variables refer concept. delete_duplicate(): Deletes duplicate rows data frames oTree list.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"dealing-with-dropouts-and-deleting-cases","dir":"","previous_headings":"","what":"Dealing with dropouts and deleting cases","title":"Get and Modify oTree Data","text":"show_dropouts(): Shows participant codes people finish () certain app(s) page(s). delete_dropouts(): Deletes data participants finish () certain app(s) page(s). function deletes participants’ data data frames oTree list. Caution: delete cases original CSV Excel files! delete_cases(): Deletes data specified participants data frames oTree list. Caution: function delete data original CSV Excel files! delete_sessions(): Deletes data specified sessions data frames oTree list. Caution: function delete data original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"deleting-sensitive-information","dir":"","previous_headings":"","what":"Deleting sensitive information","title":"Get and Modify oTree Data","text":"delete_plabels(): Deletes variable participant.label every app might contain identifiable information participants, MTurk ID. Caution: function delete variable original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"making-ids","dir":"","previous_headings":"","what":"Making IDs","title":"Get and Modify oTree Data","text":"make_ids(): Makes participant, group, session IDs across apps.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"measuring-time","dir":"","previous_headings":"","what":"Measuring time","title":"Get and Modify oTree Data","text":"apptime(): Calculates time spent specific app. extime(): Calculates time spent experiment. pagesec(): Calculates time spent page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"transferring-variables-between-the-apps","dir":"","previous_headings":"","what":"Transferring variables between the apps","title":"Get and Modify oTree Data","text":"assignv(): Copies variable all_apps_wide data frame data frames apps. assignv_to_aaw(): Copies variable one data frames all_apps_wide data frame.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"before-running-the-experiment","dir":"","previous_headings":"","what":"Before running the experiment","title":"Get and Modify oTree Data","text":"show_constant(): Shows constant variables. codebook(): Creates codebook based oTree code. See also vignette “gmoTree Codebooks.”","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"references","dir":"","previous_headings":"","what":"References","title":"Get and Modify oTree Data","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the time that was spent on an app — apptime","title":"Calculate the time that was spent on an app — apptime","text":"Calculate time spent one app several apps.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the time that was spent on an app — apptime","text":"","code":"apptime(   oTree,   apps = NULL,   pcode = NULL,   plabel = NULL,   group_id = NULL,   seconds = FALSE,   rounded = TRUE,   digits = 2,   sinfo = \"session_code\",   combine = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the time that was spent on an app — apptime","text":"oTree list data frames created import_otree apps Character. Name(s) app(s) time calculated. pcode Character. value participant.code variable time calculated one specified participant. plabel Character. value participant.label variable time calculated one specified participant. group_id Integer. value group_id variable time calculated one specified group. group_id variable can created make_ids. seconds Logical. TRUE output seconds instead minutes. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. sinfo Character. \"session_id\" use session ID additional information data frame single durations, \"session_code\" use session codes, NULL session column shown. combine Logical. TRUE variables relating epoch time merged, variables relating participant code merged data multiple versions oTree used.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the time that was spent on an app — apptime","text":"function returns list app containing information mean, minimum, maximum time participants spent app, data frame information time participant spent app, eventually, vectors relevant background information numbers. experiment's duration calculated one participant, output returns NA (per app) person make app(s).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the time that was spent on an app — apptime","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show how much time all participants spent on app \"survey\" apptime(oTree, apps = \"survey\") #> $mean_duration #> [1] 0.28 #>  #> $min_duration #> [1] 0.08 #>  #> $max_duration #> [1] 1.13 #>  #> $single_durations #>    participant  session duration #> 1     46kxib6w 7bfqtokx     1.13 #> 2     iay3dhkn 7bfqtokx     0.22 #> 3     4zhzdmzo 7bfqtokx     0.15 #> 4     3ttf7yix 7bfqtokx     0.42 #> 5     2d72mfgh 7bfqtokx     0.13 #> 6     rvce7958 7bfqtokx     0.22 #> 7     lsl3vbij 7bfqtokx     0.13 #> 8     xx78b3x0 vd1h01iv     0.17 #> 9     xmxl46rm vd1h01iv     0.15 #> 10    iagvtslv t0rog7nz     0.15 #> 11    jxh15obl t0rog7nz     0.08 #> 12    a7dppel1 t0rog7nz     0.23 #> 13    wk247s9w t0rog7nz     0.73 #> 14    xkobdvuh t0rog7nz     0.40 #> 15    1l5kal0r t0rog7nz     0.13 #> 16    7l0hmpcq qyu3qg0q     0.15 #> 17    ia9rnfvc qyu3qg0q     0.15 #>  #> $messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>   # Show how much time the participant \"a7dppel1\" spent on # the app \"survey\" apptime(oTree, pcode = \"a7dppel1\", apps = \"survey\") #> [1] 0.23  # Show how much time the participants in group 4 spent on # the app \"survey\" oTree <- make_ids(oTree,     gmake = TRUE,     from_var = \"dictator.1.group.id_in_subsession\" ) apptime(oTree, group_id = 4, apps = \"survey\") #> $mean_duration #> [1] 0.13 #>  #> $min_duration #> [1] 0.13 #>  #> $max_duration #> [1] 0.13 #>  #> $single_durations #>   participant  session duration #> 1    lsl3vbij 7bfqtokx     0.13 #>  #> $messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $warnings #> [1] \"164r1hs4\" #>   # Show how much time all participants spent on all apps apptime(oTree) #> $chatapp #> $chatapp$mean_duration #> [1] 0.65 #>  #> $chatapp$min_duration #> [1] 0.02 #>  #> $chatapp$max_duration #> [1] 1.87 #>  #> $chatapp$single_durations #>    participant  session duration #> 10    iagvtslv t0rog7nz     0.02 #> 11    jxh15obl t0rog7nz     0.07 #> 8     xx78b3x0 vd1h01iv     0.20 #> 16    7l0hmpcq qyu3qg0q     0.20 #> 9     xmxl46rm vd1h01iv     0.45 #> 17    ia9rnfvc qyu3qg0q     0.55 #> 4     3ttf7yix 7bfqtokx     0.57 #> 13    wk247s9w t0rog7nz     0.57 #> 12    a7dppel1 t0rog7nz     0.58 #> 7     lsl3vbij 7bfqtokx     0.60 #> 1     46kxib6w 7bfqtokx     0.62 #> 3     4zhzdmzo 7bfqtokx     0.77 #> 5     2d72mfgh 7bfqtokx     0.77 #> 14    xkobdvuh t0rog7nz     1.07 #> 6     rvce7958 7bfqtokx     1.08 #> 15    1l5kal0r t0rog7nz     1.10 #> 2     iay3dhkn 7bfqtokx     1.87 #>  #> $chatapp$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $chatapp$warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>  #>  #> $dictator #> $dictator$mean_duration #> [1] 2.05 #>  #> $dictator$min_duration #> [1] 0.4 #>  #> $dictator$max_duration #> [1] 5.95 #>  #> $dictator$single_durations #>    participant  session duration #> 12    vbhvhozv vd1h01iv     0.40 #> 13    2scvem7a vd1h01iv     0.43 #> 20    7l0hmpcq qyu3qg0q     0.43 #> 2     iay3dhkn 7bfqtokx     0.47 #> 21    ia9rnfvc qyu3qg0q     0.50 #> 1     46kxib6w 7bfqtokx     0.57 #> 11    xmxl46rm vd1h01iv     0.65 #> 10    xx78b3x0 vd1h01iv     0.72 #> 18    xkobdvuh t0rog7nz     0.90 #> 19    1l5kal0r t0rog7nz     0.95 #> 16    a7dppel1 t0rog7nz     1.17 #> 17    wk247s9w t0rog7nz     1.20 #> 15    jxh15obl t0rog7nz     1.58 #> 14    iagvtslv t0rog7nz     2.65 #> 9     ktjz5jli 7bfqtokx     2.88 #> 8     lsl3vbij 7bfqtokx     3.45 #> 7     164r1hs4 7bfqtokx     3.53 #> 6     rvce7958 7bfqtokx     4.37 #> 5     2d72mfgh 7bfqtokx     4.48 #> 3     4zhzdmzo 7bfqtokx     5.87 #> 4     3ttf7yix 7bfqtokx     5.95 #>  #> $dictator$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $dictator$warnings #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>  #>  #> $survey #> $survey$mean_duration #> [1] 0.28 #>  #> $survey$min_duration #> [1] 0.08 #>  #> $survey$max_duration #> [1] 1.13 #>  #> $survey$single_durations #>    participant  session duration #> 11    jxh15obl t0rog7nz     0.08 #> 5     2d72mfgh 7bfqtokx     0.13 #> 7     lsl3vbij 7bfqtokx     0.13 #> 15    1l5kal0r t0rog7nz     0.13 #> 3     4zhzdmzo 7bfqtokx     0.15 #> 9     xmxl46rm vd1h01iv     0.15 #> 10    iagvtslv t0rog7nz     0.15 #> 16    7l0hmpcq qyu3qg0q     0.15 #> 17    ia9rnfvc qyu3qg0q     0.15 #> 8     xx78b3x0 vd1h01iv     0.17 #> 2     iay3dhkn 7bfqtokx     0.22 #> 6     rvce7958 7bfqtokx     0.22 #> 12    a7dppel1 t0rog7nz     0.23 #> 14    xkobdvuh t0rog7nz     0.40 #> 4     3ttf7yix 7bfqtokx     0.42 #> 13    wk247s9w t0rog7nz     0.73 #> 1     46kxib6w 7bfqtokx     1.13 #>  #> $survey$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $survey$warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>  #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign a variable from all_apps_wide — assignv","title":"Assign a variable from all_apps_wide — assignv","text":"Assign variable $all_apps_wide app data frames.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign a variable from all_apps_wide — assignv","text":"","code":"assignv(oTree, variable, newvar)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign a variable from all_apps_wide — assignv","text":"oTree list data frames created import_otree variable Character. variable $all_apps_wide data frame assigned apps. newvar Character. name newly created variable.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign a variable from all_apps_wide — assignv","text":"function returns duplicate original oTree list data frames additional column data frames. additional column contains data specified variable found $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assign a variable from all_apps_wide — assignv","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Assign variable \"survey.1.player.gender\" and name it \"gender\" oTree <- assignv(oTree = oTree,                  variable = \"survey.1.player.gender\",                  newvar = \"gender\")  # Show the new variable in some of the other app data frames oTree$dictator$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       #> [17] \"Male\"   \"\"       \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   #> [25] \"\"       \"Male\"   \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Female\" #> [33] \"Female\" \"\"       \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   #> [41] \"\"       \"Female\" \"Female\" \"Female\" \"Male\"   \"Male\"   \"\"       \"Female\" #> [49] \"Female\" \"Female\" \"Male\"   \"Male\"   \"\"       \"Female\" \"Female\" \"Female\" #> [57] \"Male\"   \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       #> [65] \"\"       \"\"       \"\"       \"\"       \"\"       \"Female\" \"Female\" \"Female\" #> [73] \"Female\" \"Female\" \"Female\" oTree$chatapp$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\"  # The variable is now duplicated in app \"survey\" because it is obtained from # there (This can be avoided by naming the new variable the same as the old # variable) oTree$survey$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" oTree$survey$player.gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\"  # In app \"all_apps_wide,\" the variable is also there twice (This can be # avoided by naming the new variable the same as the old variable) oTree$all_apps_wide$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" \"Female\" \"Female\" \"Female\" \"Male\"   oTree$all_apps_wide$survey.1.player.gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" \"Female\" \"Female\" \"Female\" \"Male\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign a variable to all_apps_wide — assignv_to_aaw","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"Assign variable one app data frames $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"","code":"assignv_to_aaw(oTree, app, variable, newvar, resafter = NULL)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"oTree list data frames created import_otree. app Character. data frame variable taken. variable Character. name variable assigned $all_apps_wide. newvar Character. name newly created variable $all_apps_wide data frame. resafter Character. name variable precedes new variable. NULL, new variable placed end data frame.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"function returns duplicate original oTree list data frames additional column $all_apps_wide data frame contains variable question.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Check out the old variable  oTree$survey$player.age #>  [1] 22 22 23 23 33 45 NA 44 NA 33 23 NA NA 23 NA 44 21 23 23 NA NA NA NA 34 20  # Create a new variable oTree$survey$younger30 <- ifelse(oTree$survey$player.age < 30, 1, 0)  # Assign the variable younger30 to all_apps_wide oTree2 <- assignv_to_aaw(   oTree = oTree,   app = \"survey\",   variable = \"younger30\",   newvar = \"younger30\") #> Warning: New variable is created. However, there is an unequal number of participants in \"all_apps_wide\" (29) and app \"survey\" (25). Did you forget to delete dropouts and empty cases or did you forget to import app data? Sometimes, this can happen if you import data from within a session or room where you can only import \"all_apps_wide\" but not the separate app data, time data or chat data.  # Show the new variable in the all_apps_wide data frame oTree2$all_apps_wide$younger30 #>  [1]  1  1  1  1  0  0 NA  0 NA  0  1 NA NA  1 NA  0  1  1  1 NA NA NA NA  0  1 #> [26] NA NA NA NA  # Check the position of the new variable match(\"younger30\",names(oTree2$all_apps_wide)) #> [1] 56  # Place the new variable immediately after the \"survey.1.player.age\" variable oTree2 <- assignv_to_aaw(oTree,                         app = \"survey\",                         variable = \"younger30\",                         newvar = \"younger30\",                         resafter = \"survey.1.player.age\") #> Warning: New variable is created. However, there is an unequal number of participants in \"all_apps_wide\" (29) and app \"survey\" (25). Did you forget to delete dropouts and empty cases or did you forget to import app data? Sometimes, this can happen if you import data from within a session or room where you can only import \"all_apps_wide\" but not the separate app data, time data or chat data.  # Show the new variable in the all_apps_wide data frame oTree2$all_apps_wide$younger30 #>  [1]  1  1  1  1  0  0 NA  0 NA  0  1 NA NA  1 NA  0  1  1  1 NA NA NA NA  0  1 #> [26] NA NA NA NA  # Show the position of the new variable match(\"younger30\", names(oTree2$all_apps_wide)) #> [1] 50"},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a codebook for the oTree code — codebook","title":"Create a codebook for the oTree code — codebook","text":"Create codebook oTree code automatically scanning project folder retrieving variables' information.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a codebook for the oTree code — codebook","text":"","code":"codebook(   path = \".\",   fsource = \"init\",   output = \"both\",   output_dir = NULL,   output_file = \"codebook\",   output_format = \"pdf_document_simple\",   output_open = TRUE,   app_doc = TRUE,   app = NULL,   app_rm = NULL,   doc_info = TRUE,   sort = NULL,   settings_replace = \"global\",   user_settings = NULL,   include_cons = TRUE,   preamb = FALSE,   encoding = \"UTF-8\",   title = \"Codebook\",   subtitle = \"created with gmoTree\",   params = NULL,   date = \"today\",   splitvarname = FALSE,   sep_list = \"newline\",   initial = TRUE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a codebook for the oTree code — codebook","text":"path Character. Path oTree experiment. fsource Character. \"init\" information taken init.py files (newer oTree code 5.x format). \"models\" (\"model\") information taken models.py files (older oTree code 3.x format). output Character. \"list\" output contain list variables information. \"file\" output file Word PDF file. \"\" output contain file list. output_dir Character. absolute path function's output saved. absolute paths allowed parameter. Relative paths can specified output_file parameter. output_file Character. name output file generated function. file name can provided without extension. Relative paths also allowed file name. output_format Character. Specifies format file output. value passed output_format argument rmarkdown::render. Allowed options : \"html_document\", \"word_document\",  \"odt_document\", \"rtf_document\", \"md_document\",  \"latex_document\", \"pdf_document\", \"pdf_document_simple\", short forms \"html\", \"word\", \"odt\",  \"rtf\", \"md\", \"latex\", \"pdf\", \"pdf_simple\". Important: \"pdf_document\" format uses xelatex PDF generation. document require advanced LaTeX features, recommended use \"pdf_document_simple\". output_open Logical. TRUE file output opened creation. app_doc Logical. TRUE app documentation included output file. app Character. Name included app(s). Default use apps. used simultaneously app_rm. app_rm Character. Name excluded app(s). Default exclude apps. used simultaneously app. doc_info Logical. TRUE message information variables without documentation also returned. FALSE message suppressed. sort Character vector. Vector specifies order apps codebook. settings_replace Character NULL. Specifies handle references settings variables. Use \"global\" replace references global settings variables defined settings.py. Use \"user\" replace references variables provided user_settings argument. Use NULL leave references settings variables unchanged. Caution: function use variables defined SESSION_CONFIGS. vary settings variables SESSION_CONFIGS, set settings_replace \"user\" manually replace using user_settings argument. user_settings List. List variables settings.py file used replace setting variable references. used settings_replace = \"user\" used setting variables defined within SESSION_CONFIGS. include_cons Logical. TRUE section constants codebook. preamb Logical. TRUE preamble printed explains oTree saves variables. encoding Character. Encoding created Markdown file. knitr::knit, argument always assumed UTF-8 ignored. title Character. Title output file. subtitle Character. Subtitle output file. params List. List variable name value pairs passed RmD file. relevant argument output \"file\" \"\" chosen. date Character NULL. Date passed Rmd file. Either \"today\", NULL, user defined date. relevant argument output \"file\" \"\" chosen. splitvarname Logical. TRUE long variable names split across multiple lines output file tables. FALSE, table columns adjust fit longest variable names. sep_list Character. Determines sub-lists displayed file output. Use \"newline\" separate sub-lists newline characters (`\\n`), \"vector\" display strings `c(...)` format. initial Logical. TRUE initial values included output file. FALSE included.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a codebook for the oTree code — codebook","text":"function returns two main types outputs: () list variables along information (b) file containing codebook experiment doc_info TRUE also returns message containing names variables documentation.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create a codebook for the oTree code — codebook","text":"code works dictionaries used (example session configurations settings.py). Caution 1: Multiline comments ignored, meaning variables commented manner nevertheless included codebook. contrast, variables commented line comments appear codebook. Caution 2: commas value strings, might used split text. Please manually insert backslash symbol front commas avoid (.e., escape ). E.g. \"Yes, \" -> \"Yes\\, \". Caution 3: code interpret variables imported files (example CSV files) special formatting included (e.g., special string formatting Python float(1.4) represent float number). Caution 4: code developed tested basic oTree codes verified compatibility oTree versions later 5.4.0. experience issues newer versions complex code structures, please open issue GitHub. Caution 5: Custom exports part codebook. info: None values presented \"None\" (.e. string) list codebook.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a codebook for the oTree code — codebook","text":"","code":"# The examples use a slightly modified version of the official oTree sample codes.  # Make a codebook and resort the apps combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 16 #>  $ settings            :List of 10 #>  $ bargaining          :List of 4 #>  $ bertrand            :List of 4 #>  $ common_value_auction:List of 4 #>  $ cournot             :List of 4 #>  $ dictator            :List of 4 #>  $ guess_two_thirds    :List of 4 #>  $ matching_pennies    :List of 4 #>  $ payment_info        :List of 4 #>  $ prisoner            :List of 4 #>  $ public_goods_simple :List of 3 #>  $ survey              :List of 3 #>  $ traveler_dilemma    :List of 4 #>  $ trust               :List of 3 #>  $ trust_simple        :List of 3 #>  $ volunteer_dilemma   :List of 4 str(combined_codebook$bargaining$Player, 1) #> List of 4 #>  $ request:List of 6 #>  $ level2 :List of 3 #>  $ level3 :List of 3 #>  $ level  :List of 3  # Make a codebook with only the \"bargaining\" app combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   app = \"bargaining\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 2 #>  $ settings  :List of 10 #>  $ bargaining:List of 4 str(combined_codebook$bargaining$Player, 1) #> List of 4 #>  $ request:List of 6 #>  $ level2 :List of 3 #>  $ level3 :List of 3 #>  $ level  :List of 3  # Make a codebook with all but the \"bargaining\" app combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   app_rm = \"bargaining\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 15 #>  $ settings            :List of 10 #>  $ bertrand            :List of 4 #>  $ common_value_auction:List of 4 #>  $ cournot             :List of 4 #>  $ dictator            :List of 4 #>  $ guess_two_thirds    :List of 4 #>  $ matching_pennies    :List of 4 #>  $ payment_info        :List of 4 #>  $ prisoner            :List of 4 #>  $ public_goods_simple :List of 3 #>  $ survey              :List of 3 #>  $ traveler_dilemma    :List of 4 #>  $ trust               :List of 3 #>  $ trust_simple        :List of 3 #>  $ volunteer_dilemma   :List of 4 str(combined_codebook$bargaining$Player, 1) #>  NULL  # Use oTree code in 3.x format combined_codebook <- codebook(   path = system.file(\"extdata/ocode_z\", package = \"gmoTree\"),   fsource = \"model\",   output = \"list\",   doc_info = FALSE) #> Warning: Some variables or code parts contain code that is too complex for this function. Hence, this function might have overseen important variables and references to them. Found in: #> > $rankaversion$Constants (read_csv) #> > $rankend$Constants (read_csv) #> > $settings$showupToken (float) #> > $end$Constants$showupToken (float) #> > $end$Constants$showupTokenTest (float)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 4 #>  $ settings    :List of 20 #>  $ end         :List of 4 #>  $ rankaversion:List of 4 #>  $ rankend     :List of 4  # Show information on missing documentation or complex code combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   app_rm = \"bargaining\",   doc_info = TRUE) #> Variables without documentation, label, or verbose name: #> > $bertrand$Group$winning_price #> > $bertrand$Player$is_winner #> > $common_value_auction$Group$highest_bid #> > $cournot$Group$unit_price #> > $dictator$Player$gender #> > $guess_two_thirds$Group$two_thirds_avg #> > $guess_two_thirds$Group$best_guess #> > $guess_two_thirds$Group$num_winners #> > $guess_two_thirds$Player$is_winner #> > $matching_pennies$Player$is_winner #> > $public_goods_simple$Group$total_contribution #> > $public_goods_simple$Group$individual_share #> > $traveler_dilemma$Group$lower_claim #> > $traveler_dilemma$Player$adjustment #> > $volunteer_dilemma$Group$num_volunteers  if (FALSE) { # \\dontrun{  # Create a codebook PDF with authors' names and todays' date codebook(   path = system.file(\"extdata/ocode_z\", package = \"gmoTree\"),   fsource = \"init\",   doc_info = FALSE,   output = \"file\",   output_format = \"pdf_document\",   date = \"today\",   title = \"My Codebook\",   subtitle = \"codebook created with gmoTree\",   params = list(author = c(\"Max Mustermann\", \"John Doe\"))   )  # Create a codebook PDF and save it in a subfolder of the # current folder: # \"C:/Users/pzauchner/Nextcloud/R_analyses/cb/cb.pdf\" getwd() # \"C:/Users/pzauchner/Nextcloud/R_analyses\" dir.create(\"cb\") combined_codebook <- gmoTree::codebook(   path = \"C:/Users/pzauchner/Nextcloud/R_analyses/oTree\",   fsource = \"models\",   output = \"both\",   output_file = \"cb/cb.pdf\",   output_format = \"pdf_document\")  # You can also omit *.pdf after the file name combined_codebook <- gmoTree::codebook(   path = \"C:/Users/pzauchner/Nextcloud/R_analyses/oTree\",   fsource = \"models\",   output = \"both\",   output_file = \"cb/cb\",   output_format = \"pdf_document\") } # }"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete specific cases — delete_cases","title":"Delete specific cases — delete_cases","text":"Delete specific cases data frames oTree list. Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom data frames data frames variable named participant.code! Caution 3: function delete data $Chats data frame! (interpretation chat data depends participants engage , data must deleted care deleting data apps. Hence, function delete data data frame. Please manually necessary!)","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete specific cases — delete_cases","text":"","code":"delete_cases(   oTree,   pcodes = NULL,   plabels = NULL,   saved_vars = NULL,   reason,   omit = FALSE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete specific cases — delete_cases","text":"oTree list data frames created import_otree. pcodes Character. value(s) participant.code variable participants whose data removed. plabels Character. value(s) participant.label variable participants whose data removed. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. reason Character. reason deletion stored list information deleted cases $info$deleted_cases. omit Logical. TRUE deleted cases added information deleted cases $info$deleted_cases. info Logical. TRUE brief information case deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete specific cases — delete_cases","text":"function returns duplicate original oTree list data frames include deleted cases. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $codes = vector participant codes deleted cases. - $count = number participants $codes. - $full $unique = data frames $full $unique contain information deleted participant reason deleted. entries $full $unique data frames . Columns \"end_app\" \"end_page\" left empty intentionally filled delete_dropouts function.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete specific cases — delete_cases","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Delete only one case oTree2 <- delete_cases(oTree,                        pcodes = \"xmxl46rm\",                        reason = \"requested\")  # Show changes in row numbers print(paste(\"Row numbers before deletion: \", nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"Row numbers before deletion:  29 25 289 35\"  print(paste(\"Row numbers after deletion: \", nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"Row numbers after deletion:  28 24 275 35\"  # Delete several cases deletionlist <- c(\"4zhzdmzo\", \"xmxl46rm\") oTree2 <- delete_cases(oTree,                        pcodes = deletionlist,                        reason = \"requested\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Show information on all deleted cases (also dropouts): oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested  # Save one variable oTree2 <- delete_cases(oTree,   pcodes = deletionlist,   reason = \"requested\",   saved_vars = \"participant._index_in_pages\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested #>    participant._index_in_pages #> 3                           17 #> 12                          17  # Save some variables oTree2 <- delete_cases(oTree,   pcodes = deletionlist,   reason = \"requested\",   saved_vars = c(     \"participant._index_in_pages\",     \"participant._max_page_index\"))  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested #>    participant._index_in_pages participant._max_page_index #> 3                           17                          16 #> 12                          17                          16  # Get a list of all deleted cases # (If there is already a list, the new list is added to it) oTree2$info$deleted_cases$codes #> [1] \"4zhzdmzo\" \"xmxl46rm\"  # Show number of all deleted cases length(oTree2$info$deleted_cases$codes) #> [1] 2 oTree2$info$deleted_cases$count #> [1] 2  # Delete a session and delete a single case from another session oTree2 <- delete_sessions(oTree,   scodes = c(\"vd1h01iv\"),   reason = \"Server Crash\",    saved_vars = \"dictator.1.group.id_in_subsession\") oTree2 <- delete_cases(oTree2,                        pcodes = \"4zhzdmzo\",                        reason = \"requested\")                         # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>   participant.code session.code dictator.1.group.id_in_subsession end_app #> 1         xx78b3x0     vd1h01iv                                 1         #> 2         xmxl46rm     vd1h01iv                                 1         #> 3         vbhvhozv     vd1h01iv                                 2         #> 4         2scvem7a     vd1h01iv                                 2         #> 5         4zhzdmzo         <NA>                                NA         #>   end_page       reason  session #> 1          Server Crash     <NA> #> 2          Server Crash     <NA> #> 3          Server Crash     <NA> #> 4          Server Crash     <NA> #> 5             requested 7bfqtokx  # See codes of deleted variables oTree2$info$deleted_cases$codes #> [1] \"4zhzdmzo\" \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" \"2scvem7a\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 5"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete dropouts — delete_dropouts","title":"Delete dropouts — delete_dropouts","text":"Delete data participants end experiment () certain page(s) /app(s). Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom exports variable named participant.code variable named session.code! Caution 3: function delete data $Chats data frame! (interpretation chat data depends participants engage , data must deleted care deleting data apps. Hence, function delete data data frame. Please manually necessary!)","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete dropouts — delete_dropouts","text":"","code":"delete_dropouts(   oTree,   final_apps = NULL,   final_pages = NULL,   saved_vars = NULL,   inconsistent = NULL,   reason = \"ENC\",   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete dropouts — delete_dropouts","text":"oTree list data frames created import_otree final_apps Character. name(s) app(s) participants finish experiment. final_pages Character. name(s) page(s) participants finish experiment. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. inconsistent Character. function continue stopped least one participant inconsistent end_pages, inconsistent end_apps, ? continue, type \"yes\", stop function, type \"\". reason Character. reason deletion stored list information deleted cases $info$deleted_cases. info Logical. TRUE brief information dropout deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete dropouts — delete_dropouts","text":"function returns duplicate original oTree list data frames without deleted cases. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $full = data frame contains information participants finish study; shows participant codes, names apps left experiment, names pages left experiment, names app data frames information found, dropout reason (\"ENC\", experiment completed, combined name data frame dropout observed). participants usually appear multiple app data frames, $info$deleted_cases$full data frame may contain several entries person. - $unique = data frame contains similar information $full data frame one row per participant information data frame dropout observed. - $all_end = table provides information app page combinations participants ended experiment. table also includes information participants drop experiment. $all_end table shown $all_apps_wide data frame exists. - $codes = vector containing participant codes deleted participants. - $count = number deleted participants. important note argument final_pages set, function distinguish page names reoccur different apps. columns end_app end_page output empty, variables saved oTree specific participants. empty rows deleted. can done using argument del_empty = TRUE using import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete dropouts — delete_dropouts","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # First, show some row numbers print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"29 25 289 35\"  # Delete all cases that didn't end the experiment on the page \"Demographics\" # within the app \"survey\" oTree2 <- delete_dropouts(oTree,                          final_apps = c(\"survey\"),                          final_pages = c(\"Demographics\"))  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Delete all cases that didn't end the experiment on the page \"Demographics\" # This page can be in any app oTree2 <- delete_dropouts(oTree, final_pages = \"Demographics\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Delete all cases that didn't end the experiment on # any page in the app \"survey\" oTree <- delete_dropouts(oTree, final_apps = \"survey\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Get list of information on all deleted cases # (If there is already a list, the new list is added to it!) oTree2$info$deleted_cases #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 22         jxh15obl     t0rog7nz   survey           Offer #> 23         jxh15obl     t0rog7nz   survey           Offer #> 24         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 26         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 27         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 28         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 30         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 31         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 32         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #> 34         znri6myc     l8ecm1uh dictator    Introduction #> 35         znri6myc     l8ecm1uh dictator    Introduction #> 36         znri6myc     l8ecm1uh dictator    Introduction #>                            reason #> 1         ENC. Noticed at: survey #> 2  ENC. Noticed at: all_apps_wide #> 3        ENC. Noticed at: chatapp #> 4       ENC. Noticed at: dictator #> 5  ENC. Noticed at: all_apps_wide #> 6        ENC. Noticed at: chatapp #> 7       ENC. Noticed at: dictator #> 8         ENC. Noticed at: survey #> 9  ENC. Noticed at: all_apps_wide #> 10       ENC. Noticed at: chatapp #> 11      ENC. Noticed at: dictator #> 12        ENC. Noticed at: survey #> 13 ENC. Noticed at: all_apps_wide #> 14       ENC. Noticed at: chatapp #> 15      ENC. Noticed at: dictator #> 16        ENC. Noticed at: survey #> 17       ENC. Noticed at: chatapp #> 18      ENC. Noticed at: dictator #> 19        ENC. Noticed at: survey #> 20 ENC. Noticed at: all_apps_wide #> 21      ENC. Noticed at: dictator #> 22        ENC. Noticed at: survey #> 23 ENC. Noticed at: all_apps_wide #> 24       ENC. Noticed at: chatapp #> 25 ENC. Noticed at: all_apps_wide #> 26       ENC. Noticed at: chatapp #> 27      ENC. Noticed at: dictator #> 28        ENC. Noticed at: survey #> 29 ENC. Noticed at: all_apps_wide #> 30       ENC. Noticed at: chatapp #> 31      ENC. Noticed at: dictator #> 32        ENC. Noticed at: survey #> 33 ENC. Noticed at: all_apps_wide #> 34       ENC. Noticed at: chatapp #> 35      ENC. Noticed at: dictator #> 36        ENC. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page reason #> 1          164r1hs4     7bfqtokx  chatapp            chat    ENC #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage    ENC #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction    ENC #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction    ENC #> 17         d4sq7zio     l8ecm1uh dictator    Introduction    ENC #> 21         jxh15obl     t0rog7nz   survey           Offer    ENC #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage    ENC #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage    ENC #> 33         znri6myc     l8ecm1uh dictator    Introduction    ENC #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"jxh15obl\" \"ktjz5jli\" #> [8] \"vbhvhozv\" \"znri6myc\" #>  #> $count #> [1] 9 #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete duplicate data — delete_duplicate","title":"Delete duplicate data — delete_duplicate","text":"Delete duplicate rows oTree app data frames $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete duplicate data — delete_duplicate","text":"","code":"delete_duplicate(oTree)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete duplicate data — delete_duplicate","text":"oTree list data frames created import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete duplicate data — delete_duplicate","text":"function returns duplicate original oTree list data frames without duplicate rows app data frames $all_apps_wide. function effect data frames $Time $Chats. function add information $info$deleted_cases, delete important information cleans messy data import. However, function adjusts $info$initial_n, $all_apps_wide data frame exists.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete duplicate data — delete_duplicate","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # First, show some row numbers print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"41 33 366 41\"  # Delete duplicate rows oTree <- delete_duplicate(oTree)  # Show row numbers again print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"37 33 366 41\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete participant labels in all apps — delete_plabels","title":"Delete participant labels in all apps — delete_plabels","text":"work MTurk, MTurk IDs stored participant labels variable. function deletes variable $all_apps_wide every app data frame list data frames created import_otree /variables referring MTurk, participant.mturk_worker_id. Caution: function delete variables original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete participant labels in all apps — delete_plabels","text":"","code":"delete_plabels(oTree, del_plabel = TRUE, del_mturk = TRUE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete participant labels in all apps — delete_plabels","text":"oTree list data frames created import_otree. del_plabel Logical. TRUE participant labels deleted. del_mturk Logical. TRUE MTurk variables deleted.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete participant labels in all apps — delete_plabels","text":"function returns duplicate original oTree list data frames include participant labels /MTurk variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete participant labels in all apps — delete_plabels","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show participant labels oTree$all_apps_wide$participant.label #>  [1] \"Person1\"  \"Person2\"  \"Person4\"  \"Person5\"  \"Person6\"  \"Person7\"  #>  [7] \"Person8\"  \"Person9\"  \"Person10\" \"Person1\"  \"Person2\"  \"Person3\"  #> [13] \"Person4\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person5\"  #> [19] \"Person6\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person2\"  #> [25] \"Person3\"  NA         NA         NA         NA         oTree$survey$participant.label #>  [1] \"Person1\"  \"Person2\"  \"Person4\"  \"Person5\"  \"Person6\"  \"Person7\"  #>  [7] \"Person8\"  \"Person9\"  \"Person10\" \"Person1\"  \"Person2\"  \"Person3\"  #> [13] \"Person4\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person5\"  #> [19] \"Person6\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person2\"  #> [25] \"Person3\"   # Delete all participant labels oTree2 <- delete_plabels(oTree)  # Show participant labels again oTree2$all_apps_wide$participant.label #> NULL oTree2$survey$participant.label #> NULL"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete all cases of one session — delete_sessions","title":"Delete all cases of one session — delete_sessions","text":"Delete cases specific sessions data frames oTree list data frames. Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom exports variable named participant.code variable named session.code!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete all cases of one session — delete_sessions","text":"","code":"delete_sessions(oTree, scodes, saved_vars = NULL, reason, info = FALSE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete all cases of one session — delete_sessions","text":"oTree list data frames created import_otree. scodes Character. session.code(s) session(s) whose data removed. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. reason Character. reason deletion stored list information deleted cases $info$deleted_cases. info Logical. TRUE brief information session deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete all cases of one session — delete_sessions","text":"function returns duplicate original oTree list data frames include deleted sessions. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $full $unique = data frames $full $unique contain information participants whose data deleted. entries $full $unique data frames list . Columns end_app end_page left empty intentionally filled delete_dropouts function. Columns participant.code reason filled. - $codes = vector containing participant codes deleted participants. - $count = number deleted participants.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete all cases of one session — delete_sessions","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Delete one session oTree2 <- delete_sessions(oTree,   scodes = \"7bfqtokx\",   reason = \"Only tests\")  # Show changes in row numbers print(paste(\"Row numbers before deletion: \", nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"Row numbers before deletion:  29 25 289 35\"  print(paste(\"Row numbers after deletion: \", nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"Row numbers after deletion:  20 16 166 14\"  # Delete two sessions and show deletion message oTree2 <- delete_sessions(oTree,   scodes = c(\"7bfqtokx\", \"vd1h01iv\"),   reason = \"Only tests\",   info = TRUE) #> 13 case(s) deleted  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"16 12 126 10\"  # Delete session and save variable to the info list oTree2 <- delete_sessions(oTree,   scodes = c(\"7bfqtokx\", \"vd1h01iv\"),   reason = \"Server Crash\",   saved_vars = \"dictator.1.group.id_in_subsession\")  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code session.code dictator.1.group.id_in_subsession end_app #> 1          46kxib6w     7bfqtokx                                 1         #> 2          iay3dhkn     7bfqtokx                                 1         #> 3          4zhzdmzo     7bfqtokx                                 2         #> 4          3ttf7yix     7bfqtokx                                 2         #> 5          2d72mfgh     7bfqtokx                                 3         #> 6          rvce7958     7bfqtokx                                 3         #> 7          164r1hs4     7bfqtokx                                 4         #> 8          lsl3vbij     7bfqtokx                                 4         #> 9          ktjz5jli     7bfqtokx                                 5         #> 11         xx78b3x0     vd1h01iv                                 1         #> 12         xmxl46rm     vd1h01iv                                 1         #> 13         vbhvhozv     vd1h01iv                                 2         #> 14         2scvem7a     vd1h01iv                                 2         #>    end_page       reason #> 1           Server Crash #> 2           Server Crash #> 3           Server Crash #> 4           Server Crash #> 5           Server Crash #> 6           Server Crash #> 7           Server Crash #> 8           Server Crash #> 9           Server Crash #> 11          Server Crash #> 12          Server Crash #> 13          Server Crash #> 14          Server Crash  # See codes of deleted variables oTree2$info$deleted_cases$codes #>  [1] \"46kxib6w\" \"iay3dhkn\" \"4zhzdmzo\" \"3ttf7yix\" \"2d72mfgh\" \"rvce7958\" #>  [7] \"164r1hs4\" \"lsl3vbij\" \"ktjz5jli\" \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" #> [13] \"2scvem7a\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 13  # Delete a single case and then delete a session oTree2 <- delete_cases(oTree,                        pcodes = \"4zhzdmzo\",                        reason = \"requested\") oTree2 <- delete_sessions(oTree2,   scodes = c(\"vd1h01iv\"),   reason = \"Server Crash\",   saved_vars = \"dictator.1.group.id_in_subsession\")  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>   participant.code  session end_app end_page       reason session.code #> 1         4zhzdmzo 7bfqtokx                     requested         <NA> #> 2         xx78b3x0     <NA>                  Server Crash     vd1h01iv #> 3         xmxl46rm     <NA>                  Server Crash     vd1h01iv #> 4         vbhvhozv     <NA>                  Server Crash     vd1h01iv #> 5         2scvem7a     <NA>                  Server Crash     vd1h01iv #>   dictator.1.group.id_in_subsession #> 1                                NA #> 2                                 1 #> 3                                 1 #> 4                                 2 #> 5                                 2  # See codes of deleted variables oTree2$info$deleted_cases$codes #> [1] \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" \"2scvem7a\" \"4zhzdmzo\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 5"},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the time that was spent on the whole experiment — extime","title":"Calculate the time that was spent on the whole experiment — extime","text":"Calculate time spent experiment. stated otherwise, calculation starts end first page!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the time that was spent on the whole experiment — extime","text":"","code":"extime(   oTree,   pcode = NULL,   plabel = NULL,   group_id = NULL,   seconds = FALSE,   rounded = TRUE,   digits = 2L,   startat = 1L,   tz = \"UTC\",   sinfo = \"session_code\",   combine = TRUE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the time that was spent on the whole experiment — extime","text":"oTree list data frames created import_otree. pcode Character. value participant.code variable time calculated one specified participant. plabel Character. value participant.label variable time calculated one specified participant. group_id Integer. value group_id variable time calculated one specified group. group_id variable can created make_ids. seconds Logical. TRUE output seconds instead minutes. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. startat Integer character string \"real\" Whether start experiment taken time certain index person's vector page_indexes $Time data frame time_started variable $all_apps_wide (\"real\"). Important: integer, represents position within page index sequence, numeric value page_index variable. tz Character. Time zone. sinfo Character. \"session_id\" use session ID additional information data frame single durations, \"session_code\" use session codes, NULL session column shown. combine Logical. TRUE variables referring epoch time merged, variables referring participant code merged case data several versions oTree used. FALSE, function returns error several oTree versions' data present.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the time that was spent on the whole experiment — extime","text":"function returns either single value data one person calculated list information time several participants spent experiment. list, can find following information: - $mean_duration = experiment's average duration. - $min_duration = experiment's minimum duration. - $max_duration = experiment's maximum duration. - $single_durations = data frame durations used calculating min, max, mean duration. - $messages = important notes calculations. - $only_one_page = vector individuals one time stamp.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the time that was spent on the whole experiment — extime","text":"functions calculates time spent experiment using variable refers time stamp. variable present, function alternatively uses seconds_on_page2, can created pagesec function.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the time that was spent on the whole experiment — extime","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show time for one participant extime(oTree, pcode = \"wk247s9w\") #> [1] 2.5  # Make a data frame of durations extime(oTree) #> $mean_duration #> [1] 2.81 #>  #> $min_duration #> [1] 0.4 #>  #> $max_duration #> [1] 6.93 #>  #> $single_durations #>    participant  session duration #> 12    vbhvhozv vd1h01iv     0.40 #> 13    2scvem7a vd1h01iv     0.43 #> 20    7l0hmpcq qyu3qg0q     0.78 #> 10    xx78b3x0 vd1h01iv     1.08 #> 21    ia9rnfvc qyu3qg0q     1.20 #> 11    xmxl46rm vd1h01iv     1.25 #> 15    jxh15obl t0rog7nz     1.73 #> 16    a7dppel1 t0rog7nz     1.98 #> 19    1l5kal0r t0rog7nz     2.18 #> 1     46kxib6w 7bfqtokx     2.32 #> 18    xkobdvuh t0rog7nz     2.37 #> 17    wk247s9w t0rog7nz     2.50 #> 2     iay3dhkn 7bfqtokx     2.55 #> 14    iagvtslv t0rog7nz     2.82 #> 9     ktjz5jli 7bfqtokx     2.88 #> 7     164r1hs4 7bfqtokx     3.53 #> 8     lsl3vbij 7bfqtokx     4.18 #> 5     2d72mfgh 7bfqtokx     5.38 #> 6     rvce7958 7bfqtokx     5.67 #> 3     4zhzdmzo 7bfqtokx     6.78 #> 4     3ttf7yix 7bfqtokx     6.93 #>  #> $messages #> [1] \"Warning: For at least one participant, the experiment only has one page. I.e., the indices for the first and the last page are the same. See $only_one_page for information on this participant/these participants! Participants in this list are not included in the output.\" #>  #> $only_one_page #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>   # Make a data frame of durations (beginning from the end of the second page) extime(oTree, startat = 2) #> $mean_duration #> [1] 1.88 #>  #> $min_duration #> [1] 0.03 #>  #> $max_duration #> [1] 6.08 #>  #> $single_durations #>    participant  session duration #> 13    2scvem7a vd1h01iv     0.03 #> 9     ktjz5jli 7bfqtokx     0.05 #> 12    vbhvhozv vd1h01iv     0.15 #> 20    7l0hmpcq qyu3qg0q     0.63 #> 7     164r1hs4 7bfqtokx     0.82 #> 10    xx78b3x0 vd1h01iv     1.03 #> 11    xmxl46rm vd1h01iv     1.08 #> 21    ia9rnfvc qyu3qg0q     1.08 #> 8     lsl3vbij 7bfqtokx     1.40 #> 15    jxh15obl t0rog7nz     1.53 #> 16    a7dppel1 t0rog7nz     1.78 #> 19    1l5kal0r t0rog7nz     1.98 #> 18    xkobdvuh t0rog7nz     2.17 #> 1     46kxib6w 7bfqtokx     2.20 #> 17    wk247s9w t0rog7nz     2.32 #> 2     iay3dhkn 7bfqtokx     2.37 #> 14    iagvtslv t0rog7nz     2.70 #> 5     2d72mfgh 7bfqtokx     2.73 #> 6     rvce7958 7bfqtokx     2.97 #> 4     3ttf7yix 7bfqtokx     4.35 #> 3     4zhzdmzo 7bfqtokx     6.08 #>  #> $messages #> [1] \"Warning: For at least one participant, the experiment only has one page. I.e., the indices for the first and the last page are the same. See $only_one_page for information on this participant/these participants! Participants in this list are not included in the output.\" #>  #> $only_one_page #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":null,"dir":"Reference","previous_headings":"","what":"Import oTree data — import_otree","title":"Import oTree data — import_otree","text":"Import data files created oTree. files containing pattern YYYY-MM-DD end file names considered oTree files. Bot outputs saved oTree without date included. Hence, import bot data, must either rename original bot files using YYYY-MM-DD format use argument onlybots = TRUE. using second option, data bot files imported. Caution! Data can downloaded within session globally time. files downloaded, can lead $all_apps_wide data twice! can remove duplicate data using delete_duplicate. Caution! importing Excel files, function check erroneous data structures combine data frames file name patterns. using CSV = FALSE argument, clean data appropriately.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Import oTree data — import_otree","text":"","code":"import_otree(   path = \".\",   file_names = NULL,   final_apps = NULL,   final_pages = NULL,   recursive = TRUE,   csv = TRUE,   onlybots = FALSE,   del_empty = TRUE,   info = FALSE,   encoding = \"UTF-8\" )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Import oTree data — import_otree","text":"path Character. path files (default working directory). file_names Character. name(s) file(s) imported. specified, files path subfolders imported. final_apps Character. name(s) app(s) participants finish experiment. argument final_apps left empty, can still call deleting participants finish experiment delete_dropouts. final_pages Character. name(s) page(s) participants finish experiment. argument final_pages left empty, can still call deleting participants finish experiment delete_dropouts. recursive Logical. TRUE files path's subfolders also imported. csv Logical. TRUE CSV files imported. FALSE Excel files imported. onlybots Logical. TRUE bot-created files imported. del_empty Logical. TRUE empty cases deleted $all_apps_wide normal app data frames (Time Chats). info Logical. TRUE brief information data import printed. encoding Character. Encoding CSV files imported. Default \"UTF-8\".","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Import oTree data — import_otree","text":"Returns list data frames (one data frame app $all_apps_wide) list information list data frames $info. See detailed information imported files $info$imported_files. $all_apps_wide imported, see number imported cases $info$initial_n. number, empty rows already considered. , empty rows deleted del_empty=TRUE, initial_n counts rows empty. Cases deleted participants make last page /app subtracted number. Information: Empty rows rows without participant._current_app_name variable set. Empty rows deleted app data frames $all_apps_wide using del_empty = TRUE. Empty rows $Chats $Time data frames deleted. old new oTree versions combined, $Time data frame contains variables called participant_code participant__code (difference underscores). Caution! unusual amount NAs, check everything got imported correctly. Sometimes, CSV Excel file may corrupted, information found one column.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Import oTree data — import_otree","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree()  # Show the structure of the import str(oTree, max.level = 1)  # Show the names of all imported files oTree$info$imported_files  # Delete empty cases and delete every case of a person # who didn't end the experiment in the app \"survey\" oTree <- import_otree(   del_empty = TRUE,   final_apps = \"survey\",   info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import bot files import_otree(   path = \"./bot_data\",   onlybots = TRUE,   csv = TRUE,   info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import with file names (path separately) oTree2 <- import_otree(      del_empty = TRUE,      path = \"./exp_data\",      file_names = c(\"all_apps_wide-2023-03-27.csv\",                    \"ChatMessages-2023-03-27.csv\",                    \"PageTimes-2023-03-27.csv\"),      onlybots = FALSE,      csv = TRUE,      info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import with file names (without path separately) oTree2 <- import_otree(      del_empty = TRUE,      file_names = c(\"exp_data/all_apps_wide-2023-03-27.csv\",                    \"exp_data/ChatMessages-2023-03-27.csv\",                    \"exp_data/PageTimes-2023-03-27.csv\"),      onlybots = FALSE,      csv = TRUE,      info = TRUE)  # Show the structure of the import str(oTree, max.level = 1) }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames. #> List of 8 #>  $ all_apps_wide:'data.frame':\t41 obs. of  60 variables: #>  $ info         :List of 2 #>  $ chatapp      :'data.frame':\t33 obs. of  24 variables: #>  $ dictator     :'data.frame':\t123 obs. of  25 variables: #>  $ survey       :'data.frame':\t33 obs. of  29 variables: #>  $ start        :'data.frame':\t8 obs. of  24 variables: #>  $ Time         :'data.frame':\t366 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames. #> Imported: 5 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> 12 case(s) deleted #> Dropouts are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary! #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 4 app(s) and/or all_apps_wide #> No Time files available #> No chat files available #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 1 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 1 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables:"},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":null,"dir":"Reference","previous_headings":"","what":"Make IDs — make_ids","title":"Make IDs — make_ids","text":"Make session IDs , optionally, group IDs participant IDs span across data frames created import_otree. Information IDs taken $all_apps_wide can defined otherwise. Note: Older versions oTree may already contain variable called session_id $Time data frames. variable overwritten function! Important: Combine duplicate data running function!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make IDs — make_ids","text":"","code":"make_ids(   oTree,   gmake = FALSE,   pmake = TRUE,   from_app = \"all_apps_wide\",   from_var = NULL,   sstart = 1L,   gstart = 1L,   pstart = 1L,   emptyrows = NULL,   icw = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make IDs — make_ids","text":"oTree list data frames created import_otree. gmake Logical. TRUE variable called group_id made. from_var NULL, gmake automatically set TRUE. pmake Logical. TRUE variable called participant_id made. from_app Character. Name data frame session, group, participant information taken. normal app data frames $all_apps_wide allowed. from_var Character. Name variable group information taken. argument relevant $all_apps_wide used from_app group information contradicts . sstart Integer. number serves starting point session IDs. gstart Integer. number serves starting point group IDs. pstart Integer. number serves starting point participant IDs. emptyrows Character. \"\" function stop empty rows from_app. \"yes\" function continue make IDs. icw Logical. TRUE warning message ignored states IDs made oTree bug.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make IDs — make_ids","text":"ID variables made $all_apps_wide, app data frames, $Time data frame, $Chats data frame. See list additional ID variables $info$additional_variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make IDs — make_ids","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Make session IDs only oTree2 <- make_ids(oTree)  # Show new variables oTree2$all_apps_wide$session_id #>  [1] 1 1 1 1 1 1 1 1 1 2 2 2 2 3 3 3 3 3 3 4 4 4 4 5 5 6 6 6 6  # Make session IDs and group IDs # Not working with this data set because group ID is not the same in all apps if (FALSE) { # \\dontrun{       oTree2 <- make_ids(oTree, gmake = TRUE)        # Show new variables       oTree2$all_apps_wide$session_id       oTree2$all_apps_wide$group_id } # }  # Get IDs from variable \"dictator.1.group.id_in_subsession\" # in the data frame \"all_apps_wide\" oTree2 <- make_ids(oTree,                    gmake = TRUE,                    from_var = \"dictator.1.group.id_in_subsession\")  # Show new variables oTree2$all_apps_wide$session_id #>  [1] 1 1 1 1 1 1 1 1 1 2 2 2 2 3 3 3 3 3 3 4 4 4 4 5 5 6 6 6 6 oTree2$all_apps_wide$group_id #>  [1]  1  1  2  2  3  3  4  4  5  6  6  7  7  8  8  9  9 10 10 11 11 12 12 13 13 #> [26] 14 14 15 15  # Get IDs from another app than all_apps_wide oTree2 <- make_ids(oTree, gmake = TRUE, from_app = \"dictator\") #> Warning: Data frame \"all_apps_wide\" has more participants than dictator: 6cim3a5i, 1mn1kzs7, zdki96d6, byxco6zo  # Show new variables oTree2$all_apps_wide$session_id #>  [1]  1  1  1  1  1  1  1  1  1  2  2  2  2  3  3  3  3  3  3  4  4  4  4  5  5 #> [26] NA NA NA NA oTree2$all_apps_wide$group_id #>  [1]  1  1  2  2  3  3  4  4  5  6  6  7  7  8  8  9  9 10 10 11 11 12 12 13 13 #> [26] NA NA NA NA"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if the Chats data frame is messy — messy_chat","title":"Check if the Chats data frame is messy — messy_chat","text":"Check $Chats data frame includes session-related variables participant-related variables appear multiple times. may occur data different oTree versions, use different variable names, combined. desired, function can merge variables, storing data using newer oTree version's variable names removing outdated variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if the Chats data frame is messy — messy_chat","text":"","code":"messy_chat(   oTree,   combine = FALSE,   session = TRUE,   participant = TRUE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if the Chats data frame is messy — messy_chat","text":"oTree list data frames created import_otree. combine Logical. TRUE variables referring session code merged /variables referring participant code merged case data several versions oTree used. session Logical. TRUE variables referring session code checked merged. Merging works combine = TRUE. participant Logical. TRUE variables referring participant code checked merged. Merging works combine = TRUE. info Logical. TRUE brief information process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if the Chats data frame is messy — messy_chat","text":"function searches multiple variables related session code participant code $Chats data frame. can occur data old new oTree versions used. combine = FALSE, function throw error variables found. combine = TRUE, function throw error variables found. Instead, automatically combines variables new variables adds original $Chats data frame. function returns duplicate original oTree list $Chats data frame modified. new variables called participant_code session_code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if the Chats data frame is messy — messy_chat","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Show all Chats column names print(colnames(oTree$Chats)) #> [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          #> [5] \"nickname\"         \"body\"             \"timestamp\"         # Run function oTree <- messy_chat(oTree, combine = TRUE)  # Show all Chats column names again print(colnames(oTree$Chats)) #> [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          #> [5] \"nickname\"         \"body\"             \"timestamp\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if the Time data frame is messy — messy_time","title":"Check if the Time data frame is messy — messy_time","text":"Checks Time data frame includes participant-related variables time stamp variables appear multiple times. may occur data different oTree versions, use different variable names, combined. desired, function can merge variables, storing data using newer oTree version's variable names removing outdated variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if the Time data frame is messy — messy_time","text":"","code":"messy_time(   oTree,   combine = FALSE,   epoch_time = TRUE,   participant = TRUE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if the Time data frame is messy — messy_time","text":"oTree list data frames created import_otree. combine Logical. TRUE variables referring epoch time merged /variables referring participant code merged case data several versions oTree used. epoch_time Logical. TRUE variables referring time stamp checked merged. works combine = TRUE. participant Logical. TRUE variables referring participant code checked merged. works combine = TRUE. info Logical. TRUE brief information process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if the Time data frame is messy — messy_time","text":"function searches multiple variables related time stamp participant code $Time data frame, can occur data old new oTree versions used. combine = FALSE, function throw error variables found. combine = TRUE, function throw error variables found. Instead, automatically combines variables new variables adds original $Time data frame. function returns duplicate original oTree list $Time data frame modified. new variables called epoch_time_completed participant_code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if the Time data frame is messy — messy_time","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Show all Time column names print(colnames(oTree$Time)) #>  [1] \"session_code\"              \"participant_id_in_session\" #>  [3] \"participant_code\"          \"page_index\"                #>  [5] \"app_name\"                  \"page_name\"                 #>  [7] \"epoch_time_completed\"      \"round_number\"              #>  [9] \"timeout_happened\"          \"is_wait_page\"               # Run function oTree <- messy_time(oTree, combine = TRUE)  # Show all Time column names again print(colnames(oTree$Time)) #>  [1] \"session_code\"              \"participant_id_in_session\" #>  [3] \"participant_code\"          \"page_index\"                #>  [5] \"app_name\"                  \"page_name\"                 #>  [7] \"epoch_time_completed\"      \"round_number\"              #>  [9] \"timeout_happened\"          \"is_wait_page\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample experimental data — oTree","title":"Sample experimental data — oTree","text":"Sample experimental data","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample experimental data — oTree","text":"","code":"oTree"},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Sample experimental data — oTree","text":"list data frames created import_otree().","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Sample experimental data — oTree","text":"data set created using modified versions official oTree sample experiments can downloaded installing oTree. detail, following apps used: \"start,\" \"dictator,\" \"chatapp,\" \"survey.\"","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the seconds spent on each page — pagesec","title":"Calculate the seconds spent on each page — pagesec","text":"Create new variable $Time data frame contains time spent page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the seconds spent on each page — pagesec","text":"","code":"pagesec(oTree, rounded = TRUE, digits = 2, minutes = FALSE, combine = FALSE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the seconds spent on each page — pagesec","text":"oTree list data frames created import_otree. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. minutes Logical. TRUE output minutes instead seconds. combine Logical. TRUE variables referring epoch time merged, variables referring participant code merged case data several versions oTree used.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the seconds spent on each page — pagesec","text":"function returns duplicate original oTree list data frames also contains column $Time data frame  named seconds_on_page2 minutes_on_page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the seconds spent on each page — pagesec","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Create two new columns: seconds_on_page2 and minutes_on_page oTree <- pagesec(oTree, rounded = TRUE, minutes = TRUE)  # Show the Time data frame head(oTree$Time, n = 30) #>    session_code participant_id_in_session participant_code page_index app_name #> 1      7bfqtokx                         1         46kxib6w          0          #> 2      7bfqtokx                         2         iay3dhkn          0          #> 3      7bfqtokx                         3         4zhzdmzo          0          #> 4      7bfqtokx                         4         3ttf7yix          0          #> 5      7bfqtokx                         5         2d72mfgh          0          #> 6      7bfqtokx                         6         rvce7958          0          #> 7      7bfqtokx                         7         164r1hs4          0          #> 8      7bfqtokx                         8         lsl3vbij          0          #> 9      7bfqtokx                         9         ktjz5jli          0          #> 10     7bfqtokx                         1         46kxib6w          1 dictator #> 11     7bfqtokx                         1         46kxib6w          2 dictator #> 12     7bfqtokx                         2         iay3dhkn          1 dictator #> 13     7bfqtokx                         1         46kxib6w          3 dictator #> 14     7bfqtokx                         2         iay3dhkn          3 dictator #> 15     7bfqtokx                         2         iay3dhkn          4 dictator #> 16     7bfqtokx                         2         iay3dhkn          5 dictator #> 17     7bfqtokx                         1         46kxib6w          4 dictator #> 18     7bfqtokx                         1         46kxib6w          5 dictator #> 19     7bfqtokx                         1         46kxib6w          6 dictator #> 20     7bfqtokx                         1         46kxib6w          7 dictator #> 21     7bfqtokx                         2         iay3dhkn          7 dictator #> 22     7bfqtokx                         1         46kxib6w          8 dictator #> 23     7bfqtokx                         1         46kxib6w          9 dictator #> 24     7bfqtokx                         1         46kxib6w         10 dictator #> 25     7bfqtokx                         2         iay3dhkn          8 dictator #> 26     7bfqtokx                         2         iay3dhkn          9 dictator #> 27     7bfqtokx                         1         46kxib6w         11 dictator #> 28     7bfqtokx                         2         iay3dhkn         11 dictator #> 29     7bfqtokx                         2         iay3dhkn         12 dictator #> 30     7bfqtokx                         1         46kxib6w         12 dictator #>                page_name epoch_time_completed round_number timeout_happened #> 1  InitializeParticipant           1679926144            1                0 #> 2  InitializeParticipant           1679926145            1                0 #> 3  InitializeParticipant           1679926146            1                0 #> 4  InitializeParticipant           1679926146            1                0 #> 5  InitializeParticipant           1679926147            1                0 #> 6  InitializeParticipant           1679926147            1                0 #> 7  InitializeParticipant           1679926148            1                0 #> 8  InitializeParticipant           1679926148            1                0 #> 9  InitializeParticipant           1679926149            1                0 #> 10          Introduction           1679926151            1                0 #> 11                 Offer           1679926154            1                0 #> 12          Introduction           1679926156            1                0 #> 13       ResultsWaitPage           1679926156            1                0 #> 14       ResultsWaitPage           1679926156            1                0 #> 15               Results           1679926157            1                0 #> 16          Introduction           1679926158            2                0 #> 17               Results           1679926160            1                0 #> 18          Introduction           1679926162            2                0 #> 19                 Offer           1679926165            2                0 #> 20       ResultsWaitPage           1679926165            2                0 #> 21       ResultsWaitPage           1679926165            2                0 #> 22               Results           1679926166            2                0 #> 23          Introduction           1679926167            3                0 #> 24                 Offer           1679926169            3                0 #> 25               Results           1679926171            2                0 #> 26          Introduction           1679926172            3                0 #> 27       ResultsWaitPage           1679926172            3                0 #> 28       ResultsWaitPage           1679926172            3                0 #> 29               Results           1679926173            3                0 #> 30               Results           1679926178            3                0 #>    is_wait_page minutes_on_page #> 1             0              NA #> 2             0              NA #> 3             0              NA #> 4             0              NA #> 5             0              NA #> 6             0              NA #> 7             0              NA #> 8             0              NA #> 9             0              NA #> 10            0            0.12 #> 11            0            0.05 #> 12            0            0.18 #> 13            1            0.03 #> 14            1            0.00 #> 15            0            0.02 #> 16            0            0.02 #> 17            0            0.07 #> 18            0            0.03 #> 19            0            0.05 #> 20            1            0.00 #> 21            1            0.12 #> 22            0            0.02 #> 23            0            0.02 #> 24            0            0.03 #> 25            0            0.10 #> 26            0            0.02 #> 27            1            0.05 #> 28            1            0.00 #> 29            0            0.02 #> 30            0            0.10"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":null,"dir":"Reference","previous_headings":"","what":"Show constant columns — show_constant","title":"Show constant columns — show_constant","text":"Show columns variation values data frame oTree list data frames (except ones info list). function helpful running experiment check unnecessary variables. can check columns unchanging possible value columns containing specific value.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show constant columns — show_constant","text":"","code":"show_constant(oTree, value = \"any\")"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show constant columns — show_constant","text":"oTree list data frames created import_otree. value value controlled within column. value set \"\", function checks columns possible values identical.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Show constant columns — show_constant","text":"function returns list vectors, one app, $all_apps_wide, $Time /$Chats data frame. vector contains names variables constant values. variables constant values, vector empty.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Show constant columns — show_constant","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show all columns that contain only NAs show_constant(oTree = oTree) #> $all_apps_wide #>  [1] \"participant._is_bot\"                          #>  [2] \"participant._max_page_index\"                  #>  [3] \"participant.visited\"                          #>  [4] \"participant.mturk_worker_id\"                  #>  [5] \"participant.mturk_assignment_id\"              #>  [6] \"session.label\"                                #>  [7] \"session.mturk_HITId\"                          #>  [8] \"session.mturk_HITGroupId\"                     #>  [9] \"session.comment\"                              #> [10] \"session.is_demo\"                              #> [11] \"session.config.name\"                          #> [12] \"session.config.real_world_currency_per_point\" #> [13] \"session.config.participation_fee\"             #> [14] \"dictator.1.player.role\"                       #> [15] \"dictator.1.subsession.round_number\"           #> [16] \"dictator.2.player.role\"                       #> [17] \"dictator.2.subsession.round_number\"           #> [18] \"dictator.3.player.role\"                       #> [19] \"dictator.3.subsession.round_number\"           #> [20] \"chatapp.1.player.role\"                        #> [21] \"chatapp.1.player.payoff\"                      #> [22] \"chatapp.1.subsession.round_number\"            #> [23] \"survey.1.player.role\"                         #> [24] \"survey.1.player.payoff\"                       #> [25] \"survey.1.group.id_in_subsession\"              #> [26] \"survey.1.subsession.round_number\"             #>  #> $chatapp #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"player.payoff\"                   \"subsession.round_number\"         #>  [9] \"session.label\"                   \"session.mturk_HITId\"             #> [11] \"session.mturk_HITGroupId\"        \"session.comment\"                 #> [13] \"session.is_demo\"                 #>  #> $dictator #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"session.label\"                   \"session.mturk_HITId\"             #>  [9] \"session.mturk_HITGroupId\"        \"session.comment\"                 #> [11] \"session.is_demo\"                 #>  #> $survey #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"player.payoff\"                   \"group.id_in_subsession\"          #>  [9] \"subsession.round_number\"         \"session.label\"                   #> [11] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [13] \"session.comment\"                 \"session.is_demo\"                 #>  #> $Time #> [1] \"timeout_happened\" #>  #> $Chats #> character(0) #>  show_constant(oTree = oTree, value = NA) #> $all_apps_wide #>  [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #>  [3] \"session.label\"                   \"session.mturk_HITId\"             #>  [5] \"session.mturk_HITGroupId\"        \"session.comment\"                 #>  [7] \"dictator.1.player.role\"          \"dictator.2.player.role\"          #>  [9] \"dictator.3.player.role\"          \"chatapp.1.player.role\"           #> [11] \"survey.1.player.role\"            #>  #> $chatapp #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $dictator #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $survey #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $Time #> character(0) #>  #> $Chats #> character(0) #>   # Show all columns that contain only -99 show_constant(oTree = oTree, value = -99) #> $all_apps_wide #> character(0) #>  #> $chatapp #> character(0) #>  #> $dictator #> character(0) #>  #> $survey #> character(0) #>  #> $Time #> character(0) #>  #> $Chats #> character(0) #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":null,"dir":"Reference","previous_headings":"","what":"Show participants who did not finish the experiment — show_dropouts","title":"Show participants who did not finish the experiment — show_dropouts","text":"Show information people finish experiment () certain page(s) /app(s).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show participants who did not finish the experiment — show_dropouts","text":"","code":"show_dropouts(oTree, final_apps = NULL, final_pages = NULL, saved_vars = NULL)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show participants who did not finish the experiment — show_dropouts","text":"oTree list data frames created import_otree. final_apps Character. name(s) app(s) participants finish experiment. final_pages Character. name(s) page(s) participants finish experiment. saved_vars name(s) variable(s) need(s) shown list information dropout cases.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Show participants who did not finish the experiment — show_dropouts","text":"function returns list information participants finish experiment. list, can find following information: - $full = data frame contains information participants finish study; shows participant codes, names apps left experiment, names pages left experiment, names app data frames information found, dropout reason (\"ENC\", experiment completed, combined name data frame dropout observed). participants usually appear multiple app data frames, $full data frame may contain several entries person. - $unique = data frame contains similar information $full data frame one row per participant information data frame dropout observed. - $all_end = table provides information app page combinations participants ended experiment. table also includes information participants drop experiment. $all_end table shown $all_apps_wide data frame exists. - $codes = vector containing participant codes participants finish experiment. - $count = number participants finish experiment. important note argument final_pages set, function distinguish page names reoccur different apps. columns end_app end_page output empty, variables saved oTree specific participants. empty rows deleted. can done using argument del_empty = TRUE\" using import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Show participants who did not finish the experiment — show_dropouts","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show everyone who did not finish with the app \"survey\" show_dropouts(oTree, final_apps = \"survey\") #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 22         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 23         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 24         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 25         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 26         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 27         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 28         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 29         znri6myc     l8ecm1uh dictator    Introduction #> 30         znri6myc     l8ecm1uh dictator    Introduction #> 31         znri6myc     l8ecm1uh dictator    Introduction #> 32         znri6myc     l8ecm1uh dictator    Introduction #>                                                 reason #> 1  Experiment not completed. Noticed at: all_apps_wide #> 2        Experiment not completed. Noticed at: chatapp #> 3       Experiment not completed. Noticed at: dictator #> 4         Experiment not completed. Noticed at: survey #> 5  Experiment not completed. Noticed at: all_apps_wide #> 6        Experiment not completed. Noticed at: chatapp #> 7       Experiment not completed. Noticed at: dictator #> 8         Experiment not completed. Noticed at: survey #> 9  Experiment not completed. Noticed at: all_apps_wide #> 10       Experiment not completed. Noticed at: chatapp #> 11      Experiment not completed. Noticed at: dictator #> 12        Experiment not completed. Noticed at: survey #> 13 Experiment not completed. Noticed at: all_apps_wide #> 14       Experiment not completed. Noticed at: chatapp #> 15      Experiment not completed. Noticed at: dictator #> 16        Experiment not completed. Noticed at: survey #> 17 Experiment not completed. Noticed at: all_apps_wide #> 18       Experiment not completed. Noticed at: chatapp #> 19      Experiment not completed. Noticed at: dictator #> 20        Experiment not completed. Noticed at: survey #> 21 Experiment not completed. Noticed at: all_apps_wide #> 22       Experiment not completed. Noticed at: chatapp #> 23      Experiment not completed. Noticed at: dictator #> 24        Experiment not completed. Noticed at: survey #> 25 Experiment not completed. Noticed at: all_apps_wide #> 26       Experiment not completed. Noticed at: chatapp #> 27      Experiment not completed. Noticed at: dictator #> 28        Experiment not completed. Noticed at: survey #> 29 Experiment not completed. Noticed at: all_apps_wide #> 30       Experiment not completed. Noticed at: chatapp #> 31      Experiment not completed. Noticed at: dictator #> 32        Experiment not completed. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 25         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 29         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 9  Experiment not completed #> 13 Experiment not completed #> 17 Experiment not completed #> 21 Experiment not completed #> 25 Experiment not completed #> 29 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"ktjz5jli\" \"vbhvhozv\" #> [8] \"znri6myc\" #>  #> $count #> [1] 8 #>   # Show everyone who did not finish with the page \"Demographics\" show_dropouts(oTree, final_pages = \"Demographics\") #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 22         jxh15obl     t0rog7nz   survey           Offer #> 23         jxh15obl     t0rog7nz   survey           Offer #> 24         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 26         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 27         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 28         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 30         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 31         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 32         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #> 34         znri6myc     l8ecm1uh dictator    Introduction #> 35         znri6myc     l8ecm1uh dictator    Introduction #> 36         znri6myc     l8ecm1uh dictator    Introduction #>                                                 reason #> 1  Experiment not completed. Noticed at: all_apps_wide #> 2         Experiment not completed. Noticed at: survey #> 3       Experiment not completed. Noticed at: dictator #> 4        Experiment not completed. Noticed at: chatapp #> 5         Experiment not completed. Noticed at: survey #> 6       Experiment not completed. Noticed at: dictator #> 7        Experiment not completed. Noticed at: chatapp #> 8  Experiment not completed. Noticed at: all_apps_wide #> 9         Experiment not completed. Noticed at: survey #> 10      Experiment not completed. Noticed at: dictator #> 11       Experiment not completed. Noticed at: chatapp #> 12 Experiment not completed. Noticed at: all_apps_wide #> 13        Experiment not completed. Noticed at: survey #> 14      Experiment not completed. Noticed at: dictator #> 15       Experiment not completed. Noticed at: chatapp #> 16 Experiment not completed. Noticed at: all_apps_wide #> 17      Experiment not completed. Noticed at: dictator #> 18       Experiment not completed. Noticed at: chatapp #> 19 Experiment not completed. Noticed at: all_apps_wide #> 20        Experiment not completed. Noticed at: survey #> 21       Experiment not completed. Noticed at: chatapp #> 22 Experiment not completed. Noticed at: all_apps_wide #> 23        Experiment not completed. Noticed at: survey #> 24      Experiment not completed. Noticed at: dictator #> 25        Experiment not completed. Noticed at: survey #> 26      Experiment not completed. Noticed at: dictator #> 27       Experiment not completed. Noticed at: chatapp #> 28 Experiment not completed. Noticed at: all_apps_wide #> 29        Experiment not completed. Noticed at: survey #> 30      Experiment not completed. Noticed at: dictator #> 31       Experiment not completed. Noticed at: chatapp #> 32 Experiment not completed. Noticed at: all_apps_wide #> 33        Experiment not completed. Noticed at: survey #> 34      Experiment not completed. Noticed at: dictator #> 35       Experiment not completed. Noticed at: chatapp #> 36 Experiment not completed. Noticed at: all_apps_wide #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 9  Experiment not completed #> 13 Experiment not completed #> 17 Experiment not completed #> 21 Experiment not completed #> 25 Experiment not completed #> 29 Experiment not completed #> 33 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"jxh15obl\" \"ktjz5jli\" #> [8] \"vbhvhozv\" \"znri6myc\" #>  #> $count #> [1] 9 #>   # Show everyone who finished with the following apps: \"survey,\" \"dictator\" final_apps <- unique(oTree$all_apps_wide$participant._current_app_name) final_apps <- final_apps[final_apps != \"survey\"] final_apps <- final_apps[final_apps != \"dictator\"] show_dropouts(oTree, final_apps = final_apps) #> $full #>     participant.code session.code  end_app        end_page #> 1           1l5kal0r     t0rog7nz   survey    Demographics #> 2           1l5kal0r     t0rog7nz   survey    Demographics #> 3           1l5kal0r     t0rog7nz   survey    Demographics #> 4           1l5kal0r     t0rog7nz   survey    Demographics #> 5           1mn1kzs7     gii59rga   survey    Demographics #> 6           2d72mfgh     7bfqtokx   survey    Demographics #> 7           2d72mfgh     7bfqtokx   survey    Demographics #> 8           2d72mfgh     7bfqtokx   survey    Demographics #> 9           2d72mfgh     7bfqtokx   survey    Demographics #> 10          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 11          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 12          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 13          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 14          3ttf7yix     7bfqtokx   survey    Demographics #> 15          3ttf7yix     7bfqtokx   survey    Demographics #> 16          3ttf7yix     7bfqtokx   survey    Demographics #> 17          3ttf7yix     7bfqtokx   survey    Demographics #> 18          46kxib6w     7bfqtokx   survey    Demographics #> 19          46kxib6w     7bfqtokx   survey    Demographics #> 20          46kxib6w     7bfqtokx   survey    Demographics #> 21          46kxib6w     7bfqtokx   survey    Demographics #> 22          4zhzdmzo     7bfqtokx   survey    Demographics #> 23          4zhzdmzo     7bfqtokx   survey    Demographics #> 24          4zhzdmzo     7bfqtokx   survey    Demographics #> 25          4zhzdmzo     7bfqtokx   survey    Demographics #> 26          6cim3a5i     gii59rga   survey    Demographics #> 27          7l0hmpcq     qyu3qg0q   survey    Demographics #> 28          7l0hmpcq     qyu3qg0q   survey    Demographics #> 29          7l0hmpcq     qyu3qg0q   survey    Demographics #> 30          7l0hmpcq     qyu3qg0q   survey    Demographics #> 31          7wa8kk3d     l8ecm1uh dictator    Introduction #> 32          7wa8kk3d     l8ecm1uh dictator    Introduction #> 33          7wa8kk3d     l8ecm1uh dictator    Introduction #> 34          7wa8kk3d     l8ecm1uh dictator    Introduction #> 35          a7dppel1     t0rog7nz   survey    Demographics #> 36          a7dppel1     t0rog7nz   survey    Demographics #> 37          a7dppel1     t0rog7nz   survey    Demographics #> 38          a7dppel1     t0rog7nz   survey    Demographics #> 39          ao9kqvqn     l8ecm1uh dictator    Introduction #> 40          ao9kqvqn     l8ecm1uh dictator    Introduction #> 41          ao9kqvqn     l8ecm1uh dictator    Introduction #> 42          ao9kqvqn     l8ecm1uh dictator    Introduction #> 43          byxco6zo     gii59rga   survey    Demographics #> 44          d4sq7zio     l8ecm1uh dictator    Introduction #> 45          d4sq7zio     l8ecm1uh dictator    Introduction #> 46          d4sq7zio     l8ecm1uh dictator    Introduction #> 47          d4sq7zio     l8ecm1uh dictator    Introduction #> 48          ia9rnfvc     qyu3qg0q   survey    Demographics #> 49          ia9rnfvc     qyu3qg0q   survey    Demographics #> 50          ia9rnfvc     qyu3qg0q   survey    Demographics #> 51          ia9rnfvc     qyu3qg0q   survey    Demographics #> 52          iagvtslv     t0rog7nz   survey    Demographics #> 53          iagvtslv     t0rog7nz   survey    Demographics #> 54          iagvtslv     t0rog7nz   survey    Demographics #> 55          iagvtslv     t0rog7nz   survey    Demographics #> 56          iay3dhkn     7bfqtokx   survey    Demographics #> 57          iay3dhkn     7bfqtokx   survey    Demographics #> 58          iay3dhkn     7bfqtokx   survey    Demographics #> 59          iay3dhkn     7bfqtokx   survey    Demographics #> 60          jxh15obl     t0rog7nz   survey           Offer #> 61          jxh15obl     t0rog7nz   survey           Offer #> 62          jxh15obl     t0rog7nz   survey           Offer #> 63          jxh15obl     t0rog7nz   survey           Offer #> 64          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 65          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 66          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 67          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 68          lsl3vbij     7bfqtokx   survey    Demographics #> 69          lsl3vbij     7bfqtokx   survey    Demographics #> 70          lsl3vbij     7bfqtokx   survey    Demographics #> 71          lsl3vbij     7bfqtokx   survey    Demographics #> 72          rvce7958     7bfqtokx   survey    Demographics #> 73          rvce7958     7bfqtokx   survey    Demographics #> 74          rvce7958     7bfqtokx   survey    Demographics #> 75          rvce7958     7bfqtokx   survey    Demographics #> 76          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 77          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 78          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 79          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 80          wk247s9w     t0rog7nz   survey    Demographics #> 81          wk247s9w     t0rog7nz   survey    Demographics #> 82          wk247s9w     t0rog7nz   survey    Demographics #> 83          wk247s9w     t0rog7nz   survey    Demographics #> 84          xkobdvuh     t0rog7nz   survey    Demographics #> 85          xkobdvuh     t0rog7nz   survey    Demographics #> 86          xkobdvuh     t0rog7nz   survey    Demographics #> 87          xkobdvuh     t0rog7nz   survey    Demographics #> 88          xmxl46rm     vd1h01iv   survey    Demographics #> 89          xmxl46rm     vd1h01iv   survey    Demographics #> 90          xmxl46rm     vd1h01iv   survey    Demographics #> 91          xmxl46rm     vd1h01iv   survey    Demographics #> 92          xx78b3x0     vd1h01iv   survey    Demographics #> 93          xx78b3x0     vd1h01iv   survey    Demographics #> 94          xx78b3x0     vd1h01iv   survey    Demographics #> 95          xx78b3x0     vd1h01iv   survey    Demographics #> 96          zdki96d6     gii59rga   survey    Demographics #> 97          znri6myc     l8ecm1uh dictator    Introduction #> 98          znri6myc     l8ecm1uh dictator    Introduction #> 99          znri6myc     l8ecm1uh dictator    Introduction #> 100         znri6myc     l8ecm1uh dictator    Introduction #>                                                  reason #> 1         Experiment not completed. Noticed at: chatapp #> 2   Experiment not completed. Noticed at: all_apps_wide #> 3        Experiment not completed. Noticed at: dictator #> 4          Experiment not completed. Noticed at: survey #> 5   Experiment not completed. Noticed at: all_apps_wide #> 6         Experiment not completed. Noticed at: chatapp #> 7   Experiment not completed. Noticed at: all_apps_wide #> 8        Experiment not completed. Noticed at: dictator #> 9          Experiment not completed. Noticed at: survey #> 10         Experiment not completed. Noticed at: survey #> 11  Experiment not completed. Noticed at: all_apps_wide #> 12       Experiment not completed. Noticed at: dictator #> 13        Experiment not completed. Noticed at: chatapp #> 14        Experiment not completed. Noticed at: chatapp #> 15       Experiment not completed. Noticed at: dictator #> 16         Experiment not completed. Noticed at: survey #> 17  Experiment not completed. Noticed at: all_apps_wide #> 18  Experiment not completed. Noticed at: all_apps_wide #> 19       Experiment not completed. Noticed at: dictator #> 20        Experiment not completed. Noticed at: chatapp #> 21         Experiment not completed. Noticed at: survey #> 22        Experiment not completed. Noticed at: chatapp #> 23         Experiment not completed. Noticed at: survey #> 24  Experiment not completed. Noticed at: all_apps_wide #> 25       Experiment not completed. Noticed at: dictator #> 26  Experiment not completed. Noticed at: all_apps_wide #> 27       Experiment not completed. Noticed at: dictator #> 28        Experiment not completed. Noticed at: chatapp #> 29  Experiment not completed. Noticed at: all_apps_wide #> 30         Experiment not completed. Noticed at: survey #> 31        Experiment not completed. Noticed at: chatapp #> 32  Experiment not completed. Noticed at: all_apps_wide #> 33       Experiment not completed. Noticed at: dictator #> 34         Experiment not completed. Noticed at: survey #> 35         Experiment not completed. Noticed at: survey #> 36  Experiment not completed. Noticed at: all_apps_wide #> 37       Experiment not completed. Noticed at: dictator #> 38        Experiment not completed. Noticed at: chatapp #> 39        Experiment not completed. Noticed at: chatapp #> 40  Experiment not completed. Noticed at: all_apps_wide #> 41       Experiment not completed. Noticed at: dictator #> 42         Experiment not completed. Noticed at: survey #> 43  Experiment not completed. Noticed at: all_apps_wide #> 44        Experiment not completed. Noticed at: chatapp #> 45  Experiment not completed. Noticed at: all_apps_wide #> 46       Experiment not completed. Noticed at: dictator #> 47         Experiment not completed. Noticed at: survey #> 48  Experiment not completed. Noticed at: all_apps_wide #> 49       Experiment not completed. Noticed at: dictator #> 50        Experiment not completed. Noticed at: chatapp #> 51         Experiment not completed. Noticed at: survey #> 52        Experiment not completed. Noticed at: chatapp #> 53         Experiment not completed. Noticed at: survey #> 54  Experiment not completed. Noticed at: all_apps_wide #> 55       Experiment not completed. Noticed at: dictator #> 56         Experiment not completed. Noticed at: survey #> 57  Experiment not completed. Noticed at: all_apps_wide #> 58       Experiment not completed. Noticed at: dictator #> 59        Experiment not completed. Noticed at: chatapp #> 60  Experiment not completed. Noticed at: all_apps_wide #> 61       Experiment not completed. Noticed at: dictator #> 62        Experiment not completed. Noticed at: chatapp #> 63         Experiment not completed. Noticed at: survey #> 64        Experiment not completed. Noticed at: chatapp #> 65  Experiment not completed. Noticed at: all_apps_wide #> 66       Experiment not completed. Noticed at: dictator #> 67         Experiment not completed. Noticed at: survey #> 68        Experiment not completed. Noticed at: chatapp #> 69       Experiment not completed. Noticed at: dictator #> 70  Experiment not completed. Noticed at: all_apps_wide #> 71         Experiment not completed. Noticed at: survey #> 72        Experiment not completed. Noticed at: chatapp #> 73  Experiment not completed. Noticed at: all_apps_wide #> 74       Experiment not completed. Noticed at: dictator #> 75         Experiment not completed. Noticed at: survey #> 76  Experiment not completed. Noticed at: all_apps_wide #> 77       Experiment not completed. Noticed at: dictator #> 78        Experiment not completed. Noticed at: chatapp #> 79         Experiment not completed. Noticed at: survey #> 80        Experiment not completed. Noticed at: chatapp #> 81         Experiment not completed. Noticed at: survey #> 82  Experiment not completed. Noticed at: all_apps_wide #> 83       Experiment not completed. Noticed at: dictator #> 84        Experiment not completed. Noticed at: chatapp #> 85       Experiment not completed. Noticed at: dictator #> 86         Experiment not completed. Noticed at: survey #> 87  Experiment not completed. Noticed at: all_apps_wide #> 88       Experiment not completed. Noticed at: dictator #> 89        Experiment not completed. Noticed at: chatapp #> 90  Experiment not completed. Noticed at: all_apps_wide #> 91         Experiment not completed. Noticed at: survey #> 92        Experiment not completed. Noticed at: chatapp #> 93  Experiment not completed. Noticed at: all_apps_wide #> 94       Experiment not completed. Noticed at: dictator #> 95         Experiment not completed. Noticed at: survey #> 96  Experiment not completed. Noticed at: all_apps_wide #> 97        Experiment not completed. Noticed at: chatapp #> 98       Experiment not completed. Noticed at: dictator #> 99  Experiment not completed. Noticed at: all_apps_wide #> 100        Experiment not completed. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          1l5kal0r     t0rog7nz   survey    Demographics #> 5          1mn1kzs7     gii59rga   survey    Demographics #> 6          2d72mfgh     7bfqtokx   survey    Demographics #> 10         2scvem7a     vd1h01iv dictator ResultsWaitPage #> 14         3ttf7yix     7bfqtokx   survey    Demographics #> 18         46kxib6w     7bfqtokx   survey    Demographics #> 22         4zhzdmzo     7bfqtokx   survey    Demographics #> 26         6cim3a5i     gii59rga   survey    Demographics #> 27         7l0hmpcq     qyu3qg0q   survey    Demographics #> 31         7wa8kk3d     l8ecm1uh dictator    Introduction #> 35         a7dppel1     t0rog7nz   survey    Demographics #> 39         ao9kqvqn     l8ecm1uh dictator    Introduction #> 43         byxco6zo     gii59rga   survey    Demographics #> 44         d4sq7zio     l8ecm1uh dictator    Introduction #> 48         ia9rnfvc     qyu3qg0q   survey    Demographics #> 52         iagvtslv     t0rog7nz   survey    Demographics #> 56         iay3dhkn     7bfqtokx   survey    Demographics #> 60         jxh15obl     t0rog7nz   survey           Offer #> 64         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 68         lsl3vbij     7bfqtokx   survey    Demographics #> 72         rvce7958     7bfqtokx   survey    Demographics #> 76         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 80         wk247s9w     t0rog7nz   survey    Demographics #> 84         xkobdvuh     t0rog7nz   survey    Demographics #> 88         xmxl46rm     vd1h01iv   survey    Demographics #> 92         xx78b3x0     vd1h01iv   survey    Demographics #> 96         zdki96d6     gii59rga   survey    Demographics #> 97         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 6  Experiment not completed #> 10 Experiment not completed #> 14 Experiment not completed #> 18 Experiment not completed #> 22 Experiment not completed #> 26 Experiment not completed #> 27 Experiment not completed #> 31 Experiment not completed #> 35 Experiment not completed #> 39 Experiment not completed #> 43 Experiment not completed #> 44 Experiment not completed #> 48 Experiment not completed #> 52 Experiment not completed #> 56 Experiment not completed #> 60 Experiment not completed #> 64 Experiment not completed #> 68 Experiment not completed #> 72 Experiment not completed #> 76 Experiment not completed #> 80 Experiment not completed #> 84 Experiment not completed #> 88 Experiment not completed #> 92 Experiment not completed #> 96 Experiment not completed #> 97 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #>  [1] \"1l5kal0r\" \"1mn1kzs7\" \"2d72mfgh\" \"2scvem7a\" \"3ttf7yix\" \"46kxib6w\" #>  [7] \"4zhzdmzo\" \"6cim3a5i\" \"7l0hmpcq\" \"7wa8kk3d\" \"a7dppel1\" \"ao9kqvqn\" #> [13] \"byxco6zo\" \"d4sq7zio\" \"ia9rnfvc\" \"iagvtslv\" \"iay3dhkn\" \"jxh15obl\" #> [19] \"ktjz5jli\" \"lsl3vbij\" \"rvce7958\" \"vbhvhozv\" \"wk247s9w\" \"xkobdvuh\" #> [25] \"xmxl46rm\" \"xx78b3x0\" \"zdki96d6\" \"znri6myc\" #>  #> $count #> [1] 28 #>"},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-130","dir":"Changelog","previous_headings":"","what":"gmoTree 1.3.0","title":"gmoTree 1.3.0","text":"Resolved issue Constants vector presentations output files Fixed incorrect handling equal signs (=) documentation choices. splitvarname deal long variable names. Caveat: cases, columns may still overlap. Control output carefully. sep_list decide list presentation newline presentation output file initial include initial values codebook New preamble text Expanded input possibilities greater flexibility Changed default output_format pdf_document_simple Better presentations quotations inside strings Quotation marks now presented straight smart form Removed non-escaped quotation marks output Values now saved list format vectors Types variables now correspond better types original variables Improved list presentation output files better readability Enhanced error warning messages function can now better deal better empty arguments oTree code Linted older functions (readable) Website changes","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-121","dir":"Changelog","previous_headings":"","what":"gmoTree 1.2.1","title":"gmoTree 1.2.1","text":"codebook(): Create codebook oTree code Linted code (readable) Minor changes warning messages tests examples","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-110","dir":"Changelog","previous_headings":"","what":"gmoTree 1.1.0","title":"gmoTree 1.1.0","text":"CRAN release: 2024-07-04 extime(): Enhanced efficiency extended functionality: Introduced capability perform calculations using ‘seconds_on_page2’ variable. apptime(): Enhanced efficiency extended functionality: Introduced capability perform calculations using ‘seconds_on_page2’ variable. Linted code (efficient & readable) Minor changes tests.R Minor changes website, new logo","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-101","dir":"Changelog","previous_headings":"","what":"gmoTree 1.0.1","title":"gmoTree 1.0.1","text":"CRAN release: 2023-10-25 Minor changes examples DESCRIPTION file. Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-100","dir":"Changelog","previous_headings":"","what":"gmoTree 1.0.0","title":"gmoTree 1.0.0","text":"File names examples now portable. import_otree(): Minor changes. Can also import portable file names now.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-003","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.3","title":"gmoTree 0.0.3","text":"Minor improvement documentation & website. Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-002","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.2","title":"gmoTree 0.0.2","text":"Minor improvement documentation & website. (Sent CRAN omitted .) Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-001","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.1","title":"gmoTree 0.0.1","text":"Beta version gmoTree published (formerly known “ioTree”).","code":""}]
+[{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"overview","dir":"Articles","previous_headings":"","what":"Overview","title":"gmoTree Codebooks","text":"gmoTree package provides tools generating codebooks based data oTree (Chen et al., 2016) framework function codebook(). vignette introduces key features functionalities. Disclaimer: code tested custom implementations official oTree sample codes.1 However, due complexity oTree setups, may address variations. Please review output carefully, feel free open GitHub issue encounter problems.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"running-the-code","dir":"Articles","previous_headings":"","what":"Running the code","title":"gmoTree Codebooks","text":"simplest form, function requires path oTree code. following code reads contents oTree file, saves file containing codebook working directory, returns list named cbook, containing extracted information.","code":"cbook <- codebook(\"D:/pathtoyourproject/oTree_codes\")"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"codebook-structure-and-output","dir":"Articles","previous_headings":"","what":"Codebook structure and output","title":"gmoTree Codebooks","text":"output structured clear headings: Heading Level 1: Represents app oTree data. Heading Level 2: Group Player variables, categorized within app. Showing class Constants optional can turned using argument include_cons = FALSE.  example shows output cournot app, includes Constants, Group, Player variables. class contains information, heading still appear, along message “Empty class.”  Use output = \"list\" bypass file creation. option returns information list format, can used R Markdown design custom codebook. example list output looks like. (argument doc_info = FALSE suppresses messages missing variable documentation.)","code":"# Create the codebook list cbook <- codebook(path = system.file(path = \"extdata/ocode_new\",                                       package = \"gmoTree\"),                    output = \"list\",                    doc_info = FALSE)   str(cbook, 1)  # Show all apps ## List of 16 ##  $ settings            :List of 10 ##  $ bargaining          :List of 4 ##  $ bertrand            :List of 4 ##  $ common_value_auction:List of 4 ##  $ cournot             :List of 4 ##  $ dictator            :List of 4 ##  $ guess_two_thirds    :List of 4 ##  $ matching_pennies    :List of 4 ##  $ payment_info        :List of 4 ##  $ prisoner            :List of 4 ##  $ public_goods_simple :List of 3 ##  $ survey              :List of 3 ##  $ traveler_dilemma    :List of 4 ##  $ trust               :List of 3 ##  $ trust_simple        :List of 3 ##  $ volunteer_dilemma   :List of 4 print(cbook$cournot)  # Only show cournot app ## $doc ## [1] \"In Cournot competition, firms simultaneously decide the units of products to manufacture. The unit selling price depends on the total units produced. In this implementation, there are 2 firms competing for 1 period.\" ##  ## $Constants ## $Constants$NAME_IN_URL ## [1] \"cournot\" ##  ## $Constants$PLAYERS_PER_GROUP ## [1] 2 ##  ## $Constants$NUM_ROUNDS ## [1] 1 ##  ## $Constants$TOTAL_CAPACITY ## [1] 60 ##  ## $Constants$MAX_UNITS_PER_PLAYER ## [1] \"int(60 / 2)\" ##  ##  ## $Group ## $Group$unit_price ## $Group$unit_price$noargs ## [1] TRUE ##  ## $Group$unit_price$field ## [1] \"CurrencyField\" ##  ##  ## $Group$total_units ## $Group$total_units$noargs ## [1] FALSE ##  ## $Group$total_units$doc ## [1] \"Total units produced by all players\" ##  ## $Group$total_units$field ## [1] \"IntegerField\" ##  ##  ##  ## $Player ## $Player$units ## $Player$units$noargs ## [1] \"FALSE\" ##  ## $Player$units$min ## [1] \"0\" ##  ## $Player$units$max ## [1] \"int(60 / 2)\" ##  ## $Player$units$doc ## [1] \"Quantity of units to produce\" ##  ## $Player$units$label ## [1] \"How many units will you produce (from 0 to 30)?\" ##  ## $Player$units$field ## [1] \"IntegerField\""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"apps","dir":"Articles","previous_headings":"Choosing what to show","what":"Apps","title":"gmoTree Codebooks","text":"Per default, apps included codebook. generate codebook one app, use app argument. example, generate codebook cournot app: code returns list app-specific information. can also generate codebooks multiple apps specifying app argument. can also choose remove one apps. example removes app prisoner:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\",                      package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = \"cournot\")  str(cbook) ## List of 2 ##  $ settings:List of 10 ##   ..$ variable                : num 66 ##   ..$ PARTICIPANT_FIELDS      : list() ##   ..$ SESSION_FIELDS          : list() ##   ..$ LANGUAGE_CODE           : chr \"en\" ##   ..$ REAL_WORLD_CURRENCY_CODE: chr \"USD\" ##   ..$ USE_POINTS              : chr \"True\" ##   ..$ ADMIN_USERNAME          : chr \"admin\" ##   ..$ ADMIN_PASSWORD          : chr \"environ.get('OTREE_ADMIN_PASSWORD')\" ##   ..$ DEMO_PAGE_INTRO_HTML    : chr \"Here are some oTree games.\" ##   ..$ SECRET_KEY              : chr \"9356668094877\" ##  $ cournot :List of 4 ##   ..$ doc      : chr \"In Cournot competition, firms simultaneously decide the units of products to manufacture. The unit selling pric\"| __truncated__ ##   ..$ Constants:List of 5 ##   .. ..$ NAME_IN_URL         : chr \"cournot\" ##   .. ..$ PLAYERS_PER_GROUP   : num 2 ##   .. ..$ NUM_ROUNDS          : num 1 ##   .. ..$ TOTAL_CAPACITY      : num 60 ##   .. ..$ MAX_UNITS_PER_PLAYER: chr \"int(60 / 2)\" ##   ..$ Group    :List of 2 ##   .. ..$ unit_price :List of 2 ##   .. .. ..$ noargs: logi TRUE ##   .. .. ..$ field : chr \"CurrencyField\" ##   .. ..$ total_units:List of 3 ##   .. .. ..$ noargs: logi FALSE ##   .. .. ..$ doc   : chr \"Total units produced by all players\" ##   .. .. ..$ field : chr \"IntegerField\" ##   ..$ Player   :List of 1 ##   .. ..$ units:List of 6 ##   .. .. ..$ noargs: chr \"FALSE\" ##   .. .. ..$ min   : chr \"0\" ##   .. .. ..$ max   : chr \"int(60 / 2)\" ##   .. .. ..$ doc   : chr \"Quantity of units to produce\" ##   .. .. ..$ label : chr \"How many units will you produce (from 0 to 30)?\" ##   .. .. ..$ field : chr \"IntegerField\" cbook <- codebook(   path = system.file(\"extdata/ocode_new\",                      package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = c(\"cournot\", \"dictator\"))  str(cbook, 1) ## List of 3 ##  $ settings:List of 10 ##  $ cournot :List of 4 ##  $ dictator:List of 4 cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app_rm = \"prisoner\")  str(cbook, 1) ## List of 15 ##  $ settings            :List of 10 ##  $ bargaining          :List of 4 ##  $ bertrand            :List of 4 ##  $ common_value_auction:List of 4 ##  $ cournot             :List of 4 ##  $ dictator            :List of 4 ##  $ guess_two_thirds    :List of 4 ##  $ matching_pennies    :List of 4 ##  $ payment_info        :List of 4 ##  $ public_goods_simple :List of 3 ##  $ survey              :List of 3 ##  $ traveler_dilemma    :List of 4 ##  $ trust               :List of 3 ##  $ trust_simple        :List of 3 ##  $ volunteer_dilemma   :List of 4"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"otree-data-description","dir":"Articles","previous_headings":"Choosing what to show","what":"oTree data description","title":"gmoTree Codebooks","text":"setting preamb = TRUE parameter, predefined description oTree data inserted beginning codebook, explaining experimental data stored oTree.","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"customizing-the-codebook-titles-and-metadata","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Customizing the codebook titles and metadata","title":"gmoTree Codebooks","text":"can easily modify titles, subtitles, dates, author names codebooks using following arguments:","code":"codebook(     path = \"YouroTreePath\",  # Can be either absolute or relative!     title = \"Codebook\",     subtitle = \"Example Project\",     date = \"today\",     params = list(author = c(\"Max Mustermann\", \"John Doe\")) )"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"sorting-the-code","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Sorting the code","title":"gmoTree Codebooks","text":"can sort apps codebook specifying sort argument. example:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   doc_info = FALSE,   app = c(\"cournot\", \"dictator\"),   sort = c(\"dictator\", \"cournot\"))  str(cbook, 1) ## List of 3 ##  $ settings:List of 10 ##  $ dictator:List of 4 ##  $ cournot :List of 4"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"referring-to-settings","dir":"Articles","previous_headings":"Customizing how the codebook is shown","what":"Referring to settings","title":"gmoTree Codebooks","text":"gmoTree package can automatically replace references variables settings.py values settings.py file. enable , set settings_replace = \"global\". can also choose replace references settings variables using settings_replace = NULL. also possible provide list variables replace settings variables argument user_settings. example:","code":"cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = \"global\",   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] 66 cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = NULL,   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] \"settings.variable\" cbook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   settings_replace = \"user\",   user_settings = list(variable = \"someValue\"),   app = \"dictator\") ## Variables without documentation, label, or verbose name: ## > $dictator$Player$gender print(cbook$dictator$Constants$Variable) ## [1] \"someValue\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"saving-your-codebook","dir":"Articles","previous_headings":"","what":"Saving your codebook","title":"gmoTree Codebooks","text":"choose output = \"file\" output = \"\", codebook saved professional document ready publication sharing.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"output-formats","dir":"Articles","previous_headings":"Saving your codebook","what":"Output formats","title":"gmoTree Codebooks","text":"argument output_format allows choose format exported codebook file. Available formats : html_document word_document latex_document odt_document rtf_document md_document pdf_document pdf_document_simple can choose format best suits needs, formats except PDF allowing easy post-generation editing. knitting PDF, make sure LaTex installed! recommended use output_format = pdf_document_simple. However, many non-Latin characters (e.g., Chinese characters) may work format. cases, can choose output_format = pdf_document, set use xelatex. Please note using xelatex gmoTree limitations: example, gmoTree currently handle long variable values result excessively long table cells. can cause PDF display improperly certain viewers, Nitro. address , carefully review file. necessary, consider using output_format = latex_document. Alternatively, open file PDF viewer can handle cases, save ensure displays correctly PDF viewers.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"output-files","dir":"Articles","previous_headings":"Saving your codebook","what":"Output files","title":"gmoTree Codebooks","text":"default, gmoTree codebooks saved working directory default file name codebook. can modify specifying custom file name directory path. example, save codebook different name, use following code: can also include file extension, although optional: can save file subfolder within current directory including absolute relative folder name output_file argument. example: can also specify absolute paths, either output_dir argument directly within file name specified output_file. example:","code":"codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"gmoTree_codebook\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"gmoTree_codebook.pdf\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_file = \"codebookfiles/gmoTree_codebook.pdf\") codebook(     path = \"C:/Users/username/folder/oTree\",  # Replace!     output_dir  = \"C:/Users/username/folder/codebooks\",     output_file = \"mycodebook\")"},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"summary","dir":"Articles","previous_headings":"","what":"Summary","title":"gmoTree Codebooks","text":"vignette documents customize codebook generated codebook() function, including options content selection, formatting, exporting various formats. tools enable creation comprehensive tailored documentation experimental data.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/codebook.html","id":"references","dir":"Articles","previous_headings":"","what":"References","title":"gmoTree Codebooks","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"background-information-on-the-data-downloaded-by-otree","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"Background information on the data downloaded by oTree","title":"Introduction to gmoTree","text":"oTree experiment structured around one modular units called “apps,” encompass one multiple “pages.” Data generated app can downloaded individually, offering flexibility analyze separate components experiment. -encompassing view experiment, data apps can also downloaded comprehensive file labeled “all_apps_wide.” addition aforementioned app data cumulative all_apps_wide file, oTree generates file time stamps every page. file documenting chat interactions also provided experiment includes one multiple chat rooms. newer oTree versions, also custom data can downloaded. oTree experiment run across different databases, set data files downloaded database. include individual app data files, all_apps_wide file, file time stamps every page, chat log file chat room used experiment. gmoTree package’s functionality lies ability load aggregate files ease.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"import_otree","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"import_otree()","title":"Introduction to gmoTree","text":"can import oTree data combine list data frames using import_otree() function. data frame named according associated app, function generates accompanying info list details essential information regarding imported files, deleted cases. information list updated use functions within package. worth noting even use one all_apps_wide file, still load data import_otree() want access functions within gmoTree package. Alternatively, reproduce structure created function hand. following example shows import oTree data, structure oTree list data frames importing data, information provided oTree$info. Caution: function works oTree data saved using typical oTree file pattern!","code":"# Get path to the package data path <- system.file(\"extdata/exp_data_5.4.0\", package = \"gmoTree\")  # Import without specifications # Import all oTree files in this folder and its subfolders otree <- import_otree(path = path) ## Warning in import_otree(path = path): You have stored all_apps_wide globally ## but also room-specific. This function will import both of them. (Globally, the ## files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All ## apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing ## is there twice! (Advice: You may use delete_duplicate() to remove duplicate ## rows of all oTree data frames.  # Check the structure of the oTree list of data frames str(otree, 1) ## List of 8 ##  $ all_apps_wide:'data.frame':   12 obs. of  60 variables: ##  $ info         :List of 2 ##  $ chatapp      :'data.frame':   8 obs. of  24 variables: ##  $ dictator     :'data.frame':   48 obs. of  25 variables: ##  $ start        :'data.frame':   8 obs. of  24 variables: ##  $ survey       :'data.frame':   8 obs. of  29 variables: ##  $ Time         :'data.frame':   77 obs. of  10 variables: ##  $ Chats        :'data.frame':   6 obs. of  7 variables:  # The initial info list otree$info ## $imported_files ## [1] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/ChatMessages-2023-05-16.csv\"  ## [2] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/PageTimes-2023-05-16.csv\"     ## [3] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/survey_2023-05-16.csv\"        ## [4] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/start_2023-05-16.csv\"         ## [5] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/dictator_2023-05-16.csv\"      ## [6] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/dictator_2023-05-00.csv\"      ## [7] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/chatapp_2023-05-16.csv\"       ## [8] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/all_apps_wide_2023-05-16.csv\" ## [9] \"C:/Users/Lenovo/AppData/Local/R/win-library/4.4/gmoTree/extdata/exp_data_5.4.0/all_apps_wide-2023-05-16.csv\" ##  ## $initial_n ## [1] 12"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_duplicate","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"delete_duplicate()","title":"Introduction to gmoTree","text":"Sometimes, data imported several times. happen several reasons. First, one data set might part another download temporarily stored data downloading final data frame. Second, room-specific global data imported, data $all_apps_wide data frame two times. Third, data stored several imported folders. function delete_duplicate() deletes duplicate data apps $all_apps_wide. , however, change $Time $Chats data frames. running function, let us first check number participant codes initial count executing delete_duplicate() function. imported $all_apps_wide data frame, 12 participant codes. However, among , 8 unique, indicates presence duplicate data. $info data frame suggests initially 12 entries. remove duplicates, employ delete_duplicate() function: Please note details deleted rows added list deleted cases. list might used analysis, function mainly focuses cleaning untidy data import. However, count $info$initial_n adjusted accordingly. deletion operation, find participant codes unique, count $info$initial_n matches number unique participant codes.","code":"# Initial check before deletion length(otree$all_apps_wide$participant.code) ## [1] 12 length(unique(otree$all_apps_wide$participant.code)) ## [1] 8 otree$info$initial_n ## [1] 12 # Delete duplicate cases otree <- delete_duplicate(otree) # Check participant codes and initial_n after deletion length(otree$all_apps_wide$participant.code) ## [1] 8 length(unique(otree$all_apps_wide$participant.code)) ## [1] 8 otree$info$initial_n ## [1] 8"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"dealing-with-messy-chats-and-time-data-frames","dir":"Articles","previous_headings":"Importing and cleaning up data","what":"Dealing with messy Chats and Time data frames","title":"Introduction to gmoTree","text":"combine data experiments ran different versions oTree, might happen several variables referring attribute $Time $Chats data frames. functions messy_chat() messy_time() integrate corresponding variables used argument combine = TRUE. show example, let us first load data different versions oTree. Now can run functions messy_time() messy_chat(). warning messages part expected output, indicating precisely variables combined. need concern see . However, can also turn using info = FALSE.","code":"# Import data from different oTree versions otree_all <- import_otree(   path = system.file(\"extdata\", package = \"gmoTree\")) ## Warning in import_otree(path = system.file(\"extdata\", package = \"gmoTree\")): ## You have stored all_apps_wide globally but also room-specific. This function ## will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" ## Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") ## After importing the data, make sure nothing is there twice! (Advice: You may ## use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Check names of Time data frame names(otree_all$Time) ##  [1] \"session_code\"              \"participant_id_in_session\" ##  [3] \"participant_code\"          \"page_index\"                ##  [5] \"app_name\"                  \"page_name\"                 ##  [7] \"epoch_time_completed\"      \"round_number\"              ##  [9] \"timeout_happened\"          \"is_wait_page\"  # Check names of Chats data frame names(otree_all$Chats) ## [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          ## [5] \"nickname\"         \"body\"             \"timestamp\" otree_all <- messy_time(otree_all,                         combine = TRUE,                         info = TRUE) otree_all <- messy_chat(otree_all,                         combine = TRUE,                         info = TRUE) # Check names of Time data frame again names(otree_all$Time) ##  [1] \"session_code\"              \"participant_id_in_session\" ##  [3] \"participant_code\"          \"page_index\"                ##  [5] \"app_name\"                  \"page_name\"                 ##  [7] \"epoch_time_completed\"      \"round_number\"              ##  [9] \"timeout_happened\"          \"is_wait_page\"  # Check names of Chats data frame again names(otree_all$Chats) ## [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          ## [5] \"nickname\"         \"body\"             \"timestamp\""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"show_dropouts","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"show_dropouts()","title":"Introduction to gmoTree","text":"Sometimes, participants drop experiments. get overview dropouts, can use function show_dropouts(). creates three data frames/tables information participants finish () certain app(s) page(s). First, function show_dropouts() creates data frame $full provides specific information apps pages participants left experiment prematurely. Additionally, data frame indicates apps affected participants dropped . Second, function show_dropouts() also generates smaller data frame $unique includes information person . Third, function show_dropouts() furthermore creates table $all_end, contains information participants ended experiment. columns contain names pages experiment; rows contain names apps.","code":"# Show everyone that has not finished with the app \"survey\" dropout_list <- show_dropouts(otree, \"survey\")  head(dropout_list$full) ##   participant.code session.code  end_app        end_page ## 1         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 2         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 3         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 4         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 5         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6         dhgisush     2wlrl5kb dictator           Offer ##                                                reason ## 1 Experiment not completed. Noticed at: all_apps_wide ## 2       Experiment not completed. Noticed at: chatapp ## 3      Experiment not completed. Noticed at: dictator ## 4         Experiment not completed. Noticed at: start ## 5        Experiment not completed. Noticed at: survey ## 6 Experiment not completed. Noticed at: all_apps_wide dropout_list$unique ##    participant.code session.code  end_app        end_page ## 1          1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6          dhgisush     2wlrl5kb dictator           Offer ## 11         j2g9mcaf     jk9ekpl0 dictator    Introduction ## 16         p6m495xi     2wlrl5kb dictator    Introduction ##                      reason ## 1  Experiment not completed ## 6  Experiment not completed ## 11 Experiment not completed ## 16 Experiment not completed dropout_list$all_end ##            ##            Demographics Introduction Offer ResultsWaitPage ##   dictator            0            2     1               1 ##   survey              4            0     0               0"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_dropouts","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_dropouts()","title":"Introduction to gmoTree","text":"function delete_dropouts() removes data related participants prematurely terminated experiment data frames oTree list, exception data info list $Chats data frame. highly recommend manually delete chat data, can occasionally become unintelligible one person’s input removed. Therefore, function delete chat input participants dropped experiment. running example, let us first check row numbers data frames. run function delete_dropouts() check row numbers , see cases deleted data frame $Chats data frame. Just show_dropouts(), delete_dropouts() function also gives detailed information deleted cases. Caution: function delete data original CSV Excel files!","code":"# First, check some row numbers nrow(otree$all_apps_wide) ## [1] 8 nrow(otree$survey) ## [1] 8 nrow(otree$Time) ## [1] 77 nrow(otree$Chats) ## [1] 6 # Delete all cases that didn't end the experiment on the page \"Demographics\" # within the app \"survey\" otree2 <- delete_dropouts(otree,                          final_apps = \"survey\",                          final_pages = \"Demographics\",                          info = TRUE) ## 4 case(s) deleted ## Dropouts are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary!  # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 66 nrow(otree2$Chats) ## [1] 6 head(otree2$info$deleted_cases$full) ##   participant.code session.code  end_app        end_page ## 1         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 2         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 3         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 4         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 5         1k58kgm7     jk9ekpl0 dictator ResultsWaitPage ## 6         dhgisush     2wlrl5kb dictator           Offer ##                           reason ## 1        ENC. Noticed at: survey ## 2         ENC. Noticed at: start ## 3      ENC. Noticed at: dictator ## 4       ENC. Noticed at: chatapp ## 5 ENC. Noticed at: all_apps_wide ## 6        ENC. Noticed at: survey  otree2$info$deleted_cases$unique ##    participant.code session.code  end_app        end_page reason ## 1          1k58kgm7     jk9ekpl0 dictator ResultsWaitPage    ENC ## 6          dhgisush     2wlrl5kb dictator           Offer    ENC ## 11         j2g9mcaf     jk9ekpl0 dictator    Introduction    ENC ## 16         p6m495xi     2wlrl5kb dictator    Introduction    ENC  otree2$info$deleted_cases$all_end ##            ##            Demographics Introduction Offer ResultsWaitPage ##   dictator            0            2     1               1 ##   survey              4            0     0               0"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_cases","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_cases()","title":"Introduction to gmoTree","text":"Sometimes, participants ask data deleted. delete_cases() function can delete person app’s data frame, $all_apps_wide, $Time data frame. , data $Chats data frame must deleted hand. function adds information deleted cases previously created information deleted cases. Caution: function delete data original CSV Excel files!","code":"# First, check some row numbers nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 66 nrow(otree2$Chats) ## [1] 6 # Delete one participant person <- otree2$all_apps_wide$participant.code[1] otree2 <- delete_cases(otree2,                        pcodes = person,                        reason = \"requested\",                        saved_vars = \"participant._index_in_pages\",                        info = TRUE) ## 1 case(s) deleted. Cases are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary! # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 3 nrow(otree2$survey) ## [1] 3 nrow(otree2$Time) ## [1] 48 nrow(otree2$Chats) ## [1] 6 # Check for all deleted cases (also dropouts): tail(otree2$info$deleted_cases$full) ##    participant.code session.code  end_app     end_page ## 16         p6m495xi     2wlrl5kb dictator Introduction ## 17         p6m495xi     2wlrl5kb dictator Introduction ## 18         p6m495xi     2wlrl5kb dictator Introduction ## 19         p6m495xi     2wlrl5kb dictator Introduction ## 20         p6m495xi     2wlrl5kb dictator Introduction ## 21         sdh9ar2m         <NA>                       ##                            reason  session participant._index_in_pages ## 16        ENC. Noticed at: survey     <NA>                          NA ## 17         ENC. Noticed at: start     <NA>                          NA ## 18      ENC. Noticed at: dictator     <NA>                          NA ## 19       ENC. Noticed at: chatapp     <NA>                          NA ## 20 ENC. Noticed at: all_apps_wide     <NA>                          NA ## 21                      requested jk9ekpl0                          18"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_sessions","dir":"Articles","previous_headings":"Dealing with dropouts and deleting cases","what":"delete_sessions()","title":"Introduction to gmoTree","text":"certainly hope never becomes necessary, may instances entire session needs removed data set due unforeseen issues. However, occurs, can use function delete_sessions(). function removes sessions’ data apps, $all_apps_wide, $Time data frame also sessions’ chat data $Chats data frame chatting usually restricted within session. following, see row numbers deletion, application function, row numbers deletion. Apart functions, sessions’ entries $Chats data frame destroyed since chat data occurs just per session may thus eliminated without impacting comprehensibility chat data.","code":"# First, check some row numbers nrow(otree2$all_apps_wide) ## [1] 3 nrow(otree2$survey) ## [1] 3 nrow(otree2$Time) ## [1] 48 nrow(otree2$Chats) ## [1] 6 # Delete one session otree2 <- delete_sessions(otree,   scodes = \"jk9ekpl0\",   reason = \"Only tests\",   info = TRUE) ## 4 case(s) deleted # Check row numbers again nrow(otree2$all_apps_wide) ## [1] 4 nrow(otree2$survey) ## [1] 4 nrow(otree2$Time) ## [1] 38 nrow(otree2$Chats) ## [1] 3"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"delete_pabels","dir":"Articles","previous_headings":"Deleting sensitive information","what":"delete_pabels()","title":"Introduction to gmoTree","text":"uncommon participant.label variable contain sensitive information like MTurk worker ID. can raise serious privacy concerns. function delete_plabels() automatically removes variable data frames. Additionally, function option delete MTurk-related variables. following, see application delete_plabels() function, preceded information sensitive variables running function followed information sensitive variables running function. Caution: function delete variable original CSV Excel files!","code":"# Check variables head(otree2$all_apps_wide$participant.label) ## [1] \"\"        \"\"        \"Person1\" \"Person2\" head(otree2$all_apps_wide$participant.mturk_worker_id) ## [1] NA NA NA NA head(otree2$survey$participant.label) ## [1] \"\"        \"\"        \"Person1\" \"Person2\"  # Delete all participant labels otree2 <- delete_plabels(otree2, del_mturk = TRUE)  # Check variables head(otree2$all_apps_wide$participant.label) ## NULL head(otree2$all_apps_wide$participant.mturk_worker_id) ## NULL head(otree2$survey$participant.label) ## NULL"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"make_ids","dir":"Articles","previous_headings":"Making IDs","what":"make_ids()","title":"Introduction to gmoTree","text":"working oTree, participant codes, session codes, group IDs used identify cases. However, often, researchers prefer streamlined, consecutive numbering system spans sessions, beginning first participant, session, group concluding last. make_ids() function provides way achieve goal. using function, let us inspect underlying variables first. function returns following variables. prior example, Group IDs calculated group IDs must called specifically. Since group IDs per app data match (groups relevant dictator app), just using group_id = TRUE lead error message. cases group IDs vary among apps, can specified make_ids() app variable used extracting group information. instance, following syntax can used obtain group IDs variable dictator.1.group.id_in_subsession $all_apps_wide.","code":"# Check variables first otree2$all_apps_wide$participant.code ## [1] \"dhgisush\" \"p6m495xi\" \"c9inx5wl\" \"kr8yd7f3\" otree2$all_apps_wide$session.code ## [1] \"2wlrl5kb\" \"2wlrl5kb\" \"mz2r27bk\" \"mz2r27bk\" otree2$all_apps_wide$dictator.1.group.id_in_subsession ## [1] 1 1 1 1 # Make session IDs only otree2 <- make_ids(otree2) # Check variables otree2$all_apps_wide$participant_id ## [1] 1 2 3 4 otree2$all_apps_wide$session_id ## [1] 1 1 2 2 # Get IDs from \"from_variable\" in the data frame \"all_apps_wide\" otree2 <- make_ids(otree2,                    # gmake = TRUE,  # Not necessary if from_var is not NULL                    from_var = \"dictator.1.group.id_in_subsession\") ## Warning in make_ids(otree2, from_var = \"dictator.1.group.id_in_subsession\"): ## The group variable values are constant. Group IDs now correspond to session ## IDs. # Check variables otree2$all_apps_wide$participant_id ## [1] 1 2 3 4 otree2$all_apps_wide$group_id ## [1] 1 1 2 2 otree2$all_apps_wide$session_id ## [1] 1 1 2 2"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"apptime","dir":"Articles","previous_headings":"Measuring the time","what":"apptime()","title":"Introduction to gmoTree","text":"need determine much time participants spent specific app, apptime() function powerful tool can help. function calculates summary statistics mean, minimum, maximum time spent page, well detailed list durations participant app. following example shows much time participants spent app “survey” minutes. can also get time specific participants . Without specifying applications, get duration applications individually.","code":"# Calculate the time all participants spent on app \"survey\" apptime(otree2, apps = \"survey\", digits = 3) ## $mean_duration ## [1] 0.242 ##  ## $min_duration ## [1] 0.233 ##  ## $max_duration ## [1] 0.25 ##  ## $single_durations ##   participant  session duration ## 1    c9inx5wl mz2r27bk    0.250 ## 2    kr8yd7f3 mz2r27bk    0.233 ##  ## $messages ## [1] \"For some participants, no duration could be calculated. See list in $warnings.\" ##  ## $warnings ## [1] \"dhgisush\" \"p6m495xi\" # Calculate the time one participant spent on app \"dictator\" apptime(otree2, pcode = \"c9inx5wl\", digits = 3) ## $chatapp ## [1] 0.267 ##  ## $dictator ## [1] 0.5 ##  ## $start ## [1] 0.017 ##  ## $survey ## [1] 0.25"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"extime","dir":"Articles","previous_headings":"Measuring the time","what":"extime()","title":"Introduction to gmoTree","text":"need determine much time participants spent complete experiment, can use extime() function. function calculates summary statistics mean, minimum, maximum time spent experiment, well detailed list durations participant. (Note min, max, mean values two digits underlying data.) can also get duration just one participant.","code":"# Calculate the time that all participants spent on the experiment extime(otree2, digits = 3) ## $mean_duration ## [1] 0.525 ##  ## $min_duration ## [1] 0.05 ##  ## $max_duration ## [1] 1.033 ##  ## $single_durations ##   participant  session duration ## 2    p6m495xi 2wlrl5kb    0.050 ## 1    dhgisush 2wlrl5kb    0.117 ## 4    kr8yd7f3 mz2r27bk    0.900 ## 3    c9inx5wl mz2r27bk    1.033 # Calculate the time one participant spent on the experiment extime(otree2, pcode = \"c9inx5wl\", digits = 3) ## [1] 1.033"},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"pagesec","dir":"Articles","previous_headings":"Measuring the time","what":"pagesec()","title":"Introduction to gmoTree","text":"older versions oTree included variable called seconds_on_page $Time data frame. Although good reason omit , sometimes want detailed information time spent one page. Therefore, created function pagesec() adds new variable seconds_on_page2 $Time data frame.","code":"# Create two new columns: seconds_on_page2 and minutes_on_page otree2 <- pagesec(otree2, rounded = TRUE, minutes = TRUE) tail(otree2$Time) ##    timeout_happened is_wait_page group_id session_id participant_id ## 72                0            0        2          2              3 ## 73                0            0        2          2              4 ## 74                0            0        2          2              4 ## 75                0            0        2          2              3 ## 76                0            0        2          2              4 ## 77                0            0        2          2              3 ##    session_code participant_id_in_session participant_code page_index app_name ## 72     mz2r27bk                         1         c9inx5wl         15   survey ## 73     mz2r27bk                         2         kr8yd7f3         15   survey ## 74     mz2r27bk                         2         kr8yd7f3         16   survey ## 75     mz2r27bk                         1         c9inx5wl         16   survey ## 76     mz2r27bk                         2         kr8yd7f3         17   survey ## 77     mz2r27bk                         1         c9inx5wl         17   survey ##                  page_name epoch_time_completed round_number minutes_on_page ## 72 CognitiveReflectionTest           1684258104            1            0.05 ## 73 CognitiveReflectionTest           1684258108            1            0.13 ## 74                   Offer           1684258109            1            0.02 ## 75                   Offer           1684258110            1            0.10 ## 76            Demographics           1684258114            1            0.08 ## 77            Demographics           1684258116            1            0.10"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"assignv","dir":"Articles","previous_headings":"Transferring variables between the apps","what":"assignv()","title":"Introduction to gmoTree","text":"function assignv() copies variable $all_apps_wide data frame data frames apps. following example, variable survey.1.player.gender copied $all_apps_wide app data frames; data frames, new variable named gender. also copies variable $all_apps_wide keep degree consistency.","code":"# Assign variable \"survey.1.player.gender\" and name it \"gender\" otree2 <- assignv(oTree = otree2,                  variable = \"survey.1.player.gender\",                  newvar = \"gender\") # Control otree2$dictator$gender ##  [1] \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       \"Female\" \"Male\"   ##  [9] \"Female\" \"Male\"   \"Female\" \"Male\" otree2$chatapp$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" # In app \"survey\", the variable is now twice because it is taken from here otree2$survey$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" otree2$survey$player.gender ## [1] \"\"       \"\"       \"Female\" \"Male\" # In app \"all_apps_wide,\" the variable is also there twice # (This can be avoided by calling the new variable the same # as the old variable) otree2$all_apps_wide$gender ## [1] \"\"       \"\"       \"Female\" \"Male\" otree2$all_apps_wide$survey.1.player.gender ## [1] \"\"       \"\"       \"Female\" \"Male\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"assignv_to_aaw","dir":"Articles","previous_headings":"Transferring variables between the apps","what":"assignv_to_aaw()","title":"Introduction to gmoTree","text":"function assignv_to_aaw() copies variable one data frames $all_apps_wide data frame. following example, variable $survey data frame copied $all_apps_wide placed directly variable survey.1.player.age.","code":"# Create a new variable otree2$survey$younger30 <- ifelse(otree2$survey$player.age < 30, 1, 0)  # Get variable younger30 from survey to all_apps_wide # and put the new variable right behind the old age variable otree2 <- assignv_to_aaw(otree2,                         app = \"survey\",                         variable = \"younger30\",                         newvar = \"younger30\",                         resafter = \"survey.1.player.age\")  # Control otree2$all_apps_wide$survey.1.player.age ## [1] NA NA 66 33  # Check the position of the old age variable and the new variable match(\"survey.1.player.age\", colnames(otree2$all_apps_wide)) ## [1] 52 match(\"younger30\", colnames(otree2$all_apps_wide)) ## [1] 53"},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"show_constant","dir":"Articles","previous_headings":"Before running the experiment","what":"show_constant()","title":"Introduction to gmoTree","text":"program experiments, frequently add variables turn useless later. forget remove , especially experiments numerous rounds, data frame becomes unreasonably huge. function show_constant(), may identify variables variation remove experiment. following example, variable named constant created, vary. function show_constant() shows us many variables also unchanging; however, delete oTree internal. Yet, prevent unreasonably large data frame, remove variable constant running experiment.","code":"# Make a constant column (this variable is usually created in oTree) otree2$dictator$constant <- 3  # Show all columns that contain columns containing only one specified value show_constant(oTree = otree2) ## $all_apps_wide ##  [1] \"participant._is_bot\"                          ##  [2] \"participant._max_page_index\"                  ##  [3] \"participant.visited\"                          ##  [4] \"session.label\"                                ##  [5] \"session.comment\"                              ##  [6] \"session.config.real_world_currency_per_point\" ##  [7] \"session.config.name\"                          ##  [8] \"session.config.participation_fee\"             ##  [9] \"start.1.player.role\"                          ## [10] \"start.1.player.payoff\"                        ## [11] \"start.1.group.id_in_subsession\"               ## [12] \"start.1.subsession.round_number\"              ## [13] \"dictator.1.player.role\"                       ## [14] \"dictator.1.group.id_in_subsession\"            ## [15] \"dictator.1.subsession.round_number\"           ## [16] \"dictator.2.player.role\"                       ## [17] \"dictator.2.group.id_in_subsession\"            ## [18] \"dictator.2.subsession.round_number\"           ## [19] \"dictator.3.player.role\"                       ## [20] \"dictator.3.group.id_in_subsession\"            ## [21] \"dictator.3.subsession.round_number\"           ## [22] \"chatapp.1.player.role\"                        ## [23] \"chatapp.1.player.payoff\"                      ## [24] \"chatapp.1.group.id_in_subsession\"             ## [25] \"chatapp.1.subsession.round_number\"            ## [26] \"survey.1.player.role\"                         ## [27] \"survey.1.player.payoff\"                       ## [28] \"survey.1.group.id_in_subsession\"              ## [29] \"survey.1.subsession.round_number\"             ##  ## $chatapp ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $dictator ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"group.id_in_subsession\"      ## [7] \"session.label\"               \"constant\"                    ##  ## $start ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $survey ## [1] \"session.comment\"             \"participant._is_bot\"         ## [3] \"participant._max_page_index\" \"participant.visited\"         ## [5] \"player.role\"                 \"player.payoff\"               ## [7] \"group.id_in_subsession\"      \"subsession.round_number\"     ## [9] \"session.label\"               ##  ## $Time ## character(0) ##  ## $Chats ## [1] \"group_id\"     \"session_id\"   \"session_code\" \"channel\""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"codebook","dir":"Articles","previous_headings":"Before running the experiment","what":"codebook()","title":"Introduction to gmoTree","text":"Thorough documentation experiment essential. detailed guidance generating codebook oTree code, refer vignette gmoTree Codebooks. recommend creating codebook running experiment, can help identify incomplete documentation potential issues within code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/articles/intro_to_gmoTree.html","id":"references","dir":"Articles","previous_headings":"","what":"References","title":"Introduction to gmoTree","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":"https://zauchnerp.github.io/gmoTree/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Patricia F. Zauchner. Author, translator, maintainer, copyright holder.            University Bremen","code":""},{"path":"https://zauchnerp.github.io/gmoTree/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.1, <https://CRAN.R-project.org/package=gmoTree/>.","code":"@Manual{,   title = {gmoTree: oTree Data Manipulation Tool},   author = {Patricia F. Zauchner},   year = {2024},   note = {R package version 1.3.1},   url = {https://CRAN.R-project.org/package=gmoTree}, }"},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":null,"dir":"","previous_headings":"","what":"Site notice","title":"Site notice","text":"website published Patricia Zauchner Universität Bremen SOCIUM Forschungszentrum Ungleichheit und Sozialpolitik Unicom-Gebäude Raum: 7.4460 Mary-Somerville-Straße 7 28359 Bremen Deutschland Telephone: +49 421 218-58555 E-Mail: patricia.zauchner [] uni-bremen.de Patricia Zauchner also responsible content accordance 55 Abs. 2 RStV.","code":""},{"path":[]},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":"accountability-for-content","dir":"","previous_headings":"Disclaimer","what":"Accountability for content","title":"Site notice","text":"contents pages created utmost care. However, guarantee contents’ accuracy, completeness topicality. According statutory provisions, furthermore responsible content web pages. context, please note accordingly obliged monitor merely transmitted saved information third parties, investigate circumstances pointing illegal activity. obligations remove block use information generally applicable laws remain unaffected per §§ 8 10 Telemedia Act (TMG).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/impressum.html","id":"accountability-for-links","dir":"","previous_headings":"Disclaimer","what":"Accountability for links","title":"Site notice","text":"Responsibility content external links (web pages third parties) lies solely operators linked pages. violations evident time linking. legal infringement become known us, remove respective link immediately.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"gmotree--get-and-modify-otree-data","dir":"","previous_headings":"","what":"Get and Modify oTree Data","title":"Get and Modify oTree Data","text":"gmoTree R package developed importing, merging, efficiently managing data obtained running oTree (Chen et al., 2016) experiments. ’s particularly valuable dealing complex experimental designs span multiple sessions generate large number files need integrated.1","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Get and Modify oTree Data","text":"install CRAN version package, use following command: install.packages(\"gmoTree\") install development version: devtools::install_github(\"ZauchnerP/gmoTree\")","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"list-of-all-functions","dir":"","previous_headings":"","what":"List of all functions","title":"Get and Modify oTree Data","text":"See page Introduction gmoTree detailed overview functions. details package whole, visit  gmoTree website.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"importing-data","dir":"","previous_headings":"","what":"Importing data","title":"Get and Modify oTree Data","text":"import_otree(): Imports oTree data combines list data frames.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"cleaning-up-data","dir":"","previous_headings":"","what":"Cleaning up data","title":"Get and Modify oTree Data","text":"messy_chat(): Checks messy Chats data frame combines variables refer concept. messy_chat(): Checks messy Time data frame combines variables refer concept. delete_duplicate(): Deletes duplicate rows data frames oTree list.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"dealing-with-dropouts-and-deleting-cases","dir":"","previous_headings":"","what":"Dealing with dropouts and deleting cases","title":"Get and Modify oTree Data","text":"show_dropouts(): Shows participant codes people finish () certain app(s) page(s). delete_dropouts(): Deletes data participants finish () certain app(s) page(s). function deletes participants’ data data frames oTree list. Caution: delete cases original CSV Excel files! delete_cases(): Deletes data specified participants data frames oTree list. Caution: function delete data original CSV Excel files! delete_sessions(): Deletes data specified sessions data frames oTree list. Caution: function delete data original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"deleting-sensitive-information","dir":"","previous_headings":"","what":"Deleting sensitive information","title":"Get and Modify oTree Data","text":"delete_plabels(): Deletes variable participant.label every app might contain identifiable information participants, MTurk ID. Caution: function delete variable original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"making-ids","dir":"","previous_headings":"","what":"Making IDs","title":"Get and Modify oTree Data","text":"make_ids(): Makes participant, group, session IDs across apps.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"measuring-time","dir":"","previous_headings":"","what":"Measuring time","title":"Get and Modify oTree Data","text":"apptime(): Calculates time spent specific app. extime(): Calculates time spent experiment. pagesec(): Calculates time spent page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"transferring-variables-between-the-apps","dir":"","previous_headings":"","what":"Transferring variables between the apps","title":"Get and Modify oTree Data","text":"assignv(): Copies variable all_apps_wide data frame data frames apps. assignv_to_aaw(): Copies variable one data frames all_apps_wide data frame.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"before-running-the-experiment","dir":"","previous_headings":"","what":"Before running the experiment","title":"Get and Modify oTree Data","text":"show_constant(): Shows constant variables. codebook(): Creates codebook based oTree code. See also vignette “gmoTree Codebooks.”","code":""},{"path":"https://zauchnerp.github.io/gmoTree/index.html","id":"references","dir":"","previous_headings":"","what":"References","title":"Get and Modify oTree Data","text":"Chen, D. L., Schonger, M., & Wickens, C. (2016). oTree—open-source platform laboratory, online, field experiments. Journal Behavioral Experimental Finance, 9, 88–97. https://doi.org/10.1016/j.jbef.2015.12.001","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the time that was spent on an app — apptime","title":"Calculate the time that was spent on an app — apptime","text":"Calculate time spent one app several apps.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the time that was spent on an app — apptime","text":"","code":"apptime(   oTree,   apps = NULL,   pcode = NULL,   plabel = NULL,   group_id = NULL,   seconds = FALSE,   rounded = TRUE,   digits = 2,   sinfo = \"session_code\",   combine = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the time that was spent on an app — apptime","text":"oTree list data frames created import_otree apps Character. Name(s) app(s) time calculated. pcode Character. value participant.code variable time calculated one specified participant. plabel Character. value participant.label variable time calculated one specified participant. group_id Integer. value group_id variable time calculated one specified group. group_id variable can created make_ids. seconds Logical. TRUE output seconds instead minutes. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. sinfo Character. \"session_id\" use session ID additional information data frame single durations, \"session_code\" use session codes, NULL session column shown. combine Logical. TRUE variables relating epoch time merged, variables relating participant code merged data multiple versions oTree used.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the time that was spent on an app — apptime","text":"function returns list app containing information mean, minimum, maximum time participants spent app, data frame information time participant spent app, eventually, vectors relevant background information numbers. experiment's duration calculated one participant, output returns NA (per app) person make app(s).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/apptime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the time that was spent on an app — apptime","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show how much time all participants spent on app \"survey\" apptime(oTree, apps = \"survey\") #> $mean_duration #> [1] 0.28 #>  #> $min_duration #> [1] 0.08 #>  #> $max_duration #> [1] 1.13 #>  #> $single_durations #>    participant  session duration #> 1     46kxib6w 7bfqtokx     1.13 #> 2     iay3dhkn 7bfqtokx     0.22 #> 3     4zhzdmzo 7bfqtokx     0.15 #> 4     3ttf7yix 7bfqtokx     0.42 #> 5     2d72mfgh 7bfqtokx     0.13 #> 6     rvce7958 7bfqtokx     0.22 #> 7     lsl3vbij 7bfqtokx     0.13 #> 8     xx78b3x0 vd1h01iv     0.17 #> 9     xmxl46rm vd1h01iv     0.15 #> 10    iagvtslv t0rog7nz     0.15 #> 11    jxh15obl t0rog7nz     0.08 #> 12    a7dppel1 t0rog7nz     0.23 #> 13    wk247s9w t0rog7nz     0.73 #> 14    xkobdvuh t0rog7nz     0.40 #> 15    1l5kal0r t0rog7nz     0.13 #> 16    7l0hmpcq qyu3qg0q     0.15 #> 17    ia9rnfvc qyu3qg0q     0.15 #>  #> $messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>   # Show how much time the participant \"a7dppel1\" spent on # the app \"survey\" apptime(oTree, pcode = \"a7dppel1\", apps = \"survey\") #> [1] 0.23  # Show how much time the participants in group 4 spent on # the app \"survey\" oTree <- make_ids(oTree,     gmake = TRUE,     from_var = \"dictator.1.group.id_in_subsession\" ) apptime(oTree, group_id = 4, apps = \"survey\") #> $mean_duration #> [1] 0.13 #>  #> $min_duration #> [1] 0.13 #>  #> $max_duration #> [1] 0.13 #>  #> $single_durations #>   participant  session duration #> 1    lsl3vbij 7bfqtokx     0.13 #>  #> $messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $warnings #> [1] \"164r1hs4\" #>   # Show how much time all participants spent on all apps apptime(oTree) #> $chatapp #> $chatapp$mean_duration #> [1] 0.65 #>  #> $chatapp$min_duration #> [1] 0.02 #>  #> $chatapp$max_duration #> [1] 1.87 #>  #> $chatapp$single_durations #>    participant  session duration #> 10    iagvtslv t0rog7nz     0.02 #> 11    jxh15obl t0rog7nz     0.07 #> 8     xx78b3x0 vd1h01iv     0.20 #> 16    7l0hmpcq qyu3qg0q     0.20 #> 9     xmxl46rm vd1h01iv     0.45 #> 17    ia9rnfvc qyu3qg0q     0.55 #> 4     3ttf7yix 7bfqtokx     0.57 #> 13    wk247s9w t0rog7nz     0.57 #> 12    a7dppel1 t0rog7nz     0.58 #> 7     lsl3vbij 7bfqtokx     0.60 #> 1     46kxib6w 7bfqtokx     0.62 #> 3     4zhzdmzo 7bfqtokx     0.77 #> 5     2d72mfgh 7bfqtokx     0.77 #> 14    xkobdvuh t0rog7nz     1.07 #> 6     rvce7958 7bfqtokx     1.08 #> 15    1l5kal0r t0rog7nz     1.10 #> 2     iay3dhkn 7bfqtokx     1.87 #>  #> $chatapp$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $chatapp$warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>  #>  #> $dictator #> $dictator$mean_duration #> [1] 2.05 #>  #> $dictator$min_duration #> [1] 0.4 #>  #> $dictator$max_duration #> [1] 5.95 #>  #> $dictator$single_durations #>    participant  session duration #> 12    vbhvhozv vd1h01iv     0.40 #> 13    2scvem7a vd1h01iv     0.43 #> 20    7l0hmpcq qyu3qg0q     0.43 #> 2     iay3dhkn 7bfqtokx     0.47 #> 21    ia9rnfvc qyu3qg0q     0.50 #> 1     46kxib6w 7bfqtokx     0.57 #> 11    xmxl46rm vd1h01iv     0.65 #> 10    xx78b3x0 vd1h01iv     0.72 #> 18    xkobdvuh t0rog7nz     0.90 #> 19    1l5kal0r t0rog7nz     0.95 #> 16    a7dppel1 t0rog7nz     1.17 #> 17    wk247s9w t0rog7nz     1.20 #> 15    jxh15obl t0rog7nz     1.58 #> 14    iagvtslv t0rog7nz     2.65 #> 9     ktjz5jli 7bfqtokx     2.88 #> 8     lsl3vbij 7bfqtokx     3.45 #> 7     164r1hs4 7bfqtokx     3.53 #> 6     rvce7958 7bfqtokx     4.37 #> 5     2d72mfgh 7bfqtokx     4.48 #> 3     4zhzdmzo 7bfqtokx     5.87 #> 4     3ttf7yix 7bfqtokx     5.95 #>  #> $dictator$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $dictator$warnings #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>  #>  #> $survey #> $survey$mean_duration #> [1] 0.28 #>  #> $survey$min_duration #> [1] 0.08 #>  #> $survey$max_duration #> [1] 1.13 #>  #> $survey$single_durations #>    participant  session duration #> 11    jxh15obl t0rog7nz     0.08 #> 5     2d72mfgh 7bfqtokx     0.13 #> 7     lsl3vbij 7bfqtokx     0.13 #> 15    1l5kal0r t0rog7nz     0.13 #> 3     4zhzdmzo 7bfqtokx     0.15 #> 9     xmxl46rm vd1h01iv     0.15 #> 10    iagvtslv t0rog7nz     0.15 #> 16    7l0hmpcq qyu3qg0q     0.15 #> 17    ia9rnfvc qyu3qg0q     0.15 #> 8     xx78b3x0 vd1h01iv     0.17 #> 2     iay3dhkn 7bfqtokx     0.22 #> 6     rvce7958 7bfqtokx     0.22 #> 12    a7dppel1 t0rog7nz     0.23 #> 14    xkobdvuh t0rog7nz     0.40 #> 4     3ttf7yix 7bfqtokx     0.42 #> 13    wk247s9w t0rog7nz     0.73 #> 1     46kxib6w 7bfqtokx     1.13 #>  #> $survey$messages #> [1] \"For some participants, no duration could be calculated. See list in $warnings.\" #>  #> $survey$warnings #> [1] \"164r1hs4\" \"ktjz5jli\" \"vbhvhozv\" \"2scvem7a\" \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" #> [8] \"d4sq7zio\" #>  #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign a variable from all_apps_wide — assignv","title":"Assign a variable from all_apps_wide — assignv","text":"Assign variable $all_apps_wide app data frames.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign a variable from all_apps_wide — assignv","text":"","code":"assignv(oTree, variable, newvar)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign a variable from all_apps_wide — assignv","text":"oTree list data frames created import_otree variable Character. variable $all_apps_wide data frame assigned apps. newvar Character. name newly created variable.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign a variable from all_apps_wide — assignv","text":"function returns duplicate original oTree list data frames additional column data frames. additional column contains data specified variable found $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assign a variable from all_apps_wide — assignv","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Assign variable \"survey.1.player.gender\" and name it \"gender\" oTree <- assignv(oTree = oTree,                  variable = \"survey.1.player.gender\",                  newvar = \"gender\")  # Show the new variable in some of the other app data frames oTree$dictator$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       #> [17] \"Male\"   \"\"       \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   #> [25] \"\"       \"Male\"   \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Female\" #> [33] \"Female\" \"\"       \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   #> [41] \"\"       \"Female\" \"Female\" \"Female\" \"Male\"   \"Male\"   \"\"       \"Female\" #> [49] \"Female\" \"Female\" \"Male\"   \"Male\"   \"\"       \"Female\" \"Female\" \"Female\" #> [57] \"Male\"   \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       \"\"       #> [65] \"\"       \"\"       \"\"       \"\"       \"\"       \"Female\" \"Female\" \"Female\" #> [73] \"Female\" \"Female\" \"Female\" oTree$chatapp$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\"  # The variable is now duplicated in app \"survey\" because it is obtained from # there (This can be avoided by naming the new variable the same as the old # variable) oTree$survey$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" oTree$survey$player.gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\"  # In app \"all_apps_wide,\" the variable is also there twice (This can be # avoided by naming the new variable the same as the old variable) oTree$all_apps_wide$gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" \"Female\" \"Female\" \"Female\" \"Male\"   oTree$all_apps_wide$survey.1.player.gender #>  [1] \"Male\"   \"Female\" \"Male\"   \"Female\" \"Female\" \"Male\"   \"\"       \"Male\"   #>  [9] \"\"       \"Female\" \"Female\" \"\"       \"\"       \"Male\"   \"\"       \"Female\" #> [17] \"Female\" \"Female\" \"Male\"   \"\"       \"\"       \"\"       \"\"       \"Female\" #> [25] \"Female\" \"Female\" \"Female\" \"Female\" \"Male\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":null,"dir":"Reference","previous_headings":"","what":"Assign a variable to all_apps_wide — assignv_to_aaw","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"Assign variable one app data frames $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"","code":"assignv_to_aaw(oTree, app, variable, newvar, resafter = NULL)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"oTree list data frames created import_otree. app Character. data frame variable taken. variable Character. name variable assigned $all_apps_wide. newvar Character. name newly created variable $all_apps_wide data frame. resafter Character. name variable precedes new variable. NULL, new variable placed end data frame.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"function returns duplicate original oTree list data frames additional column $all_apps_wide data frame contains variable question.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/assignv_to_aaw.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Assign a variable to all_apps_wide — assignv_to_aaw","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Check out the old variable  oTree$survey$player.age #>  [1] 22 22 23 23 33 45 NA 44 NA 33 23 NA NA 23 NA 44 21 23 23 NA NA NA NA 34 20  # Create a new variable oTree$survey$younger30 <- ifelse(oTree$survey$player.age < 30, 1, 0)  # Assign the variable younger30 to all_apps_wide oTree2 <- assignv_to_aaw(   oTree = oTree,   app = \"survey\",   variable = \"younger30\",   newvar = \"younger30\") #> Warning: New variable is created. However, there is an unequal number of participants in \"all_apps_wide\" (29) and app \"survey\" (25). Did you forget to delete dropouts and empty cases or did you forget to import app data? Sometimes, this can happen if you import data from within a session or room where you can only import \"all_apps_wide\" but not the separate app data, time data or chat data.  # Show the new variable in the all_apps_wide data frame oTree2$all_apps_wide$younger30 #>  [1]  1  1  1  1  0  0 NA  0 NA  0  1 NA NA  1 NA  0  1  1  1 NA NA NA NA  0  1 #> [26] NA NA NA NA  # Check the position of the new variable match(\"younger30\",names(oTree2$all_apps_wide)) #> [1] 56  # Place the new variable immediately after the \"survey.1.player.age\" variable oTree2 <- assignv_to_aaw(oTree,                         app = \"survey\",                         variable = \"younger30\",                         newvar = \"younger30\",                         resafter = \"survey.1.player.age\") #> Warning: New variable is created. However, there is an unequal number of participants in \"all_apps_wide\" (29) and app \"survey\" (25). Did you forget to delete dropouts and empty cases or did you forget to import app data? Sometimes, this can happen if you import data from within a session or room where you can only import \"all_apps_wide\" but not the separate app data, time data or chat data.  # Show the new variable in the all_apps_wide data frame oTree2$all_apps_wide$younger30 #>  [1]  1  1  1  1  0  0 NA  0 NA  0  1 NA NA  1 NA  0  1  1  1 NA NA NA NA  0  1 #> [26] NA NA NA NA  # Show the position of the new variable match(\"younger30\", names(oTree2$all_apps_wide)) #> [1] 50"},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a codebook for the oTree code — codebook","title":"Create a codebook for the oTree code — codebook","text":"Create codebook oTree code automatically scanning project folder retrieving variables' information.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a codebook for the oTree code — codebook","text":"","code":"codebook(   path = \".\",   fsource = \"init\",   output = \"both\",   output_dir = NULL,   output_file = \"codebook\",   output_format = \"pdf_document_simple\",   output_open = TRUE,   app_doc = TRUE,   app = NULL,   app_rm = NULL,   doc_info = TRUE,   sort = NULL,   settings_replace = \"global\",   user_settings = NULL,   include_cons = TRUE,   preamb = FALSE,   encoding = \"UTF-8\",   title = \"Codebook\",   subtitle = \"created with gmoTree\",   params = NULL,   date = \"today\",   splitvarname = FALSE,   sep_list = \"newline\",   initial = TRUE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a codebook for the oTree code — codebook","text":"path Character. Path oTree experiment. fsource Character. \"init\" information taken init.py files (newer oTree code 5.x format). \"models\" (\"model\") information taken models.py files (older oTree code 3.x format). output Character. \"list\" output contain list variables information. \"file\" output file Word PDF file. \"\" output contain file list. output_dir Character. absolute path function's output saved. absolute paths allowed parameter. Relative paths can specified output_file parameter. output_file Character. name output file generated function. file name can provided without extension. Relative paths also allowed file name. output_format Character. Specifies format file output. value passed output_format argument rmarkdown::render. Allowed options : \"html_document\", \"word_document\",  \"odt_document\", \"rtf_document\", \"md_document\",  \"latex_document\", \"pdf_document\", \"pdf_document_simple\", short forms \"html\", \"word\", \"odt\",  \"rtf\", \"md\", \"latex\", \"pdf\", \"pdf_simple\". Important: \"pdf_document\" format uses xelatex PDF generation. document require advanced LaTeX features, recommended use \"pdf_document_simple\". output_open Logical. TRUE file output opened creation. app_doc Logical. TRUE app documentation included output file. app Character. Name included app(s). Default use apps. used simultaneously app_rm. app_rm Character. Name excluded app(s). Default exclude apps. used simultaneously app. doc_info Logical. TRUE message information variables without documentation also returned. FALSE message suppressed. sort Character vector. Vector specifies order apps codebook. settings_replace Character NULL. Specifies handle references settings variables. Use \"global\" replace references global settings variables defined settings.py. Use \"user\" replace references variables provided user_settings argument. Use NULL leave references settings variables unchanged. Caution: function use variables defined SESSION_CONFIGS. vary settings variables SESSION_CONFIGS, set settings_replace \"user\" manually replace using user_settings argument. user_settings List. List variables settings.py file used replace setting variable references. used settings_replace = \"user\" used setting variables defined within SESSION_CONFIGS. include_cons Logical. TRUE section constants codebook. preamb Logical. TRUE preamble printed explains oTree saves variables. encoding Character. Encoding created Markdown file. knitr::knit, argument always assumed UTF-8 ignored. title Character. Title output file. subtitle Character. Subtitle output file. params List. List variable name value pairs passed RmD file. relevant argument output \"file\" \"\" chosen. date Character NULL. Date passed Rmd file. Either \"today\", NULL, user defined date. relevant argument output \"file\" \"\" chosen. splitvarname Logical. TRUE long variable names split across multiple lines output file tables. FALSE, table columns adjust fit longest variable names. sep_list Character. Determines sub-lists displayed file output. Use \"newline\" separate sub-lists newline characters (`\\n`), \"vector\" display strings `c(...)` format. initial Logical. TRUE initial values included output file. FALSE included.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a codebook for the oTree code — codebook","text":"function returns two main types outputs: () list variables along information (b) file containing codebook experiment doc_info TRUE also returns message containing names variables documentation.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create a codebook for the oTree code — codebook","text":"code works dictionaries used (example session configurations settings.py). Caution 1: Multiline comments ignored, meaning variables commented manner nevertheless included codebook. contrast, variables commented line comments appear codebook. Caution 2: commas value strings, might used split text. Please manually insert backslash symbol front commas avoid (.e., escape ). E.g. \"Yes, \" -> \"Yes\\, \". Caution 3: code interpret variables imported files (example CSV files) special formatting included (e.g., special string formatting Python float(1.4) represent float number). Caution 4: code developed tested basic oTree codes verified compatibility oTree versions later 5.4.0. experience issues newer versions complex code structures, please open issue GitHub. Caution 5: Custom exports part codebook. info: None values presented \"None\" (.e. string) list codebook.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/codebook.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create a codebook for the oTree code — codebook","text":"","code":"# The examples use a slightly modified version of the official oTree sample codes.  # Make a codebook and resort the apps combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 16 #>  $ settings            :List of 10 #>  $ bargaining          :List of 4 #>  $ bertrand            :List of 4 #>  $ common_value_auction:List of 4 #>  $ cournot             :List of 4 #>  $ dictator            :List of 4 #>  $ guess_two_thirds    :List of 4 #>  $ matching_pennies    :List of 4 #>  $ payment_info        :List of 4 #>  $ prisoner            :List of 4 #>  $ public_goods_simple :List of 3 #>  $ survey              :List of 3 #>  $ traveler_dilemma    :List of 4 #>  $ trust               :List of 3 #>  $ trust_simple        :List of 3 #>  $ volunteer_dilemma   :List of 4 str(combined_codebook$bargaining$Player, 1) #> List of 4 #>  $ request:List of 6 #>  $ level2 :List of 3 #>  $ level3 :List of 3 #>  $ level  :List of 3  # Make a codebook with only the \"bargaining\" app combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   app = \"bargaining\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 2 #>  $ settings  :List of 10 #>  $ bargaining:List of 4 str(combined_codebook$bargaining$Player, 1) #> List of 4 #>  $ request:List of 6 #>  $ level2 :List of 3 #>  $ level3 :List of 3 #>  $ level  :List of 3  # Make a codebook with all but the \"bargaining\" app combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   output = \"list\",   fsource = \"init\",   app_rm = \"bargaining\",   doc_info = FALSE)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 15 #>  $ settings            :List of 10 #>  $ bertrand            :List of 4 #>  $ common_value_auction:List of 4 #>  $ cournot             :List of 4 #>  $ dictator            :List of 4 #>  $ guess_two_thirds    :List of 4 #>  $ matching_pennies    :List of 4 #>  $ payment_info        :List of 4 #>  $ prisoner            :List of 4 #>  $ public_goods_simple :List of 3 #>  $ survey              :List of 3 #>  $ traveler_dilemma    :List of 4 #>  $ trust               :List of 3 #>  $ trust_simple        :List of 3 #>  $ volunteer_dilemma   :List of 4 str(combined_codebook$bargaining$Player, 1) #>  NULL  # Use oTree code in 3.x format combined_codebook <- codebook(   path = system.file(\"extdata/ocode_z\", package = \"gmoTree\"),   fsource = \"model\",   output = \"list\",   doc_info = FALSE) #> Warning: Some variables or code parts contain code that is too complex for this function. Hence, this function might have overseen important variables and references to them. Found in: #> > $rankaversion$Constants (read_csv) #> > $rankend$Constants (read_csv) #> > $settings$showupToken (float) #> > $end$Constants$showupToken (float) #> > $end$Constants$showupTokenTest (float)  # Show the structure of the codebook str(combined_codebook, 1) #> List of 4 #>  $ settings    :List of 20 #>  $ end         :List of 4 #>  $ rankaversion:List of 4 #>  $ rankend     :List of 4  # Show information on missing documentation or complex code combined_codebook <- codebook(   path = system.file(\"extdata/ocode_new\", package = \"gmoTree\"),   fsource = \"init\",   output = \"list\",   app_rm = \"bargaining\",   doc_info = TRUE) #> Variables without documentation, label, or verbose name: #> > $bertrand$Group$winning_price #> > $bertrand$Player$is_winner #> > $common_value_auction$Group$highest_bid #> > $cournot$Group$unit_price #> > $dictator$Player$gender #> > $guess_two_thirds$Group$two_thirds_avg #> > $guess_two_thirds$Group$best_guess #> > $guess_two_thirds$Group$num_winners #> > $guess_two_thirds$Player$is_winner #> > $matching_pennies$Player$is_winner #> > $public_goods_simple$Group$total_contribution #> > $public_goods_simple$Group$individual_share #> > $traveler_dilemma$Group$lower_claim #> > $traveler_dilemma$Player$adjustment #> > $volunteer_dilemma$Group$num_volunteers  if (FALSE) { # \\dontrun{  # Create a codebook PDF with authors' names and todays' date codebook(   path = system.file(\"extdata/ocode_z\", package = \"gmoTree\"),   fsource = \"init\",   doc_info = FALSE,   output = \"file\",   output_format = \"pdf_document\",   date = \"today\",   title = \"My Codebook\",   subtitle = \"codebook created with gmoTree\",   params = list(author = c(\"Max Mustermann\", \"John Doe\"))   )  # Create a codebook PDF and save it in a subfolder of the # current folder: # \"C:/Users/pzauchner/Nextcloud/R_analyses/cb/cb.pdf\" getwd() # \"C:/Users/pzauchner/Nextcloud/R_analyses\" dir.create(\"cb\") combined_codebook <- gmoTree::codebook(   path = \"C:/Users/pzauchner/Nextcloud/R_analyses/oTree\",   fsource = \"models\",   output = \"both\",   output_file = \"cb/cb.pdf\",   output_format = \"pdf_document\")  # You can also omit *.pdf after the file name combined_codebook <- gmoTree::codebook(   path = \"C:/Users/pzauchner/Nextcloud/R_analyses/oTree\",   fsource = \"models\",   output = \"both\",   output_file = \"cb/cb\",   output_format = \"pdf_document\") } # }"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete specific cases — delete_cases","title":"Delete specific cases — delete_cases","text":"Delete specific cases data frames oTree list. Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom data frames data frames variable named participant.code! Caution 3: function delete data $Chats data frame! (interpretation chat data depends participants engage , data must deleted care deleting data apps. Hence, function delete data data frame. Please manually necessary!)","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete specific cases — delete_cases","text":"","code":"delete_cases(   oTree,   pcodes = NULL,   plabels = NULL,   saved_vars = NULL,   reason,   omit = FALSE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete specific cases — delete_cases","text":"oTree list data frames created import_otree. pcodes Character. value(s) participant.code variable participants whose data removed. plabels Character. value(s) participant.label variable participants whose data removed. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. reason Character. reason deletion stored list information deleted cases $info$deleted_cases. omit Logical. TRUE deleted cases added information deleted cases $info$deleted_cases. info Logical. TRUE brief information case deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete specific cases — delete_cases","text":"function returns duplicate original oTree list data frames include deleted cases. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $codes = vector participant codes deleted cases. - $count = number participants $codes. - $full $unique = data frames $full $unique contain information deleted participant reason deleted. entries $full $unique data frames . Columns \"end_app\" \"end_page\" left empty intentionally filled delete_dropouts function.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_cases.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete specific cases — delete_cases","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Delete only one case oTree2 <- delete_cases(oTree,                        pcodes = \"xmxl46rm\",                        reason = \"requested\")  # Show changes in row numbers print(paste(\"Row numbers before deletion: \", nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"Row numbers before deletion:  29 25 289 35\"  print(paste(\"Row numbers after deletion: \", nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"Row numbers after deletion:  28 24 275 35\"  # Delete several cases deletionlist <- c(\"4zhzdmzo\", \"xmxl46rm\") oTree2 <- delete_cases(oTree,                        pcodes = deletionlist,                        reason = \"requested\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Show information on all deleted cases (also dropouts): oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested  # Save one variable oTree2 <- delete_cases(oTree,   pcodes = deletionlist,   reason = \"requested\",   saved_vars = \"participant._index_in_pages\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested #>    participant._index_in_pages #> 3                           17 #> 12                          17  # Save some variables oTree2 <- delete_cases(oTree,   pcodes = deletionlist,   reason = \"requested\",   saved_vars = c(     \"participant._index_in_pages\",     \"participant._max_page_index\"))  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"27 23 258 35\"  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code  session end_app end_page    reason #> 3          4zhzdmzo 7bfqtokx                  requested #> 12         xmxl46rm vd1h01iv                  requested #>    participant._index_in_pages participant._max_page_index #> 3                           17                          16 #> 12                          17                          16  # Get a list of all deleted cases # (If there is already a list, the new list is added to it) oTree2$info$deleted_cases$codes #> [1] \"4zhzdmzo\" \"xmxl46rm\"  # Show number of all deleted cases length(oTree2$info$deleted_cases$codes) #> [1] 2 oTree2$info$deleted_cases$count #> [1] 2  # Delete a session and delete a single case from another session oTree2 <- delete_sessions(oTree,   scodes = c(\"vd1h01iv\"),   reason = \"Server Crash\",    saved_vars = \"dictator.1.group.id_in_subsession\") oTree2 <- delete_cases(oTree2,                        pcodes = \"4zhzdmzo\",                        reason = \"requested\")                         # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>   participant.code session.code dictator.1.group.id_in_subsession end_app #> 1         xx78b3x0     vd1h01iv                                 1         #> 2         xmxl46rm     vd1h01iv                                 1         #> 3         vbhvhozv     vd1h01iv                                 2         #> 4         2scvem7a     vd1h01iv                                 2         #> 5         4zhzdmzo         <NA>                                NA         #>   end_page       reason  session #> 1          Server Crash     <NA> #> 2          Server Crash     <NA> #> 3          Server Crash     <NA> #> 4          Server Crash     <NA> #> 5             requested 7bfqtokx  # See codes of deleted variables oTree2$info$deleted_cases$codes #> [1] \"4zhzdmzo\" \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" \"2scvem7a\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 5"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete dropouts — delete_dropouts","title":"Delete dropouts — delete_dropouts","text":"Delete data participants end experiment () certain page(s) /app(s). Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom exports variable named participant.code variable named session.code! Caution 3: function delete data $Chats data frame! (interpretation chat data depends participants engage , data must deleted care deleting data apps. Hence, function delete data data frame. Please manually necessary!)","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete dropouts — delete_dropouts","text":"","code":"delete_dropouts(   oTree,   final_apps = NULL,   final_pages = NULL,   saved_vars = NULL,   inconsistent = NULL,   reason = \"ENC\",   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete dropouts — delete_dropouts","text":"oTree list data frames created import_otree final_apps Character. name(s) app(s) participants finish experiment. final_pages Character. name(s) page(s) participants finish experiment. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. inconsistent Character. function continue stopped least one participant inconsistent end_pages, inconsistent end_apps, ? continue, type \"yes\", stop function, type \"\". reason Character. reason deletion stored list information deleted cases $info$deleted_cases. info Logical. TRUE brief information dropout deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete dropouts — delete_dropouts","text":"function returns duplicate original oTree list data frames without deleted cases. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $full = data frame contains information participants finish study; shows participant codes, names apps left experiment, names pages left experiment, names app data frames information found, dropout reason (\"ENC\", experiment completed, combined name data frame dropout observed). participants usually appear multiple app data frames, $info$deleted_cases$full data frame may contain several entries person. - $unique = data frame contains similar information $full data frame one row per participant information data frame dropout observed. - $all_end = table provides information app page combinations participants ended experiment. table also includes information participants drop experiment. $all_end table shown $all_apps_wide data frame exists. - $codes = vector containing participant codes deleted participants. - $count = number deleted participants. important note argument final_pages set, function distinguish page names reoccur different apps. columns end_app end_page output empty, variables saved oTree specific participants. empty rows deleted. can done using argument del_empty = TRUE using import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_dropouts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete dropouts — delete_dropouts","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # First, show some row numbers print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"29 25 289 35\"  # Delete all cases that didn't end the experiment on the page \"Demographics\" # within the app \"survey\" oTree2 <- delete_dropouts(oTree,                          final_apps = c(\"survey\"),                          final_pages = c(\"Demographics\"))  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Delete all cases that didn't end the experiment on the page \"Demographics\" # This page can be in any app oTree2 <- delete_dropouts(oTree, final_pages = \"Demographics\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Delete all cases that didn't end the experiment on # any page in the app \"survey\" oTree <- delete_dropouts(oTree, final_apps = \"survey\")  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"20 16 248 35\"  # Get list of information on all deleted cases # (If there is already a list, the new list is added to it!) oTree2$info$deleted_cases #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 22         jxh15obl     t0rog7nz   survey           Offer #> 23         jxh15obl     t0rog7nz   survey           Offer #> 24         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 26         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 27         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 28         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 30         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 31         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 32         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #> 34         znri6myc     l8ecm1uh dictator    Introduction #> 35         znri6myc     l8ecm1uh dictator    Introduction #> 36         znri6myc     l8ecm1uh dictator    Introduction #>                            reason #> 1         ENC. Noticed at: survey #> 2  ENC. Noticed at: all_apps_wide #> 3        ENC. Noticed at: chatapp #> 4       ENC. Noticed at: dictator #> 5  ENC. Noticed at: all_apps_wide #> 6        ENC. Noticed at: chatapp #> 7       ENC. Noticed at: dictator #> 8         ENC. Noticed at: survey #> 9  ENC. Noticed at: all_apps_wide #> 10       ENC. Noticed at: chatapp #> 11      ENC. Noticed at: dictator #> 12        ENC. Noticed at: survey #> 13 ENC. Noticed at: all_apps_wide #> 14       ENC. Noticed at: chatapp #> 15      ENC. Noticed at: dictator #> 16        ENC. Noticed at: survey #> 17       ENC. Noticed at: chatapp #> 18      ENC. Noticed at: dictator #> 19        ENC. Noticed at: survey #> 20 ENC. Noticed at: all_apps_wide #> 21      ENC. Noticed at: dictator #> 22        ENC. Noticed at: survey #> 23 ENC. Noticed at: all_apps_wide #> 24       ENC. Noticed at: chatapp #> 25 ENC. Noticed at: all_apps_wide #> 26       ENC. Noticed at: chatapp #> 27      ENC. Noticed at: dictator #> 28        ENC. Noticed at: survey #> 29 ENC. Noticed at: all_apps_wide #> 30       ENC. Noticed at: chatapp #> 31      ENC. Noticed at: dictator #> 32        ENC. Noticed at: survey #> 33 ENC. Noticed at: all_apps_wide #> 34       ENC. Noticed at: chatapp #> 35      ENC. Noticed at: dictator #> 36        ENC. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page reason #> 1          164r1hs4     7bfqtokx  chatapp            chat    ENC #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage    ENC #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction    ENC #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction    ENC #> 17         d4sq7zio     l8ecm1uh dictator    Introduction    ENC #> 21         jxh15obl     t0rog7nz   survey           Offer    ENC #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage    ENC #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage    ENC #> 33         znri6myc     l8ecm1uh dictator    Introduction    ENC #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"jxh15obl\" \"ktjz5jli\" #> [8] \"vbhvhozv\" \"znri6myc\" #>  #> $count #> [1] 9 #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete duplicate data — delete_duplicate","title":"Delete duplicate data — delete_duplicate","text":"Delete duplicate rows oTree app data frames $all_apps_wide.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete duplicate data — delete_duplicate","text":"","code":"delete_duplicate(oTree)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete duplicate data — delete_duplicate","text":"oTree list data frames created import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete duplicate data — delete_duplicate","text":"function returns duplicate original oTree list data frames without duplicate rows app data frames $all_apps_wide. function effect data frames $Time $Chats. function add information $info$deleted_cases, delete important information cleans messy data import. However, function adjusts $info$initial_n, $all_apps_wide data frame exists.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_duplicate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete duplicate data — delete_duplicate","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # First, show some row numbers print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"41 33 366 41\"  # Delete duplicate rows oTree <- delete_duplicate(oTree)  # Show row numbers again print(paste(nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"37 33 366 41\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete participant labels in all apps — delete_plabels","title":"Delete participant labels in all apps — delete_plabels","text":"work MTurk, MTurk IDs stored participant labels variable. function deletes variable $all_apps_wide every app data frame list data frames created import_otree /variables referring MTurk, participant.mturk_worker_id. Caution: function delete variables original CSV Excel files!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete participant labels in all apps — delete_plabels","text":"","code":"delete_plabels(oTree, del_plabel = TRUE, del_mturk = TRUE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete participant labels in all apps — delete_plabels","text":"oTree list data frames created import_otree. del_plabel Logical. TRUE participant labels deleted. del_mturk Logical. TRUE MTurk variables deleted.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete participant labels in all apps — delete_plabels","text":"function returns duplicate original oTree list data frames include participant labels /MTurk variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_plabels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete participant labels in all apps — delete_plabels","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show participant labels oTree$all_apps_wide$participant.label #>  [1] \"Person1\"  \"Person2\"  \"Person4\"  \"Person5\"  \"Person6\"  \"Person7\"  #>  [7] \"Person8\"  \"Person9\"  \"Person10\" \"Person1\"  \"Person2\"  \"Person3\"  #> [13] \"Person4\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person5\"  #> [19] \"Person6\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person2\"  #> [25] \"Person3\"  NA         NA         NA         NA         oTree$survey$participant.label #>  [1] \"Person1\"  \"Person2\"  \"Person4\"  \"Person5\"  \"Person6\"  \"Person7\"  #>  [7] \"Person8\"  \"Person9\"  \"Person10\" \"Person1\"  \"Person2\"  \"Person3\"  #> [13] \"Person4\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person5\"  #> [19] \"Person6\"  \"Person1\"  \"Person2\"  \"Person3\"  \"Person4\"  \"Person2\"  #> [25] \"Person3\"   # Delete all participant labels oTree2 <- delete_plabels(oTree)  # Show participant labels again oTree2$all_apps_wide$participant.label #> NULL oTree2$survey$participant.label #> NULL"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":null,"dir":"Reference","previous_headings":"","what":"Delete all cases of one session — delete_sessions","title":"Delete all cases of one session — delete_sessions","text":"Delete cases specific sessions data frames oTree list data frames. Caution 1: function delete cases original CSV Excel files! Caution 2: function delete cases custom exports custom exports variable named participant.code variable named session.code!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Delete all cases of one session — delete_sessions","text":"","code":"delete_sessions(oTree, scodes, saved_vars = NULL, reason, info = FALSE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Delete all cases of one session — delete_sessions","text":"oTree list data frames created import_otree. scodes Character. session.code(s) session(s) whose data removed. saved_vars Character. name(s) variable(s) need(s) stored list information deleted cases $info$deleted_cases. reason Character. reason deletion stored list information deleted cases $info$deleted_cases. info Logical. TRUE brief information session deletion process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Delete all cases of one session — delete_sessions","text":"function returns duplicate original oTree list data frames include deleted sessions. adds information deleted cases $info$deleted_cases. (list also filled functions.) list, can find following information: - $full $unique = data frames $full $unique contain information participants whose data deleted. entries $full $unique data frames list . Columns end_app end_page left empty intentionally filled delete_dropouts function. Columns participant.code reason filled. - $codes = vector containing participant codes deleted participants. - $count = number deleted participants.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/delete_sessions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Delete all cases of one session — delete_sessions","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Delete one session oTree2 <- delete_sessions(oTree,   scodes = \"7bfqtokx\",   reason = \"Only tests\")  # Show changes in row numbers print(paste(\"Row numbers before deletion: \", nrow(oTree$all_apps_wide), nrow(oTree$survey), nrow(oTree$Time), nrow(oTree$Chats))) #> [1] \"Row numbers before deletion:  29 25 289 35\"  print(paste(\"Row numbers after deletion: \", nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"Row numbers after deletion:  20 16 166 14\"  # Delete two sessions and show deletion message oTree2 <- delete_sessions(oTree,   scodes = c(\"7bfqtokx\", \"vd1h01iv\"),   reason = \"Only tests\",   info = TRUE) #> 13 case(s) deleted  # Show row numbers again print(paste(nrow(oTree2$all_apps_wide), nrow(oTree2$survey), nrow(oTree2$Time), nrow(oTree2$Chats))) #> [1] \"16 12 126 10\"  # Delete session and save variable to the info list oTree2 <- delete_sessions(oTree,   scodes = c(\"7bfqtokx\", \"vd1h01iv\"),   reason = \"Server Crash\",   saved_vars = \"dictator.1.group.id_in_subsession\")  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>    participant.code session.code dictator.1.group.id_in_subsession end_app #> 1          46kxib6w     7bfqtokx                                 1         #> 2          iay3dhkn     7bfqtokx                                 1         #> 3          4zhzdmzo     7bfqtokx                                 2         #> 4          3ttf7yix     7bfqtokx                                 2         #> 5          2d72mfgh     7bfqtokx                                 3         #> 6          rvce7958     7bfqtokx                                 3         #> 7          164r1hs4     7bfqtokx                                 4         #> 8          lsl3vbij     7bfqtokx                                 4         #> 9          ktjz5jli     7bfqtokx                                 5         #> 11         xx78b3x0     vd1h01iv                                 1         #> 12         xmxl46rm     vd1h01iv                                 1         #> 13         vbhvhozv     vd1h01iv                                 2         #> 14         2scvem7a     vd1h01iv                                 2         #>    end_page       reason #> 1           Server Crash #> 2           Server Crash #> 3           Server Crash #> 4           Server Crash #> 5           Server Crash #> 6           Server Crash #> 7           Server Crash #> 8           Server Crash #> 9           Server Crash #> 11          Server Crash #> 12          Server Crash #> 13          Server Crash #> 14          Server Crash  # See codes of deleted variables oTree2$info$deleted_cases$codes #>  [1] \"46kxib6w\" \"iay3dhkn\" \"4zhzdmzo\" \"3ttf7yix\" \"2d72mfgh\" \"rvce7958\" #>  [7] \"164r1hs4\" \"lsl3vbij\" \"ktjz5jli\" \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" #> [13] \"2scvem7a\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 13  # Delete a single case and then delete a session oTree2 <- delete_cases(oTree,                        pcodes = \"4zhzdmzo\",                        reason = \"requested\") oTree2 <- delete_sessions(oTree2,   scodes = c(\"vd1h01iv\"),   reason = \"Server Crash\",   saved_vars = \"dictator.1.group.id_in_subsession\")  # Check the \"full\" deletion information oTree2$info$deleted_cases$full #>   participant.code  session end_app end_page       reason session.code #> 1         4zhzdmzo 7bfqtokx                     requested         <NA> #> 2         xx78b3x0     <NA>                  Server Crash     vd1h01iv #> 3         xmxl46rm     <NA>                  Server Crash     vd1h01iv #> 4         vbhvhozv     <NA>                  Server Crash     vd1h01iv #> 5         2scvem7a     <NA>                  Server Crash     vd1h01iv #>   dictator.1.group.id_in_subsession #> 1                                NA #> 2                                 1 #> 3                                 1 #> 4                                 2 #> 5                                 2  # See codes of deleted variables oTree2$info$deleted_cases$codes #> [1] \"xx78b3x0\" \"xmxl46rm\" \"vbhvhozv\" \"2scvem7a\" \"4zhzdmzo\"  # See number of deleted variables oTree2$info$deleted_cases$count #> [1] 5"},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the time that was spent on the whole experiment — extime","title":"Calculate the time that was spent on the whole experiment — extime","text":"Calculate time spent experiment. stated otherwise, calculation starts end first page!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the time that was spent on the whole experiment — extime","text":"","code":"extime(   oTree,   pcode = NULL,   plabel = NULL,   group_id = NULL,   seconds = FALSE,   rounded = TRUE,   digits = 2L,   startat = 1L,   tz = \"UTC\",   sinfo = \"session_code\",   combine = TRUE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the time that was spent on the whole experiment — extime","text":"oTree list data frames created import_otree. pcode Character. value participant.code variable time calculated one specified participant. plabel Character. value participant.label variable time calculated one specified participant. group_id Integer. value group_id variable time calculated one specified group. group_id variable can created make_ids. seconds Logical. TRUE output seconds instead minutes. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. startat Integer character string \"real\" Whether start experiment taken time certain index person's vector page_indexes $Time data frame time_started variable $all_apps_wide (\"real\"). Important: integer, represents position within page index sequence, numeric value page_index variable. tz Character. Time zone. sinfo Character. \"session_id\" use session ID additional information data frame single durations, \"session_code\" use session codes, NULL session column shown. combine Logical. TRUE variables referring epoch time merged, variables referring participant code merged case data several versions oTree used. FALSE, function returns error several oTree versions' data present.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the time that was spent on the whole experiment — extime","text":"function returns either single value data one person calculated list information time several participants spent experiment. list, can find following information: - $mean_duration = experiment's average duration. - $min_duration = experiment's minimum duration. - $max_duration = experiment's maximum duration. - $single_durations = data frame durations used calculating min, max, mean duration. - $messages = important notes calculations. - $only_one_page = vector individuals one time stamp.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculate the time that was spent on the whole experiment — extime","text":"functions calculates time spent experiment using variable refers time stamp. variable present, function alternatively uses seconds_on_page2, can created pagesec function.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/extime.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the time that was spent on the whole experiment — extime","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show time for one participant extime(oTree, pcode = \"wk247s9w\") #> [1] 2.5  # Make a data frame of durations extime(oTree) #> $mean_duration #> [1] 2.81 #>  #> $min_duration #> [1] 0.4 #>  #> $max_duration #> [1] 6.93 #>  #> $single_durations #>    participant  session duration #> 12    vbhvhozv vd1h01iv     0.40 #> 13    2scvem7a vd1h01iv     0.43 #> 20    7l0hmpcq qyu3qg0q     0.78 #> 10    xx78b3x0 vd1h01iv     1.08 #> 21    ia9rnfvc qyu3qg0q     1.20 #> 11    xmxl46rm vd1h01iv     1.25 #> 15    jxh15obl t0rog7nz     1.73 #> 16    a7dppel1 t0rog7nz     1.98 #> 19    1l5kal0r t0rog7nz     2.18 #> 1     46kxib6w 7bfqtokx     2.32 #> 18    xkobdvuh t0rog7nz     2.37 #> 17    wk247s9w t0rog7nz     2.50 #> 2     iay3dhkn 7bfqtokx     2.55 #> 14    iagvtslv t0rog7nz     2.82 #> 9     ktjz5jli 7bfqtokx     2.88 #> 7     164r1hs4 7bfqtokx     3.53 #> 8     lsl3vbij 7bfqtokx     4.18 #> 5     2d72mfgh 7bfqtokx     5.38 #> 6     rvce7958 7bfqtokx     5.67 #> 3     4zhzdmzo 7bfqtokx     6.78 #> 4     3ttf7yix 7bfqtokx     6.93 #>  #> $messages #> [1] \"Warning: For at least one participant, the experiment only has one page. I.e., the indices for the first and the last page are the same. See $only_one_page for information on this participant/these participants! Participants in this list are not included in the output.\" #>  #> $only_one_page #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>   # Make a data frame of durations (beginning from the end of the second page) extime(oTree, startat = 2) #> $mean_duration #> [1] 1.88 #>  #> $min_duration #> [1] 0.03 #>  #> $max_duration #> [1] 6.08 #>  #> $single_durations #>    participant  session duration #> 13    2scvem7a vd1h01iv     0.03 #> 9     ktjz5jli 7bfqtokx     0.05 #> 12    vbhvhozv vd1h01iv     0.15 #> 20    7l0hmpcq qyu3qg0q     0.63 #> 7     164r1hs4 7bfqtokx     0.82 #> 10    xx78b3x0 vd1h01iv     1.03 #> 11    xmxl46rm vd1h01iv     1.08 #> 21    ia9rnfvc qyu3qg0q     1.08 #> 8     lsl3vbij 7bfqtokx     1.40 #> 15    jxh15obl t0rog7nz     1.53 #> 16    a7dppel1 t0rog7nz     1.78 #> 19    1l5kal0r t0rog7nz     1.98 #> 18    xkobdvuh t0rog7nz     2.17 #> 1     46kxib6w 7bfqtokx     2.20 #> 17    wk247s9w t0rog7nz     2.32 #> 2     iay3dhkn 7bfqtokx     2.37 #> 14    iagvtslv t0rog7nz     2.70 #> 5     2d72mfgh 7bfqtokx     2.73 #> 6     rvce7958 7bfqtokx     2.97 #> 4     3ttf7yix 7bfqtokx     4.35 #> 3     4zhzdmzo 7bfqtokx     6.08 #>  #> $messages #> [1] \"Warning: For at least one participant, the experiment only has one page. I.e., the indices for the first and the last page are the same. See $only_one_page for information on this participant/these participants! Participants in this list are not included in the output.\" #>  #> $only_one_page #> [1] \"7wa8kk3d\" \"znri6myc\" \"ao9kqvqn\" \"d4sq7zio\" #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":null,"dir":"Reference","previous_headings":"","what":"Import oTree data — import_otree","title":"Import oTree data — import_otree","text":"Import data files created oTree. files containing pattern YYYY-MM-DD end file names considered oTree files. Bot outputs saved oTree without date included. Hence, import bot data, must either rename original bot files using YYYY-MM-DD format use argument onlybots = TRUE. using second option, data bot files imported. Caution! Data can downloaded within session globally time. files downloaded, can lead $all_apps_wide data twice! can remove duplicate data using delete_duplicate. Caution! importing Excel files, function check erroneous data structures combine data frames file name patterns. using CSV = FALSE argument, clean data appropriately.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Import oTree data — import_otree","text":"","code":"import_otree(   path = \".\",   file_names = NULL,   final_apps = NULL,   final_pages = NULL,   recursive = TRUE,   csv = TRUE,   onlybots = FALSE,   del_empty = TRUE,   info = FALSE,   encoding = \"UTF-8\" )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Import oTree data — import_otree","text":"path Character. path files (default working directory). file_names Character. name(s) file(s) imported. specified, files path subfolders imported. final_apps Character. name(s) app(s) participants finish experiment. argument final_apps left empty, can still call deleting participants finish experiment delete_dropouts. final_pages Character. name(s) page(s) participants finish experiment. argument final_pages left empty, can still call deleting participants finish experiment delete_dropouts. recursive Logical. TRUE files path's subfolders also imported. csv Logical. TRUE CSV files imported. FALSE Excel files imported. onlybots Logical. TRUE bot-created files imported. del_empty Logical. TRUE empty cases deleted $all_apps_wide normal app data frames (Time Chats). info Logical. TRUE brief information data import printed. encoding Character. Encoding CSV files imported. Default \"UTF-8\".","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Import oTree data — import_otree","text":"Returns list data frames (one data frame app $all_apps_wide) list information list data frames $info. See detailed information imported files $info$imported_files. $all_apps_wide imported, see number imported cases $info$initial_n. number, empty rows already considered. , empty rows deleted del_empty=TRUE, initial_n counts rows empty. Cases deleted participants make last page /app subtracted number. Information: Empty rows rows without participant._current_app_name variable set. Empty rows deleted app data frames $all_apps_wide using del_empty = TRUE. Empty rows $Chats $Time data frames deleted. old new oTree versions combined, $Time data frame contains variables called participant_code participant__code (difference underscores). Caution! unusual amount NAs, check everything got imported correctly. Sometimes, CSV Excel file may corrupted, information found one column.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/import_otree.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Import oTree data — import_otree","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree()  # Show the structure of the import str(oTree, max.level = 1)  # Show the names of all imported files oTree$info$imported_files  # Delete empty cases and delete every case of a person # who didn't end the experiment in the app \"survey\" oTree <- import_otree(   del_empty = TRUE,   final_apps = \"survey\",   info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import bot files import_otree(   path = \"./bot_data\",   onlybots = TRUE,   csv = TRUE,   info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import with file names (path separately) oTree2 <- import_otree(      del_empty = TRUE,      path = \"./exp_data\",      file_names = c(\"all_apps_wide-2023-03-27.csv\",                    \"ChatMessages-2023-03-27.csv\",                    \"PageTimes-2023-03-27.csv\"),      onlybots = FALSE,      csv = TRUE,      info = TRUE)  # Show the structure of the import str(oTree, max.level = 1)  # Import with file names (without path separately) oTree2 <- import_otree(      del_empty = TRUE,      file_names = c(\"exp_data/all_apps_wide-2023-03-27.csv\",                    \"exp_data/ChatMessages-2023-03-27.csv\",                    \"exp_data/PageTimes-2023-03-27.csv\"),      onlybots = FALSE,      csv = TRUE,      info = TRUE)  # Show the structure of the import str(oTree, max.level = 1) }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames. #> List of 8 #>  $ all_apps_wide:'data.frame':\t41 obs. of  60 variables: #>  $ info         :List of 2 #>  $ chatapp      :'data.frame':\t33 obs. of  24 variables: #>  $ dictator     :'data.frame':\t123 obs. of  25 variables: #>  $ survey       :'data.frame':\t33 obs. of  29 variables: #>  $ start        :'data.frame':\t8 obs. of  24 variables: #>  $ Time         :'data.frame':\t366 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames. #> Imported: 5 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> 12 case(s) deleted #> Dropouts are deleted from all data frames. Except: The list of oTree data frames includes a chat. As the interpretation of chat data depends on how participants engage with each other, the data must be deleted with more care than deleting data in other apps. Hence, this function does not delete data in this data frame. Please do this manually if necessary! #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 4 app(s) and/or all_apps_wide #> No Time files available #> No chat files available #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 1 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables: #> Imported: 1 app(s) and/or all_apps_wide #> Imported: Time file(s) #> Imported: Chat file(s) #> List of 8 #>  $ all_apps_wide:'data.frame':\t27 obs. of  60 variables: #>  $ info         :List of 3 #>  $ chatapp      :'data.frame':\t21 obs. of  24 variables: #>  $ dictator     :'data.frame':\t75 obs. of  25 variables: #>  $ survey       :'data.frame':\t21 obs. of  29 variables: #>  $ start        :'data.frame':\t4 obs. of  24 variables: #>  $ Time         :'data.frame':\t326 obs. of  10 variables: #>  $ Chats        :'data.frame':\t41 obs. of  7 variables:"},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":null,"dir":"Reference","previous_headings":"","what":"Make IDs — make_ids","title":"Make IDs — make_ids","text":"Make session IDs , optionally, group IDs participant IDs span across data frames created import_otree. Information IDs taken $all_apps_wide can defined otherwise. Note: Older versions oTree may already contain variable called session_id $Time data frames. variable overwritten function! Important: Combine duplicate data running function!","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Make IDs — make_ids","text":"","code":"make_ids(   oTree,   gmake = FALSE,   pmake = TRUE,   from_app = \"all_apps_wide\",   from_var = NULL,   sstart = 1L,   gstart = 1L,   pstart = 1L,   emptyrows = NULL,   icw = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Make IDs — make_ids","text":"oTree list data frames created import_otree. gmake Logical. TRUE variable called group_id made. from_var NULL, gmake automatically set TRUE. pmake Logical. TRUE variable called participant_id made. from_app Character. Name data frame session, group, participant information taken. normal app data frames $all_apps_wide allowed. from_var Character. Name variable group information taken. argument relevant $all_apps_wide used from_app group information contradicts . sstart Integer. number serves starting point session IDs. gstart Integer. number serves starting point group IDs. pstart Integer. number serves starting point participant IDs. emptyrows Character. \"\" function stop empty rows from_app. \"yes\" function continue make IDs. icw Logical. TRUE warning message ignored states IDs made oTree bug.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Make IDs — make_ids","text":"ID variables made $all_apps_wide, app data frames, $Time data frame, $Chats data frame. See list additional ID variables $info$additional_variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/make_ids.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Make IDs — make_ids","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Make session IDs only oTree2 <- make_ids(oTree)  # Show new variables oTree2$all_apps_wide$session_id #>  [1] 1 1 1 1 1 1 1 1 1 2 2 2 2 3 3 3 3 3 3 4 4 4 4 5 5 6 6 6 6  # Make session IDs and group IDs # Not working with this data set because group ID is not the same in all apps if (FALSE) { # \\dontrun{       oTree2 <- make_ids(oTree, gmake = TRUE)        # Show new variables       oTree2$all_apps_wide$session_id       oTree2$all_apps_wide$group_id } # }  # Get IDs from variable \"dictator.1.group.id_in_subsession\" # in the data frame \"all_apps_wide\" oTree2 <- make_ids(oTree,                    gmake = TRUE,                    from_var = \"dictator.1.group.id_in_subsession\")  # Show new variables oTree2$all_apps_wide$session_id #>  [1] 1 1 1 1 1 1 1 1 1 2 2 2 2 3 3 3 3 3 3 4 4 4 4 5 5 6 6 6 6 oTree2$all_apps_wide$group_id #>  [1]  1  1  2  2  3  3  4  4  5  6  6  7  7  8  8  9  9 10 10 11 11 12 12 13 13 #> [26] 14 14 15 15  # Get IDs from another app than all_apps_wide oTree2 <- make_ids(oTree, gmake = TRUE, from_app = \"dictator\") #> Warning: Data frame \"all_apps_wide\" has more participants than dictator: 6cim3a5i, 1mn1kzs7, zdki96d6, byxco6zo  # Show new variables oTree2$all_apps_wide$session_id #>  [1]  1  1  1  1  1  1  1  1  1  2  2  2  2  3  3  3  3  3  3  4  4  4  4  5  5 #> [26] NA NA NA NA oTree2$all_apps_wide$group_id #>  [1]  1  1  2  2  3  3  4  4  5  6  6  7  7  8  8  9  9 10 10 11 11 12 12 13 13 #> [26] NA NA NA NA"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if the Chats data frame is messy — messy_chat","title":"Check if the Chats data frame is messy — messy_chat","text":"Check $Chats data frame includes session-related variables participant-related variables appear multiple times. may occur data different oTree versions, use different variable names, combined. desired, function can merge variables, storing data using newer oTree version's variable names removing outdated variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if the Chats data frame is messy — messy_chat","text":"","code":"messy_chat(   oTree,   combine = FALSE,   session = TRUE,   participant = TRUE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if the Chats data frame is messy — messy_chat","text":"oTree list data frames created import_otree. combine Logical. TRUE variables referring session code merged /variables referring participant code merged case data several versions oTree used. session Logical. TRUE variables referring session code checked merged. Merging works combine = TRUE. participant Logical. TRUE variables referring participant code checked merged. Merging works combine = TRUE. info Logical. TRUE brief information process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if the Chats data frame is messy — messy_chat","text":"function searches multiple variables related session code participant code $Chats data frame. can occur data old new oTree versions used. combine = FALSE, function throw error variables found. combine = TRUE, function throw error variables found. Instead, automatically combines variables new variables adds original $Chats data frame. function returns duplicate original oTree list $Chats data frame modified. new variables called participant_code session_code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_chat.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if the Chats data frame is messy — messy_chat","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Show all Chats column names print(colnames(oTree$Chats)) #> [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          #> [5] \"nickname\"         \"body\"             \"timestamp\"         # Run function oTree <- messy_chat(oTree, combine = TRUE)  # Show all Chats column names again print(colnames(oTree$Chats)) #> [1] \"session_code\"     \"id_in_session\"    \"participant_code\" \"channel\"          #> [5] \"nickname\"         \"body\"             \"timestamp\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if the Time data frame is messy — messy_time","title":"Check if the Time data frame is messy — messy_time","text":"Checks Time data frame includes participant-related variables time stamp variables appear multiple times. may occur data different oTree versions, use different variable names, combined. desired, function can merge variables, storing data using newer oTree version's variable names removing outdated variables.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if the Time data frame is messy — messy_time","text":"","code":"messy_time(   oTree,   combine = FALSE,   epoch_time = TRUE,   participant = TRUE,   info = FALSE )"},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if the Time data frame is messy — messy_time","text":"oTree list data frames created import_otree. combine Logical. TRUE variables referring epoch time merged /variables referring participant code merged case data several versions oTree used. epoch_time Logical. TRUE variables referring time stamp checked merged. works combine = TRUE. participant Logical. TRUE variables referring participant code checked merged. works combine = TRUE. info Logical. TRUE brief information process printed.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if the Time data frame is messy — messy_time","text":"function searches multiple variables related time stamp participant code $Time data frame, can occur data old new oTree versions used. combine = FALSE, function throw error variables found. combine = TRUE, function throw error variables found. Instead, automatically combines variables new variables adds original $Time data frame. function returns duplicate original oTree list $Time data frame modified. new variables called epoch_time_completed participant_code.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/messy_time.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Check if the Time data frame is messy — messy_time","text":"","code":"# Set data folder first withr::with_dir(system.file(\"extdata\", package = \"gmoTree\"), {  # Import all oTree files in this folder and its subfolders oTree <- import_otree() }) #> Warning: You have stored all_apps_wide globally but also room-specific. This function will import both of them. (Globally, the files are saved as \"all_apps_wide_.\" Room-specific, the files are saved as \"All apps - wide-\" or \"all_apps_wide-.\") After importing the data, make sure nothing is there twice! (Advice: You may use delete_duplicate() to remove duplicate rows of all oTree data frames.  # Show all Time column names print(colnames(oTree$Time)) #>  [1] \"session_code\"              \"participant_id_in_session\" #>  [3] \"participant_code\"          \"page_index\"                #>  [5] \"app_name\"                  \"page_name\"                 #>  [7] \"epoch_time_completed\"      \"round_number\"              #>  [9] \"timeout_happened\"          \"is_wait_page\"               # Run function oTree <- messy_time(oTree, combine = TRUE)  # Show all Time column names again print(colnames(oTree$Time)) #>  [1] \"session_code\"              \"participant_id_in_session\" #>  [3] \"participant_code\"          \"page_index\"                #>  [5] \"app_name\"                  \"page_name\"                 #>  [7] \"epoch_time_completed\"      \"round_number\"              #>  [9] \"timeout_happened\"          \"is_wait_page\""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample experimental data — oTree","title":"Sample experimental data — oTree","text":"Sample experimental data","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample experimental data — oTree","text":"","code":"oTree"},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Sample experimental data — oTree","text":"list data frames created import_otree().","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/oTree.html","id":"source","dir":"Reference","previous_headings":"","what":"Source","title":"Sample experimental data — oTree","text":"data set created using modified versions official oTree sample experiments can downloaded installing oTree. detail, following apps used: \"start,\" \"dictator,\" \"chatapp,\" \"survey.\"","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculate the seconds spent on each page — pagesec","title":"Calculate the seconds spent on each page — pagesec","text":"Create new variable $Time data frame contains time spent page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculate the seconds spent on each page — pagesec","text":"","code":"pagesec(oTree, rounded = TRUE, digits = 2, minutes = FALSE, combine = FALSE)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculate the seconds spent on each page — pagesec","text":"oTree list data frames created import_otree. rounded Logical. TRUE output rounded. digits Integer. number digits output rounded. parameter effect unless rounded = TRUE. minutes Logical. TRUE output minutes instead seconds. combine Logical. TRUE variables referring epoch time merged, variables referring participant code merged case data several versions oTree used.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculate the seconds spent on each page — pagesec","text":"function returns duplicate original oTree list data frames also contains column $Time data frame  named seconds_on_page2 minutes_on_page.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/pagesec.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Calculate the seconds spent on each page — pagesec","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Create two new columns: seconds_on_page2 and minutes_on_page oTree <- pagesec(oTree, rounded = TRUE, minutes = TRUE)  # Show the Time data frame head(oTree$Time, n = 30) #>    session_code participant_id_in_session participant_code page_index app_name #> 1      7bfqtokx                         1         46kxib6w          0          #> 2      7bfqtokx                         2         iay3dhkn          0          #> 3      7bfqtokx                         3         4zhzdmzo          0          #> 4      7bfqtokx                         4         3ttf7yix          0          #> 5      7bfqtokx                         5         2d72mfgh          0          #> 6      7bfqtokx                         6         rvce7958          0          #> 7      7bfqtokx                         7         164r1hs4          0          #> 8      7bfqtokx                         8         lsl3vbij          0          #> 9      7bfqtokx                         9         ktjz5jli          0          #> 10     7bfqtokx                         1         46kxib6w          1 dictator #> 11     7bfqtokx                         1         46kxib6w          2 dictator #> 12     7bfqtokx                         2         iay3dhkn          1 dictator #> 13     7bfqtokx                         1         46kxib6w          3 dictator #> 14     7bfqtokx                         2         iay3dhkn          3 dictator #> 15     7bfqtokx                         2         iay3dhkn          4 dictator #> 16     7bfqtokx                         2         iay3dhkn          5 dictator #> 17     7bfqtokx                         1         46kxib6w          4 dictator #> 18     7bfqtokx                         1         46kxib6w          5 dictator #> 19     7bfqtokx                         1         46kxib6w          6 dictator #> 20     7bfqtokx                         1         46kxib6w          7 dictator #> 21     7bfqtokx                         2         iay3dhkn          7 dictator #> 22     7bfqtokx                         1         46kxib6w          8 dictator #> 23     7bfqtokx                         1         46kxib6w          9 dictator #> 24     7bfqtokx                         1         46kxib6w         10 dictator #> 25     7bfqtokx                         2         iay3dhkn          8 dictator #> 26     7bfqtokx                         2         iay3dhkn          9 dictator #> 27     7bfqtokx                         1         46kxib6w         11 dictator #> 28     7bfqtokx                         2         iay3dhkn         11 dictator #> 29     7bfqtokx                         2         iay3dhkn         12 dictator #> 30     7bfqtokx                         1         46kxib6w         12 dictator #>                page_name epoch_time_completed round_number timeout_happened #> 1  InitializeParticipant           1679926144            1                0 #> 2  InitializeParticipant           1679926145            1                0 #> 3  InitializeParticipant           1679926146            1                0 #> 4  InitializeParticipant           1679926146            1                0 #> 5  InitializeParticipant           1679926147            1                0 #> 6  InitializeParticipant           1679926147            1                0 #> 7  InitializeParticipant           1679926148            1                0 #> 8  InitializeParticipant           1679926148            1                0 #> 9  InitializeParticipant           1679926149            1                0 #> 10          Introduction           1679926151            1                0 #> 11                 Offer           1679926154            1                0 #> 12          Introduction           1679926156            1                0 #> 13       ResultsWaitPage           1679926156            1                0 #> 14       ResultsWaitPage           1679926156            1                0 #> 15               Results           1679926157            1                0 #> 16          Introduction           1679926158            2                0 #> 17               Results           1679926160            1                0 #> 18          Introduction           1679926162            2                0 #> 19                 Offer           1679926165            2                0 #> 20       ResultsWaitPage           1679926165            2                0 #> 21       ResultsWaitPage           1679926165            2                0 #> 22               Results           1679926166            2                0 #> 23          Introduction           1679926167            3                0 #> 24                 Offer           1679926169            3                0 #> 25               Results           1679926171            2                0 #> 26          Introduction           1679926172            3                0 #> 27       ResultsWaitPage           1679926172            3                0 #> 28       ResultsWaitPage           1679926172            3                0 #> 29               Results           1679926173            3                0 #> 30               Results           1679926178            3                0 #>    is_wait_page minutes_on_page #> 1             0              NA #> 2             0              NA #> 3             0              NA #> 4             0              NA #> 5             0              NA #> 6             0              NA #> 7             0              NA #> 8             0              NA #> 9             0              NA #> 10            0            0.12 #> 11            0            0.05 #> 12            0            0.18 #> 13            1            0.03 #> 14            1            0.00 #> 15            0            0.02 #> 16            0            0.02 #> 17            0            0.07 #> 18            0            0.03 #> 19            0            0.05 #> 20            1            0.00 #> 21            1            0.12 #> 22            0            0.02 #> 23            0            0.02 #> 24            0            0.03 #> 25            0            0.10 #> 26            0            0.02 #> 27            1            0.05 #> 28            1            0.00 #> 29            0            0.02 #> 30            0            0.10"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":null,"dir":"Reference","previous_headings":"","what":"Show constant columns — show_constant","title":"Show constant columns — show_constant","text":"Show columns variation values data frame oTree list data frames (except ones info list). function helpful running experiment check unnecessary variables. can check columns unchanging possible value columns containing specific value.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show constant columns — show_constant","text":"","code":"show_constant(oTree, value = \"any\")"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show constant columns — show_constant","text":"oTree list data frames created import_otree. value value controlled within column. value set \"\", function checks columns possible values identical.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Show constant columns — show_constant","text":"function returns list vectors, one app, $all_apps_wide, $Time /$Chats data frame. vector contains names variables constant values. variables constant values, vector empty.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_constant.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Show constant columns — show_constant","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show all columns that contain only NAs show_constant(oTree = oTree) #> $all_apps_wide #>  [1] \"participant._is_bot\"                          #>  [2] \"participant._max_page_index\"                  #>  [3] \"participant.visited\"                          #>  [4] \"participant.mturk_worker_id\"                  #>  [5] \"participant.mturk_assignment_id\"              #>  [6] \"session.label\"                                #>  [7] \"session.mturk_HITId\"                          #>  [8] \"session.mturk_HITGroupId\"                     #>  [9] \"session.comment\"                              #> [10] \"session.is_demo\"                              #> [11] \"session.config.name\"                          #> [12] \"session.config.real_world_currency_per_point\" #> [13] \"session.config.participation_fee\"             #> [14] \"dictator.1.player.role\"                       #> [15] \"dictator.1.subsession.round_number\"           #> [16] \"dictator.2.player.role\"                       #> [17] \"dictator.2.subsession.round_number\"           #> [18] \"dictator.3.player.role\"                       #> [19] \"dictator.3.subsession.round_number\"           #> [20] \"chatapp.1.player.role\"                        #> [21] \"chatapp.1.player.payoff\"                      #> [22] \"chatapp.1.subsession.round_number\"            #> [23] \"survey.1.player.role\"                         #> [24] \"survey.1.player.payoff\"                       #> [25] \"survey.1.group.id_in_subsession\"              #> [26] \"survey.1.subsession.round_number\"             #>  #> $chatapp #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"player.payoff\"                   \"subsession.round_number\"         #>  [9] \"session.label\"                   \"session.mturk_HITId\"             #> [11] \"session.mturk_HITGroupId\"        \"session.comment\"                 #> [13] \"session.is_demo\"                 #>  #> $dictator #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"session.label\"                   \"session.mturk_HITId\"             #>  [9] \"session.mturk_HITGroupId\"        \"session.comment\"                 #> [11] \"session.is_demo\"                 #>  #> $survey #>  [1] \"participant._is_bot\"             \"participant._max_page_index\"     #>  [3] \"participant.visited\"             \"participant.mturk_worker_id\"     #>  [5] \"participant.mturk_assignment_id\" \"player.role\"                     #>  [7] \"player.payoff\"                   \"group.id_in_subsession\"          #>  [9] \"subsession.round_number\"         \"session.label\"                   #> [11] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [13] \"session.comment\"                 \"session.is_demo\"                 #>  #> $Time #> [1] \"timeout_happened\" #>  #> $Chats #> character(0) #>  show_constant(oTree = oTree, value = NA) #> $all_apps_wide #>  [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #>  [3] \"session.label\"                   \"session.mturk_HITId\"             #>  [5] \"session.mturk_HITGroupId\"        \"session.comment\"                 #>  [7] \"dictator.1.player.role\"          \"dictator.2.player.role\"          #>  [9] \"dictator.3.player.role\"          \"chatapp.1.player.role\"           #> [11] \"survey.1.player.role\"            #>  #> $chatapp #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $dictator #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $survey #> [1] \"participant.mturk_worker_id\"     \"participant.mturk_assignment_id\" #> [3] \"player.role\"                     \"session.label\"                   #> [5] \"session.mturk_HITId\"             \"session.mturk_HITGroupId\"        #> [7] \"session.comment\"                 #>  #> $Time #> character(0) #>  #> $Chats #> character(0) #>   # Show all columns that contain only -99 show_constant(oTree = oTree, value = -99) #> $all_apps_wide #> character(0) #>  #> $chatapp #> character(0) #>  #> $dictator #> character(0) #>  #> $survey #> character(0) #>  #> $Time #> character(0) #>  #> $Chats #> character(0) #>"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":null,"dir":"Reference","previous_headings":"","what":"Show participants who did not finish the experiment — show_dropouts","title":"Show participants who did not finish the experiment — show_dropouts","text":"Show information people finish experiment () certain page(s) /app(s).","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Show participants who did not finish the experiment — show_dropouts","text":"","code":"show_dropouts(oTree, final_apps = NULL, final_pages = NULL, saved_vars = NULL)"},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Show participants who did not finish the experiment — show_dropouts","text":"oTree list data frames created import_otree. final_apps Character. name(s) app(s) participants finish experiment. final_pages Character. name(s) page(s) participants finish experiment. saved_vars name(s) variable(s) need(s) shown list information dropout cases.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Show participants who did not finish the experiment — show_dropouts","text":"function returns list information participants finish experiment. list, can find following information: - $full = data frame contains information participants finish study; shows participant codes, names apps left experiment, names pages left experiment, names app data frames information found, dropout reason (\"ENC\", experiment completed, combined name data frame dropout observed). participants usually appear multiple app data frames, $full data frame may contain several entries person. - $unique = data frame contains similar information $full data frame one row per participant information data frame dropout observed. - $all_end = table provides information app page combinations participants ended experiment. table also includes information participants drop experiment. $all_end table shown $all_apps_wide data frame exists. - $codes = vector containing participant codes participants finish experiment. - $count = number participants finish experiment. important note argument final_pages set, function distinguish page names reoccur different apps. columns end_app end_page output empty, variables saved oTree specific participants. empty rows deleted. can done using argument del_empty = TRUE\" using import_otree.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/reference/show_dropouts.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Show participants who did not finish the experiment — show_dropouts","text":"","code":"# Use package-internal list of oTree data frames oTree <- gmoTree::oTree  # Show everyone who did not finish with the app \"survey\" show_dropouts(oTree, final_apps = \"survey\") #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 22         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 23         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 24         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 25         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 26         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 27         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 28         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 29         znri6myc     l8ecm1uh dictator    Introduction #> 30         znri6myc     l8ecm1uh dictator    Introduction #> 31         znri6myc     l8ecm1uh dictator    Introduction #> 32         znri6myc     l8ecm1uh dictator    Introduction #>                                                 reason #> 1  Experiment not completed. Noticed at: all_apps_wide #> 2        Experiment not completed. Noticed at: chatapp #> 3       Experiment not completed. Noticed at: dictator #> 4         Experiment not completed. Noticed at: survey #> 5  Experiment not completed. Noticed at: all_apps_wide #> 6        Experiment not completed. Noticed at: chatapp #> 7       Experiment not completed. Noticed at: dictator #> 8         Experiment not completed. Noticed at: survey #> 9  Experiment not completed. Noticed at: all_apps_wide #> 10       Experiment not completed. Noticed at: chatapp #> 11      Experiment not completed. Noticed at: dictator #> 12        Experiment not completed. Noticed at: survey #> 13 Experiment not completed. Noticed at: all_apps_wide #> 14       Experiment not completed. Noticed at: chatapp #> 15      Experiment not completed. Noticed at: dictator #> 16        Experiment not completed. Noticed at: survey #> 17 Experiment not completed. Noticed at: all_apps_wide #> 18       Experiment not completed. Noticed at: chatapp #> 19      Experiment not completed. Noticed at: dictator #> 20        Experiment not completed. Noticed at: survey #> 21 Experiment not completed. Noticed at: all_apps_wide #> 22       Experiment not completed. Noticed at: chatapp #> 23      Experiment not completed. Noticed at: dictator #> 24        Experiment not completed. Noticed at: survey #> 25 Experiment not completed. Noticed at: all_apps_wide #> 26       Experiment not completed. Noticed at: chatapp #> 27      Experiment not completed. Noticed at: dictator #> 28        Experiment not completed. Noticed at: survey #> 29 Experiment not completed. Noticed at: all_apps_wide #> 30       Experiment not completed. Noticed at: chatapp #> 31      Experiment not completed. Noticed at: dictator #> 32        Experiment not completed. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 25         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 29         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 9  Experiment not completed #> 13 Experiment not completed #> 17 Experiment not completed #> 21 Experiment not completed #> 25 Experiment not completed #> 29 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"ktjz5jli\" \"vbhvhozv\" #> [8] \"znri6myc\" #>  #> $count #> [1] 8 #>   # Show everyone who did not finish with the page \"Demographics\" show_dropouts(oTree, final_pages = \"Demographics\") #> $full #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 2          164r1hs4     7bfqtokx  chatapp            chat #> 3          164r1hs4     7bfqtokx  chatapp            chat #> 4          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 6          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 7          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 8          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 10         7wa8kk3d     l8ecm1uh dictator    Introduction #> 11         7wa8kk3d     l8ecm1uh dictator    Introduction #> 12         7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 14         ao9kqvqn     l8ecm1uh dictator    Introduction #> 15         ao9kqvqn     l8ecm1uh dictator    Introduction #> 16         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 18         d4sq7zio     l8ecm1uh dictator    Introduction #> 19         d4sq7zio     l8ecm1uh dictator    Introduction #> 20         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 22         jxh15obl     t0rog7nz   survey           Offer #> 23         jxh15obl     t0rog7nz   survey           Offer #> 24         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 26         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 27         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 28         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 30         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 31         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 32         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #> 34         znri6myc     l8ecm1uh dictator    Introduction #> 35         znri6myc     l8ecm1uh dictator    Introduction #> 36         znri6myc     l8ecm1uh dictator    Introduction #>                                                 reason #> 1  Experiment not completed. Noticed at: all_apps_wide #> 2         Experiment not completed. Noticed at: survey #> 3       Experiment not completed. Noticed at: dictator #> 4        Experiment not completed. Noticed at: chatapp #> 5         Experiment not completed. Noticed at: survey #> 6       Experiment not completed. Noticed at: dictator #> 7        Experiment not completed. Noticed at: chatapp #> 8  Experiment not completed. Noticed at: all_apps_wide #> 9         Experiment not completed. Noticed at: survey #> 10      Experiment not completed. Noticed at: dictator #> 11       Experiment not completed. Noticed at: chatapp #> 12 Experiment not completed. Noticed at: all_apps_wide #> 13        Experiment not completed. Noticed at: survey #> 14      Experiment not completed. Noticed at: dictator #> 15       Experiment not completed. Noticed at: chatapp #> 16 Experiment not completed. Noticed at: all_apps_wide #> 17      Experiment not completed. Noticed at: dictator #> 18       Experiment not completed. Noticed at: chatapp #> 19 Experiment not completed. Noticed at: all_apps_wide #> 20        Experiment not completed. Noticed at: survey #> 21       Experiment not completed. Noticed at: chatapp #> 22 Experiment not completed. Noticed at: all_apps_wide #> 23        Experiment not completed. Noticed at: survey #> 24      Experiment not completed. Noticed at: dictator #> 25        Experiment not completed. Noticed at: survey #> 26      Experiment not completed. Noticed at: dictator #> 27       Experiment not completed. Noticed at: chatapp #> 28 Experiment not completed. Noticed at: all_apps_wide #> 29        Experiment not completed. Noticed at: survey #> 30      Experiment not completed. Noticed at: dictator #> 31       Experiment not completed. Noticed at: chatapp #> 32 Experiment not completed. Noticed at: all_apps_wide #> 33        Experiment not completed. Noticed at: survey #> 34      Experiment not completed. Noticed at: dictator #> 35       Experiment not completed. Noticed at: chatapp #> 36 Experiment not completed. Noticed at: all_apps_wide #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          164r1hs4     7bfqtokx  chatapp            chat #> 5          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 9          7wa8kk3d     l8ecm1uh dictator    Introduction #> 13         ao9kqvqn     l8ecm1uh dictator    Introduction #> 17         d4sq7zio     l8ecm1uh dictator    Introduction #> 21         jxh15obl     t0rog7nz   survey           Offer #> 25         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 29         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 33         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 9  Experiment not completed #> 13 Experiment not completed #> 17 Experiment not completed #> 21 Experiment not completed #> 25 Experiment not completed #> 29 Experiment not completed #> 33 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #> [1] \"164r1hs4\" \"2scvem7a\" \"7wa8kk3d\" \"ao9kqvqn\" \"d4sq7zio\" \"jxh15obl\" \"ktjz5jli\" #> [8] \"vbhvhozv\" \"znri6myc\" #>  #> $count #> [1] 9 #>   # Show everyone who finished with the following apps: \"survey,\" \"dictator\" final_apps <- unique(oTree$all_apps_wide$participant._current_app_name) final_apps <- final_apps[final_apps != \"survey\"] final_apps <- final_apps[final_apps != \"dictator\"] show_dropouts(oTree, final_apps = final_apps) #> $full #>     participant.code session.code  end_app        end_page #> 1           1l5kal0r     t0rog7nz   survey    Demographics #> 2           1l5kal0r     t0rog7nz   survey    Demographics #> 3           1l5kal0r     t0rog7nz   survey    Demographics #> 4           1l5kal0r     t0rog7nz   survey    Demographics #> 5           1mn1kzs7     gii59rga   survey    Demographics #> 6           2d72mfgh     7bfqtokx   survey    Demographics #> 7           2d72mfgh     7bfqtokx   survey    Demographics #> 8           2d72mfgh     7bfqtokx   survey    Demographics #> 9           2d72mfgh     7bfqtokx   survey    Demographics #> 10          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 11          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 12          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 13          2scvem7a     vd1h01iv dictator ResultsWaitPage #> 14          3ttf7yix     7bfqtokx   survey    Demographics #> 15          3ttf7yix     7bfqtokx   survey    Demographics #> 16          3ttf7yix     7bfqtokx   survey    Demographics #> 17          3ttf7yix     7bfqtokx   survey    Demographics #> 18          46kxib6w     7bfqtokx   survey    Demographics #> 19          46kxib6w     7bfqtokx   survey    Demographics #> 20          46kxib6w     7bfqtokx   survey    Demographics #> 21          46kxib6w     7bfqtokx   survey    Demographics #> 22          4zhzdmzo     7bfqtokx   survey    Demographics #> 23          4zhzdmzo     7bfqtokx   survey    Demographics #> 24          4zhzdmzo     7bfqtokx   survey    Demographics #> 25          4zhzdmzo     7bfqtokx   survey    Demographics #> 26          6cim3a5i     gii59rga   survey    Demographics #> 27          7l0hmpcq     qyu3qg0q   survey    Demographics #> 28          7l0hmpcq     qyu3qg0q   survey    Demographics #> 29          7l0hmpcq     qyu3qg0q   survey    Demographics #> 30          7l0hmpcq     qyu3qg0q   survey    Demographics #> 31          7wa8kk3d     l8ecm1uh dictator    Introduction #> 32          7wa8kk3d     l8ecm1uh dictator    Introduction #> 33          7wa8kk3d     l8ecm1uh dictator    Introduction #> 34          7wa8kk3d     l8ecm1uh dictator    Introduction #> 35          a7dppel1     t0rog7nz   survey    Demographics #> 36          a7dppel1     t0rog7nz   survey    Demographics #> 37          a7dppel1     t0rog7nz   survey    Demographics #> 38          a7dppel1     t0rog7nz   survey    Demographics #> 39          ao9kqvqn     l8ecm1uh dictator    Introduction #> 40          ao9kqvqn     l8ecm1uh dictator    Introduction #> 41          ao9kqvqn     l8ecm1uh dictator    Introduction #> 42          ao9kqvqn     l8ecm1uh dictator    Introduction #> 43          byxco6zo     gii59rga   survey    Demographics #> 44          d4sq7zio     l8ecm1uh dictator    Introduction #> 45          d4sq7zio     l8ecm1uh dictator    Introduction #> 46          d4sq7zio     l8ecm1uh dictator    Introduction #> 47          d4sq7zio     l8ecm1uh dictator    Introduction #> 48          ia9rnfvc     qyu3qg0q   survey    Demographics #> 49          ia9rnfvc     qyu3qg0q   survey    Demographics #> 50          ia9rnfvc     qyu3qg0q   survey    Demographics #> 51          ia9rnfvc     qyu3qg0q   survey    Demographics #> 52          iagvtslv     t0rog7nz   survey    Demographics #> 53          iagvtslv     t0rog7nz   survey    Demographics #> 54          iagvtslv     t0rog7nz   survey    Demographics #> 55          iagvtslv     t0rog7nz   survey    Demographics #> 56          iay3dhkn     7bfqtokx   survey    Demographics #> 57          iay3dhkn     7bfqtokx   survey    Demographics #> 58          iay3dhkn     7bfqtokx   survey    Demographics #> 59          iay3dhkn     7bfqtokx   survey    Demographics #> 60          jxh15obl     t0rog7nz   survey           Offer #> 61          jxh15obl     t0rog7nz   survey           Offer #> 62          jxh15obl     t0rog7nz   survey           Offer #> 63          jxh15obl     t0rog7nz   survey           Offer #> 64          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 65          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 66          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 67          ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 68          lsl3vbij     7bfqtokx   survey    Demographics #> 69          lsl3vbij     7bfqtokx   survey    Demographics #> 70          lsl3vbij     7bfqtokx   survey    Demographics #> 71          lsl3vbij     7bfqtokx   survey    Demographics #> 72          rvce7958     7bfqtokx   survey    Demographics #> 73          rvce7958     7bfqtokx   survey    Demographics #> 74          rvce7958     7bfqtokx   survey    Demographics #> 75          rvce7958     7bfqtokx   survey    Demographics #> 76          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 77          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 78          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 79          vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 80          wk247s9w     t0rog7nz   survey    Demographics #> 81          wk247s9w     t0rog7nz   survey    Demographics #> 82          wk247s9w     t0rog7nz   survey    Demographics #> 83          wk247s9w     t0rog7nz   survey    Demographics #> 84          xkobdvuh     t0rog7nz   survey    Demographics #> 85          xkobdvuh     t0rog7nz   survey    Demographics #> 86          xkobdvuh     t0rog7nz   survey    Demographics #> 87          xkobdvuh     t0rog7nz   survey    Demographics #> 88          xmxl46rm     vd1h01iv   survey    Demographics #> 89          xmxl46rm     vd1h01iv   survey    Demographics #> 90          xmxl46rm     vd1h01iv   survey    Demographics #> 91          xmxl46rm     vd1h01iv   survey    Demographics #> 92          xx78b3x0     vd1h01iv   survey    Demographics #> 93          xx78b3x0     vd1h01iv   survey    Demographics #> 94          xx78b3x0     vd1h01iv   survey    Demographics #> 95          xx78b3x0     vd1h01iv   survey    Demographics #> 96          zdki96d6     gii59rga   survey    Demographics #> 97          znri6myc     l8ecm1uh dictator    Introduction #> 98          znri6myc     l8ecm1uh dictator    Introduction #> 99          znri6myc     l8ecm1uh dictator    Introduction #> 100         znri6myc     l8ecm1uh dictator    Introduction #>                                                  reason #> 1         Experiment not completed. Noticed at: chatapp #> 2   Experiment not completed. Noticed at: all_apps_wide #> 3        Experiment not completed. Noticed at: dictator #> 4          Experiment not completed. Noticed at: survey #> 5   Experiment not completed. Noticed at: all_apps_wide #> 6         Experiment not completed. Noticed at: chatapp #> 7   Experiment not completed. Noticed at: all_apps_wide #> 8        Experiment not completed. Noticed at: dictator #> 9          Experiment not completed. Noticed at: survey #> 10         Experiment not completed. Noticed at: survey #> 11  Experiment not completed. Noticed at: all_apps_wide #> 12       Experiment not completed. Noticed at: dictator #> 13        Experiment not completed. Noticed at: chatapp #> 14        Experiment not completed. Noticed at: chatapp #> 15       Experiment not completed. Noticed at: dictator #> 16         Experiment not completed. Noticed at: survey #> 17  Experiment not completed. Noticed at: all_apps_wide #> 18  Experiment not completed. Noticed at: all_apps_wide #> 19       Experiment not completed. Noticed at: dictator #> 20        Experiment not completed. Noticed at: chatapp #> 21         Experiment not completed. Noticed at: survey #> 22        Experiment not completed. Noticed at: chatapp #> 23         Experiment not completed. Noticed at: survey #> 24  Experiment not completed. Noticed at: all_apps_wide #> 25       Experiment not completed. Noticed at: dictator #> 26  Experiment not completed. Noticed at: all_apps_wide #> 27       Experiment not completed. Noticed at: dictator #> 28        Experiment not completed. Noticed at: chatapp #> 29  Experiment not completed. Noticed at: all_apps_wide #> 30         Experiment not completed. Noticed at: survey #> 31        Experiment not completed. Noticed at: chatapp #> 32  Experiment not completed. Noticed at: all_apps_wide #> 33       Experiment not completed. Noticed at: dictator #> 34         Experiment not completed. Noticed at: survey #> 35         Experiment not completed. Noticed at: survey #> 36  Experiment not completed. Noticed at: all_apps_wide #> 37       Experiment not completed. Noticed at: dictator #> 38        Experiment not completed. Noticed at: chatapp #> 39        Experiment not completed. Noticed at: chatapp #> 40  Experiment not completed. Noticed at: all_apps_wide #> 41       Experiment not completed. Noticed at: dictator #> 42         Experiment not completed. Noticed at: survey #> 43  Experiment not completed. Noticed at: all_apps_wide #> 44        Experiment not completed. Noticed at: chatapp #> 45  Experiment not completed. Noticed at: all_apps_wide #> 46       Experiment not completed. Noticed at: dictator #> 47         Experiment not completed. Noticed at: survey #> 48  Experiment not completed. Noticed at: all_apps_wide #> 49       Experiment not completed. Noticed at: dictator #> 50        Experiment not completed. Noticed at: chatapp #> 51         Experiment not completed. Noticed at: survey #> 52        Experiment not completed. Noticed at: chatapp #> 53         Experiment not completed. Noticed at: survey #> 54  Experiment not completed. Noticed at: all_apps_wide #> 55       Experiment not completed. Noticed at: dictator #> 56         Experiment not completed. Noticed at: survey #> 57  Experiment not completed. Noticed at: all_apps_wide #> 58       Experiment not completed. Noticed at: dictator #> 59        Experiment not completed. Noticed at: chatapp #> 60  Experiment not completed. Noticed at: all_apps_wide #> 61       Experiment not completed. Noticed at: dictator #> 62        Experiment not completed. Noticed at: chatapp #> 63         Experiment not completed. Noticed at: survey #> 64        Experiment not completed. Noticed at: chatapp #> 65  Experiment not completed. Noticed at: all_apps_wide #> 66       Experiment not completed. Noticed at: dictator #> 67         Experiment not completed. Noticed at: survey #> 68        Experiment not completed. Noticed at: chatapp #> 69       Experiment not completed. Noticed at: dictator #> 70  Experiment not completed. Noticed at: all_apps_wide #> 71         Experiment not completed. Noticed at: survey #> 72        Experiment not completed. Noticed at: chatapp #> 73  Experiment not completed. Noticed at: all_apps_wide #> 74       Experiment not completed. Noticed at: dictator #> 75         Experiment not completed. Noticed at: survey #> 76  Experiment not completed. Noticed at: all_apps_wide #> 77       Experiment not completed. Noticed at: dictator #> 78        Experiment not completed. Noticed at: chatapp #> 79         Experiment not completed. Noticed at: survey #> 80        Experiment not completed. Noticed at: chatapp #> 81         Experiment not completed. Noticed at: survey #> 82  Experiment not completed. Noticed at: all_apps_wide #> 83       Experiment not completed. Noticed at: dictator #> 84        Experiment not completed. Noticed at: chatapp #> 85       Experiment not completed. Noticed at: dictator #> 86         Experiment not completed. Noticed at: survey #> 87  Experiment not completed. Noticed at: all_apps_wide #> 88       Experiment not completed. Noticed at: dictator #> 89        Experiment not completed. Noticed at: chatapp #> 90  Experiment not completed. Noticed at: all_apps_wide #> 91         Experiment not completed. Noticed at: survey #> 92        Experiment not completed. Noticed at: chatapp #> 93  Experiment not completed. Noticed at: all_apps_wide #> 94       Experiment not completed. Noticed at: dictator #> 95         Experiment not completed. Noticed at: survey #> 96  Experiment not completed. Noticed at: all_apps_wide #> 97        Experiment not completed. Noticed at: chatapp #> 98       Experiment not completed. Noticed at: dictator #> 99  Experiment not completed. Noticed at: all_apps_wide #> 100        Experiment not completed. Noticed at: survey #>  #> $unique #>    participant.code session.code  end_app        end_page #> 1          1l5kal0r     t0rog7nz   survey    Demographics #> 5          1mn1kzs7     gii59rga   survey    Demographics #> 6          2d72mfgh     7bfqtokx   survey    Demographics #> 10         2scvem7a     vd1h01iv dictator ResultsWaitPage #> 14         3ttf7yix     7bfqtokx   survey    Demographics #> 18         46kxib6w     7bfqtokx   survey    Demographics #> 22         4zhzdmzo     7bfqtokx   survey    Demographics #> 26         6cim3a5i     gii59rga   survey    Demographics #> 27         7l0hmpcq     qyu3qg0q   survey    Demographics #> 31         7wa8kk3d     l8ecm1uh dictator    Introduction #> 35         a7dppel1     t0rog7nz   survey    Demographics #> 39         ao9kqvqn     l8ecm1uh dictator    Introduction #> 43         byxco6zo     gii59rga   survey    Demographics #> 44         d4sq7zio     l8ecm1uh dictator    Introduction #> 48         ia9rnfvc     qyu3qg0q   survey    Demographics #> 52         iagvtslv     t0rog7nz   survey    Demographics #> 56         iay3dhkn     7bfqtokx   survey    Demographics #> 60         jxh15obl     t0rog7nz   survey           Offer #> 64         ktjz5jli     7bfqtokx dictator ResultsWaitPage #> 68         lsl3vbij     7bfqtokx   survey    Demographics #> 72         rvce7958     7bfqtokx   survey    Demographics #> 76         vbhvhozv     vd1h01iv dictator ResultsWaitPage #> 80         wk247s9w     t0rog7nz   survey    Demographics #> 84         xkobdvuh     t0rog7nz   survey    Demographics #> 88         xmxl46rm     vd1h01iv   survey    Demographics #> 92         xx78b3x0     vd1h01iv   survey    Demographics #> 96         zdki96d6     gii59rga   survey    Demographics #> 97         znri6myc     l8ecm1uh dictator    Introduction #>                      reason #> 1  Experiment not completed #> 5  Experiment not completed #> 6  Experiment not completed #> 10 Experiment not completed #> 14 Experiment not completed #> 18 Experiment not completed #> 22 Experiment not completed #> 26 Experiment not completed #> 27 Experiment not completed #> 31 Experiment not completed #> 35 Experiment not completed #> 39 Experiment not completed #> 43 Experiment not completed #> 44 Experiment not completed #> 48 Experiment not completed #> 52 Experiment not completed #> 56 Experiment not completed #> 60 Experiment not completed #> 64 Experiment not completed #> 68 Experiment not completed #> 72 Experiment not completed #> 76 Experiment not completed #> 80 Experiment not completed #> 84 Experiment not completed #> 88 Experiment not completed #> 92 Experiment not completed #> 96 Experiment not completed #> 97 Experiment not completed #>  #> $all_end #>            #>            Demographics Introduction Offer ResultsWaitPage chat #>   chatapp             0            0     0               0    1 #>   dictator            0            4     0               3    0 #>   survey             20            0     1               0    0 #>  #> $codes #>  [1] \"1l5kal0r\" \"1mn1kzs7\" \"2d72mfgh\" \"2scvem7a\" \"3ttf7yix\" \"46kxib6w\" #>  [7] \"4zhzdmzo\" \"6cim3a5i\" \"7l0hmpcq\" \"7wa8kk3d\" \"a7dppel1\" \"ao9kqvqn\" #> [13] \"byxco6zo\" \"d4sq7zio\" \"ia9rnfvc\" \"iagvtslv\" \"iay3dhkn\" \"jxh15obl\" #> [19] \"ktjz5jli\" \"lsl3vbij\" \"rvce7958\" \"vbhvhozv\" \"wk247s9w\" \"xkobdvuh\" #> [25] \"xmxl46rm\" \"xx78b3x0\" \"zdki96d6\" \"znri6myc\" #>  #> $count #> [1] 28 #>"},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-131","dir":"Changelog","previous_headings":"","what":"gmoTree 1.3.1","title":"gmoTree 1.3.1","text":"Updated figure vignette.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-130","dir":"Changelog","previous_headings":"","what":"gmoTree 1.3.0","title":"gmoTree 1.3.0","text":"CRAN release: 2024-12-06 Resolved issue Constants vector presentations output files Fixed incorrect handling equal signs (=) documentation choices. splitvarname deal long variable names. Caveat: cases, columns may still overlap. Control output carefully. sep_list decide list presentation newline presentation output file initial include initial values codebook New preamble text Expanded input possibilities greater flexibility Changed default output_format pdf_document_simple Better presentations quotations inside strings Quotation marks now presented straight smart form Removed non-escaped quotation marks output Values now saved list format vectors Types variables now correspond better types original variables Improved list presentation output files better readability Enhanced error warning messages function can now better deal better empty arguments oTree code Linted older functions (readable) Website changes","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-121","dir":"Changelog","previous_headings":"","what":"gmoTree 1.2.1","title":"gmoTree 1.2.1","text":"codebook(): Create codebook oTree code Linted code (readable) Minor changes warning messages tests examples","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-110","dir":"Changelog","previous_headings":"","what":"gmoTree 1.1.0","title":"gmoTree 1.1.0","text":"CRAN release: 2024-07-04 extime(): Enhanced efficiency extended functionality: Introduced capability perform calculations using ‘seconds_on_page2’ variable. apptime(): Enhanced efficiency extended functionality: Introduced capability perform calculations using ‘seconds_on_page2’ variable. Linted code (efficient & readable) Minor changes tests.R Minor changes website, new logo","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-101","dir":"Changelog","previous_headings":"","what":"gmoTree 1.0.1","title":"gmoTree 1.0.1","text":"CRAN release: 2023-10-25 Minor changes examples DESCRIPTION file. Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-100","dir":"Changelog","previous_headings":"","what":"gmoTree 1.0.0","title":"gmoTree 1.0.0","text":"File names examples now portable. import_otree(): Minor changes. Can also import portable file names now.","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-003","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.3","title":"gmoTree 0.0.3","text":"Minor improvement documentation & website. Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-002","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.2","title":"gmoTree 0.0.2","text":"Minor improvement documentation & website. (Sent CRAN omitted .) Changes functions: NONE","code":""},{"path":"https://zauchnerp.github.io/gmoTree/news/index.html","id":"gmotree-001","dir":"Changelog","previous_headings":"","what":"gmoTree 0.0.1","title":"gmoTree 0.0.1","text":"Beta version gmoTree published (formerly known “ioTree”).","code":""}]
diff --git a/inst/CITATION b/inst/CITATION
index 0d42fa0..7fd2ba0 100644
--- a/inst/CITATION
+++ b/inst/CITATION
@@ -3,7 +3,7 @@ bibentry(
   title    = "gmoTree: oTree Data Manipulation Tool",
   author   = "Patricia F. Zauchner",
   year     = "2024",
-  note     = "R package version 1.3.0",
+  note     = "R package version 1.3.1",
   url      = "https://CRAN.R-project.org/package=gmoTree",
-  textVersion = "Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.0, <https://CRAN.R-project.org/package=gmoTree/>."
+  textVersion = "Zauchner, Patricia F. (2024). gmoTree: oTree Data Manipulation Tool. R package version 1.3.1, <https://CRAN.R-project.org/package=gmoTree/>."
   )
diff --git a/vignettes/intro.PNG b/vignettes/intro.png
similarity index 100%
rename from vignettes/intro.PNG
rename to vignettes/intro.png
diff --git a/vignettes/title.PNG b/vignettes/title.png
similarity index 100%
rename from vignettes/title.PNG
rename to vignettes/title.png