Skip to content

How do I use FragIt?

Casper Steinmann edited this page Aug 11, 2016 · 12 revisions

Once FragIt is installed correctly, you can use it directly from the command line. To see the available options available to you, just run the following

fragit -h

Recommended basic work-flow for FragIt

Here we will present the preferred workflow when using FragIt. First, we use FragIt to generate a configuration file which we will modify to our needs. The default way to do this changed in version 1.6.0.

In version 1.6 and later you simply run

fragit-conf -o myconfig.ini

to generate the file myconfig.ini which you can edit in your favourite text editor. If you use a version prior to this look towards the bottom of this document on how to generate the config file. It is always nice to be able to visualize the fragmentation to see if anything has gone wrong. To do this, FragIt can automatically generate appropriate pymol scripts for you to use. Change the writepymol setting in the [output] section of the myconfig.ini file to True.

Next, get your favorite protonated PDB file (or use the following example file called ala_phe_ala.pdb) to fragment it using FragIt to create an input file (.inp) for the Fragment Molecular Orbital (FMO) method and a .pymol file that we can visualize. Here shown for the example file ala_phe_ala.pdb that is provided.

fragit --use-config=myconfig.ini ala_phe_ala.pdb

Upon completion, the two files are placed in the same directory as the .pdb file.

You can visualize the result by invoking pymol from the command line as

pymol ala_phe_ala.inp.pymol

If you are satisfied with the result, you can run the calculation in GAMESS.

What if I'm not satisfied with the result?

FragIt contains many possibilities to customize the fragmentation procedure. Here are some of the most common options

Workflow for versions prior to 1.6.0

It was decided to make a separate tool to generate input defaults for different methods in the 1.6.0 release. Prior to that, to generate an input file one would run

fragit --make-config=myconfig.ini

and follow the tutorial as before.