semvec/pypi-packages huggingface dataset:
chemreps 0.1.0
Molecular machine learning representations
License: MIT License

# chemreps
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Documentation Status](https://readthedocs.org/projects/chemreps/badge/?version=latest)](https://chemreps.readthedocs.io/en/latest/?badge=latest)
[![codecov](https://codecov.io/gh/chemreps/chemreps/branch/master/graph/badge.svg)](https://codecov.io/gh/chemreps/chemreps)
[![Build Status](https://travis-ci.com/chemreps/chemreps.svg?branch=master)](https://travis-ci.com/chemreps/chemreps)
[![Gitter Chat](https://img.shields.io/gitter/room/chemreps/community.svg)](https://gitter.im/chemreps/community)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/chemreps/chemreps/master?filepath=examples%2F)

chemreps is a Python package for the creation of molecular representations for the purpose of machine learning. The molecular representations included in this library are implemented/adapted from current literature. The aim of chemreps is to provide an easy to use library for making molecular representations that can be then used with machine learning packages such as Scikit-Learn and Tensorflow.

## Current Implementations
- Coulomb Matrix
- Bag of Bonds
- Bonds/Nonbonding, Angles, Torsions
- Just Bonds

The citations for the literature from which the representations are implemented/adapted from can be found in the source code for each representation.

## Representation requests
Requests for new representations to be added can be made by raising an issue and labeling it as a feature request. Before requesting a new representation, please check under the Representation project in the Projects tab to see if that representation is included in the current work or progress.

## Install
The latest release version can be installed with:
```
pip install chemreps
```

The latest development version can be installed by:
```
git clone https://github.com/chemreps/chemreps
cd chemreps
pip install -e .
```

#### Dependencies
chemreps requires:
- Python (>=3.6)
- NumPy (>=1.12)
- cclib (>=1.5)

## Contributing
If you are interested in helping develop for this project, please check out [Contributing to chemreps](https://github.com/chemreps/chemreps/wiki/Contributing-to-chemreps) in the wiki for a guide on how to get started.

## Testing
Tests can be run in the top-level directory with the command `pytest -v --cov=chemreps tests/`

## For help
If you need any help using chemreps, feel free to post in our [Gitter](https://gitter.im/chemreps/community).

## Disclaimers:
- These are attempts at the recreation of molecular representations from literature and may not be implemented properly.
    - If we do not implement something properly, feel free to make an issue.
- This is solely a representation library and will not perform machine learning.