TotalApp Docs

Data Inspector

Upload a CSV or JSON dataset and explore it with column stats, correlation heatmaps, distribution charts, data-quality checks, and an AI-assisted cleaning recipe.

Overview

Data Inspector is a browser-based dataset explorer and AI-assisted cleaning tool. Upload a CSV or JSON file — or click Load Sample to try it instantly with a built-in demo employee dataset — and the screen parses the file, infers a type for every column (numeric, text, date, or boolean), and gives you five tabs to explore the result plus an AI-generated cleaning recipe.

Everything Runs Client-Side

Parsing, statistics, correlation, distribution charts, and quality checks all happen in your browser. Nothing is uploaded anywhere unless you explicitly click Export or Send to Graph.

Loading Data

Three ways to get data into Data Inspector:

Drag & Drop

Drop a .csv or .json file directly onto the upload area. The drop zone highlights while a file is dragged over it.

File Picker

Click Choose File (or the Upload File button in the header once a dataset is already loaded) to browse for a .csv or .json file.

Load Sample

Click Load Sample to instantly load a built-in demo employee dataset (name, department, salary, start date, performance score) — useful for trying every tab without preparing your own file.

During parsing, each column is classified as numeric, text, date, or boolean. Boolean columns are auto-detected from values like true/false, yes/no, or 1/0. Empty cells, the literal string null, and N/A are all treated as missing values.

The Five Tabs

1. Data Table

A paginated grid of the raw rows (15 rows per page), with a row number column and one column per detected field. Missing values render as an italic null. Use the pager at the bottom to move through the dataset.

2. Column Stats

One card per column showing its detected type, missing-value count, and unique-value count. Numeric columns additionally show mean, min, and max. A red progress bar under each card visualizes the proportion of missing values for that column.

3. Correlation

A split-view layout for exploring relationships between numeric columns:

  • Left panel — heatmap. An N×N Pearson correlation matrix across all numeric columns, with cell size scaling to fit the number of columns (larger cells for small datasets, smaller for wide ones) so labels never get cramped. Each cell shows the correlation coefficient (−1 to +1) on a red → gray → green scale (strong negative → no correlation → strong positive). Column headers are angled to stay readable even when names are long. Requires at least two numeric columns — with fewer, the tab shows a message instead of an empty grid.
  • Right panel — detail. Click any cell (or any row in the ranked list below) to select a column pair. The panel shows a scatter plot of the two variables with a fitted trend line, a plain-language read of the relationship (e.g. "moderate positive correlation (r = 0.62) — as X increases, Y tends to increase"), and a Top Correlated Pairs list ranking every numeric pair by strength so you can jump straight to the most significant relationships.

4. Distributions

Every column is shown at once as a card in a responsive grid, so you get a full profile of the dataset in one screen instead of switching between columns one at a time:

  • Numeric columns — a row of stat tiles (mean, median, min, max), a histogram (8 buckets), and a box plot showing the interquartile range and median line.
  • Boolean columns — a donut/pie chart showing the split between the detected values.
  • Text/date columns — a frequency bar chart of the top values, with angled labels so long category names stay readable.
  • Distribution Insights card — a trailing summary card counting how many columns of each type (numeric/text/date/boolean) the dataset has, plus a few auto-generated notes flagging columns with high variance or a skewed mean-vs-median gap.

5. Data Quality

A dashboard-style quality report, not just a checklist:

  • Data Health Score — a circular score (0–100%) in the top-left, derived from the share of missing cells, outlier cells, and duplicate rows relative to total data volume, labeled Good / Fair / Poor.
  • KPI strip — duplicate row count, number of columns with missing values, and number of columns with detected outliers.
  • Detail lists (left) — missing values per column and outliers per numeric column (IQR method, values outside [Q1 − 1.5×IQR, Q3 + 1.5×IQR]), each as a progress bar with count and percentage.
  • Quick Remediation Actions (right) — one-click fixes generated from the same detection logic as the AI recipe (remove duplicates, fill missing values, remove outliers for a specific column). Clicking Apply updates the working dataset immediately, without needing to run a full AI analysis first.

AI Cleaning Recipe

The right-hand panel runs an AI analysis (triggered by the Run AI Analysis button) that inspects the loaded dataset and proposes a list of cleaning steps. Each suggested step has:

FieldDescription
KindOne of Fill Missing, Fix Format, Remove Outlier, or Standardize (used for duplicate-row removal).
SeverityHigh, Medium, or Low, based on how much of the dataset the issue affects.
Code PreviewA pandas-style code snippet showing how the fix would be applied, toggled with the "View Code" link on each step.
ActionsApprove or Dismiss the individual step.

Use Approve All to approve every active (non-dismissed) step at once, or approve steps individually, then click Apply Selected in the panel footer to apply only the approved steps to the working dataset. Applying steps updates the Data Table and all other tabs immediately, and a "Preview Applied" badge appears in the header.

What Gets Detected

