Data Ingestion & Launchers
In dtsmartr: Interactive Virtualized Data Explorer Grid Widget

--- title: "Data Ingestion & Launchers" output: rmarkdown::html_vignette vignette: > %\VignetteIndexEntry{Data Ingestion & Launchers} %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8}

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)

dtsmartr is accessible to non-programmers, clinical coordinators, and business analysts who want to browse datasets without writing R scripts. The package includes a zero-code Data Ingestion Wizard and multiple one-click system launchers.

1. Zero-Code Data Ingestion Wizard

Boot the ingestion uploader by calling dtsmartr_launch() with no arguments:

library(dtsmartr)
dtsmartr_launch()

Drag-and-Drop File Uploader: Powered by the datamods package. Upload local files of any supported format:
CSV: Text spreadsheet datasets.
Excel (.xlsx): Multiple tabs support.
SAS (.sas7bdat): Clinical study datasets.
RDS: Native compressed R data files.
View Panel: Inspect and verify raw rows before feeding data into the main React explorer grid.
Update Panel: Custom-convert column classes (e.g. converting a character variable to factor, or numeric to character) or rename columns dynamically before loading the grid.

2. One-Click Launchers (No R Console Required)

Method A: RStudio GUI Add-in

Once dtsmartr is installed, a launcher registers in RStudio: 1. Click the Addins menu in RStudio's top toolbar. 2. Select dtsmartr Data Explorer Wizard. 3. The wizard opens automatically in your default external web browser.

Method B: Terminal Command One-Liner

Start the uploader server directly from your system Terminal (macOS/Linux) or Command Prompt (Windows):

Rscript -e "dtsmartr::dtsmartr_launch()"

Method C: Desktop Shortcut Icons

Create a double-clickable Desktop launcher to open the uploader wizard like a native desktop app:

Windows (dtsmartr_explorer.bat): Create a text file on your Desktop named dtsmartr_explorer.bat containing: batch @echo off "C:\Program Files\R\R-4.4.3\bin\x64\Rscript.exe" -e "dtsmartr::dtsmartr_launch()" (Modify the path to point to your local Rscript.exe executable).
macOS / Linux (dtsmartr_explorer.sh): Create a shell file on your Desktop named dtsmartr_explorer.sh: bash #!/bin/bash Rscript -e "dtsmartr::dtsmartr_launch()" Make it executable in the Terminal: bash chmod +x ~/Desktop/dtsmartr_explorer.sh