Metadata-Version: 2.1
Name: explosig-connect
Version: 0.0.7
Summary: Send data to ExploSig
Home-page: https://github.com/lrgr/explosig-connect
Author: Mark Keller
License: UNKNOWN
Description: [![Build Status](https://travis-ci.org/lrgr/explosig-connect.svg?branch=master)](https://travis-ci.org/lrgr/explosig-connect)
        [![PyPI](https://img.shields.io/pypi/v/explosig-connect)](https://pypi.org/project/explosig-connect/)
        [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/lrgr/explosig-connect/blob/master/examples/colab-demo.ipynb)
        
        ## ExploSig Connect
        
        Helpers for sending data from a Python environment to [ExploSig](https://github.com/lrgr/explosig) (via [ExploSig Server](https://github.com/lrgr/explosig-server)) for web-based interactive visualization.
        
        - [Documentation](https://lrgr.github.io/explosig-connect/)
        - [Open in Colab](https://colab.research.google.com/github/lrgr/explosig-connect/blob/master/examples/colab-demo.ipynb)
        
        ### Installation
        
        ```sh
        pip install explosig-connect
        ```
        
        ### Example Usage - Connecting to an existing session
        
        ```python
        >>> from explosig_connect import connect
        
        >>> # Connect using a session ID supplied by ExploSig.
        >>> session_id = 'af6242f3'
        >>> conn = connect(session_id)
        
        >>> # Obtain the SBS mutation counts matrix associated with the session.
        >>> sbs_counts_df = conn.get_mutation_category_counts('SBS')
        
        >>> # You run some custom code to derive better signature exposures.
        >>> exposures_df = my_exposures_computation_method(sbs_counts_df)
        
        >>> # Send the new exposures back to ExploSig for visualization.
        >>> conn.send_exposures('SBS', exposures_df)
        ```
        
        ### Example Usage - Starting a new session
        
        ```python
        >>> from explosig_connect import connect
        
        >>> # Start a new 'empty' session with no samples, signatures, etc. selected.
        >>> # This will attempt to open ExploSig in a new browser tab that starts the session.
        >>> conn = connect()
        
        >>> # Send an SBS mutation counts matrix to visualize.
        >>> conn.send_mutation_category_counts('SBS', my_sbs_counts_df)
        
        >>> # Send an exposures matrix to visualize.
        >>> conn.send_exposures('SBS', my_sbs_exposures_df)
        
        >>> # Send a signatures matrix to visualize.
        >>> conn.send_signatures('SBS', my_sbs_signatures_df)
        ```
        
        ### Development
        
        Build and install from the current directory.
        
        ```sh
        python setup.py sdist bdist_wheel && pip install .
        ```
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