The recipe generator checks for duplicate rows, missing values per column (filled with the column mean for numeric columns or the most frequent value for text columns), inconsistent date formats (standardized to ISO 8601), and IQR-based outliers in numeric columns.

Header Actions

Actions in the header bar follow a visual hierarchy from left to right: data-input actions, then output/utility actions, then a secondary action, then the primary Run AI Analysis button styled with the accent fill and placed at the far right.

Upload File / Load Sample

Load your own CSV or JSON file, or load the built-in sample employee dataset to explore the screen without your own data.

Export ▾

A dropdown combining three export formats: Export Cleaned (current working dataset as CSV), Export JSON (full analysis report — columns, correlation matrix, quality summary), and Export PDF (a vector PDF via jsPDF with the same analysis data, formatted for reading or sharing).

Reset

Reverts the working dataset back to the originally loaded/uploaded data, discarding any applied cleaning steps.

Send to Graph

Pushes the current dataset into TotalApp's shared data store and navigates to Graph View, so you can continue working with it visually. This is a live integration — not a placeholder.

Run AI Analysis

The primary action — generates (or regenerates) the AI cleaning recipe shown in the right-hand panel.

Terminal Commands

The bottom terminal bar accepts short commands as an alternative to clicking buttons:

CommandEffect
:analyzeRun AI analysis and generate the cleaning recipe
:approve allApprove every active recipe step
:approve <term>Approve steps whose column, kind, or title matches the given text
:applyApply all currently approved steps
:resetRevert to the original uploaded data
:exportDownload the cleaned dataset as CSV
:statsPrint row/column counts and a one-line summary per column
:sampleLoad the built-in sample employee dataset
:helpList all available commands

AI Assistant Panel

Data Inspector includes TotalApp's standard AI Assistant chrome, accessible from the tab on the right edge of the screen. It supports fullscreen mode, conversation history, and Save as Report to persist an AI-generated summary as a report you can revisit later.

The assistant is scoped as a data-cleaning advisor. It has access to the loaded file's name and row/column counts, per-column statistics (type, missing count, unique count, and mean/min/max for numeric columns), and the current AI cleaning recipe with each step's approval state. One-click suggestion chips cover the most common questions:

  • Summarize this dataset — a plain-language read of what the data contains and its overall quality.
  • Explain the cleaning recipe — a walkthrough of what each proposed step does and why.
  • Which issues are most critical? — prioritization guidance across missing values, format inconsistencies, and outliers.
  • Suggest a cleanup strategy — a recommended order of operations, including checks the built-in recipe generator may not have covered.

Scope note

The assistant's context currently covers column statistics and the AI cleaning recipe — it does not (yet) receive the Correlation matrix, Distribution charts, or Data Quality health score as structured context, so for questions specifically about those tabs it reasons from what you describe in the chat rather than from live numbers it can see directly.

Frequently Asked Questions

What file formats are supported?
CSV and JSON. JSON files can be either a top-level array of objects, or an object with a data array property.
How is a column detected as boolean vs. text?
A column is classified as boolean when it has two or fewer unique non-empty values and every one of those values is from the set true/false, yes/no, or 1/0 (case-insensitive). Otherwise it falls through to date detection, then numeric detection, and finally text as the default.
Why does the Correlation tab show a message instead of a heatmap?
The correlation matrix needs at least two numeric columns to compute anything meaningful. If your dataset has fewer than two numeric columns, the tab shows a hint instead of an empty or single-cell grid.
How does outlier detection work?
Outliers are detected per numeric column using the IQR (interquartile range) method: any value below Q1 − 1.5×IQR or above Q3 + 1.5×IQR is flagged. This is used both in the Data Quality tab's progress bars and in the AI cleaning recipe's "Remove Outlier" suggestions.
Does applying a cleaning step permanently change my source file?
No. Cleaning steps only change the in-memory working dataset shown in the browser. Your original uploaded file is untouched — use Reset at any time to discard applied steps and return to the original data, or Export to save the cleaned version as a new file.
What's the difference between Export JSON and Export PDF?
Both export the same underlying analysis data (columns, correlation matrix, quality summary), but Export JSON produces a machine-readable file for further processing, while Export PDF produces a formatted, human-readable vector document suitable for printing or sharing.
What does "Send to Graph" actually do?
It converts the current dataset's columns and rows into TotalApp's shared dataset format, registers it in the shared data store, and navigates you to Graph View so you can build visualizations from the same data without re-uploading the file.
Do the Quick Remediation Actions in Data Quality run the same fixes as the AI recipe?
Yes. Each Quick Remediation Action (remove duplicate rows, fill missing values in a column, remove outliers in a column) uses the exact same detection logic as the AI Cleaning Recipe generator, just applied instantly to one issue at a time without needing to click Run AI Analysis first.
How is the Data Health Score calculated?
It's 100 minus a penalty based on the combined share of missing cells, outlier cells, and duplicate rows relative to the dataset's total cell count, then labeled Good (≥85%), Fair (≥60%), or Poor (below 60%). It's a quick at-a-glance signal, not a substitute for reviewing the detail lists below it.