spatial-aim 1.5.0__tar.gz → 1.5.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/PKG-INFO +1 -1
  2. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/deploy/demo/README.md +16 -3
  3. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/deploy/demo/legal/imprint.md +4 -3
  4. spatial_aim-1.5.2/deploy/demo/legal/privacy.md +30 -0
  5. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/PKG-INFO +1 -1
  6. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/scm_version.json +2 -2
  7. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/__main__.py +3 -1
  8. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/demo.py +32 -6
  9. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/sidebar.py +33 -16
  10. spatial_aim-1.5.0/deploy/demo/legal/privacy.md +0 -54
  11. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.dockerignore +0 -0
  12. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.github/workflows/ci.yml +0 -0
  13. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.github/workflows/docker-demo.yml +0 -0
  14. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.github/workflows/release.yml +0 -0
  15. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.gitignore +0 -0
  16. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/.pre-commit-config.yaml +0 -0
  17. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/LICENSE +0 -0
  18. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/README.md +0 -0
  19. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/deploy/demo/Dockerfile +0 -0
  20. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/docs/aim_gui.gif +0 -0
  21. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/docs/figure_2_1.png +0 -0
  22. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/environment.yml +0 -0
  23. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/pyproject.toml +0 -0
  24. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/renovate.json +0 -0
  25. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/sample_dataset/ST/index.csv +0 -0
  26. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/sample_dataset/ST/sample_st.h5ad +0 -0
  27. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/sample_dataset/pairs.csv +0 -0
  28. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/sample_dataset/scRNA/index.csv +0 -0
  29. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/sample_dataset/scRNA/sample_sc.h5ad +0 -0
  30. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/setup.cfg +0 -0
  31. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/SOURCES.txt +0 -0
  32. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/dependency_links.txt +0 -0
  33. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/entry_points.txt +0 -0
  34. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/requires.txt +0 -0
  35. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/scm_file_list.json +0 -0
  36. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatial_aim.egg-info/top_level.txt +0 -0
  37. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/__init__.py +0 -0
  38. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/__main__.py +0 -0
  39. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/adata_schema.py +0 -0
  40. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/aggregation.py +0 -0
  41. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/__init__.py +0 -0
  42. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/coherence.py +0 -0
  43. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/__init__.py +0 -0
  44. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/collect.py +0 -0
  45. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/criteria.py +0 -0
  46. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/run.py +0 -0
  47. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/scoring.py +0 -0
  48. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/compare_ks/selection.py +0 -0
  49. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/loading.py +0 -0
  50. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/reconstruction.py +0 -0
  51. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/run.py +0 -0
  52. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/shape_consistency.py +0 -0
  53. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/analysis/topology.py +0 -0
  54. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/cli.py +0 -0
  55. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/clustering.py +0 -0
  56. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/config.py +0 -0
  57. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/__init__.py +0 -0
  58. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/README.md +0 -0
  59. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/__init__.py +0 -0
  60. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/_common.py +0 -0
  61. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/_segmentation.py +0 -0
  62. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_01_mouse_ssp.py +0 -0
  63. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_02_colorectal_cancer.py +0 -0
  64. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_03_mouse_liver.py +0 -0
  65. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_04_mouse_kidney.py +0 -0
  66. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_05_mouse_embryo.py +0 -0
  67. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_06_mouse_retina.py +0 -0
  68. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_07_mouse_mpfc.py +0 -0
  69. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_08_mouse_visual_cortex.py +0 -0
  70. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_09_human_breast_cancer.py +0 -0
  71. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/curate_10_human_mtg.py +0 -0
  72. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/dump_retina_counts.R +0 -0
  73. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/curate_datasets/environment_retina_qs.yml +0 -0
  74. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/__init__.py +0 -0
  75. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/common.py +0 -0
  76. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/runner.py +0 -0
  77. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/validate_pair.py +0 -0
  78. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/validate_sc.py +0 -0
  79. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/validate_segmentation.py +0 -0
  80. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/data/validate/validate_st.py +0 -0
  81. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/__init__.py +0 -0
  82. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/app.py +0 -0
  83. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/compute.py +0 -0
  84. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/data_access.py +0 -0
  85. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/loaders.py +0 -0
  86. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/__init__.py +0 -0
  87. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/cell_type.py +0 -0
  88. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/common.py +0 -0
  89. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/headline.py +0 -0
  90. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/ksweep.py +0 -0
  91. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/markers.py +0 -0
  92. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/report.py +0 -0
  93. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/scatter.py +0 -0
  94. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/render/shape.py +0 -0
  95. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/scaffold.py +0 -0
  96. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/state_names.py +0 -0
  97. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/texts.py +0 -0
  98. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/validation.py +0 -0
  99. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/__init__.py +0 -0
  100. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/cards.py +0 -0
  101. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/cell_type_modal.py +0 -0
  102. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/choose_k.py +0 -0
  103. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/compare_tab.py +0 -0
  104. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/controls.py +0 -0
  105. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/mapper_tab.py +0 -0
  106. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/overview.py +0 -0
  107. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/pages.py +0 -0
  108. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/reference_tab.py +0 -0
  109. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/views/report.py +0 -0
  110. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/widgets/__init__.py +0 -0
  111. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/widgets/headline_plot.py +0 -0
  112. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/widgets/linked_plot.py +0 -0
  113. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/widgets/plotly_fit.py +0 -0
  114. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/gui/widgets/slider.py +0 -0
  115. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/io.py +0 -0
  116. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/__init__.py +0 -0
  117. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/base.py +0 -0
  118. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/confidence.py +0 -0
  119. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/nearest_centroid.py +0 -0
  120. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/reference.py +0 -0
  121. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/mapping/wann.py +0 -0
  122. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/metrics/__init__.py +0 -0
  123. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/metrics/cossim.py +0 -0
  124. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/metrics/modularity.py +0 -0
  125. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/metrics/shape_consistency.py +0 -0
  126. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/metrics/topology.py +0 -0
  127. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/__init__.py +0 -0
  128. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/environment_dot.yml +0 -0
  129. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/environment_tacco.yml +0 -0
  130. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/environment_tangram.yml +0 -0
  131. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/registry.py +0 -0
  132. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/run_dot.R +0 -0
  133. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/run_dot.py +0 -0
  134. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/run_tacco.py +0 -0
  135. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/reference_aligners/run_tangram.py +0 -0
  136. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/sweep.py +0 -0
  137. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/timing.py +0 -0
  138. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/tree.py +0 -0
  139. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/src/spatialaim/utils.py +0 -0
  140. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_cli.py +0 -0
  141. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_gui_imports.py +0 -0
  142. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_gui_overview.py +0 -0
  143. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_registry.py +0 -0
  144. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_sweep_sample.py +0 -0
  145. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_topology.py +0 -0
  146. {spatial_aim-1.5.0 → spatial_aim-1.5.2}/tests/test_utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: spatial-aim
