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.
- gauge_sc-0.1.0a2/.agents/skills/gauge/SKILL.md +77 -0
- gauge_sc-0.1.0a2/.agents/skills/gauge/agents/openai.yaml +4 -0
- gauge_sc-0.1.0a2/.agents/skills/gauge/references/interfaces.md +83 -0
- gauge_sc-0.1.0a2/.readthedocs.yaml +18 -0
- gauge_sc-0.1.0a2/LICENSE +21 -0
- gauge_sc-0.1.0a2/MANIFEST.in +11 -0
- gauge_sc-0.1.0a2/PKG-INFO +107 -0
- gauge_sc-0.1.0a2/README.md +63 -0
- gauge_sc-0.1.0a2/docs/_static/brand/Inter-LICENSE.txt +92 -0
- gauge_sc-0.1.0a2/docs/_static/brand/README.txt +6 -0
- gauge_sc-0.1.0a2/docs/_static/brand/favicon.png +0 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-favicon-dark.svg +14 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-favicon-light.svg +14 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-icon-dark.svg +24 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-icon-light.svg +24 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-logo-dark.svg +31 -0
- gauge_sc-0.1.0a2/docs/_static/brand/gauge_sc-logo-light.svg +31 -0
- gauge_sc-0.1.0a2/docs/_static/custom.css +24 -0
- gauge_sc-0.1.0a2/docs/_static/fonts/InterVariable.woff2 +0 -0
- gauge_sc-0.1.0a2/docs/_static/fonts/LICENSE.txt +92 -0
- gauge_sc-0.1.0a2/docs/_static/fonts/README.md +6 -0
- gauge_sc-0.1.0a2/docs/agents.md +90 -0
- gauge_sc-0.1.0a2/docs/api.md +336 -0
- gauge_sc-0.1.0a2/docs/applications.md +18 -0
- gauge_sc-0.1.0a2/docs/assets/README.md +7 -0
- gauge_sc-0.1.0a2/docs/assets/agent-audit-run.json +240 -0
- gauge_sc-0.1.0a2/docs/assets/agent-audit-summary.md +3 -0
- gauge_sc-0.1.0a2/docs/assets/agent-audit-table.csv +8 -0
- gauge_sc-0.1.0a2/docs/assets/agent-audit.svg +1305 -0
- gauge_sc-0.1.0a2/docs/assets/application-audit.svg +113 -0
- gauge_sc-0.1.0a2/docs/assets/application-hierarchy.svg +346 -0
- gauge_sc-0.1.0a2/docs/assets/application-selection.svg +108 -0
- gauge_sc-0.1.0a2/docs/assets/application-workflow.svg +294 -0
- gauge_sc-0.1.0a2/docs/assets/concept-groupings.png +0 -0
- gauge_sc-0.1.0a2/docs/assets/concept-views.png +0 -0
- gauge_sc-0.1.0a2/docs/cli.md +86 -0
- gauge_sc-0.1.0a2/docs/concepts.md +68 -0
- gauge_sc-0.1.0a2/docs/conf.py +55 -0
- gauge_sc-0.1.0a2/docs/data-release.md +24 -0
- gauge_sc-0.1.0a2/docs/data.md +53 -0
- gauge_sc-0.1.0a2/docs/development.md +40 -0
- gauge_sc-0.1.0a2/docs/index.md +129 -0
- gauge_sc-0.1.0a2/docs/installation.md +33 -0
- gauge_sc-0.1.0a2/docs/numerical-reproducibility.md +28 -0
- gauge_sc-0.1.0a2/docs/paper-reproduction.md +21 -0
- gauge_sc-0.1.0a2/docs/real-data-tutorials.md +77 -0
- gauge_sc-0.1.0a2/docs/recipes.md +204 -0
- gauge_sc-0.1.0a2/docs/reference.rst +64 -0
- gauge_sc-0.1.0a2/docs/reproduce-figure4.md +26 -0
- gauge_sc-0.1.0a2/notebooks/00_concepts.ipynb +228 -0
- gauge_sc-0.1.0a2/notebooks/00_select_grouping.ipynb +130 -0
- gauge_sc-0.1.0a2/notebooks/01_view_specific_audit.ipynb +151 -0
- gauge_sc-0.1.0a2/notebooks/02_audit_sensitivity.ipynb +111 -0
- gauge_sc-0.1.0a2/notebooks/03_compare_groupings.ipynb +107 -0
- gauge_sc-0.1.0a2/notebooks/04_transferred_labels.ipynb +123 -0
- gauge_sc-0.1.0a2/notebooks/05_stress_checks.ipynb +194 -0
- gauge_sc-0.1.0a2/notebooks/06_hierarchy_spatial.ipynb +131 -0
- gauge_sc-0.1.0a2/notebooks/07_agent_audit.ipynb +231 -0
- gauge_sc-0.1.0a2/notebooks/README.md +29 -0
- gauge_sc-0.1.0a2/notebooks/real_data/10_platform_profiles.ipynb +618 -0
- gauge_sc-0.1.0a2/notebooks/real_data/11_mixture_audit.ipynb +807 -0
- gauge_sc-0.1.0a2/notebooks/real_data/12_spatial_hierarchy.ipynb +834 -0
- gauge_sc-0.1.0a2/notebooks/real_data/13_workflow_endpoints.ipynb +652 -0
- gauge_sc-0.1.0a2/notebooks/real_data/14_allen_granularity.ipynb +536 -0
- gauge_sc-0.1.0a2/pyproject.toml +40 -0
- gauge_sc-0.1.0a2/reproduction/DATA-SOURCES.md +19 -0
- gauge_sc-0.1.0a2/reproduction/PUBLIC-README.md +34 -0
- gauge_sc-0.1.0a2/reproduction/README.md +12 -0
- gauge_sc-0.1.0a2/reproduction/fetch_cosmx_metadata.py +97 -0
- gauge_sc-0.1.0a2/reproduction/package_figure4.py +70 -0
- gauge_sc-0.1.0a2/reproduction/package_public_results.py +164 -0
- gauge_sc-0.1.0a2/reproduction/panels.json +381 -0
- gauge_sc-0.1.0a2/reproduction/render.py +990 -0
- gauge_sc-0.1.0a2/reproduction/source_asset.py +21 -0
- gauge_sc-0.1.0a2/reproduction/validate.py +306 -0
- gauge_sc-0.1.0a2/scripts/build_docs.py +109 -0
- gauge_sc-0.1.0a2/scripts/check_allen_stability.py +138 -0
- gauge_sc-0.1.0a2/scripts/check_notebook.py +22 -0
- gauge_sc-0.1.0a2/scripts/check_real_data.py +173 -0
- gauge_sc-0.1.0a2/scripts/check_real_notebooks.py +99 -0
- gauge_sc-0.1.0a2/scripts/check_research_parity.py +193 -0
- gauge_sc-0.1.0a2/scripts/generate_logo.py +136 -0
- gauge_sc-0.1.0a2/scripts/package_tutorial_data.py +99 -0
- gauge_sc-0.1.0a2/scripts/prepare_tutorial_data.py +174 -0
- gauge_sc-0.1.0a2/scripts/render_agent_workflow.py +78 -0
- gauge_sc-0.1.0a2/scripts/render_concept_assets.py +31 -0
- gauge_sc-0.1.0a2/setup.cfg +4 -0
- gauge_sc-0.1.0a2/src/gauge_sc/__init__.py +9 -0
- gauge_sc-0.1.0a2/src/gauge_sc/__main__.py +5 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_audit.py +196 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_evaluate.py +355 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_hierarchy.py +318 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_results.py +211 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_select.py +132 -0
- gauge_sc-0.1.0a2/src/gauge_sc/_tutorial_data.py +133 -0
- gauge_sc-0.1.0a2/src/gauge_sc/cli.py +181 -0
- gauge_sc-0.1.0a2/src/gauge_sc/datasets.py +75 -0
- gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Bold.otf +0 -0
- gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Medium.otf +0 -0
- gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-Regular.otf +0 -0
- gauge_sc-0.1.0a2/src/gauge_sc/fonts/Inter-SemiBold.otf +0 -0
- gauge_sc-0.1.0a2/src/gauge_sc/fonts/LICENSE.txt +92 -0
- gauge_sc-0.1.0a2/src/gauge_sc/io.py +259 -0
- gauge_sc-0.1.0a2/src/gauge_sc/pl.py +949 -0
- gauge_sc-0.1.0a2/src/gauge_sc/tutorial_data.json +73 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/PKG-INFO +107 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/SOURCES.txt +118 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/dependency_links.txt +1 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/entry_points.txt +2 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/requires.txt +37 -0
- gauge_sc-0.1.0a2/src/gauge_sc.egg-info/top_level.txt +1 -0
- gauge_sc-0.1.0a2/tests/test_application_tutorials.py +140 -0
- gauge_sc-0.1.0a2/tests/test_hierarchy.py +226 -0
- gauge_sc-0.1.0a2/tests/test_io_cli.py +426 -0
- gauge_sc-0.1.0a2/tests/test_plotting.py +262 -0
- gauge_sc-0.1.0a2/tests/test_reproduction_integrity.py +105 -0
- gauge_sc-0.1.0a2/tests/test_selection.py +140 -0
- gauge_sc-0.1.0a2/tests/test_spatial_tutorial_palette.py +62 -0
- gauge_sc-0.1.0a2/tests/test_tutorial_data.py +124 -0
- 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,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
|
gauge_sc-0.1.0a2/LICENSE
ADDED
|
@@ -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.
|
|
Binary file
|
|
@@ -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>
|