# Data Ingestion & Launchers

`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:

      @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`:

      #!/bin/bash
      Rscript -e "dtsmartr::dtsmartr_launch()"

  Make it executable in the Terminal:

      chmod +x ~/Desktop/dtsmartr_explorer.sh