3
- Version: 1.5.0
3
+ Version: 1.5.2
4
4
  Summary: SpatialAIM — annotation-independent mapping of scRNA-seq references onto high-resolution spatial transcriptomics
5
5
  Author-email: Dominik Pysch <dominik.pysch@fau.de>
6
6
  License: GNU GENERAL PUBLIC LICENSE
@@ -18,12 +18,25 @@ deploy/demo/
18
18
  /srv/spatialaim-demo/data/ # mounted read-only at /data
19
19
  ├── datasets/ # = Data/01_Datasets_Paper (scRNA/, ST/, pairs.csv, index.csv files)
20
20
  └── results/
21
- └── <PairID:03d>_<scName>__<stName>/ # one pair output each (spatialaim run --pairs_csv naming)
21
+ ├── average/
22
+ │ └── <PairID:03d>_<scName>__<stName>/ # one pair output each (spatialaim run --pairs_csv naming)
23
+ └── ward/
24
+ └── <PairID:03d>_<scName>__<stName>/
25
+ ```
26
+
27
+ Each linkage folder is one batch run with that `--linkage_method`, e.g.
28
+
29
+ ```bash
30
+ spatialaim run --pairs_csv datasets/pairs.csv --sc_dir datasets/scRNA --st_dir datasets/ST --output_dir results/ward --linkage_method ward --mapping <mapper> --annotation <obs_column> ...
22
31
  ```
23
32
 
24
33
  Each pair output has the usual layout `<start>/<mapper>/` plus `reference_scaffold.h5ad`, as
25
- written by `spatialaim run` or the GUI. Only pairs whose results folder holds at least one finished
26
- start appear in the picker, so the demo can go live with a subset and grow.
34
+ written by `spatialaim run` or the GUI. Only pairs with at least one finished start (in any
35
+ linkage) appear in the picker, so the demo can go live with a subset and grow; the sidebar's
36
+ linkage dropdown offers the linkages a pair has. A pair output directly in `results/` (no linkage
37
+ folder) still works, under the linkage its configs record. An optional `Name`
38
+ column in `pairs.csv` sets the picker's label for a pair; empty or missing, it shows
39
+ `<PairID> · <scName> × <stName>`.
27
40
 
28
41
  Results can be computed anywhere and copied over: the demo compares the scaffold cache key without
29
42
  the input files' paths and modification times. It never rebuilds a missing scaffold (that pair then
@@ -3,9 +3,10 @@
3
3
  ## Information pursuant to § 5 DDG
4
4
 
5
5
  Dominik Pysch\
6
- Biomedical Network Science Lab\
7
- Department Artificial Intelligence in Biomedical Engineering\
8
- Friedrich-Alexander-Universität Erlangen-Nürnberg\
6
+ [Biomedical Network Science Lab](https://www.bionets.tf.fau.de/)\
7
+ [Department Artificial Intelligence in Biomedical Engineering](https://www.aibe.tf.fau.de/)\
8
+ [Friedrich-Alexander-Universität Erlangen-Nürnberg](https://www.fau.de)
9
+
9
10
  Nürnberger Str. 74\
10
11
  91052 Erlangen\
11
12
  Germany
@@ -0,0 +1,30 @@
1
+ # Privacy policy
2
+
3
+ ## 1. Controller
4
+
5
+ Dominik Pysch\
6
+ Biomedical Network Science Lab\
7
+ Department Artificial Intelligence in Biomedical Engineering\
8
+ Friedrich-Alexander-Universität Erlangen-Nürnberg\
9
+ Nürnberger Str. 74\
10
+ 91052 Erlangen\
11
+ Germany
12
+
13
+ Email: [dominik.pysch@fau.de](mailto:dominik.pysch@fau.de)
14
+
15
+ ## 2. Overview
16
+
17
+ This online demo of SpatialAIM showcases the tool using precomputed results on public datasets.
18
+ There is no registration, no upload, no tracking, no analytics and no advertising.
19
+
20
+ ## 3. Processed data
21
+
22
+ When you visit the demo, the server necessarily processes your IP address, date and time, and information on
23
+ your browser and operating system in order to deliver the page and secure the connection.
24
+
25
+ ## 4. External links
26
+
27
+ Links to other websites (e.g. GitHub, the sources of the datasets, GeneCards) are only opened
28
+ when you click them. The respective provider is responsible for any data processing there.
29
+
30
+ Last updated: Nov. 2026
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: spatial-aim
3
- Version: 1.5.0
3
+ Version: 1.5.2
4
4
  Summary: SpatialAIM — annotation-independent mapping of scRNA-seq references onto high-resolution spatial transcriptomics
5
5
  Author-email: Dominik Pysch <dominik.pysch@fau.de>
6
6
  License: GNU GENERAL PUBLIC LICENSE
@@ -1,7 +1,7 @@
1
1
  {
2
- "tag": "1.5.0",
2
+ "tag": "1.5.2",
3
3
  "distance": 0,
4
- "node": "g4d397072c89dcff916be13460a7ff7e9668cc1c5",
4
+ "node": "g97b72af57a799a66340b14fdc1d5755d61904f78",
5
5
  "dirty": false,
6
6
  "branch": "HEAD",
7
7
  "node_date": "2026-11-02"
@@ -27,11 +27,13 @@ from pathlib import Path
27
27
  PRIMARY_COLOR = "#1c83e1"
28
28
 
29
29
  # The demo is a public server: no file watcher or rerun-on-save, no developer
30
- # menu, no uploads, and no detailed error pages.
30
+ # menu, no uploads, no detailed error pages, and no cookie (the XSRF token only
31
+ # guards uploads, which the demo has none of).
31
32
  _DEMO_FLAGS = [
32
33
  "--server.fileWatcherType", "none",
33
34
  "--server.runOnSave", "false",
34
35
  "--server.maxUploadSize", "1",
36
+ "--server.enableXsrfProtection", "false",
35
37
  "--server.enableStaticServing", "true",
36
38
  "--client.toolbarMode", "viewer",
37
39
  "--client.showErrorDetails", "none",
@@ -9,9 +9,13 @@ disk. The data root holds::
9
9
 
10
10
  <data root>/
11
11
  ├── datasets/ # the paper's relational layout: scRNA/, ST/, pairs.csv
12
- └── results/ # one pair output per pair, <PairID:03d>_<scName>__<stName>/
12
+ └── results/
13
+ └── <linkage>/ # one batch run per linkage (average/, ward/)
14
+ └── <PairID:03d>_<scName>__<stName>/ # one pair output per pair
13
15
 
14
- Every pair of ``pairs.csv`` whose output holds a start is offered. The imprint
16
+ A pair output directly in ``results/`` is read too, under the linkage its configs
17
+ record. Every pair of ``pairs.csv`` with a pair output holding a start is offered,
18
+ under its optional ``Name`` column (else PairID and dataset names). The imprint
15
19
  (Impressum) and the privacy policy are Markdown files in ``SPATIALAIM_DEMO_LEGAL``
16
20
  (``imprint.md``, ``privacy.md``), read on every render so they can be
17
21
  edited without a restart.
@@ -26,6 +30,7 @@ from typing import NamedTuple
26
30
 
27
31
  import streamlit as st
28
32
 
33
+ from spatialaim import LINKAGE_METHODS
29
34
  from spatialaim.gui import data_access
30
35
 
31
36
  DATA_ENV = "SPATIALAIM_DEMO_DATA"
@@ -72,18 +77,38 @@ class DemoPair(NamedTuple):
72
77
  sc_path: Path
73
78
  st_path: Path
74
79
  segmentation: Path | None
75
- pair_dir: Path
80
+ outputs: dict[str, Path] # linkage -> pair output, LINKAGE_METHODS order
76
81
  tissue: str
77
82
  author: str
78
83
  source: str
84
+ name: str
79
85
 
80
86
  @property
81
87
  def label(self) -> str:
88
+ if self.name:
89
+ return self.name
82
90
  if self.sc_name == self.st_name:
83
91
  return f"{self.pair_id:03d} · {self.sc_name}"
84
92
  return f"{self.pair_id:03d} · {self.sc_name} × {self.st_name}"
85
93
 
86
94
 
95
+ def _pair_outputs(folder_name: str) -> dict[str, Path]:
96
+ """A pair's outputs by linkage: ``results/<linkage>/<folder>`` and a
97
+ ``results/<folder>`` under the linkage its configs record (the first
98
+ found wins); only outputs holding a start count."""
99
+ found: dict[str, Path] = {}
100
+ candidates = [(m, RESULTS_DIR / m / folder_name) for m in LINKAGE_METHODS]
101
+ candidates.append((LINKAGE_METHODS[0], RESULTS_DIR / folder_name))
102
+ for default, pair_dir in candidates:
103
+ starts = data_access.list_starts(pair_dir)
104
+ if not starts:
105
+ continue
106
+ recorded = (data_access.linkage_method_from_config(s.folder) for s in starts)
107
+ found.setdefault(next((m for m in recorded if m), default), pair_dir)
108
+ order = {m: i for i, m in enumerate(LINKAGE_METHODS)}
109
+ return dict(sorted(found.items(), key=lambda kv: order.get(kv[0], len(order))))
110
+
111
+
87
112
  def _index(path: Path) -> dict[str, dict[str, str]]:
88
113
  """The rows of an ``index.csv`` by ``Name``; empty without one."""
89
114
  if not path.exists():
@@ -108,10 +133,10 @@ def list_pairs() -> list[DemoPair]:
108
133
  pair_id, sc_name, st_name = int(row["PairID"]), row["scName"], row["stName"]
109
134
  sc_path = DATASETS_DIR / "scRNA" / f"{sc_name}.h5ad"
110
135
  st_path = DATASETS_DIR / "ST" / f"{st_name}.h5ad"
111
- pair_dir = RESULTS_DIR / f"{pair_id:03d}_{sc_name}__{st_name}"
112
136
  if not (sc_path.is_file() and st_path.is_file()):
113
137
  continue
114
- if not data_access.list_starts(pair_dir):
138
+ outputs = _pair_outputs(f"{pair_id:03d}_{sc_name}__{st_name}")
139
+ if not outputs:
115
140
  continue
116
141
  mask = (st_index.get(st_name) or {}).get("Segmentation", "").strip()
117
142
  seg = DATASETS_DIR / "ST" / "Segmentation" / mask if mask else None
@@ -124,10 +149,11 @@ def list_pairs() -> list[DemoPair]:
124
149
  sc_path,
125
150
  st_path,
126
151
  seg if seg is not None and seg.is_file() else None,
127
- pair_dir,
152
+ outputs,
128
153
  sc_row.get("Tissue", ""),
129
154
  sc_row.get("Autor", ""),
130
155
  sc_row.get("Quelle", ""),
156
+ (row.get("Name") or "").strip(),
131
157
  )
132
158
  )
133
159
  return pairs
@@ -57,6 +57,11 @@ _LINKAGE_LABELS = {
57
57
  "average": "average - allow for outlier cell types",
58
58
  "ward": "ward - more balanced cell types",
59
59
  }
60
+ _LINKAGE_HELP = (
61
+ "Linkage for the agglomeration tree over the start clusters. "
62
+ "'average' (UPGMA) peels small tight groups off a dominant cell type; "
63
+ "'ward' carries a size term and tends to produce balanced cell types."
64
+ )
60
65
 
61
66
  # The sidebar's keyed inputs keep their values for the whole session.
62
67
  # st.switch_page (the Overview's Open button) reruns without the frontend's
@@ -252,9 +257,7 @@ def _linkage_method_row(lock: dict | None) -> str:
252
257
  format_func=_fmt,
253
258
  key="cfg_linkage",
254
259
  persist_state=_PERSIST,
255
- help="Linkage for the agglomeration tree over the start clusters. "
256
- "'average' (UPGMA) peels small tight groups off a dominant cell type; "
257
- "'ward' carries a size term and tends to produce balanced cell types.",
260
+ help=_LINKAGE_HELP,
258
261
  )
259
262
  )
260
263
 
@@ -581,17 +584,18 @@ def _render_demo_sidebar() -> argparse.Namespace | None:
581
584
  if not pairs:
582
585
  st.sidebar.caption("No precomputed results available.")
583
586
  return None
584
- by_label = {p.label: p for p in pairs}
585
- label = st.sidebar.selectbox(
587
+ by_id = {p.pair_id: p for p in pairs}
588
+ pair_id = st.sidebar.selectbox(
586
589
  "Dataset pair (scRNA × ST)",
587
- list(by_label),
590
+ list(by_id),
591
+ format_func=lambda i: by_id[i].label,
588
592
  key="demo_pair",
589
593
  persist_state=_PERSIST,
590
594
  on_change=_drop_view_state,
591
595
  help="Public scRNA-seq references and spatial slices, each mapped in "
592
596
  "advance. Choosing another pair resets the result pages.",
593
597
  )
594
- pair = by_label[label]
598
+ pair = by_id[pair_id]
595
599
  details = " · ".join(x for x in (pair.tissue, pair.author) if x)
596
600
  if pair.source:
597
601
  details += f" · [source]({pair.source})"
@@ -600,8 +604,21 @@ def _render_demo_sidebar() -> argparse.Namespace | None:
600
604
 
601
605
  st.sidebar.divider()
602
606
  st.sidebar.subheader("2. Method")
603
- lock = _run_lock(pair.pair_dir)
604
- linkage_method = _linkage_method_row(lock)
607
+ linkage_method = str(
608
+ st.sidebar.selectbox(
609
+ "Linkage method",
610
+ list(pair.outputs),
611
+ format_func=lambda m: _LINKAGE_LABELS.get(m, m),
612
+ key=f"demo_linkage_{pair.pair_id}",
613
+ persist_state=_PERSIST,
614
+ on_change=_drop_view_state,
615
+ disabled=len(pair.outputs) == 1,
616
+ help=f"{_LINKAGE_HELP} Changing it resets the result pages.",
617
+ )
618
+ )
619
+ pair_dir = pair.outputs[linkage_method]
620
+ view_key = f"{pair.pair_id}_{linkage_method}"
621
+ lock = _run_lock(pair_dir)
605
622
  annotations = lock["annotations"] if lock is not None else []
606
623
  # The full sidebar's controls, disabled and showing what was computed.
607
624
  st.sidebar.multiselect(
@@ -610,17 +627,17 @@ def _render_demo_sidebar() -> argparse.Namespace | None:
610
627
  default=annotations,
611
628
  disabled=True,
612
629
  placeholder=_LEIDEN_ONLY,
613
- key=f"demo_annotations_{pair.pair_id}",
630
+ key=f"demo_annotations_{view_key}",
614
631
  help="SpatialAIM always starts from a Leiden over-clustering of the "
615
632
  "reference; these annotations were additionally used as starting points.",
616
633
  )
617
- _demo_method_rows(data_access.list_pair_mappers(pair.pair_dir), pair.pair_id)
634
+ _demo_method_rows(data_access.list_pair_mappers(pair_dir), view_key)
618
635
  return argparse.Namespace(
619
636
  scdata=pair.sc_path,
620
637
  stdata=pair.st_path,
621
638
  segmentation=pair.segmentation,
622
- output_dir=pair.pair_dir,
623
- pair_dir=pair.pair_dir,
639
+ output_dir=pair_dir,
640
+ pair_dir=pair_dir,
624
641
  k_min=_DEFAULT_K_MIN,
625
642
  k_max=_DEFAULT_K_MAX,
626
643
  k_step=_DEFAULT_K_STEP,
@@ -630,9 +647,9 @@ def _render_demo_sidebar() -> argparse.Namespace | None:
630
647
  )
631
648
 
632
649
 
633
- def _demo_method_rows(computed: list[str], pair_id: int) -> None:
650
+ def _demo_method_rows(computed: list[str], view_key: str) -> None:
634
651
  """The demo's read-only method list: ``_method_rows``' box with every method
635
- disabled, ticked where it was computed for the pair."""
652
+ disabled, ticked where it was computed for the pair output."""
636
653
  st.sidebar.markdown(
637
654
  "<div class='spatialaim-group-label'>Computed mapping methods</div>",
638
655
  unsafe_allow_html=True,
@@ -652,7 +669,7 @@ def _demo_method_rows(computed: list[str], pair_id: int) -> None:
652
669
  MAPPER_LABELS.get(m, m),
653
670
  value=m in computed,
654
671
  disabled=True,
655
- key=f"demo_method_{m}_{pair_id}",
672
+ key=f"demo_method_{m}_{view_key}",
656
673
  )
657
674
 
658
675
 
@@ -1,54 +0,0 @@
1
- # Privacy policy
2
-
3
- ## 1. Controller
4
-
5
- [First name Last name / Institution]\
6
- [Address]\
7
- Email: [name@fau.de]
8
-
9
- ## 2. Overview
10
-
11
- This online demo of SpatialAIM shows precomputed results on public datasets. There is no
12
- registration, no upload, no tracking, no analytics and no advertising. All content (including
13
- fonts and scripts) is delivered from our own server; visiting the demo transfers no data to
14
- third parties.
15
-
16
- ## 3. Hosting and access data
17
-
18
- The demo runs on a server operated by [hosting provider / data centre, address]. When you
19
- visit it, the server necessarily processes your IP address, date and time, and information on
20
- your browser and operating system in order to deliver the page and secure the connection. These
21
- data are not stored in access logs. [If they are logged: state the retention period, e.g. "Logs
22
- are deleted after 7 days."]
23
-
24
- Legal basis: [Art. 6(1)(f) GDPR (legitimate interest in secure operation) — for public bodies:
25
- Art. 6(1)(e) GDPR in conjunction with Art. 4 BayDSG].
26
-
27
- ## 4. Session data
28
-
29
- During your visit the server keeps your selections (dataset, view, cell-type names you set) in
30
- memory. They are never stored permanently and are deleted when the session ends (when you close
31
- the tab).
32
-
33
- ## 5. Cookies
34
-
35
- The demo sets a single, technically necessary cookie (`_streamlit_xsrf`) that protects the
36
- application against cross-site request forgery. Legal basis is § 25(2) no. 2 TDDDG; no consent
37
- is required.
38
-
39
- ## 6. External links
40
-
41
- Links to other websites (e.g. GitHub, the sources of the datasets, GeneCards) are only opened
42
- when you click them. The respective provider is responsible for any data processing there.
43
-
44
- ## 7. Your rights
45
-
46
- You have the right of access (Art. 15 GDPR), rectification (Art. 16), erasure (Art. 17),
47
- restriction of processing (Art. 18) and to object (Art. 21). Please contact the controller
48
- named above.
49
-
50
- You also have the right to lodge a complaint with a data protection supervisory authority,
51
- e.g. [the Bavarian State Commissioner for Data Protection (public bodies) or the Bavarian
52
- State Office for Data Protection Supervision (private bodies)].
53
-
54
- Last updated: [Month Year]
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes