shesha-geometry 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

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.
shesha/__init__.py CHANGED
@@ -42,7 +42,7 @@ from .core import (
42
42
 
43
43
  from . import bio
44
44
 
45
- __version__ = "0.1.0"
45
+ __version__ = "0.1.2"
46
46
  __author__ = "Prashant Raju"
47
47
 
48
48
  __all__ = [
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: shesha-geometry
3
- Version: 0.1.0
3
+ Version: 0.1.2
4
4
  Summary: Self-consistency metrics for representational stability analysis
5
5
  Author-email: Prashant Raju <rajuprashant@gmail.com>
6
6
  License: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://github.com/prashantcraju/shesha
8
8
  Project-URL: Documentation, https://github.com/prashantcraju/shesha#readme
9
9
  Project-URL: Repository, https://github.com/prashantcraju/shesha
10
10
  Project-URL: Issues, https://github.com/prashantcraju/shesha/issues
11
- Keywords: representation learning,neural networks,geometric stability,geometric analysis,manifold analysis,latent space,single-cell,crispr,perturb-seq,anndata,functional genomics,phenotypic stability,computational biology,scanpy,llm alignment,concept drift,model steering,ai safety,constitutional ai,perturbation analysis
11
+ Keywords: shesha,geometry,representation learning,neural networks,geometric stability,geometric analysis,manifold analysis,latent space,single-cell,crispr,perturb-seq,anndata,functional genomics,phenotypic stability,computational biology,scanpy,llm alignment,concept drift,model steering,ai safety,constitutional ai,perturbation analysis
12
12
  Classifier: Development Status :: 4 - Beta
13
13
  Classifier: Intended Audience :: Science/Research
14
14
  Classifier: License :: OSI Approved :: MIT License
@@ -19,6 +19,9 @@ Classifier: Programming Language :: Python :: 3.10
19
19
  Classifier: Programming Language :: Python :: 3.11
20
20
  Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Topic :: Scientific/Engineering
22
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
23
+ Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
24
+ Classifier: Topic :: Scientific/Engineering :: Mathematics
22
25
  Requires-Python: >=3.8
23
26
  Description-Content-Type: text/markdown
24
27
  License-File: LICENSE
@@ -31,6 +34,7 @@ Requires-Dist: pytest-cov; extra == "dev"
31
34
  Requires-Dist: black; extra == "dev"
32
35
  Requires-Dist: ruff; extra == "dev"
33
36
 
37
+ [![PyPI version](https://img.shields.io/pypi/v/shesha-geometry.svg)](https://pypi.org/project/shesha-geometry/)
34
38
  [![DOI](https://zenodo.org/badge/1133185691.svg)](https://doi.org/10.5281/zenodo.18227453)
35
39
  <p align="center">
36
40
  <img src="https://i.imgur.com/oJ5YhBo.jpg" alt="Shesha Logo" width="300">
@@ -218,6 +222,18 @@ print(f"KLF1 Magnitude: {magnitude['KLF1']:.3f}") # e.g., 2.40 (High = Strong)
218
222
  ```
219
223
 
220
224
 
225
+ ## Tutorials
226
+
227
+ Explore `shesha` with these interactive notebooks:
228
+
229
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/llm_embeddings_tutorial.ipynb) **LLM Embeddings**: **Geometric Stability:** Analyze embedding stability across layers and models using `feature_split`.
230
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/steering_vectors_tutorial.ipynb) **Steering Vectors**: **Consistency Analysis:** Compute steering vectors from contrastive pairs and measure their effectiveness and consistency.
231
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/vision_models_tutorial.ipynb) **Vision Models**: **Architecture Comparison:** Compare geometric stability and class separability across ResNets, ViTs, and other vision architectures.
232
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/drift_tutorial.ipynb) **Representational Drift**: **Perturbation Analysis:** Measure drift caused by Gaussian noise injection and LoRA fine-tuning using `rdm_drift`.
233
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/training_drift_tutorial.ipynb) **Training Dynamics**: **Live Monitoring:** Track geometric stability during model training to detect representation collapse or divergence.
234
+ * [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/prashantcraju/shesha/blob/main/tutorials/crispr_tutorial.ipynb) **CRISPR (Bio)**: **Single-Cell Analysis:** Use `shesha.bio` to analyze stability and effect sizes in single-cell CRISPR perturbation experiments.
235
+
236
+
221
237
  ## API Reference
222
238
 
223
239
  ### `shesha.feature_split(X, n_splits=30, metric='cosine', seed=None, max_samples=1600)`
@@ -373,17 +389,17 @@ If you use `shesha-geometry`, please cite:
373
389
  title = {Shesha: Self-consistency Metrics for Representational Stability},
374
390
  author = {Prashant C. Raju},
375
391
  year = {2026},
376
- url = {https://github.com/prashantcraju/shesha},
377
392
  publisher = {Zenodo},
378
- doi = {10.5281/zenodo.18227454},
379
- note = {Python package version 0.1.0}
393
+ doi = {10.5281/zenodo.18227453},
394
+ url = {https://doi.org/10.5281/zenodo.18227453},
395
+ copyright = {MIT License}
380
396
  }
381
397
 
382
398
  @article{raju2026geometric,
383
- title={Geometric Stability: The Missing Axis of Representations},
384
- author={Prashant C. Raju},
385
- journal={arXiv},
386
- year={2026}
399
+ title={Geometric Stability: The Missing Axis of Representations},
400
+ author={Raju, Prashant C.},
401
+ journal={arXiv preprint arXiv:2601.09173},
402
+ year={2026}
387
403
  }
388
404
  ```
389
405
 
@@ -1,13 +1,13 @@
1
1
  examples/tutorial.py,sha256=HoDNK_NgCEW7_PkfOkKswNH2mitCHPJ56yuldiH8skI,12167
2
- shesha/__init__.py,sha256=KaDsrk_j30OeFn7M70nHmCXp5MJ-cumS-eiT7PZyJQY,1390
2
+ shesha/__init__.py,sha256=L_C5zLsGMT--09j7OpR_Sj5xxruQK0dGrs0jotsTGt8,1390
3
3
  shesha/bio.py,sha256=4fZHfLfkMIbAYEJ80MJreP8Hg9ApoOQUtk0uDuX1ejo,10465
4
4
  shesha/core.py,sha256=_M--xVtbOBRujpCeSNu_Ala_gTjDhfJUbv8BvaaUHGM,19986
5
5
  tests/__init__.py,sha256=YYq097nXxIO0mWUP8sqw6YS-CSjFRWVEa1lPN7ATA0U,27
6
6
  tests/test_bio.py,sha256=71poE9FbfjWnAQFYFHAiPsGbdyGurRmxX6qRxHuEths,2142
7
7
  tests/test_core.py,sha256=UmVV56VkmM71ZPySsOEKEG4_sXt9D0dvXX5cfB-EGrI,5545
8
8
  tests/test_crispr.py,sha256=tUSOgXLyvd9PkEuXZ7NeqYWMWcu0aUMcXOdP7ErVLMg,6202
9
- shesha_geometry-0.1.0.dist-info/LICENSE,sha256=HWzfciMdWWnz_MNV5xEni15hw7Jnks3FWBmhRbb-bFk,1072
10
- shesha_geometry-0.1.0.dist-info/METADATA,sha256=J_LirSGGwV0amvXS5i3F7kP9tgHzFZhanT1eHRvvrE8,13036
11
- shesha_geometry-0.1.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
12
- shesha_geometry-0.1.0.dist-info/top_level.txt,sha256=30aOCV4WW_bVgWOawbrRZPahW9ilJ-S9jd-oj4-Rucw,22
13
- shesha_geometry-0.1.0.dist-info/RECORD,,
9
+ shesha_geometry-0.1.2.dist-info/LICENSE,sha256=HWzfciMdWWnz_MNV5xEni15hw7Jnks3FWBmhRbb-bFk,1072
10
+ shesha_geometry-0.1.2.dist-info/METADATA,sha256=U49bgOEBvr6iEaPOmpcFxKVEhT0EMQ6lTz6_k9hrrvo,15429
11
+ shesha_geometry-0.1.2.dist-info/WHEEL,sha256=WnJ8fYhv8N4SYVK2lLYNI6N0kVATA7b0piVUNvqIIJE,91
12
+ shesha_geometry-0.1.2.dist-info/top_level.txt,sha256=30aOCV4WW_bVgWOawbrRZPahW9ilJ-S9jd-oj4-Rucw,22
13
+ shesha_geometry-0.1.2.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (75.3.2)
2
+ Generator: setuptools (75.3.3)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5