Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
0131fda
Adding a new usage README file
adrianasupady Jul 14, 2015
a9b60a7
Added new parameter files
adrianasupady Jul 14, 2015
0efc9a9
Deleted dedicated NWCHEM folder
adrianasupady Jul 15, 2015
37d5eff
Update the README.md
adrianasupady Jul 15, 2015
35c7d8b
Deleted dedicated RDKIT folder
adrianasupady Jul 15, 2015
65d0782
Deleted dedicated FHI-aims folder
adrianasupady Jul 15, 2015
c9a5cc4
Added the versions of the software
adrianasupady Jul 15, 2015
3f3fee0
Added a new, general genetic algorithm run script
adrianasupady Jul 15, 2015
6d37e3d
Updated the manual to 1.0.0-alpha version
adrianasupady Jul 15, 2015
9f142ef
Deleted old angle measure/set module
adrianasupady Jul 15, 2015
2e187a7
Deleted old parametrization module
adrianasupady Jul 15, 2015
b0b63e8
Update of the exisiting modules
adrianasupady Jul 15, 2015
1c9a732
Added new module for handling degrees of freedom
adrianasupady Jul 15, 2015
ebc416f
Added new module for assigning parameters
adrianasupady Jul 15, 2015
4ba58dd
Added new module for setting and measuring torsions and ring
adrianasupady Jul 15, 2015
176775d
Added new module with diverse run utilities
adrianasupady Jul 15, 2015
d75df75
Added docstrings to the Torsion class
adrianasupady Jul 23, 2015
561b0c1
Added an outlook section to the README file
adrianasupady Jul 24, 2015
9e19660
Bug fix: fixed the string update in the Torsion object in the apply_o…
adrianasupady Jul 29, 2015
7914ba8
Bug fix: fixed the wrong indentation in the mutate_ring method in the…
adrianasupady Jul 29, 2015
254b5e0
Changed the wrapper for the force fields via RDKit: all optimized str…
adrianasupady Aug 6, 2015
166e9b8
Fixed the newlines in pyff.py
adrianasupady Aug 6, 2015
1473260
Update of the manual: added the information about saving the optimize…
adrianasupady Aug 6, 2015
27a0b4a
Create parameters_orca.txt
Aug 19, 2015
c80139c
Update README.md
Aug 19, 2015
860538f
Update __init__.py
Aug 19, 2015
cde2a7a
Update run_utilities.py
Aug 19, 2015
a821ee1
Update structure.py
Aug 19, 2015
41d14cd
Update utilities.py
Aug 19, 2015
08f398c
Create pyorca.py
Aug 19, 2015
c84f8d6
Update parameters_orca.txt
Sep 8, 2015
cf42f7a
Update utilities.py
Sep 8, 2015
34e3a9e
Update run_utilities.py
Sep 8, 2015
d131c91
Changed the returned energy value to be in eV
adrianasupady Sep 30, 2015
5358b82
Added the parameter 'optsteps' to control the maximal number of geome…
adrianasupady Oct 1, 2015
74553b1
Added defaults for nprocs, optsteps and chargemult to the Orca wrapper
adrianasupady Oct 1, 2015
85c10be
Adjusted run_utilites and structure to work with the defaults for cha…
adrianasupady Oct 1, 2015
1e18d53
Adjusted the docstring of the orcaObject
adrianasupady Oct 1, 2015
2c93fe4
Renamed orcaObject to OrcaObject
adrianasupady Oct 1, 2015
b065dda
Minor style/docs modifications in pyorca and structure
adrianasupady Oct 5, 2015
c9a8f18
Adjusted the ORCA specific parameter values in parameters_orca.txt
adrianasupady Oct 5, 2015
14742bd
Merge branch 'ptrab-add_orca_functionality'
adrianasupady Oct 5, 2015
6ef5f95
Update of the fafoom manual: details concerning the new ORCA function…
adrianasupady Oct 5, 2015
0691aeb
Changed the unit of the energy value in pyff from kcal/mol to eV
adrianasupady Oct 6, 2015
2589756
Changed the unit of the energy value in pynwchem from hartree to eV
adrianasupady Oct 6, 2015
c664712
Update in the manual: clarification about the used energy units
adrianasupady Oct 6, 2015
d1dab12
Added the arxiv link with the paper preprint
adrianasupady Oct 19, 2015
ee211d8
Corrected a typo in the listing of the parameter file
adrianasupady Nov 13, 2015
5d7a521
Renaming the smile to smiles parameter in the parameter files
adrianasupady Nov 13, 2015
2c05ee0
Renaming the smile to smiles
adrianasupady Nov 13, 2015
643a5d0
Renaming the smile to smiles in get_parameters
adrianasupady Nov 13, 2015
fc5f837
Renaming the smile to smiles and adding an automatic renamer to the f…
adrianasupady Nov 13, 2015
e188057
Renamed 'smart' parameter to 'smarts' parameter in the parameter files
adrianasupady Nov 13, 2015
1fb76b0
Renamed 'smart' parameter to 'smarts' parameter in deg_of_freedom
adrianasupady Nov 13, 2015
547ce5d
Renamed 'smart' parameter to 'smarts' parameter in get_parameters
adrianasupady Nov 13, 2015
b18af8e
Renamed the smart parameter and extended the renamer function for the…
adrianasupady Nov 13, 2015
dfc8502
Updated the manual, fafoom verion 1.0.0
adrianasupady Nov 13, 2015
2dca28a
Added the DOI to the paper. Added the information about launching of …
adrianasupady Dec 8, 2015
f92bfb4
Improved the check geometry function. Moved the distance function fro…
adrianasupady Dec 10, 2015
234d2a1
Added 'from future import division' to ensure correct division
adrianasupady Apr 19, 2016
bde50fb
Update in README
adrianasupady Jan 1, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 31 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,26 @@
# Fafoom - Flexible algorithm for optimization of molecules
:warning: **Fafoom is no longer maintained and will not be updated to Python 3** :warning:


