FragIt is a python based tool that allows you to quickly fragment "any" molecule and use the produced output file(s) as an a starting point for input files in quantum chemistry programs that supports such fragment based methods.
FragIt was made out of the need to quickly benchmark many different molecules while developing new fragment based methods and is now being released in the hope that it is useful for others in their research. You can read about FragIt in the published paper.
Currently, FragIt supports the fragment molecular orbital method in GAMESS. FragIt also comes with a standard purpose XYZ writer that dumps each fragment in a separate .xyz file. Finally, there is a new XYZ-MFCC writer to support molecular fragmentation with conjugate caps that will yield capped fragments and caps for MFCC. New output writers can be added easily to support other methods and programs.
Since you found this file, it is obvious that you also found the source code. You can obtain the latest version from github where tagged releases are also available. You get the source code by cloning the repository
git clone https://github.com/FragIt/fragit-main.git
s
The easiest installation option is to use conda and pip.
We have supplied an environment.yml file for you to use.
Simply run
cd fragit-main
conda env create -f environment.yml
which creates an environment called fragit.
After activating the fragit environment
conda activate fragit
you can install fragit using pip with the following command
pip install .
Without conda, the installation of FragIt becomes slightly more tedious and of course system dependent. If you have root access, you can install all dependencies using the system package manager, but if you don't, then you have to install OpenBabel manually (Github user andersx wrote a guide to how that is accomplished.) Finally, the recommended installation method for FragIt is to use pip again
pip install . --user
but it is also possible using the old school approach (deprecated and not recommended)
python setup.py build
python setup.py install
remember to make sure that environment variables (PATH and PYTHONPATH at least!) are
set up correctly or else FragIt will complain that it cannot find itself.
in a terminal, you can type
fragit
to see its help message.
See the wiki for more examples of how to use FragIt.
In order to run FragIt, you need the following installed on your system:
- The FragIt source code, look above for information on how to obtain it
- Open Babel 3 or newer with python language bindings enabled.
- Numpy 1.5 or newer.
- Python 3.9 (or later).