Metadata-Version: 2.1
Name: stars_omics
Version: 0.1.0
Summary: A spatial transcriptomics analysis tool.
Home-page: https://github.com/Zhaocy-Research/STARS/tree/main
Author: Chongyue Zhao
Author-email: zhaocy.research@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: absl-py>=2.0.0
Requires-Dist: aiobotocore>=2.5.4
Requires-Dist: aiohttp>=3.8.5
Requires-Dist: aioitertools>=0.11.0
Requires-Dist: aiosignal>=1.3.1
Requires-Dist: anndata>=0.9.2
Requires-Dist: annotated-types>=0.5.0
Requires-Dist: anyio>=3.7.1
Requires-Dist: arrow>=1.2.3
Requires-Dist: asciitree>=0.3.3
Requires-Dist: astunparse>=1.6.3
Requires-Dist: async-timeout>=4.0.3
Requires-Dist: attrs>=23.1.0
Requires-Dist: axial-positional-embedding>=0.2.1
Requires-Dist: backoff>=2.2.1
Requires-Dist: beautifulsoup4>=4.12.2
Requires-Dist: biomart>=0.9.2
Requires-Dist: blessed>=1.20.0
Requires-Dist: botocore>=1.31.17
Requires-Dist: cell2location>=0.1.3
Requires-Dist: chex>=0.1.7
Requires-Dist: click>=8.1.7
Requires-Dist: click-plugins>=1.1.1
Requires-Dist: cligj>=0.7.2
Requires-Dist: cloudpickle>=2.2.1
Requires-Dist: colorcet>=3.0.1
Requires-Dist: contextlib2>=21.6.0
Requires-Dist: cramjam>=2.8.3
Requires-Dist: croniter>=1.4.1
Requires-Dist: cryptography>=41.0.7
Requires-Dist: csbdeep>=0.8.0
Requires-Dist: dask>=2023.9.2
Requires-Dist: dask-image>=2023.8.1
Requires-Dist: datashader>=0.15.2
Requires-Dist: datashape>=0.5.2
Requires-Dist: dateutils>=0.6.12
Requires-Dist: deepdiff>=6.5.0
Requires-Dist: distributed>=2023.9.2
Requires-Dist: dm-tree>=0.1.8
Requires-Dist: docrep>=0.3.2
Requires-Dist: docutils>=0.20.1
Requires-Dist: einops>=0.6.1
Requires-Dist: entrypoints>=0.4
Requires-Dist: etils>=1.5.0
Requires-Dist: exceptiongroup>=1.1.3
Requires-Dist: fastapi>=0.103.2
Requires-Dist: fasteners>=0.19
Requires-Dist: fastparquet>=2024.2.0
Requires-Dist: filelock>=3.12.4
Requires-Dist: fiona>=1.9.4.post1
Requires-Dist: flatbuffers>=24.3.25
Requires-Dist: flax>=0.7.4
Requires-Dist: frozenlist>=1.4.0
Requires-Dist: gast>=0.6.0
Requires-Dist: geopandas>=0.14.0
Requires-Dist: google-pasta>=0.2.0
Requires-Dist: grpcio>=1.64.1
Requires-Dist: h11>=0.14.0
Requires-Dist: h5py>=3.9.0
Requires-Dist: histolab>=0.6.0
Requires-Dist: huggingface-hub>=0.17.3
Requires-Dist: igraph>=0.10.8
Requires-Dist: imagecodecs>=2024.6.1
Requires-Dist: imageio>=2.31.4
Requires-Dist: importlib-metadata>=6.8.0
Requires-Dist: importlib-resources>=6.1.0
Requires-Dist: inflect>=7.0.0
Requires-Dist: inquirer>=3.1.3
Requires-Dist: itsdangerous>=2.1.2
Requires-Dist: jaraco-classes>=3.3.0
Requires-Dist: jax>=0.4.16
Requires-Dist: jaxlib>=0.4.16
Requires-Dist: jeepney>=0.8.0
Requires-Dist: jmespath>=1.0.1
Requires-Dist: keras>=3.4.1
Requires-Dist: keyring>=24.3.0
Requires-Dist: lazy-loader>=0.3
Requires-Dist: leidenalg>=0.10.1
Requires-Dist: libclang>=18.1.1
Requires-Dist: lightning>=2.0.9.post0
Requires-Dist: lightning-cloud>=0.5.39
Requires-Dist: lightning-utilities>=0.9.0
Requires-Dist: lit>=18.1.8
Requires-Dist: littleutils>=0.2.2
Requires-Dist: llvmlite>=0.41.0
Requires-Dist: local-attention>=1.8.6
Requires-Dist: locket>=1.0.0
Requires-Dist: markdown>=3.6
Requires-Dist: markdown-it-py>=3.0.0
Requires-Dist: matplotlib-scalebar>=0.8.1
Requires-Dist: mdurl>=0.1.2
Requires-Dist: memory-profiler>=0.61.0
Requires-Dist: metric-learn>=0.7.0
Requires-Dist: ml-collections>=0.1.1
Requires-Dist: ml-dtypes>=0.3.1
Requires-Dist: more-itertools>=10.1.0
Requires-Dist: mpmath>=1.3.0
Requires-Dist: msgpack>=1.0.7
Requires-Dist: mudata>=0.2.3
Requires-Dist: multidict>=6.0.4
Requires-Dist: multipledispatch>=1.0.0
Requires-Dist: multiscale-spatial-image>=0.11.2
Requires-Dist: namex>=0.0.8
Requires-Dist: natsort>=8.4.0
Requires-Dist: nest-asyncio>=1.5.8
Requires-Dist: nh3>=0.2.15
Requires-Dist: numba>=0.58.0
Requires-Dist: numcodecs>=0.11.0
Requires-Dist: numpy>=1.26.4
Requires-Dist: numpyro>=0.13.2
Requires-Dist: nvidia-cublas-cu12>=12.1.3.1
Requires-Dist: nvidia-cuda-cupti-cu12>=12.1.105
Requires-Dist: nvidia-cuda-nvrtc-cu12>=12.1.105
Requires-Dist: nvidia-cuda-runtime-cu12>=12.1.105
Requires-Dist: nvidia-cudnn-cu12>=8.9.2.26
Requires-Dist: nvidia-cufft-cu12>=11.0.2.54
Requires-Dist: nvidia-curand-cu11>=10.2.10.91
Requires-Dist: nvidia-curand-cu12>=10.3.2.106
Requires-Dist: nvidia-cusolver-cu12>=11.4.5.107
Requires-Dist: nvidia-cusparse-cu11>=11.7.4.91
Requires-Dist: nvidia-cusparse-cu12>=12.1.0.106
Requires-Dist: nvidia-nccl-cu11>=2.14.3
Requires-Dist: nvidia-nccl-cu12>=2.20.5
Requires-Dist: nvidia-nvjitlink-cu12>=12.4.127
Requires-Dist: nvidia-nvtx-cu11>=11.7.91
Requires-Dist: nvidia-nvtx-cu12>=12.1.105
Requires-Dist: ogb>=1.3.6
Requires-Dist: ome-zarr>=0.8.1
Requires-Dist: omnipath>=1.0.7
Requires-Dist: opencv-python>=4.8.1.78
Requires-Dist: openslide-python>=1.2.0
Requires-Dist: opt-einsum>=3.3.0
Requires-Dist: optax>=0.1.7
Requires-Dist: optree>=0.11.0
Requires-Dist: orbax-checkpoint>=0.4.1
Requires-Dist: ordered-set>=4.1.0
Requires-Dist: outdated>=0.2.2
Requires-Dist: param>=1.13.0
Requires-Dist: partd>=1.4.1
Requires-Dist: patsy>=0.5.3
Requires-Dist: performer-pytorch>=1.1.4
Requires-Dist: pims>=0.6.1
Requires-Dist: pip>=24.0
Requires-Dist: pkginfo>=1.9.6
Requires-Dist: pluggy>=1.5.0
Requires-Dist: protobuf>=4.24.3
Requires-Dist: pyarrow>=13.0.0
Requires-Dist: pyct>=0.5.0
Requires-Dist: pydantic>=1.10.13
Requires-Dist: pydantic-core>=2.4.0
Requires-Dist: pygeos>=0.14
Requires-Dist: pygments>=2.16.1
Requires-Dist: pyjwt>=2.8.0
Requires-Dist: pynndescent>=0.5.10
Requires-Dist: pyproj>=3.6.1
Requires-Dist: pyro-api>=0.1.2
Requires-Dist: pyro-ppl>=1.8.6
Requires-Dist: python-editor>=1.0.4
Requires-Dist: python-multipart>=0.0.6
Requires-Dist: pytorch-lightning>=2.0.9.post0
Requires-Dist: pywavelets>=1.4.1
Requires-Dist: readchar>=4.0.5
Requires-Dist: readme-renderer>=42.0
Requires-Dist: regex>=2023.8.8
Requires-Dist: requests-toolbelt>=1.0.0
Requires-Dist: rfc3986>=2.0.0
Requires-Dist: rich>=13.5.3
Requires-Dist: s3fs>=2023.6.0
Requires-Dist: safetensors>=0.3.3
Requires-Dist: scanpy>=1.9.5
Requires-Dist: scikit-image>=0.19.3
Requires-Dist: scikit-misc>=0.3.0
Requires-Dist: scipy>=1.8.1
Requires-Dist: scprep>=1.2.3
Requires-Dist: scvi-tools>=1.0.3
Requires-Dist: seaborn>=0.12.2
Requires-Dist: secretstorage>=3.3.3
Requires-Dist: segment-anything>=1.0
Requires-Dist: session-info>=1.0.0
Requires-Dist: shapely>=2.0.1
Requires-Dist: slicerator>=1.1.0
Requires-Dist: sniffio>=1.3.0
Requires-Dist: sortedcontainers>=2.4.0
Requires-Dist: soupsieve>=2.5
Requires-Dist: sparse>=0.14.0
Requires-Dist: sparsemax>=0.1.9
Requires-Dist: spatial-image>=0.3.0
Requires-Dist: spatialdata>=0.0.12
Requires-Dist: squidpy>=1.3.0
Requires-Dist: stardist>=0.9.1
Requires-Dist: starlette>=0.27.0
Requires-Dist: starsessions>=1.3.0
Requires-Dist: statsmodels>=0.14.0
Requires-Dist: stdlib-list>=0.9.0
Requires-Dist: sympy>=1.12
Requires-Dist: tbb>=2021.10.0
Requires-Dist: tblib>=2.0.0
Requires-Dist: tensorboard>=2.16.2
Requires-Dist: tensorboard-data-server>=0.7.2
Requires-Dist: tensorflow-io-gcs-filesystem>=0.37.1
Requires-Dist: tensorstore>=0.1.44
Requires-Dist: termcolor>=2.4.0
Requires-Dist: texttable>=1.6.7
Requires-Dist: tifffile>=2023.9.26
Requires-Dist: timm>=0.9.8
Requires-Dist: tokenizers>=0.13.3
Requires-Dist: tomli>=2.0.1
Requires-Dist: toolz>=0.12.0
Requires-Dist: torch==2.1.0+cu118
Requires-Dist: torch-cluster==1.6.3+pt21cu118
Requires-Dist: torch-geometric>=2.5.3
Requires-Dist: torch-scatter==2.1.2+pt21cu118
Requires-Dist: torch-sparse==0.6.18+pt21cu118
Requires-Dist: torch-spline-conv==1.2.2+pt21cu118
Requires-Dist: torchaudio==2.1.0+cu118
Requires-Dist: torchmetrics>=1.2.0
Requires-Dist: torchvision==0.16.0+cu118
Requires-Dist: traitlets>=5.10.1
Requires-Dist: transformers>=4.33.3
Requires-Dist: triton>=2.1.0
Requires-Dist: twine>=4.0.2
Requires-Dist: typing-extensions>=4.11.0
Requires-Dist: umap-learn>=0.5.4
Requires-Dist: urllib3>=1.26.16
Requires-Dist: uvicorn>=0.23.2
Requires-Dist: validators>=0.22.0
Requires-Dist: wcwidth>=0.2.7
Requires-Dist: websocket-client>=1.6.3
Requires-Dist: websockets>=11.0.3
Requires-Dist: werkzeug>=3.0.3
Requires-Dist: wrapt>=1.15.0
Requires-Dist: xarray>=2022.12.0
Requires-Dist: xarray-dataclasses>=1.6.0
Requires-Dist: xarray-datatree>=0.0.12
Requires-Dist: xarray-schema>=0.0.3
Requires-Dist: xarray-spatial>=0.3.7
Requires-Dist: yarl>=1.9.2
Requires-Dist: zarr>=2.16.1
Requires-Dist: zict>=3.0.0
Requires-Dist: zipp>=3.17.0

# STARS (Spatial Transcriptomics across Any Resolution for Single Cells)

**STARS** (Spatial Transcriptomics across Any Resolution for Single Cells) is a Python package for the analysis of spatial transcriptomics data. It decodes true single-cell gene expression from multicellular or subcellular resolution platforms, combining **Vision Transformer models** and **contrastive learning** to integrate histology images and spot-level transcriptomics data.

**STARS** provides high-resolution analysis from tissue-wide to individual cell levels and is validated on datasets from various spatial transcriptomics platforms such as **Visium**, **Visium HD**, and **Stereo-seq**.

## Features

- **Single-Cell Gene Expression Decoding**: From subcellular or multicellular platforms.
- **High-Resolution Integration**: Combines histology images with transcriptomics data.
- **Vision Transformer Models**: For robust spatial decoding.
- **Contrastive Learning**: To improve model accuracy and generalization.
- **Supports Multiple Platforms**:
  - **Visium**
  - **Visium HD**
  - **Stereo-seq**
- **Flexible Analysis Levels**: Works at tissue, individual cell, and molecular levels.

## Installation

To install **STARS**, use the following pip command:

```bash
pip install stars-omics