Fafoom is a tool for sampling the conformational space of organic molecules. Fafoom is intended to work with FHI-aims (Fritz Haber Institute ab initio molecular simulations package).

## News

* the paper "First-principles molecular structure search with a genetic algorithm" is now published in Journal of Chemical Information and Modeling; DOI: 10.1021/acs.jcim.5b00243

* a new branch targeting the implementation of a further degree of freedom ('orientation') has been created

## Requirements

* functionality of the tool:
* Python 2.7
* Numpy
* RDKit (used version: Release_2014_09_2)
* Python (used for testing: 2.7.6) - Python3 is not supported!
* Numpy (used for testing: 1.8.2)
* RDKit (used for testing: Release_2015_03_1)

* first-principles methods:
* (recommended) FHI-aims (Fritz Haber Institute ab initio molecular simulations package)
* (alternative) NWChem (NWChem: Open Source High-Performance Computational Chemistry)
* (alternative) ORCA (- An ab initio, DFT and semiempirical SCF-MO package -)

## How to use

Expand All @@ -24,16 +33,30 @@ Fafoom is a tool for sampling the conformational space of organic molecules. Faf

import fafoom

## Examples of usage
## Example of usage

Three examples are provided with the source code in the examples folder:
An implementation of a genetic algorithm is provided in the examples folder.
Depending on the used parameter file following genetic algorithm based searches can be run:

* genetic algorithm based search utilizing first-principles (FHI-aims required)
* genetic algorithm based search utilizing force fields (force fields accessed from RDKit)
* genetic algorithm based search utilizing first-principles via NWChem (NWChem required)
* parameters_aims.txt for first-principles (FHI-aims required)
* parameters_ff.txt for force fields (force fields accessed from RDKit)
* parameters_nwchem.txt for first-principles via NWChem (NWChem required)
* parameters_orca.txt for first-principles via ORCA (ORCA required)

Get familiar with the provided manual to learn more about the tool and the parameters.

## Outlook

Development goals:

* flexible formulation of the scoring function, e.g. allowing for optimizing a user-defined property
* adding more kinds of degrees of freedom, e.g. orientation of a molecule
* adding wrappers for different molecular simulations packages

Comments, feedback or development contributions are always welcome!



## License

Fafoom is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Expand Down
9 changes: 0 additions & 9 deletions examples/GA_first_principles_FHIaims/README.md

This file was deleted.

183 changes: 0 additions & 183 deletions examples/GA_first_principles_FHIaims/ga_restart.py

This file was deleted.

Loading