<metaproperty="og:title"content="Easy data analysis for clinicians">
<metaname="description"content="Easily evaluate and analyse clinical health data in your browser, either based on a hosted version or run on your own device. Import data from multiple sources, summarise, modify and visualise data and create regression models. Export key metrics and regression analysis results in a publication ready document format.">
<metaproperty="og:description"content="Easily evaluate and analyse clinical health data in your browser, either based on a hosted version or run on your own device. Import data from multiple sources, summarise, modify and visualise data and create regression models. Export key metrics and regression analysis results in a publication ready document format.">
<liclass="nav-item"><aclass="external-link nav-link"href="https://github.com/agdamsbo/FreesearchR/"aria-label="GitHub"><spanclass="fa fab fa-github fa-lg"></span></a></li>
<p>The <ahref="https://app.freesearchr.org"class="external-link"><strong><em>FreesearchR</em></strong></a> is a simple, clinical health data exploration and analysis tool to democratise clinical research by assisting any researcher to easily evaluate and analyse data and export publication ready results.</p>
<p><ahref="https://app.freesearchr.org"class="external-link"><strong><em>FreesearchR</em></strong></a> is free and open-source, and is <ahref="https://app.freesearchr.org"class="external-link">accessible in your web browser through this link</a>. The app can also run locally, please <ahref="#run-locally-on-your-own-machine-sec-run-locally">see below</a>.</p>
<p>The <strong>FreesearchR</strong> app can be run locally on your machine, ensuring no data is transmitted externally. Below are the available options for setup and configuration.</p>
<p>The app can be configured either by passing a named list to <code>run_app()</code> or by setting environment variables in a <strong>Docker Compose</strong> file. The following variables control data access and display behavior. If no values are provided, the app will use the defaults listed below.</p>
<p><strong>Configuration Variables</strong></p>
<tableclass="table">
<colgroup>
<colwidth="22%">
<colwidth="68%">
<colwidth="9%">
</colgroup>
<thead><trclass="header">
<th>Variable</th>
<th>Description</th>
<th>Default</th>
</tr></thead>
<tbody>
<trclass="odd">
<td><code>INCLUDE_GLOBALENV</code></td>
<td>Load datasets already present in the global R environment into the app</td>
<td><code>FALSE</code></td>
</tr>
<trclass="even">
<td><code>DATA_LIMIT_DEFAULT</code></td>
<td>Default number of observations for previewing or working with a dataset</td>
<td><code>10,000</code></td>
</tr>
<trclass="odd">
<td><code>DATA_LIMIT_UPPER</code></td>
<td>Maximum number of observations a user can set for the upper limit</td>
<td><code>100,000</code></td>
</tr>
<trclass="even">
<td><code>DATA_LIMIT_LOWER</code></td>
<td>Minimum number of observations a user can set for the lower limit</td>
<td><code>1</code></td>
</tr>
</tbody>
</table>
</div>
<divclass="section level3">
<h3id="run-from-r-or-rstudio">Run from R (or RStudio)<aclass="anchor"aria-label="anchor"href="#run-from-r-or-rstudio"></a>
</h3>
<p>If you’re working with data in R, <strong>FreesearchR</strong> is a quick and easy tool for exploratory analysis.</p>
<li><p><strong>Requirement:</strong> Ensure you have <ahref="https://www.r-project.org/"class="external-link">R</a> installed, and optionally an editor like <ahref="https://posit.co/download/rstudio-desktop/"class="external-link">RStudio</a>.</p></li>
<p>Open the <strong>R console</strong> and run the following code to install the <ahref="https://github.com/agdamsbo/FreesearchR"class="external-link">FreesearchR</a> package and launch the app:</p>
<p>For advanced users, you can deploy <strong>FreesearchR</strong> using Docker. A data folder can be mounted to <code>/app/data</code> to automatically load supported file types (<code>.csv</code>, <code>.tsv</code>, <code>.txt</code>, <code>.xls</code>, <code>.xlsx</code>, <code>.ods</code>, <code>.dta</code>, <code>.rds</code>) at startup.</p>
<p>To mount a local data folder, add a <code>volumes</code> entry to your <code>docker-compose.yml</code> file:</p>
<p>Please note that the <strong><em>FreesearchR</em></strong> project is published with a <ahref="https://contributor-covenant.org/version/2/1/CODE_OF_CONDUCT.html"class="external-link">Contributor Code of Conduct</a>. By contributing to this project, you agree to abide by its terms.</p>
<p>Like any other project, this project was never possible without the great work of others. These are some of the sources and packages I have used:</p>
<li><p>The <strong><em>FreesearchR</em></strong> app is built with <ahref="https://shiny.posit.co/"class="external-link">Shiny</a> and based on <ahref="https://www.r-project.org/"class="external-link"><em>R</em></a>.</p></li>
<li><p><ahref="https://www.danieldsjoberg.com/gtsummary/"class="external-link">gtsummary</a>: superb and flexible way to create publication-ready analytical and summary tables.</p></li>
<li><p><ahref="https://github.com/dreamRs"class="external-link">dreamRs</a>: maintainers of a broad selection of great extensions and tools for <ahref="https://shiny.posit.co/"class="external-link">Shiny</a>.</p></li>
<li><p><ahref="https://easystats.github.io/easystats/"class="external-link">easystats</a>: the <ahref="https://easystats.github.io/performance/articles/check_model.html"class="external-link"><code>performance::check_model()</code></a> function was central in sparking the idea to create a data analysis tool.</p></li>
<li><p><ahref="https://biogen-inc.github.io/IDEAFilter/"class="external-link">IDEAfilter</a>: a visually appealing data filter function based on the <ahref="https://github.com/dgkf/shinyDataFilter"class="external-link">{shinyDataFilter}</a>.</p></li>
<p>The online <strong><em>FreesearchR</em></strong> app contains a tracking script, transmitting minimal data on usage. No uploaded data is transmitted anywhere. Have a look at the <ahref="https://analytics.gdamsbo.dk/share/2i4BNpMcDMB9lJvF/agdamsbo.shinyapps.io"class="external-link">tracking data here</a>. No tracking data is sent running the app locally (see above).</p>
