From 699f0db5f05007e545c261386957ee61afe35e33 Mon Sep 17 00:00:00 2001
From: Jamie Gilbert <JGilber2@its.jnj.com>
Date: Fri, 10 Jan 2025 11:19:52 -0800
Subject: [PATCH] Version 3 3 1hotfix (#1153)

* Date diff hot fix (#1151)

* DATEDIFF fixes to cast

(cherry picked from commit 0805dde632f1446ceb296b5898d75d06a49c7afe)

* Update to version number

* Package maintenance
---
 DESCRIPTION                                   |   2 +-
 R/CohortCharacterizationDiagnostics.R         |   2 +-
 R/CohortDiagnostics.R                         |   2 +-
 R/CohortLevelDiagnostics.R                    |   2 +-
 R/CohortRelationship.R                        |   2 +-
 R/ConceptIds.R                                |   2 +-
 R/ConceptSetUtils.R                           |   2 +-
 R/ConceptSets.R                               |   2 +-
 R/DataSourceInformation.R                     |   2 +-
 R/ExportCharacterization.R                    |   2 +-
 R/IncidenceRates.R                            |   2 +-
 R/InclusionRules.R                            |   2 +-
 R/Incremental.R                               |   2 +-
 R/MetaDataDiagnostics.R                       |   2 +-
 R/Private.R                                   |   2 +-
 R/ResultsDataModel.R                          |   2 +-
 R/RunDiagnostics.R                            |   2 +-
 R/Shared.R                                    |   2 +-
 R/Shiny.R                                     |   2 +-
 R/TimeSeries.R                                |   2 +-
 R/VisitContext.R                              |   2 +-
 docs/404.html                                 |   2 +-
 docs/articles/CreatingAStudyPackage.html      |   4 ++--
 .../DatabaseModeInDiagnosticsExplorer.html    |   4 ++--
 docs/articles/RunningCohortDiagnostics.html   |   4 ++--
 ...iewingResultsUsingDiagnosticsExplorer.html |   4 ++--
 docs/articles/WhatIsCohortDiagnostics.html    |   4 ++--
 docs/articles/index.html                      |   2 +-
 docs/authors.html                             |  10 +++++-----
 docs/index.html                               |   2 +-
 docs/news/index.html                          |   2 +-
 docs/pkgdown.yml                              |   2 +-
 docs/reference/CohortDiagnostics-package.html |   2 +-
 docs/reference/checkInputFileEncoding.html    |   2 +-
 .../createDiagnosticsExplorerZip.html         |   2 +-
 docs/reference/createMergedResultsFile.html   |   2 +-
 docs/reference/createResultsDataModel.html    |   2 +-
 docs/reference/deployPositConnectApp.html     |   2 +-
 docs/reference/executeDiagnostics.html        |   2 +-
 .../getCdmDataSourceInformation.html          |   2 +-
 docs/reference/getCohortCounts.html           |   2 +-
 docs/reference/getDataMigrator.html           |   2 +-
 .../getDefaultCovariateSettings.html          |   2 +-
 .../getDefaultVocabularyTableNames.html       |   2 +-
 .../getResultsDataModelSpecifications.html    |   2 +-
 docs/reference/index.html                     |   2 +-
 docs/reference/launchDiagnosticsExplorer.html |   2 +-
 docs/reference/migrateDataModel.html          |   2 +-
 .../runCohortRelationshipDiagnostics.html     |   2 +-
 .../runCohortTimeSeriesDiagnostics.html       |   2 +-
 docs/reference/uploadResults.html             |   2 +-
 docs/search.json                              |   2 +-
 extras/CohortDiagnostics.pdf                  | Bin 119945 -> 119943 bytes
 extras/PackageMaintenance.R                   |   2 +-
 inst/doc/RunningCohortDiagnostics.pdf         | Bin 225766 -> 225531 bytes
 ...ViewingResultsUsingDiagnosticsExplorer.pdf | Bin 376526 -> 376358 bytes
 inst/doc/WhatIsCohortDiagnostics.pdf          | Bin 130174 -> 129996 bytes
 inst/shiny/DiagnosticsExplorer/global.R       |   1 +
 inst/sql/sql_server/UpdateVersionNumber.sql   |   3 ++-
 59 files changed, 65 insertions(+), 63 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 4e1f58d02..c3b9b4372 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: CohortDiagnostics
 Type: Package
 Title: Diagnostics for OHDSI Cohorts
-Version: 3.3.0.99999
+Version: 3.3.1.9999
 Date: 2024-22-10
 Authors@R: c(
     person("Jamie", "Gilbert", email = "gilbert@ohdsi.org", role = c("aut", "cre")),
diff --git a/R/CohortCharacterizationDiagnostics.R b/R/CohortCharacterizationDiagnostics.R
index 1b792dabc..53d40536c 100644
--- a/R/CohortCharacterizationDiagnostics.R
+++ b/R/CohortCharacterizationDiagnostics.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/CohortDiagnostics.R b/R/CohortDiagnostics.R
index eca6dd9e1..2869d2271 100644
--- a/R/CohortDiagnostics.R
+++ b/R/CohortDiagnostics.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/CohortLevelDiagnostics.R b/R/CohortLevelDiagnostics.R
index 36f3acd8e..edec1076d 100644
--- a/R/CohortLevelDiagnostics.R
+++ b/R/CohortLevelDiagnostics.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/CohortRelationship.R b/R/CohortRelationship.R
index 7ececb130..3e0f32f86 100644
--- a/R/CohortRelationship.R
+++ b/R/CohortRelationship.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/ConceptIds.R b/R/ConceptIds.R
index 6e550d623..d037595c3 100644
--- a/R/ConceptIds.R
+++ b/R/ConceptIds.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/ConceptSetUtils.R b/R/ConceptSetUtils.R
index f3ff74c4b..f94556151 100644
--- a/R/ConceptSetUtils.R
+++ b/R/ConceptSetUtils.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/ConceptSets.R b/R/ConceptSets.R
index 10ecbb709..6923f89ca 100644
--- a/R/ConceptSets.R
+++ b/R/ConceptSets.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/DataSourceInformation.R b/R/DataSourceInformation.R
index 4079820c6..bf004b91e 100644
--- a/R/DataSourceInformation.R
+++ b/R/DataSourceInformation.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/ExportCharacterization.R b/R/ExportCharacterization.R
index 8dcd2eec4..56c2cb816 100644
--- a/R/ExportCharacterization.R
+++ b/R/ExportCharacterization.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/IncidenceRates.R b/R/IncidenceRates.R
index 7a5589ed2..77a88320f 100644
--- a/R/IncidenceRates.R
+++ b/R/IncidenceRates.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/InclusionRules.R b/R/InclusionRules.R
index 240bd7c8d..eeb9417a5 100644
--- a/R/InclusionRules.R
+++ b/R/InclusionRules.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/Incremental.R b/R/Incremental.R
index cad207db2..7ffa58141 100644
--- a/R/Incremental.R
+++ b/R/Incremental.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/MetaDataDiagnostics.R b/R/MetaDataDiagnostics.R
index a74b2fbd8..9cbcf7849 100644
--- a/R/MetaDataDiagnostics.R
+++ b/R/MetaDataDiagnostics.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/Private.R b/R/Private.R
index 8748527f4..84e5b4d31 100644
--- a/R/Private.R
+++ b/R/Private.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/ResultsDataModel.R b/R/ResultsDataModel.R
index 1061eda6a..adcb83cb0 100644
--- a/R/ResultsDataModel.R
+++ b/R/ResultsDataModel.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/RunDiagnostics.R b/R/RunDiagnostics.R
index 766955a23..e8c794825 100644
--- a/R/RunDiagnostics.R
+++ b/R/RunDiagnostics.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/Shared.R b/R/Shared.R
index f5a7a1a82..e2159feb8 100644
--- a/R/Shared.R
+++ b/R/Shared.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/Shiny.R b/R/Shiny.R
index 979795155..e0f878096 100644
--- a/R/Shiny.R
+++ b/R/Shiny.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/TimeSeries.R b/R/TimeSeries.R
index f0f43f03e..75c55a9ae 100644
--- a/R/TimeSeries.R
+++ b/R/TimeSeries.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/R/VisitContext.R b/R/VisitContext.R
index 232fcf3f7..95639da3f 100644
--- a/R/VisitContext.R
+++ b/R/VisitContext.R
@@ -1,4 +1,4 @@
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 #
diff --git a/docs/404.html b/docs/404.html
index d789290bf..54efbe86d 100644
--- a/docs/404.html
+++ b/docs/404.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="https://ohdsi.github.io/CohortDiagnostics/index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/CreatingAStudyPackage.html b/docs/articles/CreatingAStudyPackage.html
index 194f48505..b001bb0ac 100644
--- a/docs/articles/CreatingAStudyPackage.html
+++ b/docs/articles/CreatingAStudyPackage.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -62,7 +62,7 @@ <h1>Creating a study package</h1>
                         <h4 data-toc-skip class="author">Gowtham A.
 Rao</h4>
             
-            <h4 data-toc-skip class="date">2024-09-30</h4>
+            <h4 data-toc-skip class="date">2025-01-10</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/vignettes/CreatingAStudyPackage.Rmd" class="external-link"><code>vignettes/CreatingAStudyPackage.Rmd</code></a></small>
       <div class="d-none name"><code>CreatingAStudyPackage.Rmd</code></div>
diff --git a/docs/articles/DatabaseModeInDiagnosticsExplorer.html b/docs/articles/DatabaseModeInDiagnosticsExplorer.html
index b1c60112f..b5fbeb860 100644
--- a/docs/articles/DatabaseModeInDiagnosticsExplorer.html
+++ b/docs/articles/DatabaseModeInDiagnosticsExplorer.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -62,7 +62,7 @@ <h1>Database mode in Diagnostics Explorer</h1>
                         <h4 data-toc-skip class="author">Gowtham
 Rao</h4>
             
-            <h4 data-toc-skip class="date">2024-09-30</h4>
+            <h4 data-toc-skip class="date">2025-01-10</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/vignettes/DatabaseModeInDiagnosticsExplorer.Rmd" class="external-link"><code>vignettes/DatabaseModeInDiagnosticsExplorer.Rmd</code></a></small>
       <div class="d-none name"><code>DatabaseModeInDiagnosticsExplorer.Rmd</code></div>
diff --git a/docs/articles/RunningCohortDiagnostics.html b/docs/articles/RunningCohortDiagnostics.html
index 5c6b98479..f830701fd 100644
--- a/docs/articles/RunningCohortDiagnostics.html
+++ b/docs/articles/RunningCohortDiagnostics.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -62,7 +62,7 @@ <h1>Running Cohort Diagnostics</h1>
                         <h4 data-toc-skip class="author">Gowtham Rao and
 James P. Gilbert</h4>
             
-            <h4 data-toc-skip class="date">2024-09-30</h4>
+            <h4 data-toc-skip class="date">2025-01-10</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/vignettes/RunningCohortDiagnostics.Rmd" class="external-link"><code>vignettes/RunningCohortDiagnostics.Rmd</code></a></small>
       <div class="d-none name"><code>RunningCohortDiagnostics.Rmd</code></div>
diff --git a/docs/articles/ViewingResultsUsingDiagnosticsExplorer.html b/docs/articles/ViewingResultsUsingDiagnosticsExplorer.html
index 254010a5b..94be1f8d3 100644
--- a/docs/articles/ViewingResultsUsingDiagnosticsExplorer.html
+++ b/docs/articles/ViewingResultsUsingDiagnosticsExplorer.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -62,7 +62,7 @@ <h1>Viewing results using Diagnostics Explorer</h1>
                         <h4 data-toc-skip class="author">Gowtham
 Rao</h4>
             
-            <h4 data-toc-skip class="date">2024-09-30</h4>
+            <h4 data-toc-skip class="date">2025-01-10</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/vignettes/ViewingResultsUsingDiagnosticsExplorer.Rmd" class="external-link"><code>vignettes/ViewingResultsUsingDiagnosticsExplorer.Rmd</code></a></small>
       <div class="d-none name"><code>ViewingResultsUsingDiagnosticsExplorer.Rmd</code></div>
diff --git a/docs/articles/WhatIsCohortDiagnostics.html b/docs/articles/WhatIsCohortDiagnostics.html
index 1edd971fd..ce5d3b729 100644
--- a/docs/articles/WhatIsCohortDiagnostics.html
+++ b/docs/articles/WhatIsCohortDiagnostics.html
@@ -20,7 +20,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -62,7 +62,7 @@ <h1>What is Cohort Diagnostics?</h1>
                         <h4 data-toc-skip class="author">Gowtham
 Rao</h4>
             
-            <h4 data-toc-skip class="date">2024-09-30</h4>
+            <h4 data-toc-skip class="date">2025-01-10</h4>
       
       <small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/vignettes/WhatIsCohortDiagnostics.Rmd" class="external-link"><code>vignettes/WhatIsCohortDiagnostics.Rmd</code></a></small>
       <div class="d-none name"><code>WhatIsCohortDiagnostics.Rmd</code></div>
diff --git a/docs/articles/index.html b/docs/articles/index.html
index d4ca256c9..f6622038b 100644
--- a/docs/articles/index.html
+++ b/docs/articles/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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 6eaec14f5..2432e1b04 100644
--- a/docs/authors.html
+++ b/docs/authors.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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">
@@ -71,15 +71,15 @@ <h2>Authors</h2>
       <h2 id="citation">Citation</h2>
       <p><small class="dont-index">Source: <a href="https://github.com/OHDSI/CohortDiagnostics/blob/HEAD/DESCRIPTION" class="external-link"><code>DESCRIPTION</code></a></small></p>
 
-      <p>Gilbert J, Rao G, Schuemie M, Ryan P, Weaver J (2024).
+      <p>Gilbert J, Rao G, Schuemie M, Ryan P, Weaver J (2025).
 <em>CohortDiagnostics: Diagnostics for OHDSI Cohorts</em>.
-R package version 3.3.0, https://github.com/OHDSI/CohortDiagnostics, <a href="https://ohdsi.github.io/CohortDiagnostics">https://ohdsi.github.io/CohortDiagnostics</a>.
+R package version 3.3.1, https://github.com/OHDSI/CohortDiagnostics, <a href="https://ohdsi.github.io/CohortDiagnostics">https://ohdsi.github.io/CohortDiagnostics</a>.
 </p>
       <pre>@Manual{,
   title = {CohortDiagnostics: Diagnostics for OHDSI Cohorts},
   author = {Jamie Gilbert and Gowtham Rao and Martijn Schuemie and Patrick Ryan and James Weaver},
-  year = {2024},
-  note = {R package version 3.3.0, https://github.com/OHDSI/CohortDiagnostics},
+  year = {2025},
+  note = {R package version 3.3.1, https://github.com/OHDSI/CohortDiagnostics},
   url = {https://ohdsi.github.io/CohortDiagnostics},
 }</pre>
     </div>
diff --git a/docs/index.html b/docs/index.html
index 7d12b9a76..5e981cc7f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -22,7 +22,7 @@
 
     <a class="navbar-brand me-2" href="index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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 bc6329192..df9f011aa 100644
--- a/docs/news/index.html
+++ b/docs/news/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/pkgdown.yml b/docs/pkgdown.yml
index c8815d7d9..dd705fc23 100644
--- a/docs/pkgdown.yml
+++ b/docs/pkgdown.yml
@@ -7,7 +7,7 @@ articles:
   RunningCohortDiagnostics: RunningCohortDiagnostics.html
   ViewingResultsUsingDiagnosticsExplorer: ViewingResultsUsingDiagnosticsExplorer.html
   WhatIsCohortDiagnostics: WhatIsCohortDiagnostics.html
-last_built: 2024-09-30T19:09Z
+last_built: 2025-01-10T18:29Z
 urls:
   reference: https://ohdsi.github.io/CohortDiagnostics/reference
   article: https://ohdsi.github.io/CohortDiagnostics/articles
diff --git a/docs/reference/CohortDiagnostics-package.html b/docs/reference/CohortDiagnostics-package.html
index 1bbf1b4bf..671245e50 100644
--- a/docs/reference/CohortDiagnostics-package.html
+++ b/docs/reference/CohortDiagnostics-package.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/checkInputFileEncoding.html b/docs/reference/checkInputFileEncoding.html
index 05b9294ae..662890038 100644
--- a/docs/reference/checkInputFileEncoding.html
+++ b/docs/reference/checkInputFileEncoding.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/createDiagnosticsExplorerZip.html b/docs/reference/createDiagnosticsExplorerZip.html
index cb917db6a..f20694862 100644
--- a/docs/reference/createDiagnosticsExplorerZip.html
+++ b/docs/reference/createDiagnosticsExplorerZip.html
@@ -13,7 +13,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/createMergedResultsFile.html b/docs/reference/createMergedResultsFile.html
index a4001fb04..6727c0132 100644
--- a/docs/reference/createMergedResultsFile.html
+++ b/docs/reference/createMergedResultsFile.html
@@ -11,7 +11,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/createResultsDataModel.html b/docs/reference/createResultsDataModel.html
index b664ba7f9..ffb3b045a 100644
--- a/docs/reference/createResultsDataModel.html
+++ b/docs/reference/createResultsDataModel.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/deployPositConnectApp.html b/docs/reference/deployPositConnectApp.html
index 1bfb546fd..808bebd2e 100644
--- a/docs/reference/deployPositConnectApp.html
+++ b/docs/reference/deployPositConnectApp.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/executeDiagnostics.html b/docs/reference/executeDiagnostics.html
index c99ec4eb2..aa9c47975 100644
--- a/docs/reference/executeDiagnostics.html
+++ b/docs/reference/executeDiagnostics.html
@@ -17,7 +17,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getCdmDataSourceInformation.html b/docs/reference/getCdmDataSourceInformation.html
index e5b46da97..5f9623ea1 100644
--- a/docs/reference/getCdmDataSourceInformation.html
+++ b/docs/reference/getCdmDataSourceInformation.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getCohortCounts.html b/docs/reference/getCohortCounts.html
index 3266d9c22..33d2d0605 100644
--- a/docs/reference/getCohortCounts.html
+++ b/docs/reference/getCohortCounts.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getDataMigrator.html b/docs/reference/getDataMigrator.html
index 0ec7e6aa4..6e2991a78 100644
--- a/docs/reference/getDataMigrator.html
+++ b/docs/reference/getDataMigrator.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getDefaultCovariateSettings.html b/docs/reference/getDefaultCovariateSettings.html
index 5e3606e9c..90b08e1e3 100644
--- a/docs/reference/getDefaultCovariateSettings.html
+++ b/docs/reference/getDefaultCovariateSettings.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getDefaultVocabularyTableNames.html b/docs/reference/getDefaultVocabularyTableNames.html
index 9071a8c39..e3f2bfff5 100644
--- a/docs/reference/getDefaultVocabularyTableNames.html
+++ b/docs/reference/getDefaultVocabularyTableNames.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/getResultsDataModelSpecifications.html b/docs/reference/getResultsDataModelSpecifications.html
index 44bb7063e..d92797529 100644
--- a/docs/reference/getResultsDataModelSpecifications.html
+++ b/docs/reference/getResultsDataModelSpecifications.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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 bec4a0657..9c6bffefe 100644
--- a/docs/reference/index.html
+++ b/docs/reference/index.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/launchDiagnosticsExplorer.html b/docs/reference/launchDiagnosticsExplorer.html
index 85567bdb5..cd01379c8 100644
--- a/docs/reference/launchDiagnosticsExplorer.html
+++ b/docs/reference/launchDiagnosticsExplorer.html
@@ -7,7 +7,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/migrateDataModel.html b/docs/reference/migrateDataModel.html
index 68140295d..da0eca2ba 100644
--- a/docs/reference/migrateDataModel.html
+++ b/docs/reference/migrateDataModel.html
@@ -11,7 +11,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/runCohortRelationshipDiagnostics.html b/docs/reference/runCohortRelationshipDiagnostics.html
index 84c6f6eef..1e13f216e 100644
--- a/docs/reference/runCohortRelationshipDiagnostics.html
+++ b/docs/reference/runCohortRelationshipDiagnostics.html
@@ -9,7 +9,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/runCohortTimeSeriesDiagnostics.html b/docs/reference/runCohortTimeSeriesDiagnostics.html
index 55516c4b9..ee27b35d3 100644
--- a/docs/reference/runCohortTimeSeriesDiagnostics.html
+++ b/docs/reference/runCohortTimeSeriesDiagnostics.html
@@ -23,7 +23,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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/uploadResults.html b/docs/reference/uploadResults.html
index 5d5c88aa2..d938b93a7 100644
--- a/docs/reference/uploadResults.html
+++ b/docs/reference/uploadResults.html
@@ -11,7 +11,7 @@
 
     <a class="navbar-brand me-2" href="../index.html">CohortDiagnostics</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">3.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 61f3abbf2..eb658cc16 100644
--- a/docs/search.json
+++ b/docs/search.json
@@ -1 +1 @@
-[{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Creating a study package","text":"currently two approaches run Cohort Diagnostics. - Embed OHDSI study package, cohort definitions stored part study package, - WebAPi mode - cohort diagnostics dynamically pulls cohort definition webapi instance. WebAPI backend OHDSI ATLAS application, allowing programmatic access cohort definitions created ATLAS. vignette describes create self contained shareable study package can execute cohort diagnostics given set cohort definitions. recommended mode run CohortDiagnostics study. vignette, learn - use Cohort Diagnostics template package - Hydrate template package cohort definitions want diagnose. - Execute diagnostics one data sources. - Review result set using Diagnostics Explorer R shiny app Cohort Diagnostics - (optional) Submit results cohort diagnostics OHDSI Phenotype library.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"assumptions","dir":"Articles","previous_headings":"Introduction","what":"Assumptions:","title":"Creating a study package","text":"set valid cohort definition sql files (parameterized OHDSI Sql format) want run diagnostics , able export cohort definitions want diagnose Atlas using export tab within cohort definition module Atlas using ROhdsiWebApi described . access person level data OMOP CDM V5.x + format database, able execute instantiate cohorts cohort tables (.e. access schema database Create, Read, Update, Delete privileges.)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"creating-the-study-package","dir":"Articles","previous_headings":"","what":"Creating the study package","title":"Creating a study package","text":"cohorts diagnose two attributes . id: unique integer identifier cohort diagnosing. created cohort using atlas, atlas id. cohortName: unique string name cohort. Usually Atlas cohort name, can name wish identify cohort. name used display cohort Diagnostics Explorer shiny app. Example:","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"option-a-using-hydra-and-rohdsiwebapi","dir":"Articles","previous_headings":"Creating the study package","what":"option A: Using Hydra and ROhdsiWebApi","title":"Creating a study package","text":"Note: option required Hydra 0.3, writing document version Hydra develop branch. skeleton cohort diagnostics study package . skeleton package special package designed used Hydra. input Hydra study specifications file (json format). Example .","code":"# please ensure you have the latest version of Hydra. As of 08/13/2021 - CohortDiagnostics support for Hydra is still in develop branch. # please check hydra release notes and update hydra remotes::install_github(\"OHDSI/Hydra\", ref = \"develop\") outputFolder <- \"d:/temp/output\" # location where you study package will be created   ########## Please populate the information below ##################### version <- \"v0.1.0\" name <- \"Thrombosis With Thrombocytopenia Syndrome cohorts - an OHDSI network study\" packageName <- \"ThrombosisWithThrombocytopeniaSyndrome\" skeletonVersion <- \"v0.0.1\" createdBy <- \"rao@ohdsi.org\" createdDate <- Sys.Date() # default modifiedBy <- \"rao@ohdsi.org\" modifiedDate <- Sys.Date() skeletonType <- \"CohortDiagnosticsStudy\" organizationName <- \"OHDSI\" description <- \"Cohort diagnostics on Thrombosis With Thrombocytopenia Syndrome cohorts.\"   library(magrittr) # Set up baseUrl <- Sys.getenv(\"baseUrl\") # if you have security enabled, please authorize the use - example below # ROhdsiWebApi::authorizeWebApi(baseUrl, 'windows') cohortIds <- c(   22040,   22042,   22041,   22039,   22038,   22037,   22036,   22035,   22034,   22033,   22031,   22032,   22030,   22028,   22029 )    ################# end of user input ############## webApiCohorts <- ROhdsiWebApi::getCohortDefinitionsMetaData(baseUrl = baseUrl) studyCohorts <- webApiCohorts %>%   dplyr::filter(.data$id %in% cohortIds)  # compile them into a data table cohortDefinitionsArray <- list() for (i in (1:nrow(studyCohorts))) {   cohortDefinition <-     ROhdsiWebApi::getCohortDefinition(       cohortId = studyCohorts$id[[i]],       baseUrl = baseUrl     )   cohortDefinitionsArray[[i]] <- list(     id = studyCohorts$id[[i]],     createdDate = studyCohorts$createdDate[[i]],     modifiedDate = studyCohorts$createdDate[[i]],     logicDescription = studyCohorts$description[[i]],     name = stringr::str_trim(stringr::str_squish(cohortDefinition$name)),     expression = cohortDefinition$expression   ) }  tempFolder <- tempdir() unlink(x = tempFolder, recursive = TRUE, force = TRUE) dir.create(path = tempFolder, showWarnings = FALSE, recursive = TRUE)  specifications <- list(   id = 1,   version = version,   name = name,   packageName = packageName,   skeletonVersion = skeletonVersion,   createdBy = createdBy,   createdDate = createdDate,   modifiedBy = modifiedBy,   modifiedDate = modifiedDate,   skeletonType = skeletonType,   organizationName = organizationName,   description = description,   cohortDefinitions = cohortDefinitionsArray )  jsonFileName <- paste0(file.path(tempFolder, \"CohortDiagnosticsSpecs.json\")) write(x = specifications %>% RJSONIO::toJSON(pretty = TRUE, digits = 23), file = jsonFileName)   ############################################################## ############################################################## #######       Get skeleton from github            ############ #######       Uncomment if you want to use latest ############ #######       skeleton only - for advanced user   ############ ############################################################## ############################################################## ############################################################## #### get the skeleton from github # download.file(url = \"https://github.com/OHDSI/SkeletonCohortDiagnosticsStudy/archive/refs/heads/main.zip\", #                          destfile = file.path(tempFolder, 'skeleton.zip')) # unzip(zipfile =  file.path(tempFolder, 'skeleton.zip'), #       overwrite = TRUE, #       exdir = file.path(tempFolder, \"skeleton\") #         ) # fileList <- list.files(path = file.path(tempFolder, \"skeleton\"), full.names = TRUE, recursive = TRUE, all.files = TRUE) # DatabaseConnector::createZipFile(zipFile = file.path(tempFolder, 'skeleton.zip'), #                                  files = fileList, #                                  rootFolder = list.dirs(file.path(tempFolder, 'skeleton'), recursive = FALSE))  ############################################################## ############################################################## #######               Build package              ############# ############################################################## ############################################################## ##############################################################   #### Code that uses the ExampleCohortDiagnosticsSpecs in Hydra to build package hydraSpecificationFromFile <- Hydra::loadSpecifications(fileName = jsonFileName) unlink(x = outputFolder, recursive = TRUE) dir.create(path = outputFolder, showWarnings = FALSE, recursive = TRUE) Hydra::hydrate(   specifications = hydraSpecificationFromFile,   outputFolder = outputFolder )  # for advanced user using skeletons outside of Hydra # Hydra::hydrate(specifications = hydraSpecificationFromFile, #                outputFolder = outputFolder, #                skeletonFileName = file.path(tempFolder, 'skeleton.zip') # )   unlink(x = tempFolder, recursive = TRUE, force = TRUE)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/DatabaseModeInDiagnosticsExplorer.html","id":"database-mode","dir":"Articles","previous_headings":"","what":"Database mode","title":"Database mode in Diagnostics Explorer","text":"recommend use database system, file size cohort diagnostics output becomes large e.g. > 1GB, using premerged.RData may leading sluggish performance. Currently postgres server supported. use DatabaseConnector DbPool manage connections shiny application postgres. recommended method launch Shiny application provide connection details ‘launchDiagnosticsExplorer()’ shiny application. Please review documentation ‘DatabaseConnector::createConnectionDetails()’ function DatabaseConnector package connect server. example script upload data remote postgres server . ‘createResultsDataModel()’ function execute series SQL statements create empty target schema hold results Cohort Diagnostics. upload results, recommend use ‘uploadResults()’ function, provide path postgres driver. data uploaded postgres server - can execute shiny application using ‘launchDiagnosticsExplorer()’ function. Please provide connection details, along schema uploaded results (resultsDatabaseSchema). deploying server, yaml file called config.yml placed DiagnosticsExplorer path. See README.md file directory details configuration. Example yaml settings included :","code":"# Alter these configuration settings for usage with remote databases connectionDetails:   dbms: \"postgresql\"   server: \"my-database-server.com/myDatabaseName\"   user: \"postrgres\"   password: \"secret_password\"   port: 5432  # Store connection details as a json string in keyring # Store with keyring::key_set_with_value(\"KEYNAME\", jsonlite::toJSON(myConnectionDetails)) connectionDetailsSecureKey: ~  # If you used a table prefix to store the results (e.g. cd_) tablePrefix: \"\"  # Results schema being used resultsDatabaseSchema: \"cohort_diagnostics\"  # Vocabulary schemas. Should include the reuslts schema and optional custom vocabularies vocabularyDatabaseSchemas: [\"cohort_diagnostics\"]  # Custom table name for cohorts and cdm databases (probably not needed, ignores table prefix) cohortTableName: \"cohort\" databaseTableName: \"database\"  # If you wish to enable annotation - not currently reccomended in multi-user environments enableAnnotation: FALSE enableAuthorization: FALSE"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/DatabaseModeInDiagnosticsExplorer.html","id":"publishing","dir":"Articles","previous_headings":"","what":"Publishing","title":"Database mode in Diagnostics Explorer","text":"publish config can use: press publish button shiny app loads. Note - situation use secure keys keyring possible.","code":"launchDiagnosticsExplorer(   shinyConfigPath = \"path/to/config.yml\",   makePublishable = TRUE,   publishDir = file.path(getwd(), \"MyStudyDiagnosticsExplorer\"),   overwritePublishDir = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Running Cohort Diagnostics","text":"vignette discusses process generating results set CohortDiagnostics starting cohort generation. Please see HADES library information background .","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"pre-requisites","dir":"Articles","previous_headings":"Introduction","what":"pre-requisites","title":"Running Cohort Diagnostics","text":"Ensure CohortDiagnostics installed system updated latest version. example also using Eunomia test package. Optionally, may install ROhdsiWebApi package download cohort definitions ATLAS instance:","code":"remotes::install_github(\"OHDSI/Eunomia\") remotes::install_github(\"OHDSI/ROhdsiWebApi\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"configuring-the-connection-to-the-server","dir":"Articles","previous_headings":"","what":"Configuring the connection to the server","title":"Running Cohort Diagnostics","text":"need tell R connect server data . CohortDiagnostics uses DatabaseConnector package, provides createConnectionDetails function. Type ?createConnectionDetails specific settings required various database management systems (DBMS). example, one might connect PostgreSQL database using code: purposes example, use Eunomia test CDM package Sqlite database stored locally. last four lines define cdmDatabaseSchema, tempEmulationSchema, cohortDatabaseSchema, cohortTable variables. ’ll use cdmDatabaseSchema later tell R data CDM format live. tempEmulationSchema needed Oracle users, since Oracle support temporary tables. cohortDatabaseSchema, cohortTable specify want instantiate cohorts. Note Microsoft SQL Server, database schemas need specify database schema, example cdmDatabaseSchema <- \"my_cdm_data.dbo\".","code":"library(CohortDiagnostics)  connectionDetails <- createConnectionDetails(   dbms = \"postgresql\",   server = \"localhost/ohdsi\",   user = \"joe\",   password = \"supersecret\" ) connectionDetails <- Eunomia::getEunomiaConnectionDetails()  cdmDatabaseSchema <- \"main\" tempEmulationSchema <- NULL cohortDatabaseSchema <- \"main\" cohortTable <- \"cohort\""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"loading-cohort-references-from-a-package","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Loading cohort references from a package","title":"Running Cohort Diagnostics","text":"prefered usage cohort diagnostics use study package. dedicated R package can installed system run. primary reason due reproducibility, cohort definitions resources frequently change. However, study package can seen snapshot, frozen time creation incrementally updated. example, cohort diagnostics package includes example set cohort sql json run Eunomia test data OMOP Common Data Model format. Looking data.frame Cohorts see sql json cohorts:","code":"library(CohortDiagnostics) cohortDefinitionSet <- CohortGenerator::getCohortDefinitionSet(   settingsFileName = \"Cohorts.csv\",   jsonFolder = \"cohorts\",   sqlFolder = \"sql/sql_server\",   packageName = \"CohortDiagnostics\" ) View(cohortDefinitionSet)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"loading-cohort-references-from-webapi","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Loading cohort references from WebApi","title":"Running Cohort Diagnostics","text":"often desirable perform cohort diagnostics definitions stored ATLAS instance. Though preferred way running studies (certainly preferred method OHDSI network study involving multiple sites) possible load references data frame used cohort diagnostics. following code demonstrates create set cohort references ATLAS can used cohort diagnostics: Consult ROhdsiWebApi documentation details authentication atlas instance. Please note order generate inclusion rules statistics (useful diagnostic tool) parameter generateStats set TRUE.","code":"# Set up url baseUrl <- \"https://atlas.hosting.com/WebAPI\" # list of cohort ids cohortIds <- c(18345, 18346)  cohortDefinitionSet <- ROhdsiWebApi::exportCohortDefinitionSet(   baseUrl = baseUrl,   cohortIds = cohortIds,   generateStats = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"generating-cohorts","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Generating cohorts","title":"Running Cohort Diagnostics","text":"Cohorts must generated cohort diagnostics can run.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"using-cohortgenerator-to-instantiate-cohorts","dir":"Articles","previous_headings":"Running cohort diagnostics > Generating cohorts","what":"Using CohortGenerator to instantiate cohorts","title":"Running Cohort Diagnostics","text":"example, Note, code delete existing table. However, incremental mode can used setting parameter incremental = TRUE. resulting cohort table include columns: cohort_definition_id, subject_id, cohort_start_date, cohort_end_date","code":"cohortTableNames <- CohortGenerator::getCohortTableNames(cohortTable = cohortTable)  # Next create the tables on the database CohortGenerator::createCohortTables(   connectionDetails = connectionDetails,   cohortTableNames = cohortTableNames,   cohortDatabaseSchema = \"main\",   incremental = FALSE )  # Generate the cohort set CohortGenerator::generateCohortSet(   connectionDetails = connectionDetails,   cdmDatabaseSchema = cdmDatabaseSchema,   cohortDatabaseSchema = cohortDatabaseSchema,   cohortTableNames = cohortTableNames,   cohortDefinitionSet = cohortDefinitionSet,   incremental = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"executing-cohort-diagnostics","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Executing cohort diagnostics","title":"Running Cohort Diagnostics","text":"cohort definitions loaded cohort tables populated cohort diagnostics ready executed. First set export folder, results stored. execute function (using default settings) follows:","code":"exportFolder <- \"export\" executeDiagnostics(cohortDefinitionSet,   connectionDetails = connectionDetails,   cohortTable = cohortTable,   cohortDatabaseSchema = cohortDatabaseSchema,   cdmDatabaseSchema = cdmDatabaseSchema,   exportFolder = exportFolder,   databaseId = \"MyCdm\",   minCellCount = 5 )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"cohort-statistics-table-clean-up","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Cohort Statistics Table Clean up","title":"Running Cohort Diagnostics","text":"cohort generation process create number residual tables. process complete, longer required can removed.","code":"CohortGenerator::dropCohortStatsTables(   connectionDetails = connectionDetails,   cohortDatabaseSchema = cohortDatabaseSchema,   cohortTableNames = cohortTableNames )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"cohort-diagnostics-output","dir":"Articles","previous_headings":"","what":"Cohort Diagnostics Output","title":"Running Cohort Diagnostics","text":"diagnostics completed, zip file created specified export folder. zip file can shared sites, contain patient-identifiable information. unzipped, zip file contain several .csv files maybe easily audited. Note cell counts smaller 5 removed, specified using minCellCount argument, ensure non-identifiability.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"creating-an-sqlite-db-file","dir":"Articles","previous_headings":"Cohort Diagnostics Output","what":"Creating an sqlite db file","title":"Running Cohort Diagnostics","text":"Assuming completed steps described one databases, now set zip files, one per database. Make sure place zip files single folder. Optionally, can pre-merge zip files sqlite database can view results Shiny app: file can used shiny app explore results. See vignette “Viewing results using Diagnostics Explorer” details.","code":"createMergedResultsFile(exportFolder)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"viewing-the-diagnostics","dir":"Articles","previous_headings":"","what":"Viewing the diagnostics","title":"Viewing results using Diagnostics Explorer","text":"Diagnostics Explorer shiny application able present results output Cohort Diagnostics either local mode (.e. using premerged file) database mode (connected postgres database server). Shiny app can found . Make sure copy files DiagnosticsExplorer folder. launching application. maybe asked install additional packages required app, shiny, shinydashboard, shinyWidgets, DT, htmltools, scales, plotly, dplyr, purrr, tidyr, ggiraph. Note tabs left information icon. Clicking icons show additional information diagnostic, computed, may interpreted.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"launching-diagnostics-explorer","dir":"Articles","previous_headings":"","what":"Launching Diagnostics Explorer","title":"Viewing results using Diagnostics Explorer","text":"R, launch DiagnosticExplorer shiny application calling ‘launchDiagnosticsExplorer()’ function CohortDiagnostics. R-studio, may start project clicking ‘DiagnosticsExplorer.Rproj’ shiny folder, open global.R press ‘RunApp’ button. R-server (shiny server), need copy files DiagnosticsExplorer shiny app folder server. server automatically launch application (please talk shiny server administrator site specific rules.)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-the-app-using-local-file-mode-sqlite-db-","dir":"Articles","previous_headings":"","what":"Running the app using local file mode (Sqlite db).","title":"Viewing results using Diagnostics Explorer","text":"Local mode common mode run Shiny application. recommend convert csv files precomputed output Cohort Diagnostics sqlite database file follows .RData files enables faster load Shiny application. converted results data sqlite database file, may launch Diagnostics Explorer app follows: running application R-studio environment, please make sure sqlite file folder called ‘data’.","code":"createMergedResultsFile(\"C:/temp/allZipFiles\", sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\") launchDiagnosticsExplorer(sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"publishing-to-posit-connect-or-shinyapps-io","dir":"Articles","previous_headings":"","what":"Publishing to Posit Connect or shinyapps.io","title":"Viewing results using Diagnostics Explorer","text":"Publishing shiny app shared posit connect source can achieved first setting credentials server. need contact internal administrator publishing access rights. Alternatively, can use shinyapps.io service, provides limited free usage hosting applications. Firstly, advised update latest version OHDSI shiny modules : update dependencies shiny app. Following need copyable resource shiny app. can achieved launching DiagnosticsExplorer publishable options create shiny app folder \"MyStudyDiagnosticsExplorer\" R working directory. also overwrite existing application folder copy sqlite file . Following , shiny window load show “publsh” button. can follow RStudio prompts upload rsconnect/posit connect shinyapps.io server.","code":"remotes::install_packages('OHDSI/OhdsiShinyModules') launchDiagnosticsExplorer(   sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\",   makePublishable = TRUE,   publishDir = file.path(getwd(), \"MyStudyDiagnosticsExplorer\"),   overwritePublishDir = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"sharing-a-zipped-copy-of-your-shiny-app","dir":"Articles","previous_headings":"","what":"Sharing a zipped copy of your shiny app","title":"Viewing results using Diagnostics Explorer","text":"automatically create zip archive containing DiagnosticsExplorer shiny application deployment shared environments, data.ohdsi.org, run function createDiagnosticsExplorerZip: archive contain fully executable shiny application.","code":"createDiagnosticsExplorerZip(outputZipfile = \"MyCdProject.zip\", sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-the-app-using-database-mode","dir":"Articles","previous_headings":"","what":"Running the app using Database mode","title":"Viewing results using Diagnostics Explorer","text":"recommend use database system, file size cohort diagnostics output becomes large e.g. > 100mb, using sqlite database may leading sluggish performance. Currently, postgres server fully supported, though platforms DatabaseConnector support may work (currently experimental). See Vignette Database mode load data remote database.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-over-the-network","dir":"Articles","previous_headings":"","what":"Running over the network","title":"Viewing results using Diagnostics Explorer","text":"want run application network set runOverNetwork = TRUE launching application using ‘launchDiagnosticsExplorer()’. make shiny application available network (.e. within networks firewall).","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/WhatIsCohortDiagnostics.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"What is Cohort Diagnostics?","text":"CohortDiagnostics package allows one generate wide set diagnostics evaluate cohort definitions database Common Data Model (CDM). diagnostics include incidence rates (optionally stratified age, gender, calendar year), cohort characteristics (comorbidities, drug use, etc.), codes found data triggering various rules cohort definitions. CohortDiagnostics package general works two steps: Generate diagnostics database CDM. Explore generated diagnostics Shiny app included CohortDiagnostics package. use Cohort Diagnostics recommended best practice help improve confidence cohort definitions.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/WhatIsCohortDiagnostics.html","id":"features","dir":"Articles","previous_headings":"","what":"Features","title":"What is Cohort Diagnostics?","text":"Show cohort inclusion rule attrition. List source codes used running cohort definition specific database. Find orphan codes, (source) codes , included particular concept set. Compute cohort incidence across calendar years, age, gender. Break index events specific concepts triggered . Compute overlap two cohorts. Characterize cohorts, compare characterizations. Perform cohort comparison temporal comparisons. Explore patient profiles random sample subjects cohort.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Jamie Gilbert. Author, maintainer. Gowtham Rao. Author. Martijn Schuemie. Author. Patrick Ryan. Author. James Weaver. Author. Observational Health Data Science Informatics. Copyright holder.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Gilbert J, Rao G, Schuemie M, Ryan P, Weaver J (2024). CohortDiagnostics: Diagnostics OHDSI Cohorts. R package version 3.3.0, https://github.com/OHDSI/CohortDiagnostics, https://ohdsi.github.io/CohortDiagnostics.","code":"@Manual{,   title = {CohortDiagnostics: Diagnostics for OHDSI Cohorts},   author = {Jamie Gilbert and Gowtham Rao and Martijn Schuemie and Patrick Ryan and James Weaver},   year = {2024},   note = {R package version 3.3.0, https://github.com/OHDSI/CohortDiagnostics},   url = {https://ohdsi.github.io/CohortDiagnostics}, }"},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"cohortdiagnostics","dir":"","previous_headings":"","what":"Diagnostics for OHDSI Cohorts","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics part HADES.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics R utility package development evaluation phenotype algorithms OMOP CDM compliant data sets. package provides standard, end end, set analytics understanding patient capture including data generation result exploration R Shiny interface. Analytics computed include cohort characteristics, record counts, index event misclassification, captured observation windows basic incidence proportions age, gender calendar year. identification errors, CohortDiagnostics enables comparison multiple candidate cohort definitions across one data sources, facilitating reproducible research.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"features","dir":"","previous_headings":"","what":"Features","title":"Diagnostics for OHDSI Cohorts","text":"Show cohort inclusion rule attrition. List source codes used running cohort definition specific database. Find orphan codes, (source) codes , included particular concept set. Compute cohort incidence across calendar years, age, gender. Break index events specific concepts triggered . Compute overlap two cohorts. Characterize cohorts, compare characterizations. Perform cohort comparison temporal comparisons. Explore patient profiles random sample subjects cohort.","code":""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"technology","dir":"","previous_headings":"","what":"Technology","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics package R package.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"system-requirements","dir":"","previous_headings":"","what":"System Requirements","title":"Diagnostics for OHDSI Cohorts","text":"Requires R. packages used CohortDiagnostics require Java.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Diagnostics for OHDSI Cohorts","text":"See instructions configuring R environment, including Java. R, use following commands download install CohortDiagnostics:","code":"remotes::install_github(\"OHDSI/CohortDiagnostics\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"user-documentation","dir":"","previous_headings":"","what":"User Documentation","title":"Diagnostics for OHDSI Cohorts","text":"Documentation can found package website. PDF versions documentation also available: Package manual: CohortDiagnostics manual Vignette: Cohort Diagnostics Vignette: Running Cohort Diagnostics Vignette: Viewing Results Using Diagnostics Explorer","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"support","dir":"","previous_headings":"","what":"Support","title":"Diagnostics for OHDSI Cohorts","text":"Developer questions/comments/feedback: OHDSI Forum use GitHub issue tracker bugs/issues/enhancements","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Diagnostics for OHDSI Cohorts","text":"Read can contribute package.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"license","dir":"","previous_headings":"","what":"License","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics licensed Apache License 2.0","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"development","dir":"","previous_headings":"","what":"Development","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics developed R Studio.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"development-status","dir":"","previous_headings":"","what":"Development status","title":"Diagnostics for OHDSI Cohorts","text":"Stable","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/CohortDiagnostics-package.html","id":null,"dir":"Reference","previous_headings":"","what":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","title":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","text":"CohortDiagnostics R utility package development evaluation phenotype algorithms OMOP CDM compliant data sets. package provides standard, end end, set analytics understanding patient capture including data generation result exploration R Shiny interface. Analytics computed include cohort characteristics, record counts, index event misclassification, captured observation windows basic incidence proportions age, gender calendar year. identification errors, CohortDiagnostics enables comparison multiple candidate cohort definitions across one data sources, facilitating reproducible research.","code":""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/CohortDiagnostics-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","text":"Maintainer: Jamie Gilbert gilbert@ohdsi.org Authors: Gowtham Rao Martijn Schuemie Patrick Ryan James Weaver contributors: Observational Health Data Science Informatics [copyright holder]","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":null,"dir":"Reference","previous_headings":"","what":"Check character encoding of input file — checkInputFileEncoding","title":"Check character encoding of input file — checkInputFileEncoding","text":"input files, CohortDiagnostics accepts UTF-8 ASCII character encoding. function can used check whether file meets criteria.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check character encoding of input file — checkInputFileEncoding","text":"","code":"checkInputFileEncoding(fileName)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check character encoding of input file — checkInputFileEncoding","text":"fileName path file check","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check character encoding of input file — checkInputFileEncoding","text":"Throws error input file correct encoding.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":null,"dir":"Reference","previous_headings":"","what":"Create publishable shiny zip — createDiagnosticsExplorerZip","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"utility designed creating published zip shiny app sqlite database. Designed sharing projects servers like data.ohdsi.org. Takes shiny code R project adds sqlite file zip archive. Uncompressed cohort diagnostics sqlite databases can become large quickly.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"","code":"createDiagnosticsExplorerZip(   outputZipfile = file.path(getwd(), \"DiagnosticsExplorer.zip\"),   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   shinyDirectory = system.file(file.path(\"shiny\", \"DiagnosticsExplorer\"), package =     \"CohortDiagnostics\"),   overwrite = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"outputZipfile output path zip file sqliteDbPath Merged Cohort Diagnostics sqlitedb created createMergedResultsFile shinyDirectory (optional) Path location shiny code stored. default, package root overwrite zip file already exists, overwrite ?","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"function combines diagnostics results one databases single file. result sqlite database can used input Diagnostics Explorer Shiny app. also checks whether results conform results data model specifications.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"","code":"createMergedResultsFile(   dataFolder,   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   overwrite = FALSE,   tablePrefix = \"\" )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"dataFolder folder exported zip files diagnostics stored. Use executeDiagnostics function generate zip files. Zip files containing results multiple databases may placed folder. sqliteDbPath Output path sqlite database placed overwrite (Optional) overwrite existing sqlite lite db exists. tablePrefix (Optional) string insert table names (e.g. \"cd_\") database table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":null,"dir":"Reference","previous_headings":"","what":"Create the results data model tables on a database server. — createResultsDataModel","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"Create results data model tables database server.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"","code":"createResultsDataModel(   connectionDetails = NULL,   databaseSchema,   tablePrefix = \"\" )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"connectionDetails DatabaseConnector connectionDetails instance @seealso[DatabaseConnector::createConnectionDetails] databaseSchema schema postgres server tables created. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"PostgreSQL servers supported.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":null,"dir":"Reference","previous_headings":"","what":"Rsconnect deploy — deployPositConnectApp","title":"Rsconnect deploy — deployPositConnectApp","text":"Deploy application posit connect platform shinyapps.io server","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rsconnect deploy — deployPositConnectApp","text":"","code":"deployPositConnectApp(   appName,   appDir = tempfile(),   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   shinyDirectory = system.file(file.path(\"shiny\", \"DiagnosticsExplorer\"), package =     \"CohortDiagnostics\"),   connectionDetails = NULL,   shinyConfigPath = NULL,   resultsDatabaseSchema = NULL,   vocabularyDatabaseSchemas = resultsDatabaseSchema,   tablePrefix = \"\",   cohortTableName = \"cohort\",   databaseTableName = \"database\",   port = 80,   useRenvironFile = FALSE,   ... )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rsconnect deploy — deployPositConnectApp","text":"appName string name call app - unique posit connect server appDir optional - directory use copy files deployment. use consistent dir internal options can change. sqliteDbPath Path merged sqlite file. See createMergedResultsFile create file. shinyDirectory (optional) Directyory shiny app code lives. Use wish modify explorer connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package, specifying connect server CohortDiagnostics results uploaded using uploadResults function. shinyConfigPath Path shiny yml configuration file (use instead sqliteDbPath connectionDetails object) resultsDatabaseSchema schema database server CohortDiagnostics results uploaded. vocabularyDatabaseSchemas (optional) list one schemas database server vocabulary tables located. default value value resultsDatabaseSchema. can provide list vocabulary schema might represent different versions OMOP vocabulary tables. allows us compare impact vocabulary changes Diagnostics. supported sqlite database. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names cohortTableName (Optional) cohort table name differs standard - cohort (ignores prefix set) databaseTableName (Optional) database table name differs standard - database (ignores prefix set) port (optional) used runOverNetwork = TRUE. useRenvironFile logical - recommended, store db credentials .Renviron file ... parameters passed rsconnect::deployApp","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute cohort diagnostics — executeDiagnostics","title":"Execute cohort diagnostics — executeDiagnostics","text":"Runs cohort diagnostics (subset ) cohorts instantiated using Assumes cohorts already instantiated. CohortGenerator package Characterization: runTemporalCohortCharacterization argument TRUE, following default covariateSettings object created using RFeatureExtraction::createTemporalCovariateSettings Alternatively, covariate setting object may created using example.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute cohort diagnostics — executeDiagnostics","text":"","code":"executeDiagnostics(   cohortDefinitionSet,   exportFolder,   databaseId,   cohortDatabaseSchema,   databaseName = NULL,   databaseDescription = NULL,   connectionDetails = NULL,   connection = NULL,   cdmDatabaseSchema,   tempEmulationSchema = getOption(\"sqlRenderTempEmulationSchema\"),   cohortTable = \"cohort\",   cohortTableNames = CohortGenerator::getCohortTableNames(cohortTable = cohortTable),   vocabularyDatabaseSchema = cdmDatabaseSchema,   cohortIds = NULL,   cdmVersion = 5,   runInclusionStatistics = TRUE,   runIncludedSourceConcepts = TRUE,   runOrphanConcepts = TRUE,   runTimeSeries = FALSE,   runVisitContext = TRUE,   runBreakdownIndexEvents = TRUE,   runIncidenceRate = TRUE,   runCohortRelationship = TRUE,   runTemporalCohortCharacterization = TRUE,   temporalCovariateSettings = getDefaultCovariateSettings(),   minCellCount = 5,   minCharacterizationMean = 0.01,   irWashoutPeriod = 0,   incremental = FALSE,   incrementalFolder = file.path(exportFolder, \"incremental\"),   runFeatureExtractionOnSample = FALSE,   sampleN = 1000,   seed = 64374,   seedArgs = NULL )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute cohort diagnostics — executeDiagnostics","text":"cohortDefinitionSet Data.frame cohorts must include columns cohortId, cohortName, json, sql exportFolder folder output exported . folder exist created. databaseId short string identifying database (e.g. 'Synpuf'). cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. databaseName full name database. NULL, defaults value cdm_source table databaseDescription short description (several sentences) database. NULL, defaults value cdm_source table connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cohortTable Name cohort table. cohortTableNames Cohort Table names used CohortGenerator package vocabularyDatabaseSchema Schema name OMOP vocabulary data resides. commonly cdmDatabaseSchema. Note SQL Server, include database schema name, example 'vocabulary.dbo'. cohortIds Optionally, provide subset cohort IDs restrict diagnostics . cdmVersion version OMOP CDM. Default 5. (Note: 5 supported.) runInclusionStatistics Generate export statistic cohort inclusion rules? runIncludedSourceConcepts Generate export source concepts included cohorts? runOrphanConcepts Generate export potential orphan concepts? runTimeSeries Generate export time series diagnostics? runVisitContext Generate export index-date visit context? runBreakdownIndexEvents Generate export breakdown index events? runIncidenceRate Generate export cohort incidence  rates? runCohortRelationship Generate export cohort relationship? Cohort relationship checks temporal relationship two cohorts. runTemporalCohortCharacterization Generate export temporal cohort characterization? records values greater 0.001 returned. temporalCovariateSettings Either object type covariateSettings created using one createTemporalCovariateSettings function FeatureExtraction package, list objects. minCellCount minimum cell count fields contains person counts fractions. minCharacterizationMean minimum mean value characterization output. Values cut output. help reduce file size characterization output, remove information covariates low values. default 0.001 (.e. 0.1 percent) irWashoutPeriod Number days washout include calculation incidence rates - default 0 incremental Create cohort diagnostics created ? incrementalFolder incremental = TRUE, specify folder records kept cohort diagnostics executed. runFeatureExtractionOnSample Logical. TRUE, function operate sample data. Default FALSE, meaning function operate full data set. sampleN Integer. number records include sample runFeatureExtractionOnSample TRUE. Default 1000. Ignored runFeatureExtractionOnSample FALSE. seed Integer. seed random number generator used create sample. ensures sample can drawn future runs. Default 64374. seedArgs List. Additional arguments pass sampling function. can used control aspects sampling process beyond seed sample size.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Execute cohort diagnostics — executeDiagnostics","text":"cohortSetReference argument must data frame least following columns.fields exported cohort table part Cohort Diagnostics results data model. additional fields found stored JSON object metadata field cohort table: cohortId cohort Id id used identify  cohort definition. required unique. used create file names. cohortName full name cohort. shown Shiny app. json JSON cohort definition cohort. sql SQL cohort definition rendered cohort json.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Execute cohort diagnostics — executeDiagnostics","text":"","code":"if (FALSE) { # \\dontrun{ # Load cohorts (assumes that they have already been instantiated) cohortTableNames <- CohortGenerator::getCohortTableNames(cohortTable = \"cohort\") cohorts <- CohortGenerator::getCohortDefinitionSet(packageName = \"MyGreatPackage\") connectionDetails <- createConnectionDetails(   dbms = \"postgresql\",   server = \"ohdsi.com\",   port = 5432,   user = \"me\",   password = \"secure\" )  executeDiagnostics(   cohorts = cohorts,   exportFolder = \"export\",   cohortTableNames = cohortTableNames,   cohortDatabaseSchema = \"results\",   cdmDatabaseSchema = \"cdm\",   databaseId = \"mySpecialCdm\",   connectionDetails = connectionDetails )  # Use a custom set of cohorts defined in a data.frame cohorts <- data.frame(   cohortId = c(100),   cohortName = c(\"Cohort Name\"),   logicDescription = c(\"My Cohort\"),   sql = c(readLines(\"path_to.sql\")),   json = c(readLines(\"path_to.json\")) ) executeDiagnostics(   cohorts = cohorts,   exportFolder = \"export\",   cohortTable = \"cohort\",   cohortDatabaseSchema = \"results\",   cdmDatabaseSchema = \"cdm\",   databaseId = \"mySpecialCdm\",   connectionDetails = connectionDetails ) } # }"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns information from CDM source table. — getCdmDataSourceInformation","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"Returns CDM source name, description, release date, CDM release date, version vocabulary version, available.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"","code":"getCdmDataSourceInformation(   connectionDetails = NULL,   connection = NULL,   cdmDatabaseSchema )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"Returns data frame CDM Data source.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":null,"dir":"Reference","previous_headings":"","what":"Count the cohort(s) — getCohortCounts","title":"Count the cohort(s) — getCohortCounts","text":"Computes subject entry count per cohort","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count the cohort(s) — getCohortCounts","text":"","code":"getCohortCounts(   connectionDetails = NULL,   connection = NULL,   cohortDatabaseSchema,   cohortTable = \"cohort\",   cohortIds = c() )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count the cohort(s) — getCohortCounts","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. cohortTable Name cohort table. cohortIds cohort Id(s) used reference cohort cohort table. left empty, cohorts table included.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count the cohort(s) — getCohortCounts","text":"tibble cohort counts","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":null,"dir":"Reference","previous_headings":"","what":"Get database migrations instance — getDataMigrator","title":"Get database migrations instance — getDataMigrator","text":"Returns ResultModelManager DataMigrationsManager instance.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get database migrations instance — getDataMigrator","text":"","code":"getDataMigrator(connectionDetails, databaseSchema, tablePrefix = \"\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get database migrations instance — getDataMigrator","text":"connectionDetails DatabaseConnector connection details object databaseSchema String schema database schema lives tablePrefix (Optional) Use table prefix used table names (e.g. \"cd_\")","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get database migrations instance — getDataMigrator","text":"Instance ResultModelManager::DataMigrationManager interface converting existing data models","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultCovariateSettings.html","id":null,"dir":"Reference","previous_headings":"","what":"Get default covariate settings — getDefaultCovariateSettings","title":"Get default covariate settings — getDefaultCovariateSettings","text":"Default covariate settings cohort diagnostics execution","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultCovariateSettings.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get default covariate settings — getDefaultCovariateSettings","text":"","code":"getDefaultCovariateSettings()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"Get list vocabulary table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"","code":"getDefaultVocabularyTableNames()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"Get list vocabulary table names results data model","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":null,"dir":"Reference","previous_headings":"","what":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"Get specifications Cohort Diagnostics results data model","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"","code":"getResultsDataModelSpecifications()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"tibble data frame object specifications","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":null,"dir":"Reference","previous_headings":"","what":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"Launch Diagnostics Explorer Shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"","code":"launchDiagnosticsExplorer(   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   connectionDetails = NULL,   shinyConfigPath = NULL,   resultsDatabaseSchema = NULL,   vocabularyDatabaseSchema = NULL,   vocabularyDatabaseSchemas = resultsDatabaseSchema,   tablePrefix = \"\",   cohortTableName = \"cohort\",   databaseTableName = \"database\",   aboutText = NULL,   runOverNetwork = FALSE,   port = 80,   makePublishable = FALSE,   publishDir = file.path(getwd(), \"DiagnosticsExplorer\"),   overwritePublishDir = FALSE,   launch.browser = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"sqliteDbPath Path merged sqlite file. See createMergedResultsFile create file. connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package, specifying connect server CohortDiagnostics results uploaded using uploadResults function. shinyConfigPath Path shiny yml configuration file (use instead sqliteDbPath connectionDetails object) resultsDatabaseSchema schema database server CohortDiagnostics results uploaded. vocabularyDatabaseSchema (Deprecated) Please use vocabularyDatabaseSchemas. vocabularyDatabaseSchemas (optional) list one schemas database server vocabulary tables located. default value value resultsDatabaseSchema. can provide list vocabulary schema might represent different versions OMOP vocabulary tables. allows us compare impact vocabulary changes Diagnostics. supported sqlite database. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names cohortTableName (Optional) cohort table name differs standard - cohort (ignores prefix set) databaseTableName (Optional) database table name differs standard - database (ignores prefix set) aboutText Text (using HTML markup) displayed tab Shiny app. provided, tab shown. runOverNetwork (optional) want app run network? port (optional) used runOverNetwork = TRUE. makePublishable (Optional) copy data files make app publishable posit connect/shinyapp.io publishDir make publishable true - directory shiny app copied overwritePublishDir (Optional) make publishable true - overwrite directory publishing launch.browser app launched default browser, Shiny window. Note: copying clipboard work Shiny window.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"Launches Shiny app allows user explore diagnostics","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":null,"dir":"Reference","previous_headings":"","what":"Migrate Data model — migrateDataModel","title":"Migrate Data model — migrateDataModel","text":"Migrate data current state next state strongly advised backup data (either sqlite files, backup database (case using postgres backend) kept csv/zip files data generation.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Migrate Data model — migrateDataModel","text":"","code":"migrateDataModel(connectionDetails, databaseSchema, tablePrefix = \"\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Migrate Data model — migrateDataModel","text":"connectionDetails DatabaseConnector connection details object databaseSchema String schema database schema lives tablePrefix (Optional) Use table prefix used table names (e.g. \"cd_\")","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"Given set cohorts, get temporal relationships cohort_start_date cohorts.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"","code":"runCohortRelationshipDiagnostics(   connectionDetails = NULL,   connection = NULL,   cohortDatabaseSchema = NULL,   tempEmulationSchema = NULL,   cohortTable = \"cohort\",   targetCohortIds,   comparatorCohortIds,   relationshipDays )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cohortTable Name cohort table. targetCohortIds vector one Cohort Ids use target cohorts. comparatorCohortIds vector one Cohort Ids use feature/comparator cohorts. relationshipDays dataframe two columns startDay endDay representing periods time compute relationship","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"function first generates calendar period table, calendar intervals timeSeriesMinDate timeSeriesMaxDate. Calendar Month, Quarter year supported. calendar interval, time series data computed. returned object R dataframe need converted time series object perform time series analysis. Data Source time series: computes time series data source level .e. observation period table. output limited individuals cohort table people datasource (.e. present observation period table)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"","code":"runCohortTimeSeriesDiagnostics(   connectionDetails = NULL,   connection = NULL,   tempEmulationSchema = NULL,   cdmDatabaseSchema,   cohortDatabaseSchema = cdmDatabaseSchema,   cohortTable = \"cohort\",   runCohortTimeSeries = TRUE,   runDataSourceTimeSeries = FALSE,   timeSeriesMinDate = as.Date(\"1980-01-01\"),   timeSeriesMaxDate = as.Date(Sys.Date()),   stratifyByGender = TRUE,   stratifyByAgeGroup = TRUE,   cohortIds = NULL )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. cohortTable Name cohort table. runCohortTimeSeries Generate export cohort level time series? runDataSourceTimeSeries Generate export Data source level time series? .e. using persons found observation period table. timeSeriesMinDate (optional) Minimum date time series. Default value January 1st 1980. timeSeriesMaxDate (optional) Maximum date time series. Default value System date. stratifyByGender want stratify Gender stratifyByAgeGroup want stratify Age group cohortIds vector one Cohort Ids compute time distribution .","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":null,"dir":"Reference","previous_headings":"","what":"Upload results to the database server. — uploadResults","title":"Upload results to the database server. — uploadResults","text":"Requires results data model tables created using createResultsDataModel function. Set POSTGRES_PATH environmental variable path folder containing psql executable enable bulk upload (recommended).","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Upload results to the database server. — uploadResults","text":"","code":"uploadResults(   connectionDetails,   schema,   zipFileName,   forceOverWriteOfSpecifications = FALSE,   purgeSiteDataBeforeUploading = TRUE,   tempFolder = tempdir(),   tablePrefix = \"\",   ... )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Upload results to the database server. — uploadResults","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. schema schema postgres server tables created. zipFileName name zip file. forceOverWriteOfSpecifications TRUE, specifications phenotypes, cohort definitions, analysis overwritten already exist database. use specifications changed since last upload. purgeSiteDataBeforeUploading TRUE, inserting data specific databaseId data site dropped. assumes input zip file contains full data data site. tempFolder folder local file system zip files extracted . cleaned function finished. Can used specify temp folder drive sufficient space default system temp space limited. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names ... See ResultModelManager::uploadResults","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-330","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.3.0","title":"CohortDiagnostics 3.3.0","text":"Changes: Added function make deployment posit connect servers easier Added ability use CohortGenerator sample functionality executeDiagnostics speeds execution large cohort definitions Requires use FeatureExtraction 3.4.0 support new API Removed annotation tables result schema script","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-325","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.5","title":"CohortDiagnostics 3.2.5","text":"Bug Fixes: fixed broken migrations using “ADD COLUMN” Fixed broken links manaual Fixed issue Andromeda calls characterization R 4.3.x Fix Vroom issue mac","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-324","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.4","title":"CohortDiagnostics 3.2.4","text":"Bug Fix: Added support newer API OhdsiShinyModules (maintaining support old version) Resolved issue incidence rates sometimes exporting null/infinite setting 0 error cases","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-323","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.3","title":"CohortDiagnostics 3.2.3","text":"Resolved issue concept sets exported diagnostics executed. concept sets now always exported results csv imported databases","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-322","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.2","title":"CohortDiagnostics 3.2.2","text":"Fixes unit tests breaking R 4.3 due change Sys.time function","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-321","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.1","title":"CohortDiagnostics 3.2.1","text":"Added requirement Andromeda 0.6.0 (implicitly required DatabaseConnector) Fixed issue saving cohort subsets csv file viewing analysis shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-320","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.0","title":"CohortDiagnostics 3.2.0","text":"run orphan concepts checks subset cohorts Remove use lookback period IR calculations - now setting call package Added data migration support subsets database schema (allow future functionality take care ) Added functionality launchDiagnosticsExplorer make publishing poist connect/shinyapps.io straightforward (still requires removal ggiraph) Moved shiny code OHDSI/OhdsiShinyModules","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-312","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.2","title":"CohortDiagnostics 3.1.2","text":"Bug Fixes: Removed package dependency snapshot capture breaking newer versions R","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-311","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.1","title":"CohortDiagnostics 3.1.1","text":"Changes: Removed CohortExplorer app ’s now part new package. Added support custom FeatureExtraction features Bug Fixes: Fixed error checking cdm_source table Removal .data$ usage across package fix tidyselect warning","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-310","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.0","title":"CohortDiagnostics 3.1.0","text":"Changes: Major refactoring shiny app use modular code ease maintenance tests shiny modules inst/shiny/DiagnosticsExplorer/tests Added support table prefixes Diagnostics Explorer databases (e.g. cg_cohort_definition) Enabled annotation local instances DiagnosticsExplorer Added yaml configuration diagnostics explorer app, including docs usage Storage version number database results file allow future migrations Slight optimization cohort characterization queries diagnostics explorer Support database migrations adding migrateDataModel functionality. Versions data generated CohortDiagnostics 3.0.0 intended future compatible. .e. sqlite results file postgres database generated version 3.0.0 cohort diagnostics new shiny app functionality supported run migrateDataModel . Changed type dataType fieldName columnName align strategus modules Refactored export characterization results use common export Ensure tests cases always use continuous covariate Batch operations executing cohort relationship, time series, feature extraction based diagnostics. New parameter minCharacterizationMean. introduces cut output FeatureExtraction. absence parameter output atleast one row every covariateId datasource - low count useful diagnostics. Bug fixes: Fixed issue uploading results postgres db caused null values primary key field. Removed constraint fix issue. Fix index_event_breakdown duplicate entries concept observed domain multiple times Many issues resolved shiny codebase","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-303","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.3","title":"CohortDiagnostics 3.0.3","text":"Changes: Changed default batch size characterization feature extraction 100 5 causing performance issues redshift clusters. Allow setting batch size feature extraction options(\"CohortDiagnostics-FE-batch-size\" = batchSize)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-302","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.2","title":"CohortDiagnostics 3.0.2","text":"Bug fixes: Fixed issue writing csvs caused update SqlRender camelCaseToSnakeCase function check caused execution crash parameters null. Fixed issue observation period overflowing sql integer BigQuery causing execution crash","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-301","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.1","title":"CohortDiagnostics 3.0.1","text":"Bug fixes: Updated old/incorrect documentation package usage Fixed bug new versions CohortGenerator v0.5.0 causing cohort definition sets package load Fixed bug shiny app multiple runs database cause app crash selecting database","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-300","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.0","title":"CohortDiagnostics 3.0.0","text":"Changes: Time series diagnostics removed Removed runCohortDiagnostics function - now completely replaced executeDiagnostics Removed loadCohortsFromPackage function now replaced CohortGenerator::getCohortDefinitionSet Removed instantiate cohort functionality, instantiateCohortSet now used CohortGenerator package Removed optional inclusionStatisticsFolder parameter, now exported directly CohortGenerator without need generate first. Removed usage Rdata files DiagnosticsExplorer shiny app function create preMergeDiagnosticsFiles Added function createMergedResultsFile outputs shiny app Added support SqlRender/DatabaseConnector compatible database (note, experimental. Postgres sqlite backends recommended use production environments) Improved metadata collection storage runs cohort diagnostics. Removed phenotype_id field data ddl Additional checks output cohort diagnostics ensure conforms results data model. new function (internal) makeDataExportable. Results data model csv file enhanced new fields, including field specify value subjected privacy protection (.e. min cell count, eg. person count). Note bug discovered orphan concepts included source concepts leading duplication row records primary key. bug fixed calculating max value grouped primary keys. fixed another commit. New optional diagnostics computes temporal relationship two cohorts. settings temporal relationship cohorts defaults temporalCovariateSettings. diagnostics integrated characterization output diagnostics explorer, cohorts covariates. New optional diagnostics called time series diagnostics. Time series diagnostics takes input calendar period range, calendar period range calendar units (year, quarter, month) computes approximate new occurrence (approximates incidence) observations (approximates prevalence) cohort start cohort end dates calendar period. Bug fixes: Added support users include non-standard columns CDM preventing crashes","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-224","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.4","title":"CohortDiagnostics 2.2.4","text":"Bug fixes: Fixed bug causing generation premerged upload files fail output fields results data model.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-223","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.3","title":"CohortDiagnostics 2.2.3","text":"Bug fixes: Replace use dplyr across() bug introduced tidyr v1.2.0","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-222","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.2","title":"CohortDiagnostics 2.2.2","text":"Bug fixes: Fixed syntax error causing empty description field inclusion rule stats","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-221","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.1","title":"CohortDiagnostics 2.2.1","text":"Bug fixes: Added new lines NEWS.md fix package site. Updated vignette fix minor issues Cohorts zero counts now stored results display shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-220","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.0","title":"CohortDiagnostics 2.2.0","text":"Changes: 1. Added executeDiagnostics function aims replace runCohortDiagnosticsas main interface package. Updated vignette “Running Cohort Diagnostics” give clearer instructions Removed vignettes usage longer required Improved testing across database platforms Moved particularly useful warnings logInfo Bug Fixes: 1. User code removed CohortExplorer fix issue #618 Fixed bug runBreakdownIndexEvents = TRUE failed drug_era table SQL error - Issue #695 Fixed error computing incidence rates BigQuery. Fixed error cdm_source table empty (warning remains). Fixed error instantiating cohorts BigQuery.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-214","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.4","title":"CohortDiagnostics 2.1.4","text":"Changes: Minor cosmetic changes diagnostics explorer shiny app. Typo fix Fix warning type-convert https://github.com/OHDSI/CohortDiagnostics/issues/661 Use Sex instead Gender Diagnostics Explorer https://github.com/OHDSI/CohortDiagnostics/issues/676 Bug Fixes: Privacy protecting feature bug fix. prior version covariate_value covariate_value_dist failed privacy protection. Thank @msuchard reporting issue @schuemie fixing https://github.com/OHDSI/CohortDiagnostics/issues/658","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-213","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.3","title":"CohortDiagnostics 2.1.3","text":"Changes: starting diagnostics explorer using launchDiagnosticsExplorer - checks added remotes CirceR https://github.com/OHDSI/CohortDiagnostics/issues/595 Bug Fixes: Diagnostics explorer - characterization plot show warning message one cohorts selected data. Added check issue.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-212","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.2","title":"CohortDiagnostics 2.1.2","text":"Bug fixes: DiagnosticsExplorer fixes bug app failure runIndexEventBreakdown, runOrphanConcepts, includedSourceConcept set FALSE","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-211","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.1","title":"CohortDiagnostics 2.1.1","text":"Bug fixes: DiagnosticsExplorer shiny app bug fixes: inclusion rule display. Handle situation cdm_source may one row record. warning + use max value vocabularyVersion. Switch runTimeSeries BigQuery SQL translation issue, addressed version 2.3. https://github.com/OHDSI/CohortDiagnostics/issues/503 Also runTimeSeries set FALSE default. Fixed bug DDL - temporal_covariate_value_dist https://github.com/OHDSI/CohortDiagnostics/issues/490 See issue https://github.com/OHDSI/CohortDiagnostics/issues/497","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-210","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.0","title":"CohortDiagnostics 2.1.0","text":"Changes: Diagnostics explorer Shiny app enhancements: Improved tool tip Various improvements plots consistent color, axis labels labels Visit context table addition Diagnostic explorer now distinct shiny application phenotype library. PhenotypeExplorer stand alone shiny app package PhenotypeLibrarian. Lot UX changes. Reactivity deferred drop menus. Changes improve app stability. Index event breakdown now subject count Index event breakdown calculates _source_concept_id source fields CDM tables. Vocabulary database schema now supported. Metadata (vocabulary version information data source) now collected. OracleTempSchema use deprecated favor tempEmulationSchema. Run external concept count removed, concept counts data available. Function ‘runCohortDiagnosticsUsingExternalCounts’ removed. Removed code related referentConceptId = phenotypeId/1000 always hold true. Create cohort table function now private. Please use instantiate cohort. checkInputFileEncoding exported public function (scope CohortDiagnostics). Updated results data model include new tables (resolved_concepts). Cohort Diagnostics results data model now compliant standard characterization output. Support cohort_censor_stats table webapi 2.8.1 #387 Add time series diagnostics computation. Output Diagnostics explorer version. improvements help usability stability. Informative messages help debugbing needed. phenotypeDescription longer supported input cohort diagnostics. Bug fixes: databaseName databaseDescription non NULL Fixed computation standard deviation standard difference mean binary covariates.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-200","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.0.0","title":"CohortDiagnostics 2.0.0","text":"Changes: Many improvements performance computing diagnostics. Now allows computation diagnostics many (>100) cohorts . Diagnostics Explorer Shiny app can now also run results data database. Added functions uploading diagnostics data database. becomes necessary dealing large data (e.g. 100 cohort definitions). Added ability group cohort definitions phenotypes, add descriptions phenotypes. Currently consequence grouping phenotype cohort overlap computed within phenotype. Grouping phenotypes done adding phenotypeId field cohortsToCreate file, adding phenotypeDescription file. See examplePhenotypeLibraryPackage repo example. cohort overlap plot now uses stacked bar charts instead Venn diagram allow showing multiple comparisons across multiple databases . cohort characteristics comparison plot now colors domain, allows filtering domain. Switching ‘plotly’ ‘ggiraph’ interactive plotting. Added Visit Context diagnostic. Bug fixes: Fixing numerous bugs introduced v1.2.x.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-126","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.6","title":"CohortDiagnostics 1.2.6","text":"Bug fixes: Additional bug fixes characterization/temporal characterization.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-125","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.5","title":"CohortDiagnostics 1.2.5","text":"Bug fixes: Additional bug fixes characterization/temporal characterization.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-124","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.4","title":"CohortDiagnostics 1.2.4","text":"Bug fixes: Added details log characterization/temporal characterization return results returns result threshold value. default filter results Characterization Temporal Characterization value less 0.001. leading empty results cohorts - causing errors.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-123","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.3","title":"CohortDiagnostics 1.2.3","text":"Bug fixes: Fixed error many concept sets instantiated. Removed ohdsi/SqlRender Remotes https://github.com/OHDSI/CohortDiagnostics/issues/189 Fixed Digit precision RJSONIO::toJson fromJSON https://github.com/OHDSI/CohortDiagnostics/issues/161 important fix. digit precision explicitly specified RJSONIO, scientific notation used. issue seems happen integer id (conceptId, conceptSetId, cohortId etc) >= 10,000,000 (rare). Please use update id’s > 10,000,000.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-122","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.2","title":"CohortDiagnostics 1.2.2","text":"New features: 1. Minor UI changes Diagnostics explorer. Added missing sort. Added better labels plots. Download plots. Bug fixes: 1. Changes dependency ROhdsiWebApi (>= 1.1.0) DiagnosticsExplorer display bug fixes","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-121","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.1","title":"CohortDiagnostics 1.2.1","text":"New features: 1. objects DiagnosticsExplorer sorted default #173 Multi select concepts #199 Bug fixes: 1. Ensure concept sets across cohort definitions unique #174 (changes dependency ROhdsiWebApi (>= 1.1.0))","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-120","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.0","title":"CohortDiagnostics 1.2.0","text":"Changes: 1. New function retrieve concept set json cohort json New function retrieve concept set sql cohort sql DiagnosticsExplorer shiny app - DataTable now rendered using server side processing. Bug fixes UI improvements. DiagnosticsExplorer shiny app - Phenotype library mode (released) DiagnosticsExplorer shiny app - Combine included source concepts orphan concepts one submenu https://github.com/OHDSI/CohortDiagnostics/issues/129 Bug fixes: 1. https://github.com/OHDSI/CohortDiagnostics/issues/167 https://github.com/OHDSI/CohortDiagnostics/issues/165","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-111","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.1.1","title":"CohortDiagnostics 1.1.1","text":"Changes: 1. Shiny app UI improvements Link Atlas Athena cohortId. Supports baseUrl. (beta - unreleased) support Phenotype library. Shiny app look two additional csv files phenotypeDescription cohortDescription put DiagnosticExplorer Phenotype Library Mode. Plan release future version >= 1.2 Changed default selections temporal characterization Added minimum threshold value covariate_value temporal_covariate_value default value = 0 (future release, plan make 0.005 .e. 0.5%) Bug fixes: Minor bug fixes.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-110","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.1.0","title":"CohortDiagnostics 1.1.0","text":"Changes: 1. Added temporal characterization UI changes Shiny app diagnostic explorer Bug fixes: 1. Circe-update introduced bug parsing concept sets cohort definition. Handling empty cohorts Changes: Error handling: Use checkmate R-package provide informative error messages. Refactor runCohortDiagnostics: added new function refactoring existing private functions. new function get JSON parameterized OHDSI SQL cohorts diagnostics requested Note: code partially refactored depend tidyverse.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-102","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.0.2","title":"CohortDiagnostics 1.0.2","text":"Changes: Adapting new ROhdsiWebApi (>= 1.0.0) interface. Added log info provides addition run time details #72 Bugfixes: Fixing broken getTimeDistributions function. Fixing broken instantiateCohort function.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-100","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.0.0","title":"CohortDiagnostics 1.0.0","text":"Changes: Added database information tab Diagnostics Explorer Shiny app. Using Andromeda instead ff store large data objects (used characterization). Bugfixes: Fixed error cohort definition concept sets. Fixed error index event breakdown entry event contained multiple criteria domain. Fixed error related tempEmulationSchema argument (needed Oracle BigQuery). Fixed use deprecated function, causing warnings causing older versions ParallelLogger error.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-012","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.2","title":"CohortDiagnostics 0.1.2","text":"Changes Adding option run cohort instantiation diagnostics incrementally, running tasks changed since last ru.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-011","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.1","title":"CohortDiagnostics 0.1.1","text":"Changes Orphan included concepts tables now show concept ID. Bugfixes: Fixed error orphan code SQL (hard-coded database schema). Fixed bug concept counts become big regular INT. Fixed counts standard concepts shown using external concept count table.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-010","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.0","title":"CohortDiagnostics 0.1.0","text":"Changes Orphan code check now resolves concept sets instead using verbatim concepts. include specificity. Added option use y-axis databases incidence rate plot. Added runCohortDiagnosticsUsingExternalCounts function. Added option use cohort definitions WebAPI instead stored study package. Bugfixes: Fixed bug causing weird false positives orphan codes (caused transforming concept IDs scientific notation). Better handling viewer analyses executed. Now also showing cohorts zero entries. Fixed error 1 cohort.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-001","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.0.1","title":"CohortDiagnostics 0.0.1","text":"Initial version","code":""}]
+[{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Creating a study package","text":"currently two approaches run Cohort Diagnostics. - Embed OHDSI study package, cohort definitions stored part study package, - WebAPi mode - cohort diagnostics dynamically pulls cohort definition webapi instance. WebAPI backend OHDSI ATLAS application, allowing programmatic access cohort definitions created ATLAS. vignette describes create self contained shareable study package can execute cohort diagnostics given set cohort definitions. recommended mode run CohortDiagnostics study. vignette, learn - use Cohort Diagnostics template package - Hydrate template package cohort definitions want diagnose. - Execute diagnostics one data sources. - Review result set using Diagnostics Explorer R shiny app Cohort Diagnostics - (optional) Submit results cohort diagnostics OHDSI Phenotype library.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"assumptions","dir":"Articles","previous_headings":"Introduction","what":"Assumptions:","title":"Creating a study package","text":"set valid cohort definition sql files (parameterized OHDSI Sql format) want run diagnostics , able export cohort definitions want diagnose Atlas using export tab within cohort definition module Atlas using ROhdsiWebApi described . access person level data OMOP CDM V5.x + format database, able execute instantiate cohorts cohort tables (.e. access schema database Create, Read, Update, Delete privileges.)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"creating-the-study-package","dir":"Articles","previous_headings":"","what":"Creating the study package","title":"Creating a study package","text":"cohorts diagnose two attributes . id: unique integer identifier cohort diagnosing. created cohort using atlas, atlas id. cohortName: unique string name cohort. Usually Atlas cohort name, can name wish identify cohort. name used display cohort Diagnostics Explorer shiny app. Example:","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/CreatingAStudyPackage.html","id":"option-a-using-hydra-and-rohdsiwebapi","dir":"Articles","previous_headings":"Creating the study package","what":"option A: Using Hydra and ROhdsiWebApi","title":"Creating a study package","text":"Note: option required Hydra 0.3, writing document version Hydra develop branch. skeleton cohort diagnostics study package . skeleton package special package designed used Hydra. input Hydra study specifications file (json format). Example .","code":"# please ensure you have the latest version of Hydra. As of 08/13/2021 - CohortDiagnostics support for Hydra is still in develop branch. # please check hydra release notes and update hydra remotes::install_github(\"OHDSI/Hydra\", ref = \"develop\") outputFolder <- \"d:/temp/output\" # location where you study package will be created   ########## Please populate the information below ##################### version <- \"v0.1.0\" name <- \"Thrombosis With Thrombocytopenia Syndrome cohorts - an OHDSI network study\" packageName <- \"ThrombosisWithThrombocytopeniaSyndrome\" skeletonVersion <- \"v0.0.1\" createdBy <- \"rao@ohdsi.org\" createdDate <- Sys.Date() # default modifiedBy <- \"rao@ohdsi.org\" modifiedDate <- Sys.Date() skeletonType <- \"CohortDiagnosticsStudy\" organizationName <- \"OHDSI\" description <- \"Cohort diagnostics on Thrombosis With Thrombocytopenia Syndrome cohorts.\"   library(magrittr) # Set up baseUrl <- Sys.getenv(\"baseUrl\") # if you have security enabled, please authorize the use - example below # ROhdsiWebApi::authorizeWebApi(baseUrl, 'windows') cohortIds <- c(   22040,   22042,   22041,   22039,   22038,   22037,   22036,   22035,   22034,   22033,   22031,   22032,   22030,   22028,   22029 )    ################# end of user input ############## webApiCohorts <- ROhdsiWebApi::getCohortDefinitionsMetaData(baseUrl = baseUrl) studyCohorts <- webApiCohorts %>%   dplyr::filter(.data$id %in% cohortIds)  # compile them into a data table cohortDefinitionsArray <- list() for (i in (1:nrow(studyCohorts))) {   cohortDefinition <-     ROhdsiWebApi::getCohortDefinition(       cohortId = studyCohorts$id[[i]],       baseUrl = baseUrl     )   cohortDefinitionsArray[[i]] <- list(     id = studyCohorts$id[[i]],     createdDate = studyCohorts$createdDate[[i]],     modifiedDate = studyCohorts$createdDate[[i]],     logicDescription = studyCohorts$description[[i]],     name = stringr::str_trim(stringr::str_squish(cohortDefinition$name)),     expression = cohortDefinition$expression   ) }  tempFolder <- tempdir() unlink(x = tempFolder, recursive = TRUE, force = TRUE) dir.create(path = tempFolder, showWarnings = FALSE, recursive = TRUE)  specifications <- list(   id = 1,   version = version,   name = name,   packageName = packageName,   skeletonVersion = skeletonVersion,   createdBy = createdBy,   createdDate = createdDate,   modifiedBy = modifiedBy,   modifiedDate = modifiedDate,   skeletonType = skeletonType,   organizationName = organizationName,   description = description,   cohortDefinitions = cohortDefinitionsArray )  jsonFileName <- paste0(file.path(tempFolder, \"CohortDiagnosticsSpecs.json\")) write(x = specifications %>% RJSONIO::toJSON(pretty = TRUE, digits = 23), file = jsonFileName)   ############################################################## ############################################################## #######       Get skeleton from github            ############ #######       Uncomment if you want to use latest ############ #######       skeleton only - for advanced user   ############ ############################################################## ############################################################## ############################################################## #### get the skeleton from github # download.file(url = \"https://github.com/OHDSI/SkeletonCohortDiagnosticsStudy/archive/refs/heads/main.zip\", #                          destfile = file.path(tempFolder, 'skeleton.zip')) # unzip(zipfile =  file.path(tempFolder, 'skeleton.zip'), #       overwrite = TRUE, #       exdir = file.path(tempFolder, \"skeleton\") #         ) # fileList <- list.files(path = file.path(tempFolder, \"skeleton\"), full.names = TRUE, recursive = TRUE, all.files = TRUE) # DatabaseConnector::createZipFile(zipFile = file.path(tempFolder, 'skeleton.zip'), #                                  files = fileList, #                                  rootFolder = list.dirs(file.path(tempFolder, 'skeleton'), recursive = FALSE))  ############################################################## ############################################################## #######               Build package              ############# ############################################################## ############################################################## ##############################################################   #### Code that uses the ExampleCohortDiagnosticsSpecs in Hydra to build package hydraSpecificationFromFile <- Hydra::loadSpecifications(fileName = jsonFileName) unlink(x = outputFolder, recursive = TRUE) dir.create(path = outputFolder, showWarnings = FALSE, recursive = TRUE) Hydra::hydrate(   specifications = hydraSpecificationFromFile,   outputFolder = outputFolder )  # for advanced user using skeletons outside of Hydra # Hydra::hydrate(specifications = hydraSpecificationFromFile, #                outputFolder = outputFolder, #                skeletonFileName = file.path(tempFolder, 'skeleton.zip') # )   unlink(x = tempFolder, recursive = TRUE, force = TRUE)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/DatabaseModeInDiagnosticsExplorer.html","id":"database-mode","dir":"Articles","previous_headings":"","what":"Database mode","title":"Database mode in Diagnostics Explorer","text":"recommend use database system, file size cohort diagnostics output becomes large e.g. > 1GB, using premerged.RData may leading sluggish performance. Currently postgres server supported. use DatabaseConnector DbPool manage connections shiny application postgres. recommended method launch Shiny application provide connection details ‘launchDiagnosticsExplorer()’ shiny application. Please review documentation ‘DatabaseConnector::createConnectionDetails()’ function DatabaseConnector package connect server. example script upload data remote postgres server . ‘createResultsDataModel()’ function execute series SQL statements create empty target schema hold results Cohort Diagnostics. upload results, recommend use ‘uploadResults()’ function, provide path postgres driver. data uploaded postgres server - can execute shiny application using ‘launchDiagnosticsExplorer()’ function. Please provide connection details, along schema uploaded results (resultsDatabaseSchema). deploying server, yaml file called config.yml placed DiagnosticsExplorer path. See README.md file directory details configuration. Example yaml settings included :","code":"# Alter these configuration settings for usage with remote databases connectionDetails:   dbms: \"postgresql\"   server: \"my-database-server.com/myDatabaseName\"   user: \"postrgres\"   password: \"secret_password\"   port: 5432  # Store connection details as a json string in keyring # Store with keyring::key_set_with_value(\"KEYNAME\", jsonlite::toJSON(myConnectionDetails)) connectionDetailsSecureKey: ~  # If you used a table prefix to store the results (e.g. cd_) tablePrefix: \"\"  # Results schema being used resultsDatabaseSchema: \"cohort_diagnostics\"  # Vocabulary schemas. Should include the reuslts schema and optional custom vocabularies vocabularyDatabaseSchemas: [\"cohort_diagnostics\"]  # Custom table name for cohorts and cdm databases (probably not needed, ignores table prefix) cohortTableName: \"cohort\" databaseTableName: \"database\"  # If you wish to enable annotation - not currently reccomended in multi-user environments enableAnnotation: FALSE enableAuthorization: FALSE"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/DatabaseModeInDiagnosticsExplorer.html","id":"publishing","dir":"Articles","previous_headings":"","what":"Publishing","title":"Database mode in Diagnostics Explorer","text":"publish config can use: press publish button shiny app loads. Note - situation use secure keys keyring possible.","code":"launchDiagnosticsExplorer(   shinyConfigPath = \"path/to/config.yml\",   makePublishable = TRUE,   publishDir = file.path(getwd(), \"MyStudyDiagnosticsExplorer\"),   overwritePublishDir = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"Running Cohort Diagnostics","text":"vignette discusses process generating results set CohortDiagnostics starting cohort generation. Please see HADES library information background .","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"pre-requisites","dir":"Articles","previous_headings":"Introduction","what":"pre-requisites","title":"Running Cohort Diagnostics","text":"Ensure CohortDiagnostics installed system updated latest version. example also using Eunomia test package. Optionally, may install ROhdsiWebApi package download cohort definitions ATLAS instance:","code":"remotes::install_github(\"OHDSI/Eunomia\") remotes::install_github(\"OHDSI/ROhdsiWebApi\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"configuring-the-connection-to-the-server","dir":"Articles","previous_headings":"","what":"Configuring the connection to the server","title":"Running Cohort Diagnostics","text":"need tell R connect server data . CohortDiagnostics uses DatabaseConnector package, provides createConnectionDetails function. Type ?createConnectionDetails specific settings required various database management systems (DBMS). example, one might connect PostgreSQL database using code: purposes example, use Eunomia test CDM package Sqlite database stored locally. last four lines define cdmDatabaseSchema, tempEmulationSchema, cohortDatabaseSchema, cohortTable variables. ’ll use cdmDatabaseSchema later tell R data CDM format live. tempEmulationSchema needed Oracle users, since Oracle support temporary tables. cohortDatabaseSchema, cohortTable specify want instantiate cohorts. Note Microsoft SQL Server, database schemas need specify database schema, example cdmDatabaseSchema <- \"my_cdm_data.dbo\".","code":"library(CohortDiagnostics)  connectionDetails <- createConnectionDetails(   dbms = \"postgresql\",   server = \"localhost/ohdsi\",   user = \"joe\",   password = \"supersecret\" ) connectionDetails <- Eunomia::getEunomiaConnectionDetails()  cdmDatabaseSchema <- \"main\" tempEmulationSchema <- NULL cohortDatabaseSchema <- \"main\" cohortTable <- \"cohort\""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"loading-cohort-references-from-a-package","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Loading cohort references from a package","title":"Running Cohort Diagnostics","text":"prefered usage cohort diagnostics use study package. dedicated R package can installed system run. primary reason due reproducibility, cohort definitions resources frequently change. However, study package can seen snapshot, frozen time creation incrementally updated. example, cohort diagnostics package includes example set cohort sql json run Eunomia test data OMOP Common Data Model format. Looking data.frame Cohorts see sql json cohorts:","code":"library(CohortDiagnostics) cohortDefinitionSet <- CohortGenerator::getCohortDefinitionSet(   settingsFileName = \"Cohorts.csv\",   jsonFolder = \"cohorts\",   sqlFolder = \"sql/sql_server\",   packageName = \"CohortDiagnostics\" ) View(cohortDefinitionSet)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"loading-cohort-references-from-webapi","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Loading cohort references from WebApi","title":"Running Cohort Diagnostics","text":"often desirable perform cohort diagnostics definitions stored ATLAS instance. Though preferred way running studies (certainly preferred method OHDSI network study involving multiple sites) possible load references data frame used cohort diagnostics. following code demonstrates create set cohort references ATLAS can used cohort diagnostics: Consult ROhdsiWebApi documentation details authentication atlas instance. Please note order generate inclusion rules statistics (useful diagnostic tool) parameter generateStats set TRUE.","code":"# Set up url baseUrl <- \"https://atlas.hosting.com/WebAPI\" # list of cohort ids cohortIds <- c(18345, 18346)  cohortDefinitionSet <- ROhdsiWebApi::exportCohortDefinitionSet(   baseUrl = baseUrl,   cohortIds = cohortIds,   generateStats = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"generating-cohorts","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Generating cohorts","title":"Running Cohort Diagnostics","text":"Cohorts must generated cohort diagnostics can run.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"using-cohortgenerator-to-instantiate-cohorts","dir":"Articles","previous_headings":"Running cohort diagnostics > Generating cohorts","what":"Using CohortGenerator to instantiate cohorts","title":"Running Cohort Diagnostics","text":"example, Note, code delete existing table. However, incremental mode can used setting parameter incremental = TRUE. resulting cohort table include columns: cohort_definition_id, subject_id, cohort_start_date, cohort_end_date","code":"cohortTableNames <- CohortGenerator::getCohortTableNames(cohortTable = cohortTable)  # Next create the tables on the database CohortGenerator::createCohortTables(   connectionDetails = connectionDetails,   cohortTableNames = cohortTableNames,   cohortDatabaseSchema = \"main\",   incremental = FALSE )  # Generate the cohort set CohortGenerator::generateCohortSet(   connectionDetails = connectionDetails,   cdmDatabaseSchema = cdmDatabaseSchema,   cohortDatabaseSchema = cohortDatabaseSchema,   cohortTableNames = cohortTableNames,   cohortDefinitionSet = cohortDefinitionSet,   incremental = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"executing-cohort-diagnostics","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Executing cohort diagnostics","title":"Running Cohort Diagnostics","text":"cohort definitions loaded cohort tables populated cohort diagnostics ready executed. First set export folder, results stored. execute function (using default settings) follows:","code":"exportFolder <- \"export\" executeDiagnostics(cohortDefinitionSet,   connectionDetails = connectionDetails,   cohortTable = cohortTable,   cohortDatabaseSchema = cohortDatabaseSchema,   cdmDatabaseSchema = cdmDatabaseSchema,   exportFolder = exportFolder,   databaseId = \"MyCdm\",   minCellCount = 5 )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"cohort-statistics-table-clean-up","dir":"Articles","previous_headings":"Running cohort diagnostics","what":"Cohort Statistics Table Clean up","title":"Running Cohort Diagnostics","text":"cohort generation process create number residual tables. process complete, longer required can removed.","code":"CohortGenerator::dropCohortStatsTables(   connectionDetails = connectionDetails,   cohortDatabaseSchema = cohortDatabaseSchema,   cohortTableNames = cohortTableNames )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"cohort-diagnostics-output","dir":"Articles","previous_headings":"","what":"Cohort Diagnostics Output","title":"Running Cohort Diagnostics","text":"diagnostics completed, zip file created specified export folder. zip file can shared sites, contain patient-identifiable information. unzipped, zip file contain several .csv files maybe easily audited. Note cell counts smaller 5 removed, specified using minCellCount argument, ensure non-identifiability.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/RunningCohortDiagnostics.html","id":"creating-an-sqlite-db-file","dir":"Articles","previous_headings":"Cohort Diagnostics Output","what":"Creating an sqlite db file","title":"Running Cohort Diagnostics","text":"Assuming completed steps described one databases, now set zip files, one per database. Make sure place zip files single folder. Optionally, can pre-merge zip files sqlite database can view results Shiny app: file can used shiny app explore results. See vignette “Viewing results using Diagnostics Explorer” details.","code":"createMergedResultsFile(exportFolder)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"viewing-the-diagnostics","dir":"Articles","previous_headings":"","what":"Viewing the diagnostics","title":"Viewing results using Diagnostics Explorer","text":"Diagnostics Explorer shiny application able present results output Cohort Diagnostics either local mode (.e. using premerged file) database mode (connected postgres database server). Shiny app can found . Make sure copy files DiagnosticsExplorer folder. launching application. maybe asked install additional packages required app, shiny, shinydashboard, shinyWidgets, DT, htmltools, scales, plotly, dplyr, purrr, tidyr, ggiraph. Note tabs left information icon. Clicking icons show additional information diagnostic, computed, may interpreted.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"launching-diagnostics-explorer","dir":"Articles","previous_headings":"","what":"Launching Diagnostics Explorer","title":"Viewing results using Diagnostics Explorer","text":"R, launch DiagnosticExplorer shiny application calling ‘launchDiagnosticsExplorer()’ function CohortDiagnostics. R-studio, may start project clicking ‘DiagnosticsExplorer.Rproj’ shiny folder, open global.R press ‘RunApp’ button. R-server (shiny server), need copy files DiagnosticsExplorer shiny app folder server. server automatically launch application (please talk shiny server administrator site specific rules.)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-the-app-using-local-file-mode-sqlite-db-","dir":"Articles","previous_headings":"","what":"Running the app using local file mode (Sqlite db).","title":"Viewing results using Diagnostics Explorer","text":"Local mode common mode run Shiny application. recommend convert csv files precomputed output Cohort Diagnostics sqlite database file follows .RData files enables faster load Shiny application. converted results data sqlite database file, may launch Diagnostics Explorer app follows: running application R-studio environment, please make sure sqlite file folder called ‘data’.","code":"createMergedResultsFile(\"C:/temp/allZipFiles\", sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\") launchDiagnosticsExplorer(sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"publishing-to-posit-connect-or-shinyapps-io","dir":"Articles","previous_headings":"","what":"Publishing to Posit Connect or shinyapps.io","title":"Viewing results using Diagnostics Explorer","text":"Publishing shiny app shared posit connect source can achieved first setting credentials server. need contact internal administrator publishing access rights. Alternatively, can use shinyapps.io service, provides limited free usage hosting applications. Firstly, advised update latest version OHDSI shiny modules : update dependencies shiny app. Following need copyable resource shiny app. can achieved launching DiagnosticsExplorer publishable options create shiny app folder \"MyStudyDiagnosticsExplorer\" R working directory. also overwrite existing application folder copy sqlite file . Following , shiny window load show “publsh” button. can follow RStudio prompts upload rsconnect/posit connect shinyapps.io server.","code":"remotes::install_packages('OHDSI/OhdsiShinyModules') launchDiagnosticsExplorer(   sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\",   makePublishable = TRUE,   publishDir = file.path(getwd(), \"MyStudyDiagnosticsExplorer\"),   overwritePublishDir = TRUE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"sharing-a-zipped-copy-of-your-shiny-app","dir":"Articles","previous_headings":"","what":"Sharing a zipped copy of your shiny app","title":"Viewing results using Diagnostics Explorer","text":"automatically create zip archive containing DiagnosticsExplorer shiny application deployment shared environments, data.ohdsi.org, run function createDiagnosticsExplorerZip: archive contain fully executable shiny application.","code":"createDiagnosticsExplorerZip(outputZipfile = \"MyCdProject.zip\", sqliteDbPath = \"MyCohortDiagnosticsResulst.sqlite\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-the-app-using-database-mode","dir":"Articles","previous_headings":"","what":"Running the app using Database mode","title":"Viewing results using Diagnostics Explorer","text":"recommend use database system, file size cohort diagnostics output becomes large e.g. > 100mb, using sqlite database may leading sluggish performance. Currently, postgres server fully supported, though platforms DatabaseConnector support may work (currently experimental). See Vignette Database mode load data remote database.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/ViewingResultsUsingDiagnosticsExplorer.html","id":"running-over-the-network","dir":"Articles","previous_headings":"","what":"Running over the network","title":"Viewing results using Diagnostics Explorer","text":"want run application network set runOverNetwork = TRUE launching application using ‘launchDiagnosticsExplorer()’. make shiny application available network (.e. within networks firewall).","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/WhatIsCohortDiagnostics.html","id":"introduction","dir":"Articles","previous_headings":"","what":"Introduction","title":"What is Cohort Diagnostics?","text":"CohortDiagnostics package allows one generate wide set diagnostics evaluate cohort definitions database Common Data Model (CDM). diagnostics include incidence rates (optionally stratified age, gender, calendar year), cohort characteristics (comorbidities, drug use, etc.), codes found data triggering various rules cohort definitions. CohortDiagnostics package general works two steps: Generate diagnostics database CDM. Explore generated diagnostics Shiny app included CohortDiagnostics package. use Cohort Diagnostics recommended best practice help improve confidence cohort definitions.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/articles/WhatIsCohortDiagnostics.html","id":"features","dir":"Articles","previous_headings":"","what":"Features","title":"What is Cohort Diagnostics?","text":"Show cohort inclusion rule attrition. List source codes used running cohort definition specific database. Find orphan codes, (source) codes , included particular concept set. Compute cohort incidence across calendar years, age, gender. Break index events specific concepts triggered . Compute overlap two cohorts. Characterize cohorts, compare characterizations. Perform cohort comparison temporal comparisons. Explore patient profiles random sample subjects cohort.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Jamie Gilbert. Author, maintainer. Gowtham Rao. Author. Martijn Schuemie. Author. Patrick Ryan. Author. James Weaver. Author. Observational Health Data Science Informatics. Copyright holder.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Gilbert J, Rao G, Schuemie M, Ryan P, Weaver J (2025). CohortDiagnostics: Diagnostics OHDSI Cohorts. R package version 3.3.1, https://github.com/OHDSI/CohortDiagnostics, https://ohdsi.github.io/CohortDiagnostics.","code":"@Manual{,   title = {CohortDiagnostics: Diagnostics for OHDSI Cohorts},   author = {Jamie Gilbert and Gowtham Rao and Martijn Schuemie and Patrick Ryan and James Weaver},   year = {2025},   note = {R package version 3.3.1, https://github.com/OHDSI/CohortDiagnostics},   url = {https://ohdsi.github.io/CohortDiagnostics}, }"},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"cohortdiagnostics","dir":"","previous_headings":"","what":"Diagnostics for OHDSI Cohorts","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics part HADES.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"introduction","dir":"","previous_headings":"","what":"Introduction","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics R utility package development evaluation phenotype algorithms OMOP CDM compliant data sets. package provides standard, end end, set analytics understanding patient capture including data generation result exploration R Shiny interface. Analytics computed include cohort characteristics, record counts, index event misclassification, captured observation windows basic incidence proportions age, gender calendar year. identification errors, CohortDiagnostics enables comparison multiple candidate cohort definitions across one data sources, facilitating reproducible research.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"features","dir":"","previous_headings":"","what":"Features","title":"Diagnostics for OHDSI Cohorts","text":"Show cohort inclusion rule attrition. List source codes used running cohort definition specific database. Find orphan codes, (source) codes , included particular concept set. Compute cohort incidence across calendar years, age, gender. Break index events specific concepts triggered . Compute overlap two cohorts. Characterize cohorts, compare characterizations. Perform cohort comparison temporal comparisons. Explore patient profiles random sample subjects cohort.","code":""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"technology","dir":"","previous_headings":"","what":"Technology","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics package R package.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"system-requirements","dir":"","previous_headings":"","what":"System Requirements","title":"Diagnostics for OHDSI Cohorts","text":"Requires R. packages used CohortDiagnostics require Java.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Diagnostics for OHDSI Cohorts","text":"See instructions configuring R environment, including Java. R, use following commands download install CohortDiagnostics:","code":"remotes::install_github(\"OHDSI/CohortDiagnostics\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"user-documentation","dir":"","previous_headings":"","what":"User Documentation","title":"Diagnostics for OHDSI Cohorts","text":"Documentation can found package website. PDF versions documentation also available: Package manual: CohortDiagnostics manual Vignette: Cohort Diagnostics Vignette: Running Cohort Diagnostics Vignette: Viewing Results Using Diagnostics Explorer","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"support","dir":"","previous_headings":"","what":"Support","title":"Diagnostics for OHDSI Cohorts","text":"Developer questions/comments/feedback: OHDSI Forum use GitHub issue tracker bugs/issues/enhancements","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"contributing","dir":"","previous_headings":"","what":"Contributing","title":"Diagnostics for OHDSI Cohorts","text":"Read can contribute package.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"license","dir":"","previous_headings":"","what":"License","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics licensed Apache License 2.0","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"development","dir":"","previous_headings":"","what":"Development","title":"Diagnostics for OHDSI Cohorts","text":"CohortDiagnostics developed R Studio.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/index.html","id":"development-status","dir":"","previous_headings":"","what":"Development status","title":"Diagnostics for OHDSI Cohorts","text":"Stable","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/CohortDiagnostics-package.html","id":null,"dir":"Reference","previous_headings":"","what":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","title":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","text":"CohortDiagnostics R utility package development evaluation phenotype algorithms OMOP CDM compliant data sets. package provides standard, end end, set analytics understanding patient capture including data generation result exploration R Shiny interface. Analytics computed include cohort characteristics, record counts, index event misclassification, captured observation windows basic incidence proportions age, gender calendar year. identification errors, CohortDiagnostics enables comparison multiple candidate cohort definitions across one data sources, facilitating reproducible research.","code":""},{"path":[]},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/CohortDiagnostics-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"CohortDiagnostics: Diagnostics for OHDSI Cohorts — CohortDiagnostics-package","text":"Maintainer: Jamie Gilbert gilbert@ohdsi.org Authors: Gowtham Rao Martijn Schuemie Patrick Ryan James Weaver contributors: Observational Health Data Science Informatics [copyright holder]","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":null,"dir":"Reference","previous_headings":"","what":"Check character encoding of input file — checkInputFileEncoding","title":"Check character encoding of input file — checkInputFileEncoding","text":"input files, CohortDiagnostics accepts UTF-8 ASCII character encoding. function can used check whether file meets criteria.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check character encoding of input file — checkInputFileEncoding","text":"","code":"checkInputFileEncoding(fileName)"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check character encoding of input file — checkInputFileEncoding","text":"fileName path file check","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/checkInputFileEncoding.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check character encoding of input file — checkInputFileEncoding","text":"Throws error input file correct encoding.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":null,"dir":"Reference","previous_headings":"","what":"Create publishable shiny zip — createDiagnosticsExplorerZip","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"utility designed creating published zip shiny app sqlite database. Designed sharing projects servers like data.ohdsi.org. Takes shiny code R project adds sqlite file zip archive. Uncompressed cohort diagnostics sqlite databases can become large quickly.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"","code":"createDiagnosticsExplorerZip(   outputZipfile = file.path(getwd(), \"DiagnosticsExplorer.zip\"),   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   shinyDirectory = system.file(file.path(\"shiny\", \"DiagnosticsExplorer\"), package =     \"CohortDiagnostics\"),   overwrite = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createDiagnosticsExplorerZip.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create publishable shiny zip — createDiagnosticsExplorerZip","text":"outputZipfile output path zip file sqliteDbPath Merged Cohort Diagnostics sqlitedb created createMergedResultsFile shinyDirectory (optional) Path location shiny code stored. default, package root overwrite zip file already exists, overwrite ?","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":null,"dir":"Reference","previous_headings":"","what":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"function combines diagnostics results one databases single file. result sqlite database can used input Diagnostics Explorer Shiny app. also checks whether results conform results data model specifications.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"","code":"createMergedResultsFile(   dataFolder,   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   overwrite = FALSE,   tablePrefix = \"\" )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createMergedResultsFile.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Merge Shiny diagnostics files into sqlite database — createMergedResultsFile","text":"dataFolder folder exported zip files diagnostics stored. Use executeDiagnostics function generate zip files. Zip files containing results multiple databases may placed folder. sqliteDbPath Output path sqlite database placed overwrite (Optional) overwrite existing sqlite lite db exists. tablePrefix (Optional) string insert table names (e.g. \"cd_\") database table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":null,"dir":"Reference","previous_headings":"","what":"Create the results data model tables on a database server. — createResultsDataModel","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"Create results data model tables database server.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"","code":"createResultsDataModel(   connectionDetails = NULL,   databaseSchema,   tablePrefix = \"\" )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"connectionDetails DatabaseConnector connectionDetails instance @seealso[DatabaseConnector::createConnectionDetails] databaseSchema schema postgres server tables created. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/createResultsDataModel.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Create the results data model tables on a database server. — createResultsDataModel","text":"PostgreSQL servers supported.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":null,"dir":"Reference","previous_headings":"","what":"Rsconnect deploy — deployPositConnectApp","title":"Rsconnect deploy — deployPositConnectApp","text":"Deploy application posit connect platform shinyapps.io server","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Rsconnect deploy — deployPositConnectApp","text":"","code":"deployPositConnectApp(   appName,   appDir = tempfile(),   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   shinyDirectory = system.file(file.path(\"shiny\", \"DiagnosticsExplorer\"), package =     \"CohortDiagnostics\"),   connectionDetails = NULL,   shinyConfigPath = NULL,   resultsDatabaseSchema = NULL,   vocabularyDatabaseSchemas = resultsDatabaseSchema,   tablePrefix = \"\",   cohortTableName = \"cohort\",   databaseTableName = \"database\",   port = 80,   useRenvironFile = FALSE,   ... )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/deployPositConnectApp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Rsconnect deploy — deployPositConnectApp","text":"appName string name call app - unique posit connect server appDir optional - directory use copy files deployment. use consistent dir internal options can change. sqliteDbPath Path merged sqlite file. See createMergedResultsFile create file. shinyDirectory (optional) Directyory shiny app code lives. Use wish modify explorer connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package, specifying connect server CohortDiagnostics results uploaded using uploadResults function. shinyConfigPath Path shiny yml configuration file (use instead sqliteDbPath connectionDetails object) resultsDatabaseSchema schema database server CohortDiagnostics results uploaded. vocabularyDatabaseSchemas (optional) list one schemas database server vocabulary tables located. default value value resultsDatabaseSchema. can provide list vocabulary schema might represent different versions OMOP vocabulary tables. allows us compare impact vocabulary changes Diagnostics. supported sqlite database. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names cohortTableName (Optional) cohort table name differs standard - cohort (ignores prefix set) databaseTableName (Optional) database table name differs standard - database (ignores prefix set) port (optional) used runOverNetwork = TRUE. useRenvironFile logical - recommended, store db credentials .Renviron file ... parameters passed rsconnect::deployApp","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Execute cohort diagnostics — executeDiagnostics","title":"Execute cohort diagnostics — executeDiagnostics","text":"Runs cohort diagnostics (subset ) cohorts instantiated using Assumes cohorts already instantiated. CohortGenerator package Characterization: runTemporalCohortCharacterization argument TRUE, following default covariateSettings object created using RFeatureExtraction::createTemporalCovariateSettings Alternatively, covariate setting object may created using example.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Execute cohort diagnostics — executeDiagnostics","text":"","code":"executeDiagnostics(   cohortDefinitionSet,   exportFolder,   databaseId,   cohortDatabaseSchema,   databaseName = NULL,   databaseDescription = NULL,   connectionDetails = NULL,   connection = NULL,   cdmDatabaseSchema,   tempEmulationSchema = getOption(\"sqlRenderTempEmulationSchema\"),   cohortTable = \"cohort\",   cohortTableNames = CohortGenerator::getCohortTableNames(cohortTable = cohortTable),   vocabularyDatabaseSchema = cdmDatabaseSchema,   cohortIds = NULL,   cdmVersion = 5,   runInclusionStatistics = TRUE,   runIncludedSourceConcepts = TRUE,   runOrphanConcepts = TRUE,   runTimeSeries = FALSE,   runVisitContext = TRUE,   runBreakdownIndexEvents = TRUE,   runIncidenceRate = TRUE,   runCohortRelationship = TRUE,   runTemporalCohortCharacterization = TRUE,   temporalCovariateSettings = getDefaultCovariateSettings(),   minCellCount = 5,   minCharacterizationMean = 0.01,   irWashoutPeriod = 0,   incremental = FALSE,   incrementalFolder = file.path(exportFolder, \"incremental\"),   runFeatureExtractionOnSample = FALSE,   sampleN = 1000,   seed = 64374,   seedArgs = NULL )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Execute cohort diagnostics — executeDiagnostics","text":"cohortDefinitionSet Data.frame cohorts must include columns cohortId, cohortName, json, sql exportFolder folder output exported . folder exist created. databaseId short string identifying database (e.g. 'Synpuf'). cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. databaseName full name database. NULL, defaults value cdm_source table databaseDescription short description (several sentences) database. NULL, defaults value cdm_source table connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cohortTable Name cohort table. cohortTableNames Cohort Table names used CohortGenerator package vocabularyDatabaseSchema Schema name OMOP vocabulary data resides. commonly cdmDatabaseSchema. Note SQL Server, include database schema name, example 'vocabulary.dbo'. cohortIds Optionally, provide subset cohort IDs restrict diagnostics . cdmVersion version OMOP CDM. Default 5. (Note: 5 supported.) runInclusionStatistics Generate export statistic cohort inclusion rules? runIncludedSourceConcepts Generate export source concepts included cohorts? runOrphanConcepts Generate export potential orphan concepts? runTimeSeries Generate export time series diagnostics? runVisitContext Generate export index-date visit context? runBreakdownIndexEvents Generate export breakdown index events? runIncidenceRate Generate export cohort incidence  rates? runCohortRelationship Generate export cohort relationship? Cohort relationship checks temporal relationship two cohorts. runTemporalCohortCharacterization Generate export temporal cohort characterization? records values greater 0.001 returned. temporalCovariateSettings Either object type covariateSettings created using one createTemporalCovariateSettings function FeatureExtraction package, list objects. minCellCount minimum cell count fields contains person counts fractions. minCharacterizationMean minimum mean value characterization output. Values cut output. help reduce file size characterization output, remove information covariates low values. default 0.001 (.e. 0.1 percent) irWashoutPeriod Number days washout include calculation incidence rates - default 0 incremental Create cohort diagnostics created ? incrementalFolder incremental = TRUE, specify folder records kept cohort diagnostics executed. runFeatureExtractionOnSample Logical. TRUE, function operate sample data. Default FALSE, meaning function operate full data set. sampleN Integer. number records include sample runFeatureExtractionOnSample TRUE. Default 1000. Ignored runFeatureExtractionOnSample FALSE. seed Integer. seed random number generator used create sample. ensures sample can drawn future runs. Default 64374. seedArgs List. Additional arguments pass sampling function. can used control aspects sampling process beyond seed sample size.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Execute cohort diagnostics — executeDiagnostics","text":"cohortSetReference argument must data frame least following columns.fields exported cohort table part Cohort Diagnostics results data model. additional fields found stored JSON object metadata field cohort table: cohortId cohort Id id used identify  cohort definition. required unique. used create file names. cohortName full name cohort. shown Shiny app. json JSON cohort definition cohort. sql SQL cohort definition rendered cohort json.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/executeDiagnostics.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Execute cohort diagnostics — executeDiagnostics","text":"","code":"if (FALSE) { # \\dontrun{ # Load cohorts (assumes that they have already been instantiated) cohortTableNames <- CohortGenerator::getCohortTableNames(cohortTable = \"cohort\") cohorts <- CohortGenerator::getCohortDefinitionSet(packageName = \"MyGreatPackage\") connectionDetails <- createConnectionDetails(   dbms = \"postgresql\",   server = \"ohdsi.com\",   port = 5432,   user = \"me\",   password = \"secure\" )  executeDiagnostics(   cohorts = cohorts,   exportFolder = \"export\",   cohortTableNames = cohortTableNames,   cohortDatabaseSchema = \"results\",   cdmDatabaseSchema = \"cdm\",   databaseId = \"mySpecialCdm\",   connectionDetails = connectionDetails )  # Use a custom set of cohorts defined in a data.frame cohorts <- data.frame(   cohortId = c(100),   cohortName = c(\"Cohort Name\"),   logicDescription = c(\"My Cohort\"),   sql = c(readLines(\"path_to.sql\")),   json = c(readLines(\"path_to.json\")) ) executeDiagnostics(   cohorts = cohorts,   exportFolder = \"export\",   cohortTable = \"cohort\",   cohortDatabaseSchema = \"results\",   cdmDatabaseSchema = \"cdm\",   databaseId = \"mySpecialCdm\",   connectionDetails = connectionDetails ) } # }"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns information from CDM source table. — getCdmDataSourceInformation","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"Returns CDM source name, description, release date, CDM release date, version vocabulary version, available.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"","code":"getCdmDataSourceInformation(   connectionDetails = NULL,   connection = NULL,   cdmDatabaseSchema )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCdmDataSourceInformation.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns information from CDM source table. — getCdmDataSourceInformation","text":"Returns data frame CDM Data source.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":null,"dir":"Reference","previous_headings":"","what":"Count the cohort(s) — getCohortCounts","title":"Count the cohort(s) — getCohortCounts","text":"Computes subject entry count per cohort","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Count the cohort(s) — getCohortCounts","text":"","code":"getCohortCounts(   connectionDetails = NULL,   connection = NULL,   cohortDatabaseSchema,   cohortTable = \"cohort\",   cohortIds = c() )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Count the cohort(s) — getCohortCounts","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. cohortTable Name cohort table. cohortIds cohort Id(s) used reference cohort cohort table. left empty, cohorts table included.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getCohortCounts.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Count the cohort(s) — getCohortCounts","text":"tibble cohort counts","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":null,"dir":"Reference","previous_headings":"","what":"Get database migrations instance — getDataMigrator","title":"Get database migrations instance — getDataMigrator","text":"Returns ResultModelManager DataMigrationsManager instance.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get database migrations instance — getDataMigrator","text":"","code":"getDataMigrator(connectionDetails, databaseSchema, tablePrefix = \"\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get database migrations instance — getDataMigrator","text":"connectionDetails DatabaseConnector connection details object databaseSchema String schema database schema lives tablePrefix (Optional) Use table prefix used table names (e.g. \"cd_\")","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDataMigrator.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get database migrations instance — getDataMigrator","text":"Instance ResultModelManager::DataMigrationManager interface converting existing data models","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultCovariateSettings.html","id":null,"dir":"Reference","previous_headings":"","what":"Get default covariate settings — getDefaultCovariateSettings","title":"Get default covariate settings — getDefaultCovariateSettings","text":"Default covariate settings cohort diagnostics execution","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultCovariateSettings.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get default covariate settings — getDefaultCovariateSettings","text":"","code":"getDefaultCovariateSettings()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"Get list vocabulary table names","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"","code":"getDefaultVocabularyTableNames()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getDefaultVocabularyTableNames.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a list of vocabulary table names — getDefaultVocabularyTableNames","text":"Get list vocabulary table names results data model","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":null,"dir":"Reference","previous_headings":"","what":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"Get specifications Cohort Diagnostics results data model","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"","code":"getResultsDataModelSpecifications()"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/getResultsDataModelSpecifications.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get specifications for Cohort Diagnostics results data model — getResultsDataModelSpecifications","text":"tibble data frame object specifications","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":null,"dir":"Reference","previous_headings":"","what":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"Launch Diagnostics Explorer Shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"","code":"launchDiagnosticsExplorer(   sqliteDbPath = \"MergedCohortDiagnosticsData.sqlite\",   connectionDetails = NULL,   shinyConfigPath = NULL,   resultsDatabaseSchema = NULL,   vocabularyDatabaseSchema = NULL,   vocabularyDatabaseSchemas = resultsDatabaseSchema,   tablePrefix = \"\",   cohortTableName = \"cohort\",   databaseTableName = \"database\",   aboutText = NULL,   runOverNetwork = FALSE,   port = 80,   makePublishable = FALSE,   publishDir = file.path(getwd(), \"DiagnosticsExplorer\"),   overwritePublishDir = FALSE,   launch.browser = FALSE )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"sqliteDbPath Path merged sqlite file. See createMergedResultsFile create file. connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package, specifying connect server CohortDiagnostics results uploaded using uploadResults function. shinyConfigPath Path shiny yml configuration file (use instead sqliteDbPath connectionDetails object) resultsDatabaseSchema schema database server CohortDiagnostics results uploaded. vocabularyDatabaseSchema (Deprecated) Please use vocabularyDatabaseSchemas. vocabularyDatabaseSchemas (optional) list one schemas database server vocabulary tables located. default value value resultsDatabaseSchema. can provide list vocabulary schema might represent different versions OMOP vocabulary tables. allows us compare impact vocabulary changes Diagnostics. supported sqlite database. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names cohortTableName (Optional) cohort table name differs standard - cohort (ignores prefix set) databaseTableName (Optional) database table name differs standard - database (ignores prefix set) aboutText Text (using HTML markup) displayed tab Shiny app. provided, tab shown. runOverNetwork (optional) want app run network? port (optional) used runOverNetwork = TRUE. makePublishable (Optional) copy data files make app publishable posit connect/shinyapp.io publishDir make publishable true - directory shiny app copied overwritePublishDir (Optional) make publishable true - overwrite directory publishing launch.browser app launched default browser, Shiny window. Note: copying clipboard work Shiny window.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/launchDiagnosticsExplorer.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Launch the Diagnostics Explorer Shiny app — launchDiagnosticsExplorer","text":"Launches Shiny app allows user explore diagnostics","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":null,"dir":"Reference","previous_headings":"","what":"Migrate Data model — migrateDataModel","title":"Migrate Data model — migrateDataModel","text":"Migrate data current state next state strongly advised backup data (either sqlite files, backup database (case using postgres backend) kept csv/zip files data generation.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Migrate Data model — migrateDataModel","text":"","code":"migrateDataModel(connectionDetails, databaseSchema, tablePrefix = \"\")"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/migrateDataModel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Migrate Data model — migrateDataModel","text":"connectionDetails DatabaseConnector connection details object databaseSchema String schema database schema lives tablePrefix (Optional) Use table prefix used table names (e.g. \"cd_\")","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"Given set cohorts, get temporal relationships cohort_start_date cohorts.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"","code":"runCohortRelationshipDiagnostics(   connectionDetails = NULL,   connection = NULL,   cohortDatabaseSchema = NULL,   tempEmulationSchema = NULL,   cohortTable = \"cohort\",   targetCohortIds,   comparatorCohortIds,   relationshipDays )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortRelationshipDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Given a set of cohorts get relationships between the cohorts. — runCohortRelationshipDiagnostics","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cohortTable Name cohort table. targetCohortIds vector one Cohort Ids use target cohorts. comparatorCohortIds vector one Cohort Ids use feature/comparator cohorts. relationshipDays dataframe two columns startDay endDay representing periods time compute relationship","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":null,"dir":"Reference","previous_headings":"","what":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"function first generates calendar period table, calendar intervals timeSeriesMinDate timeSeriesMaxDate. Calendar Month, Quarter year supported. calendar interval, time series data computed. returned object R dataframe need converted time series object perform time series analysis. Data Source time series: computes time series data source level .e. observation period table. output limited individuals cohort table people datasource (.e. present observation period table)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"","code":"runCohortTimeSeriesDiagnostics(   connectionDetails = NULL,   connection = NULL,   tempEmulationSchema = NULL,   cdmDatabaseSchema,   cohortDatabaseSchema = cdmDatabaseSchema,   cohortTable = \"cohort\",   runCohortTimeSeries = TRUE,   runDataSourceTimeSeries = FALSE,   timeSeriesMinDate = as.Date(\"1980-01-01\"),   timeSeriesMaxDate = as.Date(Sys.Date()),   stratifyByGender = TRUE,   stratifyByAgeGroup = TRUE,   cohortIds = NULL )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/runCohortTimeSeriesDiagnostics.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Given a set of instantiated cohorts get time series for the cohorts. — runCohortTimeSeriesDiagnostics","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. Can left NULL connection provided. connection object type connection created using connect function DatabaseConnector package. Can left NULL connectionDetails provided, case new connection opened start function, closed function finishes. tempEmulationSchema database platforms like Oracle Impala truly support temp tables. emulate temp tables, provide schema write privileges temp tables can created. cdmDatabaseSchema Schema name patient-level data OMOP CDM format resides. Note SQL Server, include database schema name, example 'cdm_data.dbo'. cohortDatabaseSchema Schema name cohort table resides. Note SQL Server, include database schema name, example 'scratch.dbo'. cohortTable Name cohort table. runCohortTimeSeries Generate export cohort level time series? runDataSourceTimeSeries Generate export Data source level time series? .e. using persons found observation period table. timeSeriesMinDate (optional) Minimum date time series. Default value January 1st 1980. timeSeriesMaxDate (optional) Maximum date time series. Default value System date. stratifyByGender want stratify Gender stratifyByAgeGroup want stratify Age group cohortIds vector one Cohort Ids compute time distribution .","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":null,"dir":"Reference","previous_headings":"","what":"Upload results to the database server. — uploadResults","title":"Upload results to the database server. — uploadResults","text":"Requires results data model tables created using createResultsDataModel function. Set POSTGRES_PATH environmental variable path folder containing psql executable enable bulk upload (recommended).","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Upload results to the database server. — uploadResults","text":"","code":"uploadResults(   connectionDetails,   schema,   zipFileName,   forceOverWriteOfSpecifications = FALSE,   purgeSiteDataBeforeUploading = TRUE,   tempFolder = tempdir(),   tablePrefix = \"\",   ... )"},{"path":"https://ohdsi.github.io/CohortDiagnostics/reference/uploadResults.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Upload results to the database server. — uploadResults","text":"connectionDetails object type connectionDetails created using createConnectionDetails function DatabaseConnector package. schema schema postgres server tables created. zipFileName name zip file. forceOverWriteOfSpecifications TRUE, specifications phenotypes, cohort definitions, analysis overwritten already exist database. use specifications changed since last upload. purgeSiteDataBeforeUploading TRUE, inserting data specific databaseId data site dropped. assumes input zip file contains full data data site. tempFolder folder local file system zip files extracted . cleaned function finished. Can used specify temp folder drive sufficient space default system temp space limited. tablePrefix (Optional)  string insert table names (e.g. \"cd_\") database table names ... See ResultModelManager::uploadResults","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-330","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.3.0","title":"CohortDiagnostics 3.3.0","text":"Changes: Added function make deployment posit connect servers easier Added ability use CohortGenerator sample functionality executeDiagnostics speeds execution large cohort definitions Requires use FeatureExtraction 3.4.0 support new API Removed annotation tables result schema script","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-325","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.5","title":"CohortDiagnostics 3.2.5","text":"Bug Fixes: fixed broken migrations using “ADD COLUMN” Fixed broken links manaual Fixed issue Andromeda calls characterization R 4.3.x Fix Vroom issue mac","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-324","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.4","title":"CohortDiagnostics 3.2.4","text":"Bug Fix: Added support newer API OhdsiShinyModules (maintaining support old version) Resolved issue incidence rates sometimes exporting null/infinite setting 0 error cases","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-323","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.3","title":"CohortDiagnostics 3.2.3","text":"Resolved issue concept sets exported diagnostics executed. concept sets now always exported results csv imported databases","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-322","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.2","title":"CohortDiagnostics 3.2.2","text":"Fixes unit tests breaking R 4.3 due change Sys.time function","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-321","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.1","title":"CohortDiagnostics 3.2.1","text":"Added requirement Andromeda 0.6.0 (implicitly required DatabaseConnector) Fixed issue saving cohort subsets csv file viewing analysis shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-320","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.2.0","title":"CohortDiagnostics 3.2.0","text":"run orphan concepts checks subset cohorts Remove use lookback period IR calculations - now setting call package Added data migration support subsets database schema (allow future functionality take care ) Added functionality launchDiagnosticsExplorer make publishing poist connect/shinyapps.io straightforward (still requires removal ggiraph) Moved shiny code OHDSI/OhdsiShinyModules","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-312","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.2","title":"CohortDiagnostics 3.1.2","text":"Bug Fixes: Removed package dependency snapshot capture breaking newer versions R","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-311","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.1","title":"CohortDiagnostics 3.1.1","text":"Changes: Removed CohortExplorer app ’s now part new package. Added support custom FeatureExtraction features Bug Fixes: Fixed error checking cdm_source table Removal .data$ usage across package fix tidyselect warning","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-310","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.1.0","title":"CohortDiagnostics 3.1.0","text":"Changes: Major refactoring shiny app use modular code ease maintenance tests shiny modules inst/shiny/DiagnosticsExplorer/tests Added support table prefixes Diagnostics Explorer databases (e.g. cg_cohort_definition) Enabled annotation local instances DiagnosticsExplorer Added yaml configuration diagnostics explorer app, including docs usage Storage version number database results file allow future migrations Slight optimization cohort characterization queries diagnostics explorer Support database migrations adding migrateDataModel functionality. Versions data generated CohortDiagnostics 3.0.0 intended future compatible. .e. sqlite results file postgres database generated version 3.0.0 cohort diagnostics new shiny app functionality supported run migrateDataModel . Changed type dataType fieldName columnName align strategus modules Refactored export characterization results use common export Ensure tests cases always use continuous covariate Batch operations executing cohort relationship, time series, feature extraction based diagnostics. New parameter minCharacterizationMean. introduces cut output FeatureExtraction. absence parameter output atleast one row every covariateId datasource - low count useful diagnostics. Bug fixes: Fixed issue uploading results postgres db caused null values primary key field. Removed constraint fix issue. Fix index_event_breakdown duplicate entries concept observed domain multiple times Many issues resolved shiny codebase","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-303","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.3","title":"CohortDiagnostics 3.0.3","text":"Changes: Changed default batch size characterization feature extraction 100 5 causing performance issues redshift clusters. Allow setting batch size feature extraction options(\"CohortDiagnostics-FE-batch-size\" = batchSize)","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-302","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.2","title":"CohortDiagnostics 3.0.2","text":"Bug fixes: Fixed issue writing csvs caused update SqlRender camelCaseToSnakeCase function check caused execution crash parameters null. Fixed issue observation period overflowing sql integer BigQuery causing execution crash","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-301","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.1","title":"CohortDiagnostics 3.0.1","text":"Bug fixes: Updated old/incorrect documentation package usage Fixed bug new versions CohortGenerator v0.5.0 causing cohort definition sets package load Fixed bug shiny app multiple runs database cause app crash selecting database","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-300","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 3.0.0","title":"CohortDiagnostics 3.0.0","text":"Changes: Time series diagnostics removed Removed runCohortDiagnostics function - now completely replaced executeDiagnostics Removed loadCohortsFromPackage function now replaced CohortGenerator::getCohortDefinitionSet Removed instantiate cohort functionality, instantiateCohortSet now used CohortGenerator package Removed optional inclusionStatisticsFolder parameter, now exported directly CohortGenerator without need generate first. Removed usage Rdata files DiagnosticsExplorer shiny app function create preMergeDiagnosticsFiles Added function createMergedResultsFile outputs shiny app Added support SqlRender/DatabaseConnector compatible database (note, experimental. Postgres sqlite backends recommended use production environments) Improved metadata collection storage runs cohort diagnostics. Removed phenotype_id field data ddl Additional checks output cohort diagnostics ensure conforms results data model. new function (internal) makeDataExportable. Results data model csv file enhanced new fields, including field specify value subjected privacy protection (.e. min cell count, eg. person count). Note bug discovered orphan concepts included source concepts leading duplication row records primary key. bug fixed calculating max value grouped primary keys. fixed another commit. New optional diagnostics computes temporal relationship two cohorts. settings temporal relationship cohorts defaults temporalCovariateSettings. diagnostics integrated characterization output diagnostics explorer, cohorts covariates. New optional diagnostics called time series diagnostics. Time series diagnostics takes input calendar period range, calendar period range calendar units (year, quarter, month) computes approximate new occurrence (approximates incidence) observations (approximates prevalence) cohort start cohort end dates calendar period. Bug fixes: Added support users include non-standard columns CDM preventing crashes","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-224","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.4","title":"CohortDiagnostics 2.2.4","text":"Bug fixes: Fixed bug causing generation premerged upload files fail output fields results data model.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-223","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.3","title":"CohortDiagnostics 2.2.3","text":"Bug fixes: Replace use dplyr across() bug introduced tidyr v1.2.0","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-222","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.2","title":"CohortDiagnostics 2.2.2","text":"Bug fixes: Fixed syntax error causing empty description field inclusion rule stats","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-221","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.1","title":"CohortDiagnostics 2.2.1","text":"Bug fixes: Added new lines NEWS.md fix package site. Updated vignette fix minor issues Cohorts zero counts now stored results display shiny app","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-220","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.2.0","title":"CohortDiagnostics 2.2.0","text":"Changes: 1. Added executeDiagnostics function aims replace runCohortDiagnosticsas main interface package. Updated vignette “Running Cohort Diagnostics” give clearer instructions Removed vignettes usage longer required Improved testing across database platforms Moved particularly useful warnings logInfo Bug Fixes: 1. User code removed CohortExplorer fix issue #618 Fixed bug runBreakdownIndexEvents = TRUE failed drug_era table SQL error - Issue #695 Fixed error computing incidence rates BigQuery. Fixed error cdm_source table empty (warning remains). Fixed error instantiating cohorts BigQuery.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-214","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.4","title":"CohortDiagnostics 2.1.4","text":"Changes: Minor cosmetic changes diagnostics explorer shiny app. Typo fix Fix warning type-convert https://github.com/OHDSI/CohortDiagnostics/issues/661 Use Sex instead Gender Diagnostics Explorer https://github.com/OHDSI/CohortDiagnostics/issues/676 Bug Fixes: Privacy protecting feature bug fix. prior version covariate_value covariate_value_dist failed privacy protection. Thank @msuchard reporting issue @schuemie fixing https://github.com/OHDSI/CohortDiagnostics/issues/658","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-213","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.3","title":"CohortDiagnostics 2.1.3","text":"Changes: starting diagnostics explorer using launchDiagnosticsExplorer - checks added remotes CirceR https://github.com/OHDSI/CohortDiagnostics/issues/595 Bug Fixes: Diagnostics explorer - characterization plot show warning message one cohorts selected data. Added check issue.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-212","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.2","title":"CohortDiagnostics 2.1.2","text":"Bug fixes: DiagnosticsExplorer fixes bug app failure runIndexEventBreakdown, runOrphanConcepts, includedSourceConcept set FALSE","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-211","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.1","title":"CohortDiagnostics 2.1.1","text":"Bug fixes: DiagnosticsExplorer shiny app bug fixes: inclusion rule display. Handle situation cdm_source may one row record. warning + use max value vocabularyVersion. Switch runTimeSeries BigQuery SQL translation issue, addressed version 2.3. https://github.com/OHDSI/CohortDiagnostics/issues/503 Also runTimeSeries set FALSE default. Fixed bug DDL - temporal_covariate_value_dist https://github.com/OHDSI/CohortDiagnostics/issues/490 See issue https://github.com/OHDSI/CohortDiagnostics/issues/497","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-210","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.1.0","title":"CohortDiagnostics 2.1.0","text":"Changes: Diagnostics explorer Shiny app enhancements: Improved tool tip Various improvements plots consistent color, axis labels labels Visit context table addition Diagnostic explorer now distinct shiny application phenotype library. PhenotypeExplorer stand alone shiny app package PhenotypeLibrarian. Lot UX changes. Reactivity deferred drop menus. Changes improve app stability. Index event breakdown now subject count Index event breakdown calculates _source_concept_id source fields CDM tables. Vocabulary database schema now supported. Metadata (vocabulary version information data source) now collected. OracleTempSchema use deprecated favor tempEmulationSchema. Run external concept count removed, concept counts data available. Function ‘runCohortDiagnosticsUsingExternalCounts’ removed. Removed code related referentConceptId = phenotypeId/1000 always hold true. Create cohort table function now private. Please use instantiate cohort. checkInputFileEncoding exported public function (scope CohortDiagnostics). Updated results data model include new tables (resolved_concepts). Cohort Diagnostics results data model now compliant standard characterization output. Support cohort_censor_stats table webapi 2.8.1 #387 Add time series diagnostics computation. Output Diagnostics explorer version. improvements help usability stability. Informative messages help debugbing needed. phenotypeDescription longer supported input cohort diagnostics. Bug fixes: databaseName databaseDescription non NULL Fixed computation standard deviation standard difference mean binary covariates.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-200","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 2.0.0","title":"CohortDiagnostics 2.0.0","text":"Changes: Many improvements performance computing diagnostics. Now allows computation diagnostics many (>100) cohorts . Diagnostics Explorer Shiny app can now also run results data database. Added functions uploading diagnostics data database. becomes necessary dealing large data (e.g. 100 cohort definitions). Added ability group cohort definitions phenotypes, add descriptions phenotypes. Currently consequence grouping phenotype cohort overlap computed within phenotype. Grouping phenotypes done adding phenotypeId field cohortsToCreate file, adding phenotypeDescription file. See examplePhenotypeLibraryPackage repo example. cohort overlap plot now uses stacked bar charts instead Venn diagram allow showing multiple comparisons across multiple databases . cohort characteristics comparison plot now colors domain, allows filtering domain. Switching ‘plotly’ ‘ggiraph’ interactive plotting. Added Visit Context diagnostic. Bug fixes: Fixing numerous bugs introduced v1.2.x.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-126","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.6","title":"CohortDiagnostics 1.2.6","text":"Bug fixes: Additional bug fixes characterization/temporal characterization.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-125","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.5","title":"CohortDiagnostics 1.2.5","text":"Bug fixes: Additional bug fixes characterization/temporal characterization.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-124","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.4","title":"CohortDiagnostics 1.2.4","text":"Bug fixes: Added details log characterization/temporal characterization return results returns result threshold value. default filter results Characterization Temporal Characterization value less 0.001. leading empty results cohorts - causing errors.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-123","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.3","title":"CohortDiagnostics 1.2.3","text":"Bug fixes: Fixed error many concept sets instantiated. Removed ohdsi/SqlRender Remotes https://github.com/OHDSI/CohortDiagnostics/issues/189 Fixed Digit precision RJSONIO::toJson fromJSON https://github.com/OHDSI/CohortDiagnostics/issues/161 important fix. digit precision explicitly specified RJSONIO, scientific notation used. issue seems happen integer id (conceptId, conceptSetId, cohortId etc) >= 10,000,000 (rare). Please use update id’s > 10,000,000.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-122","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.2","title":"CohortDiagnostics 1.2.2","text":"New features: 1. Minor UI changes Diagnostics explorer. Added missing sort. Added better labels plots. Download plots. Bug fixes: 1. Changes dependency ROhdsiWebApi (>= 1.1.0) DiagnosticsExplorer display bug fixes","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-121","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.1","title":"CohortDiagnostics 1.2.1","text":"New features: 1. objects DiagnosticsExplorer sorted default #173 Multi select concepts #199 Bug fixes: 1. Ensure concept sets across cohort definitions unique #174 (changes dependency ROhdsiWebApi (>= 1.1.0))","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-120","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.2.0","title":"CohortDiagnostics 1.2.0","text":"Changes: 1. New function retrieve concept set json cohort json New function retrieve concept set sql cohort sql DiagnosticsExplorer shiny app - DataTable now rendered using server side processing. Bug fixes UI improvements. DiagnosticsExplorer shiny app - Phenotype library mode (released) DiagnosticsExplorer shiny app - Combine included source concepts orphan concepts one submenu https://github.com/OHDSI/CohortDiagnostics/issues/129 Bug fixes: 1. https://github.com/OHDSI/CohortDiagnostics/issues/167 https://github.com/OHDSI/CohortDiagnostics/issues/165","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-111","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.1.1","title":"CohortDiagnostics 1.1.1","text":"Changes: 1. Shiny app UI improvements Link Atlas Athena cohortId. Supports baseUrl. (beta - unreleased) support Phenotype library. Shiny app look two additional csv files phenotypeDescription cohortDescription put DiagnosticExplorer Phenotype Library Mode. Plan release future version >= 1.2 Changed default selections temporal characterization Added minimum threshold value covariate_value temporal_covariate_value default value = 0 (future release, plan make 0.005 .e. 0.5%) Bug fixes: Minor bug fixes.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-110","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.1.0","title":"CohortDiagnostics 1.1.0","text":"Changes: 1. Added temporal characterization UI changes Shiny app diagnostic explorer Bug fixes: 1. Circe-update introduced bug parsing concept sets cohort definition. Handling empty cohorts Changes: Error handling: Use checkmate R-package provide informative error messages. Refactor runCohortDiagnostics: added new function refactoring existing private functions. new function get JSON parameterized OHDSI SQL cohorts diagnostics requested Note: code partially refactored depend tidyverse.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-102","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.0.2","title":"CohortDiagnostics 1.0.2","text":"Changes: Adapting new ROhdsiWebApi (>= 1.0.0) interface. Added log info provides addition run time details #72 Bugfixes: Fixing broken getTimeDistributions function. Fixing broken instantiateCohort function.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-100","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 1.0.0","title":"CohortDiagnostics 1.0.0","text":"Changes: Added database information tab Diagnostics Explorer Shiny app. Using Andromeda instead ff store large data objects (used characterization). Bugfixes: Fixed error cohort definition concept sets. Fixed error index event breakdown entry event contained multiple criteria domain. Fixed error related tempEmulationSchema argument (needed Oracle BigQuery). Fixed use deprecated function, causing warnings causing older versions ParallelLogger error.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-012","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.2","title":"CohortDiagnostics 0.1.2","text":"Changes Adding option run cohort instantiation diagnostics incrementally, running tasks changed since last ru.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-011","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.1","title":"CohortDiagnostics 0.1.1","text":"Changes Orphan included concepts tables now show concept ID. Bugfixes: Fixed error orphan code SQL (hard-coded database schema). Fixed bug concept counts become big regular INT. Fixed counts standard concepts shown using external concept count table.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-010","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.1.0","title":"CohortDiagnostics 0.1.0","text":"Changes Orphan code check now resolves concept sets instead using verbatim concepts. include specificity. Added option use y-axis databases incidence rate plot. Added runCohortDiagnosticsUsingExternalCounts function. Added option use cohort definitions WebAPI instead stored study package. Bugfixes: Fixed bug causing weird false positives orphan codes (caused transforming concept IDs scientific notation). Better handling viewer analyses executed. Now also showing cohorts zero entries. Fixed error 1 cohort.","code":""},{"path":"https://ohdsi.github.io/CohortDiagnostics/news/index.html","id":"cohortdiagnostics-001","dir":"Changelog","previous_headings":"","what":"CohortDiagnostics 0.0.1","title":"CohortDiagnostics 0.0.1","text":"Initial version","code":""}]
diff --git a/extras/CohortDiagnostics.pdf b/extras/CohortDiagnostics.pdf
index 8b2c0565b4a42f91efc05b60fd141fa4754f64b2..e18c25cb94796b5b44f80c50e2b2b1da5edc4bb9 100644
GIT binary patch
delta 2183
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
JB_%~qMhcc1_A>wg

delta 2184
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
K3MC~)Peuw`d<h!>

diff --git a/extras/PackageMaintenance.R b/extras/PackageMaintenance.R
index 1a9a2faa4..9c5f912f1 100644
--- a/extras/PackageMaintenance.R
+++ b/extras/PackageMaintenance.R
@@ -1,6 +1,6 @@
 # @file PackageMaintenance
 #
-# Copyright 2024 Observational Health Data Sciences and Informatics
+# Copyright 2025 Observational Health Data Sciences and Informatics
 #
 # This file is part of CohortDiagnostics
 # 
diff --git a/inst/doc/RunningCohortDiagnostics.pdf b/inst/doc/RunningCohortDiagnostics.pdf
index ba234cea2c0f21fd1ef1db65465050b32c3ae326..462532d6a0325015b3590a228397e446b29e0b46 100644
GIT binary patch
delta 29803
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
K6ygdJu>S*n0VbdT

delta 30069
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
Sw_J{yn*)}dTwGBC_WuAG;uZS<

diff --git a/inst/doc/ViewingResultsUsingDiagnosticsExplorer.pdf b/inst/doc/ViewingResultsUsingDiagnosticsExplorer.pdf
index 07783b0fb05fe587eb724d4dd5cc5ce58224cf86..8e0aea3f1e94b1c3f1a17d28f080e3324a4144a1 100644
GIT binary patch
delta 27923
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

delta 28120
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

diff --git a/inst/doc/WhatIsCohortDiagnostics.pdf b/inst/doc/WhatIsCohortDiagnostics.pdf
index 3bbbaabf928d84dcfd170afb395080a4b4b2454f..b073d1c50cfac6a2804442b88662ee7eeee09dc8 100644
GIT binary patch
delta 25956
zcmV(=K-s_k_y^4Q2aqKJGnb*=0VsdHS4(f)HW0q&SLmn(vJ9!WdMOY)4q7xo(JatI
z(gQ8gyQ;OKKuK}ZU!NgosFh@=j{xpTtI@n4-^}vh81Ufj3;qw!*M}FcZW0lQoJAr{
zg2P=9@r;Qi$g+Zo5-4@>A^iO$$K5{WQP>RlywWFah<4q`W2c9)sfHhSe;j{)28~G|
z1S``tvKq696>%Kw<AfDii5lPPU6h9p<4K-DNtA`ZNo{3=lH~$;qns6Gio6kz(mfY@
z!BKl21tMW_k~!^r>u^?Npub>6N-|fv+r=Ur6+Q-%OhJE{MVS@kAPP>393{kVUq)&8
z69`1%XtZ@Jtfy*hK$Z0j?6H3cY;(_ViF;2)T?KiJx^8x57AiSTMh)Lo@hF~IV;r$E
z$!70_Aom2hCzkHLx`~TraI7rA3=c$*3zk8NlPqUt9tVdrs5_h#C;$yu$3+E^+{<bg
z72&-+5}#~as8|_35QFaM!)QH$OdS<aL}=uwkRb8<LsJvyphl9t!)GzQwTik#s6Oq|
z986B6OoWwhH!G$-@;K=l8#$(R8Eh0JX~wv%gbh?4Wz!8#GDVk?ll%c7f8;5@x_$=_
z!H@zu9UudwWfNQicB*!&XQLJ5rK>LdHgUs6weD?rvIU0riwjaP&htf-Ny2zW<s3#3
zZ){prZFTVQ)|T%J{)QsH#MD8NYGptty~~c+E7`&)Y4Gif6;{&N;9e5LTmblONB1O+
ztVU%T8zN|=5?bFYeb&~<e{EAkk<>uOYTF*u5nm>kD*B?viY;u-UfGhk&=+CDPzX-N
zt$a<K@i@HG6N<)E)!0`Ri%uld9FO35cU-Z=A#@$|h-vgh`pndN)sOVqnCF}%i>9>n
zZeWNGoW*Gw>;Ya&KtMOi2XF4l(TlgEm&~T^gc;f5%Y)_7=6+c7e~gxl-|)jQs@|sh
z2kXxa`+<m98fR<A1Y7fb*r%L_Z=KaqZE{s_-Chh@5>lp@gZ4xUVSF|w0g`cV5R5+Q
z(VNeGtIgJ-Bl%f>!#_Xf<l6fa5d4UM_kF*Z(wzmFdXw3IUp6*_QnH5NILn|Pk`)9O
zFbeboak04UR``9ff8%GYz#R-vi4UV-;LdikYb4ydsZax{=<T336&XQ{Ey9y(ds27q
zjl=d&ZtRK8dspescD4m8qF_dHL<v0^&*z-pj4MRT;<ChuSHR7l+I@Vz^dee%ut$^S
z9-TYl)lI<{OAoqQ<e6K=MT9CoMtC(WL{@teMDkeph5Y`ce{q0ZNvp+t+rHRY*lPT0
zu;4(=GXkX8pxECzw<lBB;o0}N_e+B{jqN(7`L=K~naZP*Ma0}AVnQ%Wt^9COod>qA
zoAFORj@Cl;qF6}O-HLzcvCS&CcdGTo|A$PZ-;;@(#sj@J{YiE{1iuenBEfE>!KKHp
zmo1YYY)MfMe<zpBmeO_WQi(eX-X@=V4?Ue8J+!#ZUOx#my)-a<Q;WORnukH^NfJ(?
z=gt&dGyUY@`%>e0K0$mFS4Iz%lI1m!%-4WVsy`=Uzo=unE1o-)*G9>E>NA|v&JSm;
zKH~?4Am*@ryg)w`5`k|4<WDv*m1ol%^U>go3`)-bQ)}g1yq|0w%CxdaA^|;g?dbkZ
zxzN?-6v#upEdKBeZo_376Xus0E8$Fy;Qw36BgFly`BwaE)rW&WM3YM=!7A&4EEoIT
z-w$rTUQ|h1Bl{#tlV}AX0TGjl1wIomGFY;Cx%eYHGrc*y_zI=6IMRdK1-IG-0S6)~
zGC2w_Ol59obZ9alGB7ncH3~0GWo~D5Xfq%%3NK7$ZfA68ATlvGI5wBj@c}1)w7O+b
zT<x|kjJvxgjk~+MySvjkH16&YT!Op11SdGbgS$&`cY=hEy!)QB&)N6>{i>^b_4K*M
z9P{Z~RZT&nti~W>4l)Hwf*f2KSQwdk0rCo}AbS%B7FGsTprxCgi8Fwek(rqtfr3KJ
z8EE2a4RR1SaRu@MxLmCON@lKqAF&@E%*;Fp6aXop1JL=yXbv#-0w@4oP1L;{fh+)O
zlYazdkc%sWsfo*n8R%eX?Es|t2oVE0dO2HLTDkts!N$PwH`Cu}QAU8QiJ2|P!^PGb
zVB%m7kY!Y01So<$K9tq~YLElK6li5)X8{0N0Mvon01Y(>RW*Q=s*;9(vKkHJM`ATM
zM@NwJ|LH|cO<hBZ9w08Fs4f8jYSIIwG}P4peyRf<KKi$$2Pmq4*#Fk~aQqvtAfYaz
zuA?l$!u0nZ04xA^ptFnh-?IPF8|6o5fPc645o+NKvj3+5fZEE{)sdHp$-~2g(bCPu
zl@a7@$>?bJPk-uG)-C{l50JAh;N$8Hv;+PFjGKe`2b``}z<(w9I~9PuwHeUC1^72e
z67(;l{RfmEK_7b8|8DF92-m+k?f&HsZ~+4UR~ai4mw#gAm6hcI_9oU2u0RJ92eS`H
zR})t^7l83Ux{o)|oa$c<0s&%f&dz^pDEybn`M=BjSL>pnk2}+UxAXBc@%Yb)nK-z)
zc>fP<{`YO0fgD_{U0hxMl@SQAu(kvK?cU|@%&Z;$(J6>1%1BD6sWZrb5YK@@0rY{6
z1EZ^_>p$Lq^NEPd^8&b;IRPv@>;UEul1ez3i-GLzKe~27_zR!7^#@L_AZIV8|C`vh
z4j>N)pZ|x!!rH-q+~P0x=5CHm8V=S@Za^9F|Kt9lLio4N66gwG1^}G^Ku<F(roRRM
z;mcn&%U|^e5Pm+6AV+|OiJc43&)Nd`aY68LF>wb1T%Fy3em?)x@V_Ml7A}CfwVCS&
z)j!q+;h*d>4i+E)&%e|ko&1;S|B!(CpH-##*i&<mgPj+Dz#M3Sz@!Lr{h$Q(|391d
zAGIXi?Ccax?19w(7pDK|Xku?|=k>o`|HDNK__teXMUb<-iQRwLtX(9nJ%Q%R)~;q&
z|AO{kdKp)f5B`fdSlR(U#`2F!<L^q@eQ@{V{IULfd;u6(xH$g9_CZTCTL++v3xJ*d
z9~1Bci2vw+_yhgF{Q{VzB~>(~#OVHS+Wg}u;a~<bw|1}uuySw$Oq`ufybzc_xWLN6
z0q|k@AhtQs^B=MRm>3;Et{)))M>khLfCb1I;qO4XSO82?e^viT+^hg5)&G`wxByHh
z|1EK_0hlbTKX~+C3KnK|0F%{!i|ia9l9!_u(BXf7c<=z2?EfvYd=vxyJK)0za`+$l
zSU3SpuK%vb{2_UO{)hR)-{arW+yEwTp!2`%{~J2xzsJWvd%^r~EdS5B`j4#U>I||4
zYFV3q{HFX57X=enXKPPA<_}V{eCR)3|Mkt_e-)tk_dfoQXi-s+rw;==D=UD3mHT4^
zY#%3o1Pco*m*4-2HT%~Q_s>Fo4E?|4zvl}82=oM+A*?Kd%=kiW(pthR{3VK}E1@ZP
z7|*J41hr)op;j`dzZ2q#=kJmNg^GjP0<$QKLGseP2L7o*4yD=@q1bkRHrrEbrtZvD
zg!fGR75oWNBt*vZG#NF5vlNyCE4xW)j%D+I3U$iZXR|sIJ3aw4#!tj}zW4l&Wu1IS
zzxhh4U)ix<0PRsS&(ezJY=_~wj7HE!xIEnj?)v^4D?Y}gUu1=L&bTlfXIvJ>v9Aa7
zu-ecHLn!BY1{?JcrcP8pod}&-_bBG7iMV<mG#1V<KI9H7mnVV25=sc$6LKDk3}-}t
zN;w}BR4$hLr$1skA;YwZthgg74hpBF6>Ch3U)0*0Alz|Xw+}H-WtB#ML=;hs;w0C6
zH{Al#5F563g}}=UaBRU*=Oi#;W6&#8qFm5PZHv|9FOUx_I+<pOs8PYWeGM%nNZKtx
z8+lfz0<L3-uPV;ILsp@9a$ZM(d($?5XNj3`0vKl(ZlhuFHOz%nvNRXqK7R|N9EAVe
zMk#tq+mD+lRD%BrD_DjqEkBc9T4y~8*1O$?d{}3;fFb6d*K#henhU8Ybt%O?eQGzj
ztCCVL#$pa1o>$JsmTWFdD+}W7wElU})n2rXU^H?^$q;AGyl&=?q26Iu>VwRG^d5wO
ziZ1ICXM^BENs5Uh;YHS>ghJeUo~jUP?s7jhkM{c!i`(}_UeAT*N^c#V5Q=Zu50`NZ
z{Ru*_X*YToU#U)7X#|r}OeJGZxs~^>uITN*j6=ng^~Sxdf@sCIxm;H5F51U1wPYyl
z0SGs%1j7@bBWE6WU%dHPe5Ngb8!&BZ!uXoHn%;FRqf(B40i2kKFe8txdxvXSRa!Ta
z;U~y3z|V0-hbJ^Tf+ZAWgVFz7s6Q$nX`du0>ojM!VGC`#kkm4xL%x$X4Ah;lhc|*R
z?ug<+1>FQiU6&Y~uhGS1P|M9bW4RG_nBk@5t@H#m0W&v6A8~3_g>q$ou42A`^ooVf
zCh!-N6MsH7E7+bUP=r|)&t1%FO_{fnzRP+ERl-t$la-d+m!^zgUkSIMx8QgB@pm(5
zPhpUa-{&u72Kl1BP=)(TE_4tIHd<_F{&-%SenL(q^ETpCM>idYJw<t4TFXB+eX~RB
z-_fw*v`8f{cH!Z6S%4US1LkDhL5=zF+k+7pH~7ys*2pp(*A_xH!gK3It{lQWo9M1C
zIuCV|3TSKeKDcqpT=pWkhg6*Y+`>U?ToFz8tAj_pSDHU$77p%VKh4L<9eBWp^IBNm
zgdW$oJM1SRRp~hjmW|-0@<TfM5otnjmmc5@xiOiH3q?Jyez}T&^Sz8!v+q5OJ}kq^
zWmMV=rpj^k{?|KWr@m_xM+oo&ma)m`kTuT5fE<tdHaq<YbGtzl!Y@CR?pr6XV)<s=
zH@P-~!;UN(d|v9z+_E$5FpNSg5of3?DR_S<x@NjngraktCKgrky-o>&j7Ic}!t0+1
zTJY5|uYw(!ND@tdQ4~%5^CE7zQy@`tell@PH@nhkR194dU!sBs9E-4lw|+O)QI_g2
z;YXkANjbwIv|#s3vu$suhb&Oc>}_WCAdAH`!t|&x7M~Q&N<>_;gmCZ@ul_ue1g>IB
zTI%jtk#B^yjB#nCw+!+W9-}a~))|XE880kIH(2!RkSuS1)Uc(~<dCh1LZ1I=ERV{9
z4NqrLf=kCtW3jo|s*?t3|G7~OZEiM+wlw|fN!s5|EK1BDbH8K{OUxxbKzBXtb&QDv
zdDMHpyZH40`Op5ffnk2q`rv#P4wukEB<!FZ47kJnt|dYu!H(2~ZkpzkV}X;c!oads
z*FFzys{8(b&-ZHf9bm7Sd)!=#2hx?h8_+FcJX%x7N{W*X?AZB>@8kWErpvFk!8`JW
zl;6BoCc*KhDmO6gm_(_>pXNDbvnSO;dN-2x_GqRCcfUC}D(Nz2l#NfCDy?MNNYJhN
z?&jnoJTf6vS!{L2L~r190+*w`Ym&d>yKg4^0*^R<@z5X68#l$&yT;jwCaa;R<Cz5S
z`YkC)5SPsVx-sF*oAhIukT2HIXKn;*$7dVk>UJO=KApifeV~D6{$x(ZQ;SiV1->sT
z(Gcm#Y``+3gE%$oUT3yP4mHq_U9m+#<4b@RiH_H^=Awur5j8<JuAS6lwHl&uc46ml
zjI}0zjcN05QXs~g3_Q=B&)n~vGuMm$2-r%rxpKEQ&I$n{(lRXqB6)HWosd`&WYN3l
z)y^y(W%%t>;aBM?IWYpkJM!o585xjz?=*{2KJ<c*WA$Fai0ghFB5o#Hhoz`TCP=Pe
zqjLO!!mLyle|=38q1k?K(BmA+AwWw{>1QW@wfN2AHr|otTcKJH_D)SF^pzymMj04I
zLL0fNdKzu6RM2Zj2~1ax@1DuKDnHAXn^yL${J5^~u_X)>KD%BvJ*kojRsDShBE?QK
z&5<plq^2oivKJMV@baK`<b3{A^a0u-xIg+~%>9lzleI6!;&M!_)PbgJWCb22cB*xM
zWai7*{Q~9qp9<smv?)TJVKDv^+Db60BU)YOT~VE5_k$O<pqI-u(?NPMsI@LjA+HJI
zenP6MXSKUpMpLG>ikB%yrn5(_KYn*cc!#?aUwu<=@VZ(h`EX<yhp5*M<`&_~x)J?%
zp@t_<&r1VBp5rk|O9RuyiHlT-;}6(>g>^gQr%;#Rys(GCl&SapGIkI1o0f_oMz6=e
zIWuL!YYDjb*d$5GO5(hHGDntHG}7ut#N;f0AU;aW%F{JqUagAKV%Ek*%NDPA%%)P=
z5qz{FXbBNazteMHi4Q>6wbY79m}D-(sV935q{uVnlw1bW?XfmRA~rfk03)D(rWHZ(
z?IkH{K_(7^Dox(hr6xhl-`?n;kO>2bHCOP(_?6Cp%m=1I7u#yCEVkw0HTd38>rlZe
zd(N|p)PQ{x?ek_slNw%4`7bD>(PTYc8ctueqP6ayXPtat&kTQHEV0(oP2La|nL%)k
z?V=1@UWbmOZ2?j#E<}*0UnaSKiDowiTA{R8w49+33@Ccd;l%9{R3e3SkGGFSC@8!_
zur1#fzI9l$FNVJutzD#3u7YpGmz;4cW_dpA`nP}Y&ER%Ac8Ye}dLI@`ZDuWr3aQ5n
z;w8P}85;u-G=EoF%6nSIJIQ^4z>S8zE0;G|i5hf{+-%%TJS-`mTuW(xR9ov@yf-WW
zJLl4w*4(>8>S7TA9xAJKP4Ay#h_eyyV8)nq6lI|x*@h4$&F$qmeKy<C4ZfSN*63+w
zAu~Li)OB4vDClO{_MFZ~rwGMpcbf-}s~t8(*<L|bV$XRz-mx)t=%ehv1mS_P9@w@)
zD6WN+9eJgA^)`Eooj{g<EILXBVjCPD)+2n$IAp6dZ#WxW?9RVNLh-D<)W`oK@(!e=
zWwp(r7XI=@-@rGz?>NvZyQCX?;Q8xBBa1n&>;0VV5_w>V*8CeDW+36)OOCXt(}D4$
z3DVtHZ&)vWzAecZ3D+Tx3wI<6!OVF?YTwrf(RPV)9q|fF<oDcvfc{c<WfXj=0WXyl
zzmRzA7tG<CS?<>Jf-%{7XetK|%r)44JX@YlmM8b_Z7^mUjuOM3oykN|=kj-dW8cCq
zhgA&JPgQlnz1*yt<D8BVyy!;YUGL4Ob~jk!C<;?IDcktig+n_}Mq%J2T1R1L$Js_S
zQe3K}rN*}&5-ZAor<U_#Jc?g7ZhZ&y_&dO9G4k2n%2-Oa(GT7`kO-a)*0j;CA$h-8
z6PgZ92Ez}Dj>MZYQi+g1x8j{Phq|V*#q1%~?EL5nI+y0eX6|WEMRd4wOrJjvI4vJi
z4niSY<RJ2Q0ClME;M3foc~)V^3vgj*sgS4sbfKb2SCmM9Bw#AA4}uzd!#1C5j%tqQ
zK<7(`HXVb}t(hr<9b@YeP!ODjNzSoiOW>ukGbbA1D`>E8aLy?+>aqztb<u{eI2|S9
zN$ks?jQdPks6~T{dq=2jl;8Xt<_Fj1&kK3$x<5||MiPudApNfUIXSqWRHg-%wk=Z*
zxWe!0bRu1U8yYzYNO}d!$xxjE>;nRQO>Lbil=~Mr&Gjg2es=EHO5yL;uJF;JONbp6
z>r58Z4_M}q76^~o<2<canT0m}49lcDB@Bb|(}Ir{GNsi?pwe#jfYan;vKC<rNkg!<
zMdeMeFU}g;Bdv|{LNu&rs0!L(8tC;wwSGH}j%l@jyOhdOYom`A#lAAcV}rz72G0bQ
z1mY;}QWxo>jZBEEKfh-~of|E&m7i@sV1rw*h8Pc4^VH2!Cz(FJhkiDI&U#!56bb4m
z<mVoaI|k-}i5^~lLrp}f^3U`ruq5VERoiK5md-!ZEz!-ZJ~zRlSzY5%+_3!Aq}$25
zsPwXbC#5?G@ojS;>_;-6Z5j!g6K;(hnK<{)F<E~KQ37+bfGN!?(*n_`o?R_X=N%R}
z5^TL-VU+}Uq$$87W|+00ty@p8m?<<FhWSbT2tOk}zvBd$Mn{B)r=9d6F@oX{Da!VW
z_@^RE5R)=|WBl@z>~BsX_CE-U6R9}@8>uCK>Ibqt>LhP$@wm;V#~MwibWQoT3j3n0
zk*TE<dmz;ask33%g^An5b9z^6Ka5L);V<m_7M6@o`6bPQb|N|iSZMHg571Nl_T}vr
zhD=V!=36^u4wpg>*v@E0#Wu3c=t_`u`83M_Z<X<RPHNzE*K~)m_}qQz8(Fpd@i!rV
zRnvFBUd1~^oP>@9I?7Abi{fdxmYlo<((M-cnS|mxW&luxOq1WhVUY=)YDf|Gv;&y2
zW|M1=?H|yB{S4&2@r#yLeL&4-Y8!BGcDB3}8gDsHR84b7rDAnmUI4_QLUpS!p@^oA
zJ?LB&%oHNfYb`lKU#C<@5;@XXJXXMehFXfl7;b@0X(iJYkFKF&Kfn8SIie{StfhBN
z`I;s&tN(uP*~o+o7F61!LR$m)l-?ScB(ex#jltR%Zg|n9eWTq<M##2<*$qv_sk{=e
z!W{;KJbcQLbBLlzTRl9_oqS$BCehNrE5YmACrtX>)&n%r>VtED3V;$)@I=XfWFI(i
zYJzx-8Y`j<>7I5gqG5^hlpQJXZT|wR10QJACQ_3@dOB-ktb6-|2&5OkH-saqWFufw
zl_PF<wIJ{BeWpPw34SzUKV7oO&^2b*>>CuqK>veNwz<OL`9Z?+V)xYZ8}b`0(I@0~
z{!hm?F^a`u7F@;JU)WWdq7GVrPbT|UG0Uf0Z1M;4H{#xwcAS>8tS3d0I$h!9&jzuI
zJ)ybvPJimrV<tzPe8Q#lYCOdf-*^1=TZtn8C>EK8l=wv<&^X0mszZ0ZN4ld*N-DkA
z0s43MwK)GYv|}UGja=DcJ%&7+e90~6w~kTo*VK$kR0#%%c%>2VsvZx2%)O`(_O6Vn
zZi~UUu9bE?7;;DiWb(u+%-3evDz7&vk{`XcIXcXw{WKU$rC$IVM4bDY7bJccZjp+2
z?L&B5r0aqHq_nQGCN8)lbLdj@yct+XT^M&%yqfsyqT8vlF16kHr-Os1i}(9kyww3g
zX}M#;ETU9Ay+6LlZiM%LXo}$wN-nZ;i@oo#UKHn|FLpT~PoDR^0k+8oGdK9!4a^?M
z?m>XhHyNCwWC)Isk*#LxM_1U;g*;@Pvy|)NExsjYePhP){&K{^>5n$m9^V^g0>yNm
zuR1BKFD_$y@%AEbM;}7^<`{au&n*fwKIQo#<c+w8zmkqzqu<+qtJMriNOe05d}n}L
zl-n90hlZ6=3P5WDA1$;b@b3S;wD%k^<{zg09=Dl=-hEa&SzB#=lI~=e2hCt-G534{
zZc(#;ZM%Ox)@KFoB*4eqZY0u?FP%V^JIasb9#8ckct@J`@U=mw4w9IL@*F8MiA6bN
z&9&;c2+w(=O0rFVu>iyq&jt><m8KyWI6hIwHd-E8Hwx^?SHbcOqR3CDFKOGtr)G)F
z_!Dg_GP?$TO@g=dyBN?D!&AdHvEb4U8j;9X<nYygX-xGY6v&dd2#!`_3};|!lfymd
zJOMi0O$fKrM~C?6tLltIZ37o!)<FSaClf{pp>p3gBc{!Nva)ewwWDi}7P5Zqt>|0(
z^uCShJ|Gk~qG^%`cEI5$V<v}uCaxPOrmlCCYJ-#ME%P}qF+Qsm`WbLXSdv!GRiVvO
z5OlDw&9N#NG!kkZc&3kI8hXd^odkv?3=O=c7-BEq4;3KG2hTf<B4I_s^JFxyB$1DK
z7utygo7Y``9SHF{#BOjaTdCFmphSCOJ7mRbFwJhV%Ur%Tx}zHt)nE?kQ0PQ7UKVWe
zNMp2dzj<4`BG42fpm0PMZfRG`fY<F0yVY2YIGn}a6vdnlf%%L=&pGqmf5Is4305Uj
zgYq$=nfdDzYtiwaibgWaE$LG1x>_NAB1FrG!SV}#Q+ai8v4VozfLUSg&{&JKp%|5v
zh}qtmxL1$BEE1wcaqo!&<!L>Nj_jOuCLP~cIaD%Yld<`Cj(d^p7mb!E=hGmBr?lSj
z184%<g`UrGrgMSAq1jt7GIVF2qs|oxYc=q6t?;kcvv*7&;(*F+!4m%Z?cTYK+!pyV
zSrsaO5q4t-m;C99n!_-o>!UZxJEGZ_EW+-szMs-(LkW@Z`^BO1h`;MtK>*^&JmIA(
zpb|g%@%My@*VWRm&sqF}W@Uq`qp*9;<KA4D$|@BzD{fQCmg7m6=o_zVP%R>*7q(dJ
zPeap*KXi6=W~u4E#%z?In?VA<zM4rFj=+z9l`~7_WcNny94QqwC?fK<*(gJmaOkxU
z9U9jzCuJ(0>u__fr%3Ng(8xV6QC#(P64_c)5xvf%uLh7NOZwFW!^F22%cl$LPpNN)
ze0iso<xhC@vXicU$31rcw#nD0R|4^H{asGt3)m1u2^S{&&)!cjj^6!7zPW>!CFnVS
zO@Az9n7_E3-mUAx)NF!6dcIk4e|a43@CK%+OY~y=D!icN=5I1|Nv>NCmOH9qCyBGA
zI1(;N`N3Tos2V1fG*FHAy;KF=4}msq;x(`|J58x^;+y?q%@1N%xD#5^N?&8T?fPPY
z9DR`TpjTCashiO~YzgQxeNxMAf~L%WSYyat9$2As$r+r5e3w$Q!2ve^UNkY)TEr5~
zXT`YI$er@tDaWdxz=Gme7~brjP-w=Wqa<Ku5Mfja(NK#bdv(9gq2i!|vbLbwU;w?$
zw5>IaGs{^5P_1AC7K0{l2Pbgs>)r>%`ZN4gXJL&ws)w2C1r{;hgxB2Y>EO|Sk~<a@
zE~i8tN$&=ELmPUTJ{A9JqwbhFfoGH8sZ7Va9Z|4<Lu~F(A-R9#NJTS)rLa&@i-yY6
z3oiV08CYGK-bu=L029^$*6PP;gR*H~oLsC!ey+o#!$@ndt$!{W&B!i(8ewhyIs33C
zKQfr>zU=X2NSZ$++nx^+@iAzBqXByKT`2BeoSp`?s_>~4F)0a+Z!`IDE2U(%PH!st
zgxW#hvbUk&5;EG7<ht<4ZYD!X#8{iwPC4yNxv%ToVXiFy$S$rSrvma1d3sz2XfXD-
zjc|EcCZ|w3`?qFd5F-Y#xn5t5sE24{sP>+HP}?nau|m=DVY9-T8$>#PmGLme1l`a_
zE(T?6S1KTg_hNDyXpbJ{yS6=Cd&?Z2{>eiQj_#1BiTV!I%~T&DO3!~=Gf>b2bA1@G
zc}Hu4;zn<Sa?Uu_&k)|k^!xLqKa7}OV+sUoV1Y$KAMk~z?MlaX6Iq!`mS}p*nN0O7
z#^#srx(q^M{&W?BDne9$Y?DO_-)gN3owTKhHtAU@o*j7jEqNlxu5^M_TN#1^ElGIi
z)A?ZMDcPSw5kbqI^HwV-#o3PVnxa^+akAzWMm#QCm+xi7S#gU>cmzXB90m%yWou@C
zN?gZxW*zM09RvD*?r5Dw8s>u`I>?;FV9Ceh5b0nMXiv~elEyQCnUjFuH}dbC^LqU*
zUXDwoaQ#HSqbTTF=w-VV4%5y$4U%~#VKVBn$~9U?T=kg{OTvyL*?-rfjpWu4aI9x2
zyi2E=xVp{S9+j`lg$77lq20+#f%m!i`?}rZ6B*FHrrRR*%|x2)Kl!dLf36<h2!#Lq
zH7N10^|vXhDChluBC;&q1Z&v$LMOnms^~bQ0Ng!fO>KK5P=j+u@o`NP@j3AvDCd^O
zJK+8LG(LaB)cEpHzYwI{@zYrtM*{|Q+t79b8Th`KZ1O}{7i;McYj^on)vClkXbG?9
zvmE5<5O-K36A_Tv!^e$ly99vuT1jMmTPggpP%;W<*6YB3<(4*q`7BneP42G>);<9>
zM@x2OC8BH9>3Y0TI~Td;jVKeh));SRC1^JhRee)X8EO-0a>QA3u%t3;4z3m1QN%5r
zNXqB3pJ%sfWZ&Ny4UMSWB{>nYvBWxZV$piIW}jJVmDNqdiBpPe`(^Pv&<i~ZGbs_j
ztMJtX@H<9-I#+6D|62ldULfL=J*z#-y3qMoijB^Tnl{Ug)^`}sYwePD&VHb+PUVa1
z?_VfZ$Wic+5-}ayv~7{Ukcz+YQjVoF3!r2K)x{l@q$F|cYM-nze}6A3`*b6K`BryG
zDH<jNUY}qeyncGd=dX>q6ar`3KP)r_#U3uGD<NEeq<<^5I&UJBSbHFc{y+=)d-o{~
z9Xv??A_33cDE8^BKA$1?9G}9)XSwmucSoH4sT~ZEXv)TZP2!G6wxGJ&Hrsa?L|W3i
z$?(ZloE5Z7Xd5fdE+1_+rSzpJ@Wu;2Z3c7HI35`aV3PZ)P`pSQVik=#rw8{hA2lph
zY8|G3g~25Y>$T<QOr%!^(oes7JFW-w=;V`fZo4BWVfhVVl0+(Ct}d}7?O#lGf5FXh
zxBx<Z?1&q`?nnZLbpe&Y(zUfC5XXTk8s3e>EwAVlsS>O2<TsN`+9e<`%E8e-r?CH5
z<;G(ZaK4ZbI^E4|-T(W_aZBZcz_+^gl{VjhVX>bUT=fF_KP6A<1i_G!B<?vOk#}#Z
z=}5o4Vzn9OUT8DGP$qB1k@9a~w>5-SCNn1jXWVtJc=*^4=??;-=u1Ny$nrJ2gm_YD
zKRGB2wPLGAeo8H|E$%$eR~lp|Y7SvJcrE!<{HLGXDXa>lfaTF}Il}1+f<`<H7y3kh
zv+vc!qPjWKc+9!CgHrE*PI-p#uKJ)2=cjME1X0_A7{C7R5;{7&K|-iVxgnt!BZ0sz
zQ6i=S!}^3?(Mp9dSo-*rg-BiO1u#YZ1@p*C3^G+Z({RPGZEp{HO-P2H>auqJ?&%An
zMa+yD`c_8rY>iT??N~<uh0Ak74qxSeOQDvhYcNy3mFnr%$TwRR=!u|A{mErTn=EoV
zsOr;MXX7iKE36K?l%@7S*#H@!5?%I>gBvi1`T>TUv@<x_6VU=nIVCVR3De+~^;y%w
zF@fS>1nQsT3M?c02W#5;46|SKA)!aDy0xR*Rcqal-r&H_87qnJruUW>$cJ%%R-2L*
zo=Z!u8ntx=jA5);Nw0hwu3VxwFqe%(>1uzR>XQTvh4tF${*oF^L|gb|4<i_M*e!?l
zww|p4ZBxz0?s8$hxr3F4jT<dVDfs@fi*zM1b4@)aiGSt!eMQ^!CQ|9Wz?brCURgDD
z={v(<!}M!Qk`m0f>lfJu(?DZ?VllWEw!@lkMXHBd{EJvO=SrI{;V&z_M?l^%h7oma
z#lCNdEK!yomxk#zWOvAW3|#=<vPWvBE}l@*dxoX?>x|B2*9~zRrj(p4Upx9=QD`%P
zB3gv8o@W?Gm5QChcXLczn}=t@`JrWmb#T&Jw<9>eahKn|UO$4*@F;J8k1<qwM7S7@
z$Wg{3HRGP$wnbVv?KHp<RG3QcgbjLB%(6#4oQbg_lZU&Ln<AUpE-cB3)^kUlfV`bv
zObM2A4l6CSqZBd*yK^0WHR|Vq!DV|8*!|FyAux&6ufr93s?r5{1V|Fn94N+^*&u3F
zZQAW;wW_ag1)^l7L+TuVZcFYa247vxJT5@%iP{pK2OCtIoBhBN(kpj?@aaw2C&So&
z#ce8N_V_G;oGneAGkoptDiUk3PvxXqIfo0TQw5}Ei8dHEkCv=EJ}L0`Dy;X_XY`vx
z^5I>tGOlqym?$~e7xRcM6#w$7u(I1avPDFW#@rI$)nV43&1>O*Y@kGML7SegnTwWF
zW!&ai!{}GdkYzVwhT*$kGs4z2+)>1j&!vu+*cykV{0L30X_Wq*xD|4WeeV+%9~+U_
z$y4E<cXYfE<GK;K#`P8a0^{Kty=K!vnw$)u)nAubzYkEP-Ec?F#)8g?r+};pac5h?
zd_Va{lHg@ksCQL=D3M|=WPaAud^$f1kE#e~8)c>ob{F6elDKsk+}zn09m9{67<dJ^
z=JmS(gs;m2oJH6z;S@i$JJEBmxS|S@jK<V_Q$E`CU^MzM5lK?-_={r!11ZrYLNN1<
zecg^a{!xCaL<YTj`W@%bHK}u!L%LC6q<=zHgVlTN;+boIsypnO;54<qkOW}cD4!bl
zD0vGCmd?Pv?$|qG%BiQ03d?sxDDH_{PhwsUzQV*{%-yHy;Lwx96NUm8RVe4|%=G3E
z&yK8T`i9;kIh`rg%+4(%ud!N$0#PgSPv$aD#bYW$ejCKRP^2J{mt2nEab2|j3<A4<
zuWEA~y829iYTm*2C$o!4-ErZtqF5h9^5W7f+hv|Ut<QI_pkKRen8kfv^^iI35MLa3
zQlzs!Pn+*!|BS2pJ}(^?*H5IB!MFopDj}6ClWhi*W-1kUs|f#nPML~vWCkOrZ4#$F
z3Cnh~pRy5$c+9Gktj8Vms3$78^<6UXTLJ7zqGeNm(Gt>9<uGl=t;#a_lReu+RF~t1
z$Q^q(IXkiz>XGmc7B)m5NsNXEf6>s4rzo2E0X-ehXL!aTygZ^l{r4~`$5Kj5fh#@!
z;r%LKC>l7$smU%6e^3k5tjkEg!lOwm#+zElG{C0LH-};+R{|VCA|_Kjbry!9VEMsH
z0p6y6KuQOG)EB}8<b!I%JZIY&c9^RF77i(KZJ!nmozKl-Y^cR+nA4nWqHd(S5+~~=
zCS(Dl%BpU9PXkfX63XRWrcBw`VI2+<$p#OjMm61_ALKk<j<$`Ovqv5~t|_2|H0$S9
zKh~Z$>@~GrytRBI`Rsz?J**I#Y2^i3C-&!m`VvL?NGUg!_bZ_w0tI&TkPb)!XvT(%
zYV8jfJr1he)0DF*85i`6923=_f{_h**d!Z2C=nc(BB~W!Fudf+F7R>EkG3y{&pAjX
zCf}$FSn_RVKUC5|=!@4lxudg(&UbEYv6CtW=v{J+mXVG6fAVWz%C(>X#+Wo|bE-do
zB~Bkw9D$*2OdNrw1|GMFJTQKzUi~T_5Rk06eq}iF^M#%gtD6a8cuOW|9YNw-bzi&{
zu=9dmc}-+iznFNgxSBvOzctpzdB`AX1$Vcz?P^qy;9G%7Y?wx8WNP{HWy5orr|>q`
z)%z6#nDT*iwv5&tUX&rw{Vh5)X-LR_QMv+-Y%*)?H||}S-cjtkYlK1AMtO_P5PPmY
zJbqRIb*PI6){l1_98M7GcUZ*O3xl{hvUBsL1Wg3<y>|ZnVMx$bRb`UXNO&ZOW{Rgt
z4}&!(cYQYCPm??FV%9YriSH?Joyjh6a<GDS%-gRUIgAgrKvzL~^Dc;KD@7ZBoN-WS
zin!NWg1vIhw_p@@;AF+C!{_ZxqU3xtXAKL@Rg6C!OUb>pFSmGqTeE{CNqLaT_OV!%
zkVHc`eSP_Hl|qJ;>m{Kl<y~x}5Nqbs=ej#%AJ=D*-x@Jcm{;lrap*lGSC#>;E}bJ!
z>C+N9bL&t<TYln%-aAX(wCo{&HX9JWTdEenu()UImx~~4@N5j$pi?npPz2okV|%PP
zX!R(#PQP|jZnHCr0Oug!#AA|i<PTk<-ufcM@XbESThM1)g-0edF(jA3QcC<l$hgwp
zbS&xv#r#5beH^3H$8kJ=6VoE%bk73nSfNTZ-a%{UVWX?h`8TXmSa@E4zzXic$Bs^Y
z=~iEYt^GtXfq>2k4V>9Y0!ztPPDRUKTQu#p!mz-s<xi(qmP;Ujwl=`yGkZRPj{gcK
zz!z)3t~0bM&|Ys=_Cxwdm^&Ok{)iX}VHPM6t%fRf(Q@urs+Sz&ZutJHATOe4jI47~
z@bx+iOY9bOkLdLgnT3>pUn=FVqzDJA^Y@zBUzGydEXz%QuBj;U%k3cIt55+q+#?#)
zZLKK|vs;DGaV3V@_t{(uLp8GH4HS3aSdpKv9X&bW2~3S|a94;G3vXIpB6hc-hU;i%
z$QFWb8uGvo3D>Eoy(SR^Q8+><z9KJB)IV<Tzj2(mIUQXGGJW!Y1qSJS{dq(>kh$zW
zXZmc%fEvNT)yins2^EN921d=|3;M&$@C{{@T3rNd&Cz;^%TW6JWD-(Zn%T^E+O#%u
zNob*ST#k{hqo0#?+`Zp(g>5+Q<ZVT0yN6l3${E&x<*$L(^D_^{(jx8Pz0_djKD{lM
zWX4wYoEpP;RVtf*<)ZjYPDpzlL~QH~L0Z8KqPOgAUP72JmT5os$#du-{vVGo7lY&w
zF0REynZHshT^ClBu;WbS$+=qNPT%)=Kkv(gu3;MQ0m7N+OSdV)AmdaKwpZ;S2sxMP
zwgef;(41H?y;<bcj_S{>%Hplj_Z%>`8K?Yn)`#gcIwXI8N_eL_H6tG+(|{|HM7KYc
z%^Mnx(%uqsC?u=f(D3N$9hiWhA%w`-T!p2HxuBK@Ij3Cy9?5J~7!-;3So<VOpc!LB
zf-z$Np+@p_5WC1&!ipr&S=kn!1-oYNv52AI)+V10Rc-8T>2W0lYT_Ux2Z^H44rvpo
zBx%|c5X#ekIi_0kfK*b>a!3Xzv6xYygEffZ_n(v!xtoRU7HFnq3KN)T0~5vq1w7;p
ziNQC+_Be}ir@IGdkIsCIwjqpVw+*WI#=csYY|LnKrVa<yGi!Te5Cbb50d{!WGF)JT
zxoGg8Yn_zL3S}#zwSsO|#Wi1Z@w9t9>d4(hgZ>DARWcH)E@Ae-_*AH8Ehyg`Ba}nh
z4#CSVOb?UwV-nHl2y}1vqRC+-6+Cg^ey4WK;Wi)Rkt$_dutkr39lS~->CzgAV4qw2
zq85UX=xS8n3b+yXR-4h;$nA4o@g#E4{{<9b3q*%5b62^>3s$n5hJe3pLBbmiEFbd)
zOQ$q{+=!j344^ne-m;B;7=~h8tk`whVgu-4;F*u|=7oEH5Af)E`Vj~*H9VTcP_w7y
zbBHRS;N+Bz9;^v7nqYhZy>)w3I1Rdtjzse!4#%wd#ysle7dAh*dn^KBM-l4llI3u+
zgl~F?2`+?dS~tuNIP>07<kOFhJ<6rFbdwH$$~ii!;a)ML2PI2G8)be0`<DK7g0;&Z
zHH+f5ja6IA9h&KmB5$%43g3BaNt0M(bX%}f+lL*2BN|w<c6=!?to4A1Z1@P_*o3V3
zRw?>fSZC1nfiO1?Y3Up~;eBjnRg^WX&<^S=^2^#Ev&Qy(N99yE9q=NmNW4Ir*qo++
zT<CP*NlQ^Cn=eRC(0N0y+wMMfQ(+K)ycQWYCX9%Dw{d_tGn1$hGvrr&HJJ!o+@wy4
zSyQ*3@6P6o5SY|(Y0Eg@+I=<IeN5aFTz#^Rp&7RL1T<mYx!sY+uVUq4(mJ(y#<PW2
z<YX~e#DSziA{wExE`zBvtMzIw`5*CrYAOytF&A0pk;e2$o*FhnX;_xNoZZU3-Vs9#
zUy{9-$A;wA%%WySaf!nj;W~)zM8wC%Gg#SNIWI_+)OZs~_$lmQp$&l#!UguiuW<MZ
zs7>9Y8n1X!J`xZ(%7GsjWc!nR;&Xsz#7=7#<w<cr9oy*P3z0b3Qt>63=$PAow*p@y
z*-B{Ab$MVis9(t~(?!oC4X%G9QC>cZ_u(Iwfz*^Ya4`Cf<Ptp6Q>f={9!mlf5O47G
zZP>QwEF?z)3^T4{7Z%+xN(zHN)V!Uu3zH`35S_r?>eSH11wkoxvzC)O^=Zb8A=&E|
zf`yY9vM2FT25K1178E6uq&1Fz)4b(DtlALW1pu<NG<}VhG#HQnjb1S(M++Y+GTI=c
z65)CD<J-XO%FXROQ$NilZQ{GqFOGqIo495#nQ;8Tg0$WNdj*a<r2sg$`7)Q(qQ!8k
znG9l?#8k(d{VRKCEJ$b}fc8<O_K9f5LXe3?Iq{Q*$(Ho$;Ey$3+S2-ePnHj_BFBov
z6)g>EACIV1rtWkB#w?gL=1F*bQ6&%5pS3r9zAt@C)2xzzS|aWLnX&*~DuX5ko{)h_
zg#u>$hiqpxoi_Oh2$nW<qhl2&ib%)3UfoRI9o4DTmE{@CQ3)s2dR)A-Fz{#P#_Nj^
zIPYn_Mb(57=w{)WMOT)8D9hM#HbQpe+?ydM68CMc7GI&L9sb%LSRzi|Mi{^4pkT>>
z2_x)h{lK<A+?svt|I9{KC#5BeKFB;oyJ0u<;s?*@@jEm=vRM)VD#|99pMwS(p~AR*
zg*8MV<h4Op%iv(`xx1zBclkpnz_d5GfAl3Ew-ToBjH#Z`#wdD!4XQ&`;cQRRrOTc3
zct6NDln+__)Hm6rMDY{T_25MFk)o-NSbl3Bu^Nwu0+^`VfHM@k9UO}jZ}*U>j*H6>
z#*q(|Kuff2$Tbg?#C51v`qQm_d-%{0UZvYURj=Yaxa}7eSnVSVoIlKDKc8;)0J`W3
zV6XCzgpOvPY&?{IIH{a13zrAH*w?F=VO(S>OxH3-f(Dk4^xR(>z=W?>H}|W%I>ng%
zeRYZ04j8;+$@)K=HJMYw)r1kStoJrq$u&9s3`F1xfsx3DU=pFa*#)>a`trWUXwdas
zJxLVK%V=SF3T8J5l<xDsT-OKl*x+78KtSzod~QD-75@@{$BS|PFeOLrm5{s<5A4vG
zLd>wmkvR)s7`!H4a=L6dSIH$+Ek}ozdh<}zbWAWn#8mVC{3rxE<Yr~3!EKE=`No4V
z(T|$@yLCK(7*~!lB~?hBh%a=WGnR8>*zOcwZJldbV#aYIeY!Yi0A7yBs;?yatDa9i
z<kBB+acNM0{^s+|Z`CY6iqKnIFsd{^Tdu}nfAe>w3RCR8oEHoAHLui-Yg>fH6S=jB
z9keBfXcy5K3;WxzLkdx9O}F*W(R2LJ>B9slVUFG8C|S`*T&){N8Qf4MRL^+(!|u|L
z@aJF3C&L)|YbEFIf;kLR{P0?UQFjfSJ-TGDB>T93$`~P*`IXKo`Y9<@70I06$-w)+
z#jh}bStlT553a}=g-fUVv7}V+@<N2`eXh)u2d!W=p15gdmk-)N*Fu7|`NfMxGU`k8
zVlggpaQ{6Fz7-DK`Q__NBji<cwCsA8tmaTQCRsYOpHhR4P8)`OqS3?Ez$KzZel}2z
z0a|5$<Bd>U-*&5*dkI0q$lb?_Tq)<%vN8~uxAY|4U$!kGiG?8bRJ_8$J?_$(;amJE
ziAKENUiYA;gsTDF)dGzMnn3Q)x2#eKX$ag>%Zf`IUWL`Vf=ENB-}z|JrVpc#n$~C~
z`e_31_qf7^Xv-NC`H@6{%Jd=JV6xZBZV94)m*24(W9@Hxcnl%ul-w5x4~|kvO<bf(
zV@y};l+v!fsE1h?j0IVXFcuwtG-uDp;-03Ae2uq_C{JK+4dl7Af1K+_CRodp382fC
zI#M|PN^r9m=B0Iq&MCJ5^-L%z$h(QUp%xu2s2%O0;v(acz5tzWQN3#KdooIszCJ~N
zo^V1UTF|tfHe>DyO_Ln0RMvr5U9M@ptg#fr_!~j1H5sw5X7{#9|90?*&LMFgrNz#)
zsXLC$01tnHv_;X%KUpqvwP==|WmEhUGFHu^9iKj9p3mM4;vghi1i^|oOIoheY2a#D
zdnJ<n53b<_Rmy|Hgm!~M_jh8=8MsP+BkkzbeJrD5yCMtlN~A#56kTrM{AVj?@a&B_
z4tW(@XsLcJcYSH_7x!!Ip-vXev~<BqHAbvtEp&0&AGRd%hTZ)lc5NJi);JB~=(xuD
zl69&+NGO6;0)g%R9Cb8M=IGwFtKy09?44-t2#^oP$z5oD)7bshc9!=mzbA};sXYff
zz6yJY4}|7b5C0I^sU-4kt9iq_%rERZqFyY4H(}w}2r=U$EhlpvO{vdEwW!H2Fh3;A
zhR#6bQiuNJ=&fPblPkhrKrg}nt=}K)wf%C8fs(@d2b+USD*0;0uauRYKXI*)UOpy7
z8}}|eq%K{RW$f+~ltoNjhxomJ$)DSti+rwF6?1CQ-G`m!FX$a_3n94z{658bZTfUB
zPfRQ9N$nA95Vi=4Hen1zk$Z)Uh(YUm|E$x;*HaM2szr~7Z5<ph4vYsPHvGski?j4r
z>Iday;@$+Ywl$s(Ar$u4;N;zkS}d2*C-#fLy`u7hqmb135mgAoBR5BX0oqBDLRW~3
zx|GayP?qaWjwqOyk}n4KFAL$mev^D%d$g|jN<Y0mSpVh(xa!@R9VMqN_A=i>Jb5O5
zEwUhjCuU_30(W_Es~H&<qT=w5>&A<7Z_!zhg+=hLpQ6-74=hQ;!}<*Fl}VHlquU{i
zJCv7-l-P9ItW<_)5qlbcC7Nmg4fXPyXYD!Vl*8-o!4ZA<7iYac9;)>7FZ&a15)tjj
z@osf^ch~BlnfM}3_U9P(m7J-8p0!$yODG2x@nVk7fOXW-p!IQM?E^ir_cs759_DO#
zNooi~D(~TfA`Qu!&nZFoc`lF9XW|vZi7(=;l%PaoRBpJ7_yc5reWy9g*4ff7BvoHn
ztpI+i?TkQ2^%DFfj8jxuup;lG{qDiRWG|T0>7~l;YpLbg*VeV{*u;WNdbpI3_deci
zF?U#2VnKN{=xnsaU_QuolTLtusX5z8*K)$na#)isu@(4U2FqhNga}Y<i=3l#zHjN$
zr>ipbGk3P_s#0QqwH4_}oNAWvgGBVDh!$10Lw0$jP6wbmY}{4T{mGMULL1W5*M70v
zkuL_rU1Z)T+uJK~rlY(R*Sy-Ww`rYer#7jExtDQ!A^@$EgzB*uW=B|{s+nw1fxIeU
z+2SkPwq8_~TIR_$jZGHs15r7BF_$~GOmZfXW44HPaH|4;mwohp4Q3cj7Ww9OHB|kz
z2P!O@e7i@wd0=I(xwG4blhlTOAs?QPvV#%d_W9oC`BK}NTKlI#hS0O`#rOe-`Z>fi
z-LFxaRUEJnKyaicr4ie>OISRrBY#~r+}8HJS=>?0fdW@l&Oq?9##JKE%L=C6oGzdz
zr}<MOd)cRdem?dPzPXkjO%g=VJCE9QavJ68sQJ{y!rN!Xw_ox`!`Y0JJ+ro%A-NYx
zlaf?=J_|^yK`K9dpqNc**{E%COA)IqQ1<VG4d$Fr_~QGX_c{-e8yT6EZ+^<GzhNpD
zDxZ^8E1TfiS?u>};;0#7-(NYka@3(h&XckUt$)>jI>p2^=Y%d&tO@EGHc4CY`3~wK
zhtU2E3hj=r<Ug!{84`SzKL$loMLd=kz{+gU{kTjkEdi%{5`MGx{`NEq?zoNhC!VF`
zjbq&P619NezR1;b#S86HvY+~P$`21a62sqbM__#oK56&K@ZuDS^&*-{cn|UDj36_#
zsGwed;B?0$gBzW?vKAk2!D!xWw<UYO+jHy&A}Q4azC~>=<t?}P`d#HdgNm}DgxV<g
zf`RG{(SQx@7LjGNOGV=sK`zLDGV!~)9X$T%J6ImJy#REE^g*<PZ>VxAHF0e70Y<W}
zU>je4RXnif=gkszGvVL_APhB^Kwn#Po;bdLm3do9g4CL+-5YtygX>8tMe)~lu=!_b
z{Gg0e(&G1DI|Z5>R~Y{E5#=?(n>%gDMr@)<(|#qRlfNz-q&$J)-J4k=GOt$;sPa|c
zhz(WPavWKsrx1Or6u+-cJy_>d6U>A-I;xOC3pgY&-1d4fbg^5NGPoTZ_N71pVApVe
zxdU?sA}NJ9fSw)g3EHyBD(hA`*5d&$=Pb5E7tOugnS|r6Vx(VZhzNdLAM-c|bI0ha
zQ{7LcZM_`ky}>&Tj@38OwOAyZJrCD-&*?R;aN*54)ND@0ZtOhx5^|?G2cc*h!e(dB
zwD#1gnpPrQJRdB4{^Heb`&~iQ-k8mQ+GZN@c#^+vPPx9Gct~FE^JL)3t(Wz#HKdf>
zdlSwJGfmCZPVD{#3C%mV?rUZ1g=cxbSNL5rRY?Exx~WCQGNG$z6;Z67Y=%KwpVC^a
z+@BhCzjURN=aX%T;OYp8^bzY0ejfNr=gb4quyoFaFGvBuhZg)~muGMx6%JE>ek>7>
zxS$>(?G@)wV?SG%fmv~2>Tqxx<yT$-sKefEWdyYUAAghSATts~UVNCpd*!N4eTAG=
zSDg#6Wdj5aF2NlF1b24{8r<DC1PShZcyM=j!UlpnY~0=5-QDe;hdX+7KlS_i0adGJ
z&7T`+IZ{`JQQ)~May`xx>uNtXLj<Uk_H=tE1$=8#gEoD(YDRX{Ao-}WZl^GwH;#a!
zTUz#iwQU8`YaZI8iT%_KCSK+=f=w5|!tM;7)yXV-1}^`z<!XvP<3Y?pJI#fI$>2>n
zw7#%(bQAbXUaTpw9)KMaZyT$VDE?{&MlF1Vl&zJ82p=>+A4tdvP<AH_$l#Lv*QzhA
zdQu>r_qX^E-R{n%Q@qv={8K~}Zs_5EW?Q*#poXF>x=q`z^`M8Z6rV_H(>ejlon^qd
z#ro!=Slxbak*bZEHUIE&1NU+U=sMV|xE0w3$yD3y$G0#BAv5cPrInZ|ChI*XS)0t0
zuFh@4zmmcs4~y_PFXYi;_qG}ZyiJ;x#iOBg>@7(`=Vr`#_byHxzLKIUHHtw5d3VRu
z1K@f5sNt+?74|tEH{1DdLlXdrU_&^2bxT3lS&3TajdcWS0OvQzkQ+m^!wv~0&*j(_
zr+-?d@rqN~^)3kCx}T=74M}kwH1OrC!jpjoynC)t(el?}UD+XuCI*S9W?{Y~4yAfC
z{QJkb79vdRQ%GP`W8RBIADk$RcOQEIYpffik|<qSmDqNOdTbCS;%7iPl&SRjh@44z
zPyW`f-!f1@gV^dQG)^3szSfmdYDMQ(KOHAEz%DfF^m-ODFHB$xpL)GPYMw}lU1_@2
zoNU~J;-*Jn*g@**p%K<i)8!iWWa%(w0_zfPw^#kaBgPTNtnLwxW7c5t`b5J@*CU2Y
zglxzM+5KBqXC)+@G7e1i2ou;chS9$6<-do#RMTQ-*I+w7APF~gOYD#_t=p;6ntqeZ
zl)70q!VAYEY60x?r=gZvF8RIac-P^Y_eyn@AB8lY%$lOBxgDy4b&8H0Bgh^c#|dvF
z#H)TNn8>oV9WFDl#cn2jxb4FJlVmPM`D51=4l3epo=nCL4+c2;&9W1!0$w-*hMHUF
zhA;)UmbA<nj!%(;+vDj1>>ICEk%-cb8a#tY!gj9`MlTHKl-fQoy3C$gr4!n0x&@X<
zt;e&cq|5TwR0*Z)2UIZO`h=YAT$c;(*0$X$Jz*blvK#6#4WG~12Xq5#@D4r!^0(_y
zRo28mMpz~HT!7Xx!@h6!GiHO<%eIkPug;U<DiRYaGnsnOLP*+9(tY5ndeU^-Y1f{4
zwWwgb2>oX^l67p&{q^dWMdg2cV~>izbkBa>_jPL%y~GGS`_C@4J{dkuHOP!JLQbCM
ztrchv$A*<6L5SWJJSwfa$?3Ow7K^ul9(-KK6YSO+IdD=l1s8o(`znok%&_eg=x|dv
z1R5E>EBic%VmtR@{DXJUlu?tc>M!o%czSZq?DbksYj;4vkt73EU@g;tS*rksGG@iV
z>J&TL<fu_3y#h4q?K#W%-r*=}@8}Z$><b=zvxO-J+@tqAzp0y_CYsWlX-}0J_w^We
zRKSqr4iN2KtVnjS_k3AGN_Z*%v`ks(uBA33?)g|hr^a!=y<n0P3KxLpr5&Tw(aKD*
z?MvZ@D|4e9S~Sgmxu9^9q2C)P*CmUqZbtnUj+6AGu7ey>W@J9YuZ9wd&yfl>mr3yC
z(YQrg>BBYi)XYdm#M+LkX!)`vFA9xnr=?EJ2GBV#z8hd`tXp4R(!%eqD090kc65qS
z7b^vG<3f#35RWiM4)i+AOXx8eio2$uS1;TyBAoL#ErW+Twq}ZtI!tE$jh4t8@T6Ei
z66{k;lH;87nL(aFXO!iGn4evYugRPR<u(h*iCfb9{?~@u&)%q`ln~ZPl4H4D6_*$Z
z;OOWJ2E^ZWI7+FrW_m3{uxv@rPUq|e3w$dXd;&N84oMqQ1jm|S3M6O#iE7gLSB|}^
zvddZ{=Z!l|<%67v+tHNhXWMe_EYWVe#-g<w=NZx^p}@9vmMbfatq<Q$G_b)e$m;^A
zgdQqElS3u&rpA^0?ifjfwT9Rj1gY-<3<ryMhj0&$jCsy2R9J15Pcv<~bt20(+M-cR
z0|l8B=2hFTX0^QhPNZhW%ZIqdSrPHGTrSThnCmjYLaI{9!fvkXyPOHkTNV+<$5!7@
zN&oWlM}sysH!NXT8-*#w27?(2Nf&At5Aln=eAm>sf3s^-uM$(zY?{xI5I$sJejkl%
zcI3IjxaMD26=y3MRNY&q<J4|3k7|n-#YYY{J*l7_H(utSIdu{VnK(k4|A6vw%sQ3@
zQs(S6TCr_?<NdaN#p(_8hJI%*Q+T?KC5qF=aE<ezu=TBvT#$o4a>pA-X!(7E^j6Ti
zJ|vV$t+OC)U}71e=!}*=vUCziv`zab{>u6!5c(EW3&S4y>0&T1+fHS@X7e160$V^>
zp6#pZ#gs-NrU_C^S4DF8egg(xL63UO)5;}V_T$Hw87ziVN=+SspfPSE@WFhj8a9&1
zNX7XVFhXxpLC;NE<P2L3%8*(8h4?XwfsM9Z%rJ%or%G?!H{34g0iJ4L;v$#Zo@uoa
zFUuWST#aTZglIrK%SZ%?;KV#LMNp+C%BGZYeGbBYen{y|LTs|kIzN_JB;Pl#O~+uT
zVz2#4+1*-Da!k>7I`dsiUgdLrM&+qt9a3jYbrpH*cHfc$v_}9BegJ3zs$RTeq`UYN
z%G~nDj%s}N4u>eqpByrPO~xfaajM7T>C1ZR2u@uKmB~+Rqtueo@8-L|oz58F)tQoy
z4}?4yQQ1W=D3=sQS~-S_y=1yrlA9@8gAR~}|0tv*%X<Hu5Tdinh@~B9JwyCK(iWCk
zixnUA4_4MeHPpRMg^}Q#&hJ%>kj|}A9$|GM;l1Y#CS~9(51GRdFa$aK!mbUDK9Uq8
z&D^pUR;4+?J`5m{MZEq%s{hVKFzx8|3SLrQzK|Y1H0s?dhs(Q=a=``}3OTC6;rfK3
zhnfk-3N(=7%skOQN>yXc6gt>44-Q{0znK2*_Gj7BCQ<K}3N#s#DJ-EJ!QDN`vh<vj
z1q%Hj#DXC}SaUHD2<bKHUASZJsd3jNJ%RJ{Nl-%#L*`B)akZa#Sdcdh&uXtXreM#h
z<@w0OP;fbDvS5rbjY?xT`rx-vy|%QQ)RF{S0kyq#ku|q7hcafcCQ%u&RUm4z6<HiF
zZXnj<#~rOJM5CTU$IyV-*Z*r<!9sNkA%6b1<FF)?7&l;_II7g^QXfe^!lT0WHPSfq
z@SWtGKWCdvuzx_8>h2aQgk_`^a%jk~V`@oJ%jJ#FmWMvQ6t(Trnc}EIzg`f5TC@~2
z7ieHM$ba#%$49y+6SRV5v_lrc%uu{Z9Snz_yGQPgW;Hw6%NPtN>~Zee5MxSPNPxr-
z+0JN<O#t4S)8dr89bAO=Kj$(ay4U%&Qx$)@08iDBJtZi%)l+jyvrPFO=~@5Fv>g8T
zsR!fQ%=jq_1q-YtG9y<71MFZHov(^Cme!9SE?Pd6#&m?Wt{l2=^AuG0sO3J+=Da|T
zzauPpRI+Bf2WAV9W8~^zMXh%qyAklH1e-f({b$+$Io^<7)6O9q7sSj&VksQ<A>5^9
zeVlna*(DkVsg||nrX3%S=fdtw1CN$taRsf0;vLmYToovz{tTpoQC9HOeyU=ytUK6z
z9Fzp`jK7Hmo~|YcEk@I^X8+~6Y=pA1-4~qe@b<qvYQ8Pj^Ksj>Ig^rJJ-ihyhsY!U
zxd#%@=(u;fFQRv#m+3zot8C;pzvuJ|)rbtnt`&p&LOirhs>9PpCRS{M3TWXw+oUG)
z_-T-u!s~}A?5SJ&l)3{ByuK-GZ2WT19v{aGA~X!56LRvabpLgeq^PTB18Hy9NY4|a
zPL?5OAcnL1s(ZuYMW?$WGUF%b3(AHy9s?T9^8-#$-klS*y1&M38LVl>vL5c^z*|LT
zDaGH_q4yrVULyL>&Rr;*(%CXv-A|C@Y|1Mx{zeH+HO)h1A9|3sX+$~w!>&v-quTyb
zNQ8Eh_1m$&gl$Kx9fsLhkjv}=QT4g$FwB<1N1RVS1H+EDbtND~A8mU9p^*~4*BSWi
zey68k``4r%EjG;~Y+QyhRL+35Gnyay07Qj`8hP}QkS#}GYHp!01YD$H5SF!`HSsHr
zFxpAL*cPnI+E}7~x|jBD_!Efe*iki&yqzC<k{U>S@+y2CSF=wg%{crJ()H!6kylI6
zXmy$E<Aha`<}b};WNN`}EVM3J**=ilSoTwcpyz;_wn&M0x8&G#Y_+Bv%)C(LJKZ}N
zD0g%!dK<lmbnoFDMhWr*Kb7ugX6B9k8%29z;AgtzwSm}4;t~G>BQu5%`_bB%W;I=#
z8vPx^dItFxf^D=73D*m!O{|gTg}eXsanOc29!FxCs_;#cdb+NuQ8h{x{{nLV!cH(j
zzJIyS8${X<+Ozz2$1E$8OW_xq(6ZsbH3;@<74QjNt}r{6_aO`+x^Zme{LsIVKIfOJ
z!9m#vjO|+}9w{r!3DVtL3$U>Am%Y#qo;<%qD)PZs*cHXO7xq&jMXcv%e-aHK0{5k5
zQbhX#!cpUeZwT6W&6wN?>%at#y$Bv}rr@oO62tsmj9my$+vNVlJG^UXk9lYq`K|_9
zk|avKf6$!m#jqn*K+br%IFcH;x-*-W><!L*ZGicZTQBZq2}VoQ)lsX>d)ie%Hq&O)
z_$%B~lug`_7S$#yib9XJ&k_v&tVp9fwj?pkWbKdYcDOw&BHN^wXJ9ae41x^Z7@Y+>
z7G&4{V<Bw$om~4y(fsf=akY)8i2Pvg9DiIXJD=aLWT)#pEe@u7UTnXfPFI&Ng<&eR
z|Ncg|PZxi**sjuYD)UXb$?TDM_pswI9RcEpc(XWrlmxTc6{uObmFRUum811-8o=M@
zbjLvQ^B9m>6!9+F15SN&{i?e^9dl8*4QPBnn244pIAfN)vN!0DgZk()ZNMk(<nGE7
zv9g5$A_aJVn!BYu;HHrnN`*8JmCYo&r^u`7rFhxe5+wb7a~x@uazRQvW9Dx>O*^BV
zt}AH>Zmw}303Ma-?53GmBIlU~6gLKj(c=6A$!pIYZ7fLt>mSue3z4~NlxYwpR?N;f
zPc*;2A_U?5Y?zorBk<@)uh_N1#872%=8B(O#*%{N;zh^yI!C<2As^II3)D7Tse1pp
zyFRf!U?pXRNvuH`Pe?qnFO9HI@U!<HC~;@&s@B>widlzACKmd$bejz8nqgCj7PUw3
zKzdHmH@*cjG5|S3(rc1?Ke!)os&==%Jp<NszuPFKoGSIbXSf2@vBU@C1mRF1D<leu
zZEwp@{1(kBd$z)`!zdp*)h$FQW)hW8V8E5`rc{)wOuH|jp#j>`j?41C1Jk%eOLFT)
zBks%?qCgvcyIiJ<(I=S<u#)(Gwf^$idlcPD1qks26!Kjb`yYdkzkw4oY7}#-<CG#@
zI<+2O%y~20mWFoA1d*uJpV;Te->_|h=%&#80hUfw=J3+?bEmvPiiU<K&cPxh2>TRa
zq^6==YimxP(WdKQ0{zfK<m3-f;nC=>DFvlDr<79YrQmib;rQ@RceYv--HLKrNfADU
z(J)3}<p#47??=I>>(H$fdr40$CFwI3#|hLYEB*X-zW3dhyyJ*(W1odtU?gssUd^8d
zS22yZWfxlRCm3iEM;N2?5<qv&CsY%khs9D`>vZEbY4IdCV!~*0XJA1B3c9e*1fOqH
z`=j_|;KO|x>cYjzY!UM?xhXBY!T;e`xp#1YJ?T~omdBomp5RNwP#PhAV&78D?i#60
z<M4D>x~YU{09#H{*$+{K{A4)(hbm%2ykAU+Ebgw2>Z*2IFvF+*I*!Qh@QEQ2gSf*&
z+T~CRiuG!K|F|*LxFXl;Ly;jhP9_JN@6a^K`^<HmAraAV9~G|wWu^4bA+x=@E2iYY
zaZchNasiHytTk`MsT)uAyF%xo#%m9l`piJuv1gu1l({u{(zdCta2jIEQaLT3+JzQn
z(+IOgSk&J~Zb@7gZ`pQpC9u`vf*H8cs~4Zi=Jw$$CX|alh3l0fV!&eNd~MgI2N{lR
z)Emxgq<nk{e&cQ5aK%L|Zuovibt~ZrI3=fHRZy=<SlYLLKb`&b)22d+DD&&@rXtXN
zY+MIgTlzeHr8leS)dt17U@@XWu%(WF?qQ=o5!;pr?Nn_In%WFU*GuF<|3slGh)%`x
z&sUd^=17vb5|Hc(<?NjR0;^DKE6(o<t<8*SZ}-cT(sGbYx+QD@8kBx|=s^82z_gpX
zX4g~0ik9?~hr`;xwBE^Csfh4MM-|SJC^t7WDdRgse`WXk@_c{FwHt#$EzT!_Y*!3Z
zcm*v!^`1dHm0kG0IGRlO@w3oi6?1$RQv(wemB4|4PJL||Vgk)-rJ~x9htpBi!=0~5
z1zb&$CFIdpugiPp;9ou;9!%_#KvtSHt($KDS^C#N<HdD7IBq+5<k(jrSd=fkzMW|>
z%9Il9&1fEc=e<>0&0~?UTtS&dPqk{KvC*|k=@-2E)4hxLgD<90d1cIp2vb~WX&mWJ
z-U*jN^<sc`L5T)L<YBjYwb`gXhhO`I?V*f>Sc>b;4Zre~QznVCOm`Isln49PqncRQ
zn<ecJPm}D%<aGDw2a_Cy&xG(H*@%cmCL83(DlR~~{^E+WZHdWD#wP6e5&B9k8l;$G
z{9=iw{vV)p(QR~d^zC2xnf6)T+$p^?=B=;^^#v6Paf74SzyLhv{QCW9?zA+!gz2ph
zn^B`5%#XpGrPF<C7_)aBU`U_UoO26|mx0y7`yOae&380n9d%NR=xY-VXApSyvxNA{
zGd^P_kQA-MfDyr-6{k9Q<o?E_ODcbs$kzhx-L<Cb^3S|v3_Woo{D>+S6f(#Nh0z<4
zUUG>Y+PwakUNqeUQTE+W^~@&c)A!A^TH)R-1V7hgZdqCB@{-qLK&TWhh#{mN+fl9f
z1g_`Mxhb4UR)0S&kj@Gl0CNdM!kwZiXnj)0sQM$tesE1#9!VFxEo9#@;<ZJs9_Y@5
z9xxq7cWxqS8o#$%kzAM}9^-mYrWu~fyTePqtS`(Y5wsY2Au`S?@JFpl4@bC{`M?3q
z5FK(2KT-e{&J<$}{Pn6)Rw#t(*DMYccDfW>)7OS3SjXKJ4v5$}5cb0~UGW(>8C$Ad
zR3MszAgn+uI_pS79K*|`7iWAZ!xQv1#UO#?()Jo<9b2#P&x>kwF3WL5=A-|PBC$hW
zh+w}cH!J=5&osl>>AaA3hhdW3^anTf|6VbG|J^a_s=EcI=cD^I1WNe7T+Z?Ljp`qU
zb!jyoNXXl)dYhOwbK|sM)T;4DR%%(7P?%`z7KS44e`$oIhfq-V_3vV&90v`B4|F+#
zqd&|boiq*Ubv>BVNea_5@*+m5sLw<}a~yv}nhHa8AfyA?{)zv6h1y7k&UTjpJ<Ie(
ze_fni>~j~GX)VUn7^0d7#?`R*-Y2Ud*Y*8UtRZfW+g}^6wP$DMr!K23xo2)b9XD(x
z%I|=3K2r7XM`{scw`^Bm`KfS;!X<3b=Z>$%*jakP=2}Ei^=lpU{qq}|HolLTp)(P#
z{25%s;OUPFV10#h5cXbL*wGRo)`3P%cgI+Z#jMl2+<=p)*;(I@H&K6sftD%<xd#=f
z`Q(1)Ng`hED8w1JYx*>0DcN`U@YBsd@)S-jI~lflXL41Z67%#o(RcN3K8GzTm_l(?
zMiazeEg#LWW8&l~uj4AXgHt?9o4!s45sLBwQNSIFWKP2nR;$YUP4O(?v&(&}H@|;}
z7#BKZ^plyh_9EjPVTebj>WJ9KkGa86#G-)**51nNZ>B=WW02JqDjE*|%FUjT^5+%F
zfMCr-{?8Zxycn!SH$yhcDSki@WkXd}2EGuT-V0SzYhMl9^7C^Y#l4bR?8yq1Ux+8Q
z4M8_kWV|h+Cs1r4kH>5RBKj))i!eh9=+6a!O5@I6$l2uReB{W?W$~PHWyu-_@$+Rk
z2qUXM^Lv8PFf2T)=-BUVK97Dwl2yIV#Uhwa0&MEJVij+e{h5g5t=&@eux@r$rU<yG
zZt15;IETPk%z%XR=Xe8k1GfWa=&!X34u5oIScQTaoU5n3sX_7pf69#?$L0y*$0gjs
zs}4tqKbXqs$1vUSFA3)3b!vH+pn5uVFL<wVD{xfTDQ6{v5T>Q9YHh(4o$X-{3*12V
z?2zezT;a!A+PC)!cZm&@U#U*4so_k6_jxV#z1@v;pl*NufE(_q#rjt{18~u}C+c^M
z%GxQtm*=32gLzjVe!9*g><?eT>>Wss**CqHggx)xK7ka>)rTac(J6*W>?FFf5R7c=
z`<7%Foc6Lj-r!7vpL9|z%7}#deo59n#qJ{!TW>;x{mou|_FR;Wayt=)e@PKz?5r}P
zx)Uzd6$Sk2Y0!zFI+rQ;X>7Cwm}dIHZd@&WIhu?WB~}istNY8vjoan2@C-hsT4ZbO
zN~F=1QdyD`9SZ(}CQO7yycU#{PXD3}k*9VLSLWVQ$$u}8FMa=k+M8B};YLT6>}+yU
z+SKB0m`_RTUmxt29tvkO(KxpuB>Td~MKFvJ6?UN+IFq)IzHnac;EPjQ=Jabe;O(!k
zXD`iBG$a#%1f@fVeC1SqWvF~DS@VUon_`R;OG`+93AC)7R-^a(jR-5k;(}E;DTA)%
zYGtBfg_nBWOvyo`LrfUW_8>n7g8iK~;govzx$c%yV?x!1nwhlvDWqth(OAt7XMCdQ
z_C87}3%$e;kB(n#sQ(ft=lPMxXK`4fNJ5oQk?9*yupV((GJC0kOV`YkCW!4D2U&L0
zkIjJ1eW5odz8PQ!?VLH-Sr(V&zi)K})N*yg4Cl-!c-rk%hL?(8M-q=EQwT_LPz7J)
z2M|LU7q!spnEt?Yor8^d#-xy;*{}Z7gUmjTJ9h*#KQ65}SNCqF_t~MFJ_*565wFPH
z%YO;DED?A(W*E;%-Qro(zgjcQi^b0vOP(w_bMIzAIHg?*{`SnW%ARfYmN?URuSR_5
z(;{Ys<J+f6zqX4K>gYO~lp3Ng$#~hqb1Rtdr_;v2#tQ^oX;7u3mlNfaC5ZjQ)gy)a
z#w2zWYwGCnLvA#x>)(qTWfV<pQroC-+iHwBWgEk^M5@4ewK*GZ{$qb}1yr12LddV~
z9v_v^*`WMawDt0=OqISF)n}&&fp;0?@lH$3FZA`T-ppMk_@sHfDF8|1l@HXpBP%Bh
zD=P~t3mY#x8zT!34GRkm9TKyGy_tluvpE^91Rom<+y5I$LBE26Ky&c?uW4Ib+i8Ud
z(|4h=)3i+&<Gjq;8tmOGW1VGcLX)N+LyDc&&`cRY5;o4-;oAX67M?gzqu*MOW*s2n
zwsRuo1`|YuCC|>7W<0HBk#-#iYf)$xhmVz}Hu`ytsz1?en*G-lerl8*6{XWM%Rr{4
zJl%ev>2MX<RTaZ$G+PESDM0e8ey&x%n>_s}4&#gxVH>Gvu*x`l)KV6^e1b?PdjL+p
z6q_xX<tGkwl99;Yla!Ox<j8IF@hTRX=#-`Si!d<ASoNk=eX?6=*i~Kd#g|kwMlmiD
z*x5f#9W4acllrmjs@&nue$00+Ban||R<RJn$*F8#ahTlBC`OX9zXLVAR(QfjB?Llm
zosY(A+0{8f|7B>-Yf~v6AlzIo<=v6iIQQROQPG?7Jx_<LF~X`oh*EVR<G3yRlyhUL
zR0O`*L<n4q(Tf{Pxfo{aCS;$xhb{NxW=Uc~Di9xQB9wH)*J|cPS@6TB_aVK{qh5Ns
z4<G0=ym?biGe8)t1I$YdqJ#aGq++sqYIJ#%q0g(WPt889Fs)QQFJT6_u#=7uvpoah
zVnfvf+j5Nk1Xt!)x4Nu<g+lJaU!NxcR_3%uU!qKto0X;0Qxc{}BKo$h9ys;}3V~kg
zyTzXHGd+Yu)@^(KglLQMV4u*D#cEeVEE0;t_*T?71(ieufHNeXvXPulGwy_uTGj3(
zQM#G<Gc{U$UUG*a$IK4WNzkAWkJ)SC^ZGyN-?}yeFA83Nay}FguF?lHrRB^-3&|aS
z?j{e`5mvNLJ&l82w$Z-vQmJ61Ik(ug9!+;TS~?#KLhsl(TUQXPR$-y&#JJ>Xboy?K
zhE3<5tgp&m1N718{nbj_c#+iStHsp=?`n#FI>e(iP3w>U!@@sz7phdwbZ!OsNutUi
zqkgVb^j;=!R!!}vI8$mba5itdrC!R{=Z}|ur+W@V6Q)z+ZZBGv1TTanYkaNCzX+JM
zL}s&|lxmt$aVF~XZ`Q0>Q%>$iZD#)y{g;%^<J4Nz6DU~nTOH>ZlQ;I`a6c?DC#nQ>
zB3p=*`VOndL`azDk|>NLi^h*c5Gq?~W5a3X=SDF$^B6~qiA__}7fPd<AX+I@AH;Xh
zN-4v%&X}2yMc4Ivn9wEc!Aj;ED3O_+{?e6Qq={BnWRSJhnV1f#tYX#emYQyEe5AbN
zJ8gav1ay%4C>E}!o36|ntHTJ;PG;~tgz<0Gz<cRmJ6_aBtP$Ui*3iF`Qa01vh!G40
zG!HQc1!n$Ojf>qXG=*7>r0OibV4O4+z9kkH88l+lBU3LWcBV3ol@a>8>zMEeGNG$}
z*|jKUdPH?GK&&@F#9A=zkK4#iG!YP_?rWFI1fI5`ju{OG+v7mzVavGDoc1K#$rh|K
z-Q`VHNIJZJnswsAyI~&z@n4@ku!*>H`{N>H(Xwd$t?E(N3$J(d!lO>jlA1X3;nL`x
z<JC%+b1@|h`)eT#+RpUD{6y~>En#1T>4HuSY>@kQ^=f9pMn@1z>9DEfPtJ@uR$~i0
zz|iKbrLuy!XGxDk{9)5|suT!=x~jRIM9!!hPiiLLqfkwrNlaE-96Judn@6luPx9PB
z+Lp+<%Dv^cwWI*t4{*7E{MRl?NxmrD3YnHV{{VCZ>k|Co%rGgrqS6ghVjO;R+S2#~
zNBSowr(Kdjlg)4gzWY>BUGnB`KN`6t;9YIXG3Md>nXXJjCHoa<v*0>$7_WZ96JCW6
zg;;ImC?8^#At^-Mo~38H+c!0}vZe?Kd*0+VXO9-SLl#EIyI3;xn9_zay^d_&S2uqh
zG<Um27K(i<ns@%D|MMvF+@x0&aJ&J7nJb6s6{Jlk%!Be5&df9v-40S}!x1xqsFmYq
ztVE;T1&SbB1ipXYzVMj}?)>2)Q+!O!xd~tJ9w%HMrH5?FtzX~k_Sn0zwe%1WxV$Ig
zWp-b1d%6J+dqW4~p!zY8q7;0hus22A6vWb*1*YKWj#Vncy>jYBk%M2L?{uOy$Kcg*
zR`&#LZtu*drfI;@+s>rfp`R6qXV4TJk=(GWZqQjZtvS&xH{aM6T=ecV>^x6-4ei*v
zcw!ayhlgA;^Gs+m>ap5dj1k>Fd&aLib}?J~4pnaE05=;?k%n%*EnD2TQ#@r%%d0w*
znXkn<vtu3`5wG+g{T(-?uM-gADEDw-L*n=Aqdi~d$c7hHx^SvTEE=E|1!!TB&$(>6
zb+|WZgzS=T_C`Gaf)&<(Yib7X|5kNXaqZ%Mx2y-j&6kyE0k7MaYb!BXckfUqu##Bc
z5r(D6PHZ<k1?vpZ${Qc{ln-^8L#&)Tg-bYwjm5UE25jpKFN%m@VOq!ZTMb7`#ykW&
zKF2?A=ZjHI1^1OAT>^C7yUabv;j)Qe{~T0_`~Unm4*8hh)Jy&fM^jF;ytvQryy)>v
z=dY03(Qomy)Sr?Gm<Z?|rjY!NzLTSUOQ&8;&3yi?4`pr<^RYcw*ekJKr8Pd-(ybuh
ztwS^`6w*FaBfGKoaQ;2eDBr8nx!OsKIhm1>ggx}7K*l3(ItF+=cy4Rgna0sE(T6H(
zt(tY1_Rd^5?D@W43v1Kku_0CE&n`q#;)_=T@QpJjc_GXVD*XL^oA<pw<U45yK{l$3
zobsw4_`-b-wT)mwX{<+SXC}|C)QC{&?3-E%ywVy0*asbq^Re(r1oNT#m{S9Xy9)dp
zzN{@G$<8IkxdQO|VkYtw^X#pCzRNY-+q&YaF%ibwl^3yJm@_$f=Hxl#sYavSNIL{h
z4AF1VQmk;qw~-@v@AwP(cZ));KvVjza?QB5Tq;_fi-Ph^fFD#m5wkLszh*qddAjuL
zl*2iK#^*x+Y?2iE=nW2%dv&ezZ}&Y}Vm6oAW$Bd4S54D!;jBMWu)kKpsJ%=GpWEdY
z&g<;w4+D~nO1=sY<bZ4ru`f3B>nMS5h+KR7j)^;Ytwn|vPs<xaa3>lO4%+RaW>+yI
z*2E+icHk$w^b8lM2ht&W&7qW`XDAzGb}mr~PIgwQ|3)N9c1|8nNfvH4F<x#?aZVmF
zPHuKdAu@sgZ$$t9=<`{*xKnc1py&YNiAEG?Wn@3&mqFeGBD82IBmBi6DA1uDR)Y~V
zRd|9(3$#D&U(n`T<<qU4t8ql=D-p&IwGGldY@$#RDM=((^kBS5BLs&-aWqU8KdM49
z6w_3Zuluoq0;9Q~^l8Q5WtBpZ)bffky_N%yzw>Wsi0@%9TZ3CHbs6X0<~6?Q-u+ix
z8Q6zxf|@E(jE&rhPKUAev^p^bv`Qh~wGVf@XkZ)M`xNz8C{iR&ZXP6RYDq;Yr2hfu
C<C0AP

delta 26149
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

diff --git a/inst/shiny/DiagnosticsExplorer/global.R b/inst/shiny/DiagnosticsExplorer/global.R
index 334dc0d24..0a52f51f6 100644
--- a/inst/shiny/DiagnosticsExplorer/global.R
+++ b/inst/shiny/DiagnosticsExplorer/global.R
@@ -108,3 +108,4 @@ dataSource <-
 
 
 
+
diff --git a/inst/sql/sql_server/UpdateVersionNumber.sql b/inst/sql/sql_server/UpdateVersionNumber.sql
index 5930947b8..6892ca5cd 100644
--- a/inst/sql/sql_server/UpdateVersionNumber.sql
+++ b/inst/sql/sql_server/UpdateVersionNumber.sql
@@ -1,6 +1,7 @@
 {DEFAULT @package_version = package_version}
-{DEFAULT @version_number = '3.3.0'}
+{DEFAULT @version_number = '3.3.1'}
 
 DELETE FROM @database_schema.@table_prefix@package_version;
 INSERT INTO @database_schema.@table_prefix@package_version (version_number) VALUES ('@version_number');
 
+