gauge-sc 0.1.0a2__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 (120) hide show
  1. gauge_sc-0.1.0a2/.agents/skills/gauge/SKILL.md +77 -0
  2. gauge_sc-0.1.0a2/.agents/skills/gauge/agents/openai.yaml +4 -0
  3. gauge_sc-0.1.0a2/.agents/skills/gauge/references/interfaces.md +83 -0
  4. gauge_sc-0.1.0a2/.readthedocs.yaml +18 -0
  5. gauge_sc-0.1.0a2/LICENSE +21 -0
  6. gauge_sc-0.1.0a2/MANIFEST.in +11 -0
  7. gauge_sc-0.1.0a2/PKG-INFO +107 -0
  8. gauge_sc-0.1.0a2/README.md +63 -0
  9. gauge_sc-0.1.0a2/docs/_static/brand/Inter-LICENSE.txt +92 -0
  10. gauge_sc-0.1.0a2/docs/_static/brand/README.txt +6 -0
  11. gauge_sc-0.1.0a2/docs/_static/brand/favicon.png +0 -0
  12. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-favicon-dark.svg +14 -0
  13. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-favicon-light.svg +14 -0
  14. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-icon-dark.svg +24 -0
  15. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-icon-light.svg +24 -0
  16. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-logo-dark.svg +31 -0
  17. gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-logo-light.svg +31 -0
  18. gauge_sc-0.1.0a2/docs/_static/custom.css +24 -0
  19. gauge_sc-0.1.0a2/docs/_static/fonts/InterVariable.woff2 +0 -0
  20. gauge_sc-0.1.0a2/docs/_static/fonts/LICENSE.txt +92 -0
  21. gauge_sc-0.1.0a2/docs/_static/fonts/README.md +6 -0
  22. gauge_sc-0.1.0a2/docs/agents.md +90 -0
  23. gauge_sc-0.1.0a2/docs/api.md +336 -0
  24. gauge_sc-0.1.0a2/docs/applications.md +18 -0
  25. gauge_sc-0.1.0a2/docs/assets/README.md +7 -0
  26. gauge_sc-0.1.0a2/docs/assets/agent-audit-run.json +240 -0
  27. gauge_sc-0.1.0a2/docs/assets/agent-audit-summary.md +3 -0
  28. gauge_sc-0.1.0a2/docs/assets/agent-audit-table.csv +8 -0
  29. gauge_sc-0.1.0a2/docs/assets/agent-audit.svg +1305 -0
  30. gauge_sc-0.1.0a2/docs/assets/application-audit.svg +113 -0
  31. gauge_sc-0.1.0a2/docs/assets/application-hierarchy.svg +346 -0
  32. gauge_sc-0.1.0a2/docs/assets/application-selection.svg +108 -0
  33. gauge_sc-0.1.0a2/docs/assets/application-workflow.svg +294 -0
  34. gauge_sc-0.1.0a2/docs/assets/concept-groupings.png +0 -0
  35. gauge_sc-0.1.0a2/docs/assets/concept-views.png +0 -0
  36. gauge_sc-0.1.0a2/docs/cli.md +86 -0
  37. gauge_sc-0.1.0a2/docs/concepts.md +68 -0
  38. gauge_sc-0.1.0a2/docs/conf.py +55 -0
  39. gauge_sc-0.1.0a2/docs/data-release.md +24 -0
  40. gauge_sc-0.1.0a2/docs/data.md +53 -0
  41. gauge_sc-0.1.0a2/docs/development.md +40 -0
  42. gauge_sc-0.1.0a2/docs/index.md +129 -0
  43. gauge_sc-0.1.0a2/docs/installation.md +33 -0
  44. gauge_sc-0.1.0a2/docs/numerical-reproducibility.md +28 -0
  45. gauge_sc-0.1.0a2/docs/paper-reproduction.md +21 -0
  46. gauge_sc-0.1.0a2/docs/real-data-tutorials.md +77 -0
  47. gauge_sc-0.1.0a2/docs/recipes.md +204 -0
  48. gauge_sc-0.1.0a2/docs/reference.rst +64 -0
  49. gauge_sc-0.1.0a2/docs/reproduce-figure4.md +26 -0
  50. gauge_sc-0.1.0a2/notebooks/00_concepts.ipynb +228 -0
  51. gauge_sc-0.1.0a2/notebooks/00_select_grouping.ipynb +130 -0
  52. gauge_sc-0.1.0a2/notebooks/01_view_specific_audit.ipynb +151 -0
  53. gauge_sc-0.1.0a2/notebooks/02_audit_sensitivity.ipynb +111 -0
  54. gauge_sc-0.1.0a2/notebooks/03_compare_groupings.ipynb +107 -0
  55. gauge_sc-0.1.0a2/notebooks/04_transferred_labels.ipynb +123 -0
  56. gauge_sc-0.1.0a2/notebooks/05_stress_checks.ipynb +194 -0
  57. gauge_sc-0.1.0a2/notebooks/06_hierarchy_spatial.ipynb +131 -0
  58. gauge_sc-0.1.0a2/notebooks/07_agent_audit.ipynb +231 -0
  59. gauge_sc-0.1.0a2/notebooks/README.md +29 -0
  60. gauge_sc-0.1.0a2/notebooks/real_data/10_platform_profiles.ipynb +618 -0
  61. gauge_sc-0.1.0a2/notebooks/real_data/11_mixture_audit.ipynb +807 -0
  62. gauge_sc-0.1.0a2/notebooks/real_data/12_spatial_hierarchy.ipynb +834 -0
  63. gauge_sc-0.1.0a2/notebooks/real_data/13_workflow_endpoints.ipynb +652 -0
  64. gauge_sc-0.1.0a2/notebooks/real_data/14_allen_granularity.ipynb +536 -0
  65. gauge_sc-0.1.0a2/pyproject.toml +40 -0
  66. gauge_sc-0.1.0a2/reproduction/DATA-SOURCES.md +19 -0
  67. gauge_sc-0.1.0a2/reproduction/PUBLIC-README.md +34 -0
  68. gauge_sc-0.1.0a2/reproduction/README.md +12 -0
  69. gauge_sc-0.1.0a2/reproduction/fetch_cosmx_metadata.py +97 -0
  70. gauge_sc-0.1.0a2/reproduction/package_figure4.py +70 -0
  71. gauge_sc-0.1.0a2/reproduction/package_public_results.py +164 -0
  72. gauge_sc-0.1.0a2/reproduction/panels.json +381 -0
  73. gauge_sc-0.1.0a2/reproduction/render.py +990 -0
  74. gauge_sc-0.1.0a2/reproduction/source_asset.py +21 -0
  75. gauge_sc-0.1.0a2/reproduction/validate.py +306 -0
  76. gauge_sc-0.1.0a2/scripts/build_docs.py +109 -0
  77. gauge_sc-0.1.0a2/scripts/check_allen_stability.py +138 -0
  78. gauge_sc-0.1.0a2/scripts/check_notebook.py +22 -0
  79. gauge_sc-0.1.0a2/scripts/check_real_data.py +173 -0
  80. gauge_sc-0.1.0a2/scripts/check_real_notebooks.py +99 -0
  81. gauge_sc-0.1.0a2/scripts/check_research_parity.py +193 -0
  82. gauge_sc-0.1.0a2/scripts/generate_logo.py +136 -0
  83. gauge_sc-0.1.0a2/scripts/package_tutorial_data.py +99 -0
  84. gauge_sc-0.1.0a2/scripts/prepare_tutorial_data.py +174 -0
  85. gauge_sc-0.1.0a2/scripts/render_agent_workflow.py +78 -0
  86. gauge_sc-0.1.0a2/scripts/render_concept_assets.py +31 -0
  87. gauge_sc-0.1.0a2/setup.cfg +4 -0
  88. gauge_sc-0.1.0a2/src/gauge_sc/__init__.py +9 -0
  89. gauge_sc-0.1.0a2/src/gauge_sc/__main__.py +5 -0
  90. gauge_sc-0.1.0a2/src/gauge_sc/_audit.py +196 -0
  91. gauge_sc-0.1.0a2/src/gauge_sc/_evaluate.py +355 -0
  92. gauge_sc-0.1.0a2/src/gauge_sc/_hierarchy.py +318 -0
  93. gauge_sc-0.1.0a2/src/gauge_sc/_results.py +211 -0
  94. gauge_sc-0.1.0a2/src/gauge_sc/_select.py +132 -0
  95. gauge_sc-0.1.0a2/src/gauge_sc/_tutorial_data.py +133 -0
  96. gauge_sc-0.1.0a2/src/gauge_sc/cli.py +181 -0
  97. gauge_sc-0.1.0a2/src/gauge_sc/datasets.py +75 -0
  98. gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Bold.otf +0 -0
  99. gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Medium.otf +0 -0
  100. gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Regular.otf +0 -0
  101. gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-SemiBold.otf +0 -0
  102. gauge_sc-0.1.0a2/src/gauge_sc/fonts/LICENSE.txt +92 -0
  103. gauge_sc-0.1.0a2/src/gauge_sc/io.py +259 -0
  104. gauge_sc-0.1.0a2/src/gauge_sc/pl.py +949 -0
  105. gauge_sc-0.1.0a2/src/gauge_sc/tutorial_data.json +73 -0
  106. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/PKG-INFO +107 -0
  107. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/SOURCES.txt +118 -0
  108. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/dependency_links.txt +1 -0
  109. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/entry_points.txt +2 -0
  110. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/requires.txt +37 -0
  111. gauge_sc-0.1.0a2/src/gauge_sc.egg-info/top_level.txt +1 -0
  112. gauge_sc-0.1.0a2/tests/test_application_tutorials.py +140 -0
  113. gauge_sc-0.1.0a2/tests/test_hierarchy.py +226 -0
  114. gauge_sc-0.1.0a2/tests/test_io_cli.py +426 -0
  115. gauge_sc-0.1.0a2/tests/test_plotting.py +262 -0
  116. gauge_sc-0.1.0a2/tests/test_reproduction_integrity.py +105 -0
  117. gauge_sc-0.1.0a2/tests/test_selection.py +140 -0
  118. gauge_sc-0.1.0a2/tests/test_spatial_tutorial_palette.py +62 -0
  119. gauge_sc-0.1.0a2/tests/test_tutorial_data.py +124 -0
  120. gauge_sc-0.1.0a2/tests/test_workflow.py +335 -0
