You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-13Lines changed: 14 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
## DataMap: Visualizing Data Matrices in Your Browser
2
2
3
-
To use this app, just visit this static [GitHub page](https://gexijin.github.io/datamap/) deployed from this repo via Actions. For large datasets, install it as an R package for local execution:
3
+
To use this app, just visit this static [GitHub page](https://gexijin.github.io/datamap/) deployed from this repo. For large datasets, install it as an R package:
DataMap is a secure, browser-based application for visualizing high-dimensional 'omics and other data matrices with heatmaps, PCA, and t-SNE. Built with Shiny and running entirely in your browser through Shinylive technology, DataMap ensures your data never leaves your device.
10
+
DataMap is a secure, browser-based application for visualizing high-dimensional 'omics and other data matrices with heatmaps, PCA, and t-SNE. Built with R/Shiny using [shinylive](https://posit-dev.github.io/r-shinylive/), DataMap is a serverless app that ensures your data never leaves your device.
Your data should be organized in a matrix format where:
35
34
- The first row must contain column headers
36
35
- The first column may contain row identifiers.
37
36
- Some columns can be categorical, which will be used to color rows.
38
-
- Column annotation can be uploaded separately.
39
-
37
+
- Column annotation can be included in the data matrix or uploaded separately.
40
38
41
39
## FAQ
42
40
43
41
**Is my data secure?**
44
-
Yes. DataMap runs entirely in your browser. Your data never leaves your device.
42
+
Yes. DataMap runs entirely in your browser. After loading the app, it works fine even if you disconnect the internet.
45
43
46
44
**What browsers are supported?**
47
-
Chrome, Firefox, Edge, and Safari (latest versions recommended).
45
+
Chrome, Firefox (slower to load), Edge, and Safari.
48
46
49
47
**Can I use DataMap offline?**
50
-
Yes, once loaded in your browser, DataMap can operate without an internet connection.
48
+
Yes, once loaded in your browser, DataMap can operate without an internet connection. Alternatively, you can intsall DataMap as an R package.
51
49
52
50
**Limitations?**
53
-
Slower in the browser when clustering 5000 rows or columns. Can take up to 2 minutes.
51
+
Slower in the browser when clustering 5000 rows or columns. Can take up to 2 minutes. For large datasets, install and use it as an R package.
52
+
53
+
**Why did you write DataMap?**
54
+
A. I love heatmaps. B. I wanted to do an vibe coding experiment. I prompted and Claude.ai 95% of the code. See my [blog](https://www.ge-lab.org/2025/04/21/extreme-vibe-coding-the-making-of-datamap/) on how DataMap was developed.
54
55
55
-
## How to Cite
56
+
## Cite our preprint
56
57
57
-
If you use DataMap in your research, please cite it as:
58
+
If you use DataMap in your research, please cite:
58
59
59
60
> Ge, X. (2025). DataMap: A Portable Application for Visualizing High-Dimensional Data, [arXiv:2504.08875](https://arxiv.org/abs/2504.08875), 2025.
0 commit comments