A library to generate fingerprints for molecular structures based on a set of fragments
The library generates fragment fingerprints based on pre-defined fragments, which can be set by the user, and can generate both bit and count fingerprints. Fragment fingerprints are created by matching fragments or substructures of a molecule with pre-defined fragments. If a match is found, the corresponding positions in the fingerprint are filled. The special feature of the fragment fingerprinter is that fingerprints are generated exclusively by comparing unique SMILES (Strings). This means that both the pre-defined fragments and the substructures or fragments of the molecule for which the fingerprint is being generated must be represented as unique SMILES strings. The implementation of the fragment fingerprinter is based on the Chemistry Development Kit (CDK).
The "src" subfolder contains all source code packages including JUnit tests.
The test class FragmentFingerprinterTest tests the functionalities of fragment fingerprinter. Among other things, it tests whether the bit and count fingerprint of a molecule has been generated correctly. Furthermore, various methods of the CountFingerprint and BitSetFingerprint classes are tested.
The test "resources" subfolder contains two text files. The text file named "FragmentList.txt" contains all key fragments. And the file named "MoleculeList.txt" contains fragments/substructures of molecules. In total, 10 molecules with their corresponding fragments are stored in the file.
The folder "PerformanceTestCMDApplication" contains the executable JAVA archive FragmentFingerprints-fat.jar. It can be executed from the command-line (command: java -jar) to do a performance snapshot of fragment fingerprinter's scaling behaviour for a growing number of input molecules. For more details see the file "Performance_test_instruction.txt"
see in "wiki"
FragmentFingerprints is hosted as a package/artifact on the sonatype maven central repository. See the
artifact page for installation
guidelines using build tools like maven or gradle.
To install FragmentFingerprints via its JAR archive, you can get it from the
releases. Note that other dependencies
will need to be installed via JAR archives as well this way.
In order to open the project locally, e.g. to extend it, download or clone the repository and
open it in a Gradle-supporting IDE (e.g. IntelliJ) as a Gradle project and execute the build.gradle file.
Gradle will then take care of installing all dependencies. A Java Development Kit (JDK) of version 17 or higher must also
be pre-installed.
Needs to be pre-installed:
- Java Development Kit (JDK) version 17
- Adoptium OpenJDK (as one possible source of the JDK)
- Gradle version 7.3
Managed by Gradle:
- Chemistry Development Kit (CDK) version 2.9
- Chemistry Development Kit on GitHub
- License: GNU Lesser General Public License 2.1
- JUnit Jupiter version 5.9.1
- JUnit
- License: Eclipse Public License - v 2.0
Chemistry Development Kit (CDK)
- Chemistry Development Kit on GitHub
- Steinbeck C, Han Y, Kuhn S, Horlacher O, Luttmann E, Willighagen EL. The Chemistry Development Kit (CDK): An Open-Source Java Library for Chemo- and Bioinformatics. J Chem Inform Comput Sci. 2003;43(2):493-500.
- Steinbeck C, Hoppe C, Kuhn S, Floris M, Guha R, Willighagen EL. Recent Developments of the Chemistry Development Kit (CDK) - An Open-Source Java Library for Chemo- and Bioinformatics. Curr Pharm Des. 2006; 12(17):2111-2120.
- May JW and Steinbeck C. Efficient ring perception for the Chemistry Development Kit. J. Cheminform. 2014; 6:3.
- Willighagen EL, Mayfield JW, Alvarsson J, Berg A, Carlsson L, Jeliazkova N, Kuhn S, Pluska T, Rojas-Chertó M, Spjuth O, Torrance G, Evelo CT, Guha R, Steinbeck C, The Chemistry Development Kit (CDK) v2.0: atom typing, depiction, molecular formulas, and substructure searching. J Cheminform. 2017; 9:33.
- Groovy Cheminformatics with the Chemistry Development Kit