Based on the current published tutorial and the public tidymassshiny 1.0.0 source; checked September 23, 2026.
Save a complete analysis
Keep the initialized sample sheet, raw-file references, intermediate mass_dataset objects, cleaned and annotated objects, complete statistical/enrichment tables, figures and parameters. For local use, inspect the output directories reported by the app. For hosted use, record the JOB ID and Download All Data before the service retention window expires. Confirm the archive opens and contains the results you intended to keep.
When reopening compatible objects or fMSEA results, confirm which steps they represent. Changing a parameter does not retroactively regenerate a saved result. Preserve software/package versions and database provenance alongside the outputs.
Troubleshooting
| Problem | Action |
|---|---|
| Folder picker cannot see my computer | A remote R process sees its server filesystem; use upload or run locally |
| Docker cannot find data | Check host-folder permissions and container mount; select the container path |
| Table sample mismatch | Compare exact IDs against the initialized sample sheet; remove non-intensity columns |
| Incorrect polarity or RT | Map the ion column and set minutes/seconds explicitly |
| Missing R package | Install from the correct source, inspect the first error and restart the app |
| Raw processing takes a long time | Inspect progress/logs, reduce threads if memory is limiting; avoid repeated Start clicks |
| No MS2 candidates | Check polarity, precursor/RT association, database type and matching tolerances |
| No enrichment results | Check ID mapping, organism, selection and background; an empty result can be valid |
| LLM evaluation fails | Verify the optional provider configuration; preserve the statistical results independently |
| A plot looks different after reloading | Confirm the saved object, selected sample groups and plotting settings |
For a report, include app/package versions, local/Docker/hosted deployment, module, steps to reproduce, logs and a de-identified input example. Do not share API keys or private sample identifiers.