pax_global_header 0000666 0000000 0000000 00000000064 15167150676 0014530 g ustar 00root root 0000000 0000000 52 comment=0a419423f6b41778b9147aae7b081cf1034c6a72
centres-1.4/ 0000775 0000000 0000000 00000000000 15167150676 0013037 5 ustar 00root root 0000000 0000000 centres-1.4/.gitignore 0000664 0000000 0000000 00000000006 15167150676 0015023 0 ustar 00root root 0000000 0000000 target centres-1.4/CITATION.cff 0000664 0000000 0000000 00000000477 15167150676 0014741 0 ustar 00root root 0000000 0000000 cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "John"
given-names: "Mayfield"
orcid: "https://orcid.org/0000-0001-7730-2646"
title: "centres"
version: 1.0
doi: 10.1021/acs.jcim.8b00324
date-released: 2018-06-28
url: "https://github.com/SiMolecule/centres"
centres-1.4/LICENSE 0000664 0000000 0000000 00000002375 15167150676 0014053 0 ustar 00root root 0000000 0000000 Copyright (c) 2020, John Mayfield
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. centres-1.4/README.md 0000664 0000000 0000000 00000006663 15167150676 0014331 0 ustar 00root root 0000000 0000000 # Stereochemistry Labelling Done Good
Centres is an Open Source Java library for that allows perception and labelling of stereogenic centres in chemical structures using the [Cahn-Ingold-Prelog priority rules](https://en.wikipedia.org/wiki/Cahn%E2%80%93Ingold%E2%80%93Prelog_priority_rules).
### How to Use
You can use Centres interactively at http://www.simolecule.com/cdkdepict by selecting the annotation "CIP Stereo Label". Alternatively you can download the `centres.jar` (built on CDK) from the releases page. This JAR can be used to label and test an SD or SMILES file.
```
java -jar centres.jar input.sdf
```
To run the benchmark tests pressented by [Hanson *et al*](https://chemrxiv.org/articles/Algorithmic_Analysis_of_Cahn-Ingold-Prelog_Rules_of_Stereochemistry_Proposals_for_Revised_Rules_and_a_Guide_for_Machine_Implementation/6342881) (note limitations below) run the following commands. The files can be downloaded from https://cipvalidationsuite.github.io/ValidationSuite/.
```
java -jar centres.jar compounds_2d.sdf -e CIP_LABELS
java -jar centres.jar compounds_3d.sdf -e CIP_LABELS
java -jar centres.jar compounds.smi -e 1
```
### Key Features
* Generic library allowing [dependency injection](http://en.wikipedia.org/wiki/Dependency_injection) of any molecule/atom object representation. Currently
supported 'endpoints':
* [Chemistry Development Kit](https://github.com/cdk/cdk)
* [OPSIN](https://bitbucket.org/dan2097/opsin/)
* [JChem](https://chemaxon.com/products/jchem-engines)
* Perception and labelling of tetrahedral (__R__/__S__/__r__/__s__) and geometric double bonds (__Z__/__E__).
* Implementation of the Cahn-Ingold-Prelog (CIP) priority rules as they appear in Prelog and Helmchen, 1982
* Implementation of the Cahn-Ingold-Prelog (CIP) priority rules as they appear in Nomenclature of Organic Chemistry, IUPAC Recommendations and Preferred Names 2013
### Install
`jchem` and `opsin` backends do not currently pass the internal validation tests and should be skipped when running tests.
```
mvn install -pl '!jchem,!opsin'
```
alternatively skip the tests:
```
mvn install -DskipTests
```
### License
[BSD 2-Clause](https://opensource.org/licenses/BSD-2-Clause)
### Authors
John Mayfield (né May)
### Limitations
- Helicene and chirality planes are not supported
- SMILES does not capture axial atropisomerism but this is supported in 2D/3D
- When using CDK the 3D SDfile must find stereocentres with little information available, the current algorithm does not find all centres in the test sets by default. To prevent this a modified version of CDK is used in Centres that captures all possible tetrahedral/double bond stereochemistries.
### References
* Robert M. Hanson John Mayfield Mikko J. Vainio Andrey Yerin Dmitry Redkin Sophia Musacchio. Algorithmic Analysis of Cahn-Ingold-Prelog Rules of Stereochemistry: Proposals for Revised Rules and a Guide for Machine Implementation. __Submitted__ [preprint](https://chemrxiv.org/articles/Algorithmic_Analysis_of_Cahn-Ingold-Prelog_Rules_of_Stereochemistry_Proposals_for_Revised_Rules_and_a_Guide_for_Machine_Implementation/6342881).
* Prelog and Helmchen. Basic Principles of the CIP-System and Proposals for a Revision. __Angewandte Chemie International Edition__ 21 (1982) 567-683
* Perdih and Rmzinger. Stereo-chemistry and Sequence Rules A Proposal for Modification of Cahn-Ingold-Prelog System. __Tetrahedron: Asymmetry__ Vol 5 (1994) 835-861
centres-1.4/cdk/ 0000775 0000000 0000000 00000000000 15167150676 0013600 5 ustar 00root root 0000000 0000000 centres-1.4/cdk/README.md 0000664 0000000 0000000 00000000153 15167150676 0015056 0 ustar 00root root 0000000 0000000 __centres-cdk__
This module provides an implementation of centres for the Chemistry Development Kit (CDK). centres-1.4/cdk/pom.xml 0000664 0000000 0000000 00000010660 15167150676 0015120 0 ustar 00root root 0000000 0000000
centrescom.simolecule.centres1.44.0.0centres-cdk2.12${project.groupId}centres-core${project.parent.version}${project.groupId}centres-core${project.parent.version}test-jartestjunitjunitorg.openscience.cdkcdk-interfaces${cdk.version}org.openscience.cdkcdk-io${cdk.version}org.openscience.cdkcdk-ctab${cdk.version}org.openscience.cdkcdk-standard${cdk.version}org.openscience.cdkcdk-smiles${cdk.version}org.openscience.cdkcdk-silent${cdk.version}org.apache.maven.pluginsmaven-shade-plugin3.1.1packageshadecentrescom.simolecule.centres.LabelCiporg.apache.maven.pluginsmaven-compiler-plugin88