vitessce-python
Python API and Jupyter widget facilitating interactive visualization of spatial single-cell data with Vitessce.
Installation
To install with pip:
$ pip install vitessce[all]
Getting started
Explore our example notebooks. These contain demos of different use cases and integrations with single-cell data analysis packages.
Development
For a development installation (requires NodeJS and NPM),
$ git clone https://github.com/vitessce/vitessce-python.git
$ cd vitessce-python
$ conda env create -f environment.yml
$ conda activate vitessce-python-dev
$ pip install -e ".[dev]"
Conda environments
In this repository, there are multiple conda environments for different purposes:
vitessce-python-dev(defined in environment.yml) is used for the development of thevitesscepackage itselfvitessce-python-notebooks(defined in docs/notebooks/environment.yml) is used for running the example notebooks in thedocs/notebooks/directory (seedocs/notebooks/README.mdfor more information)vitessce-python-binder(defined in binder/environment.yml) is the environment used by Binder upon opening notebooks from this repository
Linting and testing
flake8
pytest
Formatting
One file:
autopep8 --in-place --aggressive ./path/to/file.py
All .py files:
find . -name '*.py' -exec autopep8 --in-place --aggressive '{}' \;
Documentation
make html
Deployment
To deploy a new version, increment the version of the Python package in setup.py.
Then, when you push or merge the code with the incremented versions to main, the GitHub Action deploy.yml workflow will build and push the package to PyPI.
Resources
- ipywidget docs: Building a Custom Widget
- ipywidget docs: Low Level Widget Tutorial
- ipywidget example: ipyleaflet
- ipywidget example (with React): ipymaterialui
- ipywidget example (with React): higlass-python
- ipywidget cookiecutter
- Sphinx: Getting Started
- Read the Docs Sphinx Theme
- jupyter server proxy
Getting/Offering Help
If you have a specific bug or feature request, please feel free to open an issue. Otherwise our discussions section is a great place to get help or offer it. If you aren't sure if something is a bug or not, don't have all the reproduction steps, or just have a general question, feel free to open a discussion post.
3 maintainers
Release files for vitessce 3.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vitessce-3.0.1.tar.gz | 26.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vitessce-3.0.1-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 26.5 MB
Release files / vitessce-3.0.1.tar.gz
| Download URL | vitessce-3.0.1.tar.gz |
|---|---|
| Size | 26.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
875a8cc8b3cf7bf5bfa2f7c95774bc5c791494158bb606c347210856b5c957a1
|
|
BLAKE2b-256 checksum How to use checksums |
d8b2e0269ef80f3ca5343a3244b45e6251ceec9c49ab37f3f262351c8a00f3bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
Release files / vitessce-3.0.1-py2.py3-none-any.whl
| Download URL | vitessce-3.0.1-py2.py3-none-any.whl |
|---|---|
| Size | 50.8 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
c65da80801bb8442eab41a70c645a5938d401d8cf88831875fe4eaa51c6f14c7
|
|
BLAKE2b-256 checksum How to use checksums |
93c96cdb87248c527e4ba8626efa7461fe2822ca3964ead7007f44c73851f725
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