@@ -0,0 +1,77 @@
1
+ ---
2
+ name: gauge
3
+ description: "Use ITCA+ to evaluate prediction support for supplied biological groupings, audit group contributions across data views, or select flat or hierarchical grouping granularity in single-cell and spatial AnnData. Use for ITCA/ITCA+ analysis requests, interpretation of saved results, and Scanpy integration."
4
+ ---
5
+
6
+ # GAUGE
7
+
8
+ ITCA measures information-weighted predictability of supplied group distinctions
9
+ from a specified view. ITCA+ balances that support against retained complexity.
10
+ Choose an analysis that answers the user's question; this skill does not fix a
11
+ classifier, view, preprocessing recipe, screening ratio, or complexity penalty.
12
+
13
+ ## Frame the task
14
+
15
+ - **Evaluate**: compare support for fixed groupings, labels or workflow endpoints.
16
+ - **Audit**: contrast group contributions between two views for one grouping.
17
+ - **Select**: choose among supplied candidates, or prune a supplied hierarchy.
18
+
19
+ Infer intent from the request and available tutorial/context. Inspect the data
20
+ before choosing settings. If the meaning of labels, the reference view, or the
21
+ selection goal is unclear, ask a concise scientific question. Make routine
22
+ execution choices yourself and explain consequential analysis choices.
23
+
24
+ ## Inspect and decide
25
+
26
+ 1. Check the active Python environment, installed ITCA+ version and public API.
27
+ Skill installation does not install the Python package. Use the existing
28
+ analysis environment or install the user's software checkout when needed.
29
+ 2. Inventory `.obs`, `.obsm`, layers, cell identities, group support and preprocessing
30
+ provenance. The CLI `inspect` command helps; inspect values in Python as needed.
31
+ Do not infer that `.X` is normalized, that PCA is suitable, or that QC columns
32
+ exist from their names alone. Reuse a saved evaluation if it matches the task.
33
+ 3. Choose the grouping(s) and named views with a stated rationale. Generating
34
+ clusters, embeddings or workflow candidates is a separate Scanpy step.
35
+ Preserve a common observation set when comparing candidates. Review control
36
+ views separately and choose a selection view explicitly.
37
+ 4. Select evaluation settings appropriate to support and compute budget. Default
38
+ API values are available choices, not prescribed scientific settings. Small
39
+ groups constrain folds and audit eligibility. Changes to labels or features
40
+ require a fresh evaluation; changing audit/selection settings does not.
41
+ 5. For an audit, decide whether descriptive contrasts alone answer the question.
42
+ Screening is optional. If requested, explain the chosen mirror ratio and
43
+ eligibility requirement; do not tune them to obtain desired candidate calls.
44
+ For selection, relate delta or population-scale calibration to the user's
45
+ desired granularity. When no scale is established, explore a clearly labeled
46
+ sensitivity path or ask about the target scale rather than inventing certainty.
47
+
48
+ Use [the interface reference](references/interfaces.md) for CLI configuration,
49
+ result reuse and the distinctions needed to interpret scores. Examples there
50
+ illustrate syntax; adapt their names and settings to the actual data.
51
+
52
+ ## Execute and communicate
53
+
54
+ Use `gauge_sc.evaluate`, `audit`, `select`, or their CLI wrappers. Keep input AnnData
55
+ unchanged. Save to a new result directory, retaining settings, fingerprints,
56
+ validity reasons and tables. Use `gauge.io.load_result` to resume work without refitting.
57
+ Use Python when the task needs a custom sklearn classifier or richer Scanpy work.
58
+
59
+ Show the key table and a figure appropriate to the question. ITCA+ plot helpers
60
+ return Matplotlib handles; Scanpy can display explicitly written group labels or
61
+ scores on existing embeddings. Export figures only when requested. AnnData
62
+ writeback is explicit and requires unchanged cells and original labels.
63
+
64
+ Explain the outcome in terms of supported distinctions and the specified views:
65
+
66
+ - Keep ITCA, flat ITCA+ and hierarchical split gain distinct; scores are in nats.
67
+ - Positive centered contrast is relative to the eligible-group median. Inspect
68
+ raw contributions and QC covariates before attributing a cause.
69
+ - Audit scores are group-level descriptions. Mirror screening is not a p-value,
70
+ FDR guarantee, doublet call, or evidence that a cell should be removed.
71
+ - Hierarchy decisions use conditional within-parent scores and ancestor closure;
72
+ different branches can stop at different depths under one global penalty.
73
+ - Report ineligible groups, no-threshold outcomes and relevant sensitivity. Treat
74
+ predictability as evidence about a view, not independent biological truth.
75
+
76
+ Finish with the scientific finding, chosen settings, validity limitations and
77
+ paths to useful outputs. Keep operational details proportional to the task.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "GAUGE"
3
+ short_description: "Evaluate, audit and select biological groupings"
4
+ default_prompt: "Use $gauge to evaluate my AnnData groupings and explain the result."
@@ -0,0 +1,83 @@
1
+ # Interfaces and result reuse
2
+
3
+ Use the installed version's help and Python signatures when versions differ.
4
+ The public computations are `evaluate`, `audit`, and `select`; plotting is under
5
+ `gauge.pl`, result loading under `gauge.io`, teaching data under `gauge.datasets`.
6
+
7
+ ## CLI
8
+
9
+ `gauge_sc` and `python -m gauge_sc` have the same commands:
10
+
11
+ ```bash
12
+ gauge inspect data.h5ad
13
+ gauge evaluate data.h5ad --config evaluation.json --output results/evaluation
14
+ gauge audit results/evaluation --reference molecular --contrast qc --output results/audit
15
+ gauge select results/evaluation --view molecular --delta 0.02 0.05 --output results/selection
16
+ ```
17
+
18
+ The names, paths and penalties above are syntax examples, not required settings.
19
+ `evaluate` reads JSON API keyword arguments. Choose an obs grouping column (or
20
+ list of candidates) **or** an ordered hierarchy, plus named views. Each view has
21
+ one source:
22
+
23
+ ```json
24
+ {
25
+ "groupby": "labels",
26
+ "views": {
27
+ "molecular": {"obsm": "X_pca"},
28
+ "qc": {"obs": ["total_counts", "pct_counts_mt"], "log1p": ["total_counts"]}
29
+ }
30
+ }
31
+ ```
32
+
33
+ Other sources are `{"X": true}` and `{"layer": "log_normalized"}`.
34
+ Optional evaluation fields: `n_splits`, `random_state`, `aggregation`
35
+ (`pooled` or `fold_mean`), and `min_child_cells` for hierarchy input.
36
+ The CLI uses the API's default classifier; use Python's `classifier=` for a
37
+ custom sklearn estimator/pipeline. X, layers and obsm are used as supplied.
38
+ Numeric obs views use training-fold standardization and only explicit log1p.
39
+
40
+ Audit accepts `--groupby` (required with multiple candidates),
41
+ `--min-test-cells`, and optional `--maximum-mirror-ratio` in (0, 1]. Omitting
42
+ the ratio disables candidate screening. Selection requires exactly one of
43
+ `--delta` (nonnegative nats) or `--population-ratio` in (0, 1/e], with one or
44
+ more distinct values. Calibration gives delta = -p log(p); it is not a cell-size
45
+ filter. Neither command refits a saved evaluation.
46
+
47
+ Successful analysis commands print a JSON summary and save `result.json` plus
48
+ CSV tables. Failures return exit status 2 and a JSON error on stderr. Help and
49
+ version output are plain text. Existing output directories are never overwritten.
50
+ JSON is authoritative: keep string IDs and boolean flags when loading; do not
51
+ reconstruct results from CSV with inferred numeric labels.
52
+
53
+ ## Python and interpretation
54
+
55
+ ```python
56
+ import gauge_sc as gauge
57
+
58
+ evaluation = gauge.io.load_result("results/evaluation")
59
+ audit = gauge.audit(evaluation, reference="molecular", contrast="qc")
60
+ print(audit.table)
61
+ fig = gauge.pl.audit(audit, show=False)
62
+ ```
63
+
64
+ Evaluation has `.table` (candidate/view), `.groups` (additive contributions),
65
+ `.folds`, `.predictions`, and `.metadata`. Groups use fixed whole-dataset
66
+ proportions; views of one grouping share stratified folds. Different groupings
67
+ are stratified separately. Fold variation is descriptive, not a confidence interval.
68
+
69
+ Audit subtracts reference contributions from contrast contributions, then
70
+ subtracts the median difference over eligible groups within that grouping.
71
+ Review `.metadata['screening']`, eligibility and raw differences. An absent
72
+ threshold or no eligible groups is a valid descriptive outcome.
73
+
74
+ Flat selection retains ITCA, penalty and ITCA+ in `.table`, with selected rows
75
+ in `.path`. Hierarchical selection has `.splits` and `.assignments`; top-level
76
+ roots remain fixed, ineligible/unary splits block descendants, and the objective
77
+ is total conditional split gain rather than flat partition ITCA+.
78
+
79
+ `.save(new_directory)` exists on every result kind. Loading restores tables,
80
+ settings, fingerprints and exclusion reasons; it does not retain fitted models.
81
+ `audit.write_to_adata` broadcasts group scores to cells. Hierarchical selection
82
+ writeback also needs an explicit chosen penalty when the path has multiple values.
83
+ Do not overwrite existing obs/uns keys or treat broadcast scores as cell-level calls.
@@ -0,0 +1,18 @@
1
+ version: 2
2
+ build:
3
+ os: ubuntu-24.04
4
+ tools:
5
+ python: "3.12"
6
+ jobs:
7
+ pre_build:
8
+ - python scripts/build_docs.py --prepare-only
9
+ sphinx:
10
+ configuration: artifacts/docs/source/conf.py
11
+ fail_on_warning: true
12
+ python:
13
+ install:
14
+ - method: pip
15
+ path: .
16
+ extra_requirements:
17
+ - docs
18
+ - tutorial
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 GAUGE contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,11 @@
1
+ include README.md
2
+ include LICENSE
3
+ recursive-include docs *.md *.rst *.png *.svg *.py *.css *.woff2 *.txt *.csv *.json
4
+ include .readthedocs.yaml
5
+ recursive-include notebooks *.ipynb *.md
6
+ recursive-include scripts *.py
7
+ prune artifacts
8
+ prune data
9
+ global-exclude *.h5ad
10
+ recursive-include .agents/skills/gauge *.md *.yaml
11
+ recursive-include reproduction *.py *.md *.json
@@ -0,0 +1,107 @@
1
+ Metadata-Version: 2.4
2
+ Name: gauge-sc
3
+ Version: 0.1.0a2
4
+ Summary: View-specific evaluation and audit of biological groupings
5
+ License-Expression: MIT AND OFL-1.1
6
+ Project-URL: Source, https://github.com/zhanglabtools/gauge-sc
7
+ Requires-Python: >=3.10
8
+ Description-Content-Type: text/markdown
9
+ License-File: LICENSE
10
+ License-File: src/gauge_sc/fonts/LICENSE.txt
11
+ Requires-Dist: numpy>=1.23
12
+ Requires-Dist: pandas>=1.5
13
+ Requires-Dist: scipy>=1.9
14
+ Requires-Dist: scikit-learn>=1.2
15
+ Requires-Dist: anndata>=0.9
16
+ Requires-Dist: matplotlib>=3.7
17
+ Requires-Dist: seaborn>=0.13
18
+ Provides-Extra: validation
19
+ Requires-Dist: scanpy>=1.9; extra == "validation"
20
+ Requires-Dist: igraph>=0.10; extra == "validation"
21
+ Requires-Dist: leidenalg>=0.9; extra == "validation"
22
+ Provides-Extra: tutorial
23
+ Requires-Dist: scanpy>=1.9; extra == "tutorial"
24
+ Requires-Dist: igraph>=0.10; extra == "tutorial"
25
+ Requires-Dist: nbformat>=5; extra == "tutorial"
26
+ Requires-Dist: nbclient>=0.8; extra == "tutorial"
27
+ Requires-Dist: ipykernel>=6; extra == "tutorial"
28
+ Provides-Extra: docs
29
+ Requires-Dist: sphinx<9,>=8; extra == "docs"
30
+ Requires-Dist: furo>=2024.8.6; extra == "docs"
31
+ Requires-Dist: myst-nb<2,>=1.2; extra == "docs"
32
+ Requires-Dist: sphinx-copybutton<1,>=0.5; extra == "docs"
33
+ Requires-Dist: sphinx-design<1,>=0.6; extra == "docs"
34
+ Provides-Extra: reproduction
35
+ Requires-Dist: scanpy>=1.9; extra == "reproduction"
36
+ Requires-Dist: igraph>=0.10; extra == "reproduction"
37
+ Requires-Dist: leidenalg>=0.9; extra == "reproduction"
38
+ Provides-Extra: dev
39
+ Requires-Dist: pytest>=7; extra == "dev"
40
+ Requires-Dist: black>=23; extra == "dev"
41
+ Requires-Dist: build>=1; extra == "dev"
42
+ Requires-Dist: ipython>=8; extra == "dev"
43
+ Dynamic: license-file
44
+
45
+ <p align="center">
46
+ <picture>
47
+ <source media="(prefers-color-scheme: dark)" srcset="docs/_static/brand/gauge_sc-logo-dark.svg">
48
+ <source media="(prefers-color-scheme: light)" srcset="docs/_static/brand/gauge_sc-logo-light.svg">
49
+ <img alt="GAUGE" src="docs/_static/brand/gauge_sc-logo-light.svg" width="420">
50
+ </picture>
51
+ </p>
52
+
53
+ GAUGE evaluates biological groupings in single-cell and spatial transcriptomics.
54
+ Use ITCA to measure how well a data view predicts group assignments and to
55
+ compare molecular and quality-control (QC) contributions. Use ITCA+ to select
56
+ a grouping from flat or hierarchical candidates.
57
+
58
+ - **[Tutorials](docs/real-data-tutorials.md)** · Learn GAUGE with runnable notebooks and real datasets.
59
+ - **[Paper reproduction](reproduction/README.md)** · Browse Figures 1–6 and redraw the 41 results from frozen source tables.
60
+
61
+ ## Install
62
+
63
+ Use Python 3.10 or newer. From the root of a GAUGE software checkout, run:
64
+
65
+ ```bash
66
+ python -m pip install .
67
+ ```
68
+
69
+ The Python distribution is `gauge-sc`, the module is `gauge_sc`, and the CLI
70
+ command is `gauge`. For the notebook dependencies, install with
71
+ `python -m pip install ".[tutorial]"`. Real-data inputs are available from
72
+ the [tutorial data release](https://github.com/zhanglabtools/gauge-sc/releases/tag/tutorial-data-v1).
73
+
74
+ ## Quick start
75
+
76
+ Compare how much the molecular and QC views support each group in a synthetic
77
+ dataset that ships with GAUGE.
78
+
79
+ ```python
80
+ import gauge_sc as gauge
81
+
82
+ adata = gauge.datasets.audit_example()
83
+ evaluation = gauge.evaluate(
84
+ adata,
85
+ groupby="group",
86
+ views={
87
+ "molecular": {"obsm": "X_pca"},
88
+ "qc": {
89
+ "obs": ["total_counts", "n_genes_by_counts", "pct_counts_mt"],
90
+ "log1p": ["total_counts", "n_genes_by_counts"],
91
+ },
92
+ },
93
+ )
94
+ audit = gauge.audit(evaluation, reference="molecular", contrast="qc")
95
+ print(audit.table)
96
+ ```
97
+
98
+ Run the [view-specific audit notebook](notebooks/01_view_specific_audit.ipynb)
99
+ for plots, or the [grouping selection notebook](notebooks/00_select_grouping.ipynb)
100
+ to try ITCA+.
101
+
102
+ [Python API](docs/api.md) · [CLI](docs/cli.md) · [Agent skill](docs/agents.md)
103
+
104
+ ## License
105
+
106
+ GAUGE software is available under the [MIT License](LICENSE). The bundled Inter
107
+ fonts use the [SIL Open Font License 1.1](src/gauge_sc/fonts/LICENSE.txt).
@@ -0,0 +1,63 @@
1
+ <p align="center">
2
+ <picture>
3
+ <source media="(prefers-color-scheme: dark)" srcset="docs/_static/brand/gauge_sc-logo-dark.svg">
4
+ <source media="(prefers-color-scheme: light)" srcset="docs/_static/brand/gauge_sc-logo-light.svg">
5
+ <img alt="GAUGE" src="docs/_static/brand/gauge_sc-logo-light.svg" width="420">
6
+ </picture>
7
+ </p>
8
+
9
+ GAUGE evaluates biological groupings in single-cell and spatial transcriptomics.
10
+ Use ITCA to measure how well a data view predicts group assignments and to
11
+ compare molecular and quality-control (QC) contributions. Use ITCA+ to select
12
+ a grouping from flat or hierarchical candidates.
13
+
14
+ - **[Tutorials](docs/real-data-tutorials.md)** · Learn GAUGE with runnable notebooks and real datasets.
15
+ - **[Paper reproduction](reproduction/README.md)** · Browse Figures 1–6 and redraw the 41 results from frozen source tables.
16
+
17
+ ## Install
18
+
19
+ Use Python 3.10 or newer. From the root of a GAUGE software checkout, run:
20
+
21
+ ```bash
22
+ python -m pip install .
23
+ ```
24
+
25
+ The Python distribution is `gauge-sc`, the module is `gauge_sc`, and the CLI
26
+ command is `gauge`. For the notebook dependencies, install with
27
+ `python -m pip install ".[tutorial]"`. Real-data inputs are available from
28
+ the [tutorial data release](https://github.com/zhanglabtools/gauge-sc/releases/tag/tutorial-data-v1).
29
+
30
+ ## Quick start
31
+
32
+ Compare how much the molecular and QC views support each group in a synthetic
33
+ dataset that ships with GAUGE.
34
+
35
+ ```python
36
+ import gauge_sc as gauge
37
+
38
+ adata = gauge.datasets.audit_example()
39
+ evaluation = gauge.evaluate(
40
+ adata,
41
+ groupby="group",
42
+ views={
43
+ "molecular": {"obsm": "X_pca"},
44
+ "qc": {
45
+ "obs": ["total_counts", "n_genes_by_counts", "pct_counts_mt"],
46
+ "log1p": ["total_counts", "n_genes_by_counts"],
47
+ },
48
+ },
49
+ )
50
+ audit = gauge.audit(evaluation, reference="molecular", contrast="qc")
51
+ print(audit.table)
52
+ ```
53
+
54
+ Run the [view-specific audit notebook](notebooks/01_view_specific_audit.ipynb)
55
+ for plots, or the [grouping selection notebook](notebooks/00_select_grouping.ipynb)
56
+ to try ITCA+.
57
+
58
+ [Python API](docs/api.md) · [CLI](docs/cli.md) · [Agent skill](docs/agents.md)
59
+
60
+ ## License
61
+
62
+ GAUGE software is available under the [MIT License](LICENSE). The bundled Inter
63
+ fonts use the [SIL Open Font License 1.1](src/gauge_sc/fonts/LICENSE.txt).
@@ -0,0 +1,92 @@
1
+ Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)
2
+
3
+ This Font Software is licensed under the SIL Open Font License, Version 1.1.
4
+ This license is copied below, and is also available with a FAQ at:
5
+ http://scripts.sil.org/OFL
6
+
7
+ -----------------------------------------------------------
8
+ SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
9
+ -----------------------------------------------------------
10
+
11
+ PREAMBLE
12
+ The goals of the Open Font License (OFL) are to stimulate worldwide
13
+ development of collaborative font projects, to support the font creation
14
+ efforts of academic and linguistic communities, and to provide a free and
15
+ open framework in which fonts may be shared and improved in partnership
16
+ with others.
17
+
18
+ The OFL allows the licensed fonts to be used, studied, modified and
19
+ redistributed freely as long as they are not sold by themselves. The
20
+ fonts, including any derivative works, can be bundled, embedded,
21
+ redistributed and/or sold with any software provided that any reserved
22
+ names are not used by derivative works. The fonts and derivatives,
23
+ however, cannot be released under any other type of license. The
24
+ requirement for fonts to remain under this license does not apply
25
+ to any document created using the fonts or their derivatives.
26
+
27
+ DEFINITIONS
28
+ "Font Software" refers to the set of files released by the Copyright
29
+ Holder(s) under this license and clearly marked as such. This may
30
+ include source files, build scripts and documentation.
31
+
32
+ "Reserved Font Name" refers to any names specified as such after the
33
+ copyright statement(s).
34
+
35
+ "Original Version" refers to the collection of Font Software components as
36
+ distributed by the Copyright Holder(s).
37
+
38
+ "Modified Version" refers to any derivative made by adding to, deleting,
39
+ or substituting -- in part or in whole -- any of the components of the
40
+ Original Version, by changing formats or by porting the Font Software to a
41
+ new environment.
42
+
43
+ "Author" refers to any designer, engineer, programmer, technical
44
+ writer or other person who contributed to the Font Software.
45
+
46
+ PERMISSION AND CONDITIONS
47
+ Permission is hereby granted, free of charge, to any person obtaining
48
+ a copy of the Font Software, to use, study, copy, merge, embed, modify,
49
+ redistribute, and sell modified and unmodified copies of the Font
50
+ Software, subject to the following conditions:
51
+
52
+ 1) Neither the Font Software nor any of its individual components,
53
+ in Original or Modified Versions, may be sold by itself.
54
+
55
+ 2) Original or Modified Versions of the Font Software may be bundled,
56
+ redistributed and/or sold with any software, provided that each copy
57
+ contains the above copyright notice and this license. These can be
58
+ included either as stand-alone text files, human-readable headers or
59
+ in the appropriate machine-readable metadata fields within text or
60
+ binary files as long as those fields can be easily viewed by the user.
61
+
62
+ 3) No Modified Version of the Font Software may use the Reserved Font
63
+ Name(s) unless explicit written permission is granted by the corresponding
64
+ Copyright Holder. This restriction only applies to the primary font name as
65
+ presented to the users.
66
+
67
+ 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
68
+ Software shall not be used to promote, endorse or advertise any
69
+ Modified Version, except to acknowledge the contribution(s) of the
70
+ Copyright Holder(s) and the Author(s) or with their explicit written
71
+ permission.
72
+
73
+ 5) The Font Software, modified or unmodified, in part or in whole,
74
+ must be distributed entirely under this license, and must not be
75
+ distributed under any other license. The requirement for fonts to
76
+ remain under this license does not apply to any document created
77
+ using the Font Software.
78
+
79
+ TERMINATION
80
+ This license becomes null and void if any of the above conditions are
81
+ not met.
82
+
83
+ DISCLAIMER
84
+ THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
85
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
86
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
87
+ OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
88
+ COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
89
+ INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
90
+ DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
91
+ FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
92
+ OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -0,0 +1,6 @@
1
+ GAUGE adaptive-canopy mark, redrawn as native SVG from the author's approved reference.
2
+ Lettering uses Inter Bold outlines and requires no installed fonts.
3
+ Light: blue #0072B2, sky blue #56B4E9, orange #E69F00, ink #111111.
4
+ Dark: blue #75C7EE, sky blue #B4DFF4, orange #F4B942, ink #F8FAFC.
5
+ Logo and icon files have transparent backgrounds. Favicon SVGs omit the fine lower branches.
6
+ Regenerate SVGs with python scripts/generate_logo.py. Font attribution is in Inter-LICENSE.txt.
@@ -0,0 +1,14 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 184.00 184" role="img" aria-label="GAUGE canopy">
2
+ <title>GAUGE canopy</title>
3
+ <desc></desc>
4
+ <path fill="#75C7EE" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#75C7EE" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ </g>
10
+ <circle cx="92" cy="32" r="28" fill="#75C7EE"/>
11
+ <circle cx="39" cy="58" r="24" fill="#75C7EE"/>
12
+ <circle cx="144" cy="52" r="21" fill="#B4DFF4"/>
13
+ <circle cx="156" cy="94" r="15" fill="#F4B942"/>
14
+ </svg>
@@ -0,0 +1,14 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 184.00 184" role="img" aria-label="GAUGE canopy">
2
+ <title>GAUGE canopy</title>
3
+ <desc></desc>
4
+ <path fill="#0072B2" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#0072B2" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ </g>
10
+ <circle cx="92" cy="32" r="28" fill="#0072B2"/>
11
+ <circle cx="39" cy="58" r="24" fill="#0072B2"/>
12
+ <circle cx="144" cy="52" r="21" fill="#56B4E9"/>
13
+ <circle cx="156" cy="94" r="15" fill="#E69F00"/>
14
+ </svg>
@@ -0,0 +1,24 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 184.00 184" role="img" aria-label="GAUGE canopy">
2
+ <title>GAUGE canopy</title>
3
+ <desc>An adaptive canopy: broad crowns and fine branches share a tapered trunk. One crown is highlighted in orange.</desc>
4
+ <path fill="#75C7EE" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#75C7EE" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ <path d="M90 160 C80 137 74 125 57 123 C40 123 29 113 22 103" stroke-width="7"/>
10
+ <path d="M57 123 C51 116 47 109 47 102" stroke-width="4.5"/>
11
+ <path d="M49 122 C40 124 32 126 27 127" stroke-width="4.5"/>
12
+ <path d="M99 161 C113 145 127 147 134 131 C137 125 141 122 146 121" stroke-width="5.5"/>
13
+ <path d="M116 147 C124 147 129 145 133 141" stroke-width="4.5"/>
14
+ </g>
15
+ <circle cx="92" cy="32" r="28" fill="#75C7EE"/>
16
+ <circle cx="39" cy="58" r="24" fill="#75C7EE"/>
17
+ <circle cx="144" cy="52" r="21" fill="#B4DFF4"/>
18
+ <circle cx="156" cy="94" r="15" fill="#F4B942"/>
19
+ <circle cx="20" cy="99" r="11" fill="#B4DFF4"/>
20
+ <circle cx="47" cy="99" r="7" fill="#B4DFF4"/>
21
+ <circle cx="26" cy="127" r="7.5" fill="#B4DFF4"/>
22
+ <circle cx="146" cy="121" r="8" fill="#B4DFF4"/>
23
+ <circle cx="132" cy="141" r="7.5" fill="#B4DFF4"/>
24
+ </svg>
@@ -0,0 +1,24 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 184.00 184" role="img" aria-label="GAUGE canopy">
2
+ <title>GAUGE canopy</title>
3
+ <desc>An adaptive canopy: broad crowns and fine branches share a tapered trunk. One crown is highlighted in orange.</desc>
4
+ <path fill="#0072B2" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#0072B2" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ <path d="M90 160 C80 137 74 125 57 123 C40 123 29 113 22 103" stroke-width="7"/>
10
+ <path d="M57 123 C51 116 47 109 47 102" stroke-width="4.5"/>
11
+ <path d="M49 122 C40 124 32 126 27 127" stroke-width="4.5"/>
12
+ <path d="M99 161 C113 145 127 147 134 131 C137 125 141 122 146 121" stroke-width="5.5"/>
13
+ <path d="M116 147 C124 147 129 145 133 141" stroke-width="4.5"/>
14
+ </g>
15
+ <circle cx="92" cy="32" r="28" fill="#0072B2"/>
16
+ <circle cx="39" cy="58" r="24" fill="#0072B2"/>
17
+ <circle cx="144" cy="52" r="21" fill="#56B4E9"/>
18
+ <circle cx="156" cy="94" r="15" fill="#E69F00"/>
19
+ <circle cx="20" cy="99" r="11" fill="#56B4E9"/>
20
+ <circle cx="47" cy="99" r="7" fill="#56B4E9"/>
21
+ <circle cx="26" cy="127" r="7.5" fill="#56B4E9"/>
22
+ <circle cx="146" cy="121" r="8" fill="#56B4E9"/>
23
+ <circle cx="132" cy="141" r="7.5" fill="#56B4E9"/>
24
+ </svg>
@@ -0,0 +1,31 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 606.06 184" role="img" aria-label="GAUGE">
2
+ <title>GAUGE</title>
3
+ <desc>An adaptive canopy: broad crowns and fine branches share a tapered trunk. One crown is highlighted in orange.</desc>
4
+ <path fill="#75C7EE" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#75C7EE" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ <path d="M90 160 C80 137 74 125 57 123 C40 123 29 113 22 103" stroke-width="7"/>
10
+ <path d="M57 123 C51 116 47 109 47 102" stroke-width="4.5"/>
11
+ <path d="M49 122 C40 124 32 126 27 127" stroke-width="4.5"/>
12
+ <path d="M99 161 C113 145 127 147 134 131 C137 125 141 122 146 121" stroke-width="5.5"/>
13
+ <path d="M116 147 C124 147 129 145 133 141" stroke-width="4.5"/>
14
+ </g>
15
+ <circle cx="92" cy="32" r="28" fill="#75C7EE"/>
16
+ <circle cx="39" cy="58" r="24" fill="#75C7EE"/>
17
+ <circle cx="144" cy="52" r="21" fill="#B4DFF4"/>
18
+ <circle cx="156" cy="94" r="15" fill="#F4B942"/>
19
+ <circle cx="20" cy="99" r="11" fill="#B4DFF4"/>
20
+ <circle cx="47" cy="99" r="7" fill="#B4DFF4"/>
21
+ <circle cx="26" cy="127" r="7.5" fill="#B4DFF4"/>
22
+ <circle cx="146" cy="121" r="8" fill="#B4DFF4"/>
23
+ <circle cx="132" cy="141" r="7.5" fill="#B4DFF4"/>
24
+ <g fill="#F8FAFC" transform="translate(205 135) scale(0.052734375 -0.052734375)">
25
+ <path d="M795 -20C1169 -20 1438 217 1438 608V794H818V562H1142C1137 371 1009 251 797 251C558 251 404 430 404 746C404 1062 563 1239 793 1239C959 1239 1071 1152 1113 1010H1423C1381 1304 1123 1510 788 1510C396 1510 94 1226 94 743C94 272 377 -20 795 -20Z" transform="translate(0 0)"/>
26
+ <path d="M49 0H386L497 346H1026L1141 0H1480L958 1490H558ZM573 585 616 719C661 869 705 1046 755 1251C807 1048 854 872 902 719L947 585Z" transform="translate(1513 0)"/>
27
+ <path d="M750 -21C1118 -21 1365 197 1365 523V1490H1059V548C1059 374 937 249 750 249C563 249 440 374 440 548V1490H135V523C135 197 379 -21 750 -21Z" transform="translate(3018 0)"/>
28
+ <path d="M795 -20C1169 -20 1438 217 1438 608V794H818V562H1142C1137 371 1009 251 797 251C558 251 404 430 404 746C404 1062 563 1239 793 1239C959 1239 1071 1152 1113 1010H1423C1381 1304 1123 1510 788 1510C396 1510 94 1226 94 743C94 272 377 -20 795 -20Z" transform="translate(4493 0)"/>
29
+ <path d="M135 0H1134V253H440V628H1080V877H440V1237H1132V1490H135Z" transform="translate(6006 0)"/>
30
+ </g>
31
+ </svg>
@@ -0,0 +1,31 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 606.06 184" role="img" aria-label="GAUGE">
2
+ <title>GAUGE</title>
3
+ <desc>An adaptive canopy: broad crowns and fine branches share a tapered trunk. One crown is highlighted in orange.</desc>
4
+ <path fill="#0072B2" d="M82 177 C88 155 87 129 88 101 L88 49 C88 45 96 45 96 49 L96 102 C96 128 97 154 102 177Z"/>
5
+ <g fill="none" stroke="#0072B2" stroke-linecap="round" stroke-linejoin="round">
6
+ <path d="M91 108 C87 92 62 85 49 66" stroke-width="8.5"/>
7
+ <path d="M95 136 C112 111 107 98 115 82 C121 73 133 66 140 57" stroke-width="8.5"/>
8
+ <path d="M98 133 C114 113 130 107 150 97" stroke-width="8"/>
9
+ <path d="M90 160 C80 137 74 125 57 123 C40 123 29 113 22 103" stroke-width="7"/>
10
+ <path d="M57 123 C51 116 47 109 47 102" stroke-width="4.5"/>
11
+ <path d="M49 122 C40 124 32 126 27 127" stroke-width="4.5"/>
12
+ <path d="M99 161 C113 145 127 147 134 131 C137 125 141 122 146 121" stroke-width="5.5"/>
13
+ <path d="M116 147 C124 147 129 145 133 141" stroke-width="4.5"/>
14
+ </g>
15
+ <circle cx="92" cy="32" r="28" fill="#0072B2"/>
16
+ <circle cx="39" cy="58" r="24" fill="#0072B2"/>
17
+ <circle cx="144" cy="52" r="21" fill="#56B4E9"/>
18
+ <circle cx="156" cy="94" r="15" fill="#E69F00"/>
19
+ <circle cx="20" cy="99" r="11" fill="#56B4E9"/>
20
+ <circle cx="47" cy="99" r="7" fill="#56B4E9"/>
21
+ <circle cx="26" cy="127" r="7.5" fill="#56B4E9"/>
22
+ <circle cx="146" cy="121" r="8" fill="#56B4E9"/>
23
+ <circle cx="132" cy="141" r="7.5" fill="#56B4E9"/>
24
+ <g fill="#111111" transform="translate(205 135) scale(0.052734375 -0.052734375)">
25
+ <path d="M795 -20C1169 -20 1438 217 1438 608V794H818V562H1142C1137 371 1009 251 797 251C558 251 404 430 404 746C404 1062 563 1239 793 1239C959 1239 1071 1152 1113 1010H1423C1381 1304 1123 1510 788 1510C396 1510 94 1226 94 743C94 272 377 -20 795 -20Z" transform="translate(0 0)"/>
26
+ <path d="M49 0H386L497 346H1026L1141 0H1480L958 1490H558ZM573 585 616 719C661 869 705 1046 755 1251C807 1048 854 872 902 719L947 585Z" transform="translate(1513 0)"/>
27
+ <path d="M750 -21C1118 -21 1365 197 1365 523V1490H1059V548C1059 374 937 249 750 249C563 249 440 374 440 548V1490H135V523C135 197 379 -21 750 -21Z" transform="translate(3018 0)"/>
28
+ <path d="M795 -20C1169 -20 1438 217 1438 608V794H818V562H1142C1137 371 1009 251 797 251C558 251 404 430 404 746C404 1062 563 1239 793 1239C959 1239 1071 1152 1113 1010H1423C1381 1304 1123 1510 788 1510C396 1510 94 1226 94 743C94 272 377 -20 795 -20Z" transform="translate(4493 0)"/>
29
+ <path d="M135 0H1134V253H440V628H1080V877H440V1237H1132V1490H135Z" transform="translate(6006 0)"/>
30
+ </g>
31
+ </svg>