Metadata-Version: 2.1
Name: xsmiles
Version: 0.2.2
Summary: A Custom Jupyter Widget Library
Home-page: https://github.com/Bayer-Group/xsmiles-jupyterlab
Author: Henry Heberle
Author-email: 
License: BSD
Description: # XSMILES visualizations in Jupyter Lab
        
        A Custom Jupyter Lab Widget to visualize SMILES-based and atom-based scores.
        
        ## Please Cite
        
        If you use XSMILES, the use cases, its code, or the generated explanations, please cite our article:
        
        **Article in preparation**, a preprint should appear mid September!
        
        ```
        Heberle, H., Zhao, L., Schmidt, S., Wolf, T., & Heinrich, J. (2022). XSMILES: interactive visualization for molecules, SMILES and XAI scores. Article in preparation.
        ```
        
        ```BibTeX
        @article{Heberle2022XSMILES,
        author = {Heberle, Henry and Zhao, Linlin and Schmidt, Sebastian and Wolf, Thomas and Heinrich, Julian},
        doi = {},
        journal = {Article in preparation},
        month = {},
        number = {},
        pages = {},
        title = {{XSMILES: interactive visualization for molecules, SMILES and XAI scores}},
        volume = {},
        year = {2022}
        }
        ```
        
        ![JupyterLab Notebook](/examples/widget_example.png)
        
        ## Availability and examples
        
        - [XSMILES main page](https://github.com/Bayer-Group/xsmiles)
        
        - [TBD Demo website](https://)
        
        - [HOW TO use XSMILES (JupyterLab notebook)](examples/xsmiles_examples.ipynb)
        
        - [More examples with JupyterLab](https://github.com/Bayer-Group/xsmiles-use-cases)
        
        - [TBD PiPY repository](http://)
        
        - [KNIME component? Check the main page](https://github.com/Bayer-Group/xsmiles)
        
        ## Example Notebook with a how-to
        
        To use XSMILES with Jupyter Lab you need to install the package with pip **and have internet connection** while using it.
        
        RDKit MinimalLib is downloaded by your browser.
        
        Please check this notebook to see **how to use** the tool: [Notebook](examples/xsmiles_examples.ipynb)
        
        Note that it is only being tested with **Jupyter Lab**. A reason for you to use Lab is the space available for visualizations, which is much better than in regular Jupyter notebooks. We also had problems with the installation with Jupyter notebooks.
        
        ## Installation
        
        ### Quick example - create conda environment and installs xsmiles
        
        ```bash
        conda create --name xsmiles_env python=3.7 -c conda-forge # create conda env with python 3.7
        
        conda activate xsmiles_env # activate the created env
        
        conda install -c conda-forge jupyterlab # install jupyter lab
        
        pip install xsmiles # if xsmiles is not in pip yet, try pip install xsmiles-0.2.2-py2.py3-none-any.whl
        # Download the most up to date whl from this repository's releases)
        
        jupyter lab examples/xsmiles_examples.ipynb # run a notebook with jupyter lab
        ```
        
        ## Uninstall
        
        - `pip uninstall xsmiles`
        - `rm -r <path-to:>/share/jupyter/labextensions/xsmiles`
        - `jupyter labextension list`
        
        
        ## Development
        
        Please check the `DEVELOPMENT.md` file.
Keywords: Jupyter,Widgets,IPython
Platform: Linux
Platform: Mac OS X
Platform: Windows
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Jupyter
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: examples
Provides-Extra: docs
