Metadata-Version: 2.1
Name: pykale
Version: 0.1.0a1
Summary: Knowledge-aware machine learning from multiple sources in Python
Home-page: https://github.com/pykale/pykale
Author: The PyKale team
Author-email: pykale-group@sheffield.ac.uk
License: MIT
Project-URL: Documentation, https://pykale.readthedocs.io
Project-URL: Source, https://github.com/pykale/pykale
Description: <p align="center">
          <img src="https://github.com/pykale/pykale/raw/master/docs/images/pykale_logo.png" width="5%" alt='project-monai'> PyKale
        </p>
        
        -----------------------------------------
        
        ![build](https://github.com/pykale/pykale/workflows/build/badge.svg)
        ![Unit Tests](https://github.com/pykale/pykale/workflows/unit%20tests/badge.svg)
        [![Documentation Status](https://readthedocs.org/projects/pykale/badge/?version=latest)](https://pykale.readthedocs.io/en/latest/?badge=latest)
        [![Conda license](https://anaconda.org/gpytorch/gpytorch/badges/license.svg)](https://anaconda.org/pykale/pykale)
        <!-- [![PyPI version](https://badge.fury.io/py/pykale.svg)](https://badge.fury.io/py/pykale) -->
        <!-- [![Conda version](https://anaconda.org/pykale/pykale/badges/version.svg)](https://anaconda.org/pykale/pykale) -->
        <!-- [![Downloads](https://pepy.tech/badge/pykale)](https://pepy.tech/project/pykale) -->
        <!-- [![Downloads](https://anaconda.org/pykale/pykale/badges/downloads.svg)](https://anaconda.org/pykale/pykale) -->
        
        [Getting Started](https://github.com/pykale/pykale/tree/master/examples) |
        [Documentation](https://pykale.readthedocs.io/) |
        [Contributing](https://github.com/pykale/pykale/blob/master/CONTRIBUTING.md) |
        [Discussions](https://github.com/pykale/pykale/discussions)
        
        PyKale is a machine learning library that leverages knowledge from multiple sources for accurate and *interpretable* prediction. It supports graphs, images, and videos now. It is based on [PyTorch](https://pytorch.org/) and several other libraries but differs from existing ones by adopting a unified pipeline-based APIs design and incorporating key recent developments. See the [Trello board](https://trello.com/b/X8VBNAvf/pykale-api-overview) for an overview.
        
        <img src="https://github.com/pykale/pykale/raw/master/docs/images/pykale_pipeline.png"
             alt="Machine learning pipeline"
             style="float: center;" />
        
        PyKale also aims to facilitate *interdisciplinary* research on *knowledge-aware* machine learning for graphs, images, and videos in computer vision, graph analysis, and medical imaging applications. Key machine learning areas of interests include **dimensionality reduction**, **deep learning**, **multimodal learning**, and **transfer learning**.
        
        ### Pipeline-based modules (core, generic, and reusable)
        
        - `loaddata` load data from disk or online resources as in input
        - `prepdata` preprocess data to fit machine learning modules below (transforms)
        - `embed` embed data in a new space to learn a new representation (feature extraction/selection)
        - `predict` predict a desired output
        - `evaluate` evaluate the performance using some metrics
        - `interpret` interpret the features and outputs via post-prediction analysis mainly via visualisation
        - `pipeline` specify a machine learning workflow by combining several other modules
        
        ### Dataset-specific modules
        
        - `examples`: Real-application on particular datasets.
        
        ## Installation
        
        **Requirements**:
        - Python >= 3.6
        - PyTorch >= 1.7
        
        Install PyKale using `pip` or `conda`:
        
        ```bash
        pip install pykale
        conda install -c pykale pykale
        ```
        
        You need to first install [PyTorch Lightning](https://github.com/PyTorchLightning/pytorch-lightning) for `kale.embed.pipeline` and [PyTorch Geometric](https://github.com/rusty1s/pytorch_geometric) to work on graphs.
        
        To upgrade to the latest (unstable) version, run
        
        ```bash
        pip install --upgrade git+https://github.com/pykale/pykale.git
        ```
        
        To run the unit tests:
        
        ```bash
        python -m unittest
        ```
        
        ## Examples, Tutorials, and Discussions
        
        See our numerous [**examples (and tutorials)**](https://github.com/pykale/pykale/tree/master/examples) on how to perform prediction tasks in PyKale.
        
        Ask and answer questions over on [PyKale's GitHub Discussions tab](https://github.com/pykale/pykale/discussions).
        
        ## Contributing
        
        PyKale is under active development. Please star and fork PyKale to follow the latest update. Welcome to [contribute](https://github.com/pykale/pykale/blob/master/CONTRIBUTING.md) and join / contact us via <a href="mailto:pykale-group&#64;sheffield.ac.uk">email</a>. The participation in this open source project is subject to [Code of Conduct](https://github.com/pykale/pykale/blob/master/CODE_OF_CONDUCT.md).
        
        ## The Team
        
        PyKale is primarily maintained by a group of researchers at the University of Sheffield: [Haiping Lu](http://staffwww.dcs.shef.ac.uk/people/H.Lu/), [Raivo Koot](https://github.com/RaivoKoot), [Xianyuan Liu](https://github.com/XianyuanLiu), [Shuo Zhou](https://sz144.github.io/), and [Peizhen Bai](https://github.com/pz-white).
        
        We would like to thank our other contributors including (but not limited to) David Jones, and Will Furnass.
        
        ## Citation
        
            @Misc{pykale2021,
              author =   {Haiping Lu and Raivo Koot and Xianyuan Liu and Shuo Zhou and Peizhen Bai},
              title =    {{PyKale}: Knowledge-aware machine learning from multiple sources in Python},
              howpublished = {\url{https://github.com/pykale/pykale}},
              year = {2021}
            }
        
        ## Acknowledgements
        
        The development of PyKale is partially supported by the following project(s).
        
        - Wellcome Trust Innovator Awards: Digital Technologies Ref 215799/Z/19/Z "Developing a Machine Learning Tool to Improve Prognostic and Treatment Response Assessment on Cardiac MRI Data".
        
Keywords: machine learning,pytorch,dimensionality reduction,deep learning,multimodal learning,transfer learning
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: Software Development :: Libraries
Classifier: Natural Language :: English
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: pipeline
Provides-Extra: docs
Provides-Extra: utils
Provides-Extra: test
