Metadata-Version: 2.1
Name: pygamess
Version: 0.5.0
Summary: GAMESS wrapper for Python
Home-page: https://github.com/kzfm/pygamess
Author: Ohkawa Kazufumi
Author-email: kerolinq@gmail.com
License: MIT
Description: ==========
         pygamess
        ==========
        
        `pygamess` is a GAMESS wrapper for Python
        
        
        Requirements
        ------------
        * Python 3.7 or later (pygamess <0.5 supports only Python2)
        * RDKit
        * GAMESS
        * ruamel.YAML
        
        Setup
        -----
        ::
        
            $ pip install pygamess
        
        set GAMESS_HOME environment in your .bashrc::
        
            $ export GAMESS_HOME=/usr/local/gamess
        
        Test
        -----
        ::
        
            $ pytest
        
        Basic Usage
        -----------
        
        Single point calculation
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from pygamess import Gamess
            >>> from rdkit import Chem
            >>> from rdkit.Chem import AllChem
            >>> m = Chem.MolFromSmiles("CC")
            >>> m = Chem.AddHs(m)
            >>> AllChem.EmbedMolecule(m)
            0
            >>> AllChem.UFFOptimizeMolecule(m,maxIters=200)
            0
            >>> g = Gamess()
            >>> r = g.run(m)
            >>> 
            >>> r.mol
            <rdkit.Chem.rdchem.Mol object at 0x7ff4ef2498b0>
            >>> r.mol.GetProp("total_energy")
            '-78.302511990200003'
        
        Geometry optimization
        ~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from pygamess import Gamess
            >>> from rdkit import Chem
            >>> from rdkit.Chem import AllChem
            >>> m = Chem.MolFromSmiles("CC")
            >>> m = Chem.AddHs(m)
            >>> AllChem.EmbedMolecule(m)
            0
            >>> AllChem.UFFOptimizeMolecule(m,maxIters=200)
            0
            >>> g = Gamess()
            >>> g.run_type('optimize')
            >>> optimized_mol = g.run(mol)
            >>> optimized_mol.GetProp("total_energy")
            '-78.306179626599999'
        
        Changing basis sets
        ~~~~~~~~~~~~~~~~~~~
        
        ::
        
            >>> from pygamess import Gamess
            >>> from rdkit import Chem
            >>> from rdkit.Chem import AllChem
            >>> m = Chem.MolFromSmiles("CC")
            >>> m = Chem.AddHs(m)
            >>> AllChem.EmbedMolecule(m)
            0
            >>> AllChem.UFFOptimizeMolecule(m,maxIters=200)
            0
            >>> g = Gamess()
            >>> g.run_type = "optimize"
            >>> g.run(m).GetProp("total_energy")
            '-78.302511907400003'
            >>> g.basis_set("3-21G")
            {'gbasis': 'N21', 'ngauss': '3'}
            >>> g.run(m).GetProp("total_energy")
            '-78.790442552000002'
            >>> g.basis_set("6-31G")
            {'gbasis': 'N31', 'ngauss': '6'}
            >>> g.run(m).GetProp("total_energy")
            '-79.194024566899998'
            >>> g.basis_set("6-31G*")
            {'gbasis': 'N31', 'ndfunc': '1', 'ngauss': '6'}
            >>> g.run(m).GetProp("total_energy")
            '-79.225521673399996'
            >>> g.basis_set("6-31G**")
            {'gbasis': 'N31', 'ndfunc': '1', 'npfunc': '1', 'ngauss': '6'}
            >>> g.run(m).GetProp("total_energy")
            '-79.235082450899995'
            
        Or edit the basis attribute directly::
        
            >>> g.options['basis'] = {'gbasis': 'sto', 'ngauss': '3'}
            >>> mol_sto3g = g.run(m)
            >>> mol_sto3g.GetProp("total_energy")
            '-78.302511907400003'
        
        DFT calculation
        ~~~~~~~~~~~~~~~
        
        B3LYP/6-31G*::
        
            >>> g = Gamess()
            >>> g.run_type('optimize')
            >>> g.basis_set("6-31G*")
            {'gbasis': 'N31', 'ngauss': '6', 'ndfunc': '1'}
            >>> g.dft_type('B3LYP')
            >>> g.run(m).GetProp("total_energy")
            '-79.765221302'
        
        
        M062X/6-31G**::
        
            >>> g = Gamess()
            >>> g.run_type('optimize')
            >>> g.dft_type('M06-2X')
            >>> g.basis_set("6-31G**")
            {'gbasis': 'N31', 'ngauss': '6', 'ndfunc': '1', 'npfunc': '1'}
            >>> g.run(m).GetProp("total_energy")
            '-79.778397791200007'
        
        
        Printing GAMESS INPUT
        ~~~~~~~~~~~~~~~~~~~~~
        
        use input method::
        
            >>> g.input(mol)
        
        
        History
        -------
        
        0.5.0 (2020-09-13)
        ~~~~~~~~~~~~~~~~~~~~
        
        * Support Python3
        
        0.4.1.1 (2017-09-16)
        ~~~~~~~~~~~~~~~~~~~~
        
        * Update Readme
        
        0.4.1 (2017-09-16)
        ~~~~~~~~~~~~~~~~~~
        
        * Bug fix (coordinates problem)
        
        0.4.0 (2017-09-13)
        ~~~~~~~~~~~~~~~~~~
        
        * Change the backend library from openbabel to RDKit
        
        0.3.0 (2012-03-31)
        ~~~~~~~~~~~~~~~~~~
        
        * Use internal rungms (default)
        * Add basis_set method(STO-3G,3-21G,6-31G,6-311G,6-31G*,6-31G**,AM1,PM3,MNDO)
        * Constructor can accept options
        * Bug fixed (spin multiplicity)
        
        0.2.2 (2012-03-30)
        ~~~~~~~~~~~~~~~~~~
        
        * Add charge settings
        * Change Method name (gamess_input -> input)
        
        0.2.1 (2012-03-23)
        ~~~~~~~~~~~~~~~~~~
        
        * Bug fix (multiplicity setting for pybel) 
        * Bug fix (print error when rungms exec failed)
        * Add document
        
        0.2.0 (2012-03-06)
        ~~~~~~~~~~~~~~~~~~
        
        * Run method accepts OBMol and Pybel-Molecule object
        
        0.1.2 (2011-09-23)
        ~~~~~~~~~~~~~~~~~~
        
        * Add CIS method (and optimization)
        
        0.1.1 (2011-08-06)
        ~~~~~~~~~~~~~~~~~~
        
        * Update document
        * Semiempical method (AM1, PM3, MNDO)
        * Add statpt option
        * Change default error print message (10 lines)
        
        0.1 (2011-6-25)
        ~~~~~~~~~~~~~~~~~~
        * First release
        
Keywords: chemistry
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Requires: rdkit
Requires: ruamel.YAML
Description-Content-Type: text/x-rst
