add references

docs/source/bibliography.bib

@@ -0,0 +1,232 @@
+
+@article{malde2011,
+	title = {An {Automated} {Force} {Field} {Topology} {Builder} ({ATB}) and {Repository}: {Version} 1.0},
+	volume = {7},
+	issn = {1549-9618, 1549-9626},
+	shorttitle = {An {Automated} {Force} {Field} {Topology} {Builder} ({ATB}) and {Repository}},
+	url = {https://pubs.acs.org/doi/10.1021/ct200196m},
+	doi = {10.1021/ct200196m},
+	abstract = {The Automated force field Topology Builder (ATB, http://compbio.biosci.uq.edu.au/atb) is a Web-accessible server that can provide topologies and parameters for a wide range of molecules appropriate for use in molecular simulations, computational drug design, and X-ray refinement. The ATB has three primary functions: (1) to act as a repository for molecules that have been parametrized as part of the GROMOS family of force fields, (2) to act as a repository for pre-equilibrated systems for use as starting configurations in molecular dynamics simulations (solvent mixtures, lipid systems pre-equilibrated to adopt a specific phase, etc.), and (3) to generate force field descriptions of novel molecules compatible with the GROMOS family of force fields in a variety of formats (GROMOS, GROMACS, and CNS). Force field descriptions of novel molecules are derived using a multistep process in which results from quantum mechanical (QM) calculations are combined with a knowledge-based approach to ensure compatibility (as far as possible) with a specific parameter set of the GROMOS force field. The ATB has several unique features: (1) It requires that the user stipulate the protonation and tautomeric states of the molecule. (2) The symmetry of the molecule is analyzed to ensure that equivalent atoms are assigned identical parameters. (3) Charge groups are assigned automatically. (4) Where the assignment of a given parameter is ambiguous, a range of possible alternatives is provided. The ATB also provides several validation tools to assist the user to assess the degree to which the topology generated may be appropriate for a given task. In addition to detailing the steps involved in generating a force field topology compatible with a specific GROMOS parameter set (GROMOS 53A6), the challenges involved in the automatic generation of force field parameters for atomic simulations in general are discussed.},
+	language = {en},
+	number = {12},
+	urldate = {2019-05-29},
+	journal = {Journal of Chemical Theory and Computation},
+	author = {Malde, Alpeshkumar K. and Zuo, Le and Breeze, Matthew and Stroet, Martin and Poger, David and Nair, Pramod C. and Oostenbrink, Chris and Mark, Alan E.},
+	month = dec,
+	year = {2011},
+	note = {00000},
+	keywords = {Must-cite, ATB},
+	pages = {4026--4037},
+	file = {Malde_2011_An_Automated_Force_Field_Topology_Builder_(ATB)_and_Repository_-_Version_1.0.pdf:/Users/lily/OneDrive - Australian National University/Papers/Malde_2011_An_Automated_Force_Field_Topology_Builder_(ATB)_and_Repository_-_Version_1.0.pdf:application/pdf},
+}
+
+
+@article{cieplak1995,
+	title = {Application of the multimolecule and multiconformational {RESP} methodology to biopolymers: {Charge} derivation for {DNA}, {RNA}, and proteins},
+	volume = {16},
+	issn = {0192-8651, 1096-987X},
+	shorttitle = {Application of the multimolecule and multiconformational {RESP} methodology to biopolymers},
+	url = {http://doi.wiley.com/10.1002/jcc.540161106},
+	doi = {10.1002/jcc.540161106},
+	language = {en},
+	number = {11},
+	urldate = {2019-08-06},
+	journal = {Journal of Computational Chemistry},
+	author = {Cieplak, Piotr and Cornell, Wendy D. and Bayly, Christopher and Kollman, Peter A.},
+	month = nov,
+	year = {1995},
+	note = {00876},
+	keywords = {RESP},
+	pages = {1357--1377},
+	file = {Cieplak_1995_Application_of_the_multimolecule_and_multiconformational_RESP_methodology_to_biopolymers_-_Charge.pdf:/Users/lily/OneDrive - Australian National University/Papers/Cieplak_1995_Application_of_the_multimolecule_and_multiconformational_RESP_methodology_to_biopolymers_-_Charge.pdf:application/pdf},
+}
+
+@article{cornell1993,
+	title = {Application of {RESP} charges to calculate conformational energies, hydrogen bond energies, and free energies of solvation},
+	volume = {115},
+	issn = {0002-7863, 1520-5126},
+	url = {http://pubs.acs.org/doi/abs/10.1021/ja00074a030},
+	doi = {10.1021/ja00074a030},
+	abstract = {We apply a new restrained electrostatic potential fit charge model (two-stage RESP) to conformational analysis and the calculation of intermolecular interactions. Specifically, we study conformational energies in butane, methyl ethyl thioether, three simple alcohols, three simple amines, and 1,2-ethanediol as a function of charge model (two-stage RESP vs standard ESP) and 1-4 electrostatic scale factor. We demonstrate that the two-stage RESP model with a 1-4 electrostatic scale factor of —1/1.2 is a very good model, as evaluated by comparison with high-level ab initio calculations. For methanol and /V-methylacetamide interactions with TIP3P water, the two-stage RESP model leads to hydrogen bonds only slightly weaker than found with the standard ESP changes. In tests on DNA base pairs, the two-stage RESP model leads to hydrogen bonds which are {\textasciitilde} 1 kcal/mol weaker than those calculated with the standard ESP charges but closer in magnitude to the best current available ab initio calculations. Furthermore, the two-stage RESP charges, unlike the standard ESP charges, reproduce the result that Hoogsteen hydrogen bonding is stronger than Watson-Crick hydrogen bonding for adenine-thymine base pairs. The free energies of solvation of both methanol and f/ww-iV-methylacetamide were also calculated for the standard ESP and two-stage RESP models and both were in good agreement with experiment. We have combined the use of two-stage RESP charges with multiple conformational fitting—recently employed using standard ESP charges as described by Reynolds, et al. (J. Am. Chem. Soc. 1992, 114, 9075)—in studies of conformationally dependent dipole moments and energies of propylamine. We find that the combination of these approaches is synergistic in leading to useful charge distributions for molecular simulations. Two-stage RESP charges thus reproduce both intermolecular and intramolecular energies and structures quite well, making this charge model a critical advancement in the development of a general force field for modeling biological macromolecules and their ligands, both in the gas phase and in solution.},
+	language = {en},
+	number = {21},
+	urldate = {2019-08-06},
+	journal = {Journal of the American Chemical Society},
+	author = {Cornell, Wendy D. and Cieplak, Piotr and Bayly, Christopher I. and Kollman, Peter A.},
+	month = oct,
+	year = {1993},
+	note = {01110},
+	keywords = {RESP},
+	pages = {9620--9631},
+	file = {Cornell_1993_Application_of_RESP_charges_to_calculate_conformational_energies,_hydrogen_bond_energies,_and_free.pdf:/Users/lily/OneDrive - Australian National University/Papers/Cornell_1993_Application_of_RESP_charges_to_calculate_conformational_energies,_hydrogen_bond_energies,_and_free.pdf:application/pdf},
+}
+
+@article{bayly1993,
+	title = {A well-behaved electrostatic potential based method using charge restraints for deriving atomic charges: the {RESP} model},
+	volume = {97},
+	issn = {0022-3654, 1541-5740},
+	shorttitle = {A well-behaved electrostatic potential based method using charge restraints for deriving atomic charges},
+	url = {http://pubs.acs.org/doi/abs/10.1021/j100142a004},
+	doi = {10.1021/j100142a004},
+	language = {en},
+	number = {40},
+	urldate = {2019-08-06},
+	journal = {The Journal of Physical Chemistry},
+	author = {Bayly, Christopher I. and Cieplak, Piotr and Cornell, Wendy and Kollman, Peter A.},
+	month = oct,
+	year = {1993},
+	note = {04975},
+	keywords = {RESP},
+	pages = {10269--10280},
+	file = {Bayly_1993_A_well-behaved_electrostatic_potential_based_method_using_charge_restraints_for_deriving_atomic.pdf:/Users/lily/OneDrive - Australian National University/Papers/Bayly_1993_A_well-behaved_electrostatic_potential_based_method_using_charge_restraints_for_deriving_atomic.pdf:application/pdf},
+}
+
+@article{dupradeau2010,
+	title = {The {R}.{E}.{D}. tools: advances in {RESP} and {ESP} charge derivation and force field library building},
+	volume = {12},
+	issn = {1463-9076, 1463-9084},
+	shorttitle = {The {R}.{E}.{D}. tools},
+	url = {http://xlink.rsc.org/?DOI=c0cp00111b},
+	doi = {10.1039/c0cp00111b},
+	language = {en},
+	number = {28},
+	urldate = {2019-08-06},
+	journal = {Physical Chemistry Chemical Physics},
+	author = {Dupradeau, François-Yves and Pigache, Adrien and Zaffran, Thomas and Savineau, Corentin and Lelong, Rodolphe and Grivel, Nicolas and Lelong, Dimitri and Rosanski, Wilfried and Cieplak, Piotr},
+	year = {2010},
+	note = {00595},
+	keywords = {RESP, RED},
+	pages = {7821},
+	file = {Dupradeau_2010_The_R.E.D._tools_-_advances_in_RESP_and_ESP_charge_derivation_and_force_field_library_building.pdf:/Users/lily/OneDrive - Australian National University/Papers/Dupradeau_2010_The_R.E.D._tools_-_advances_in_RESP_and_ESP_charge_derivation_and_force_field_library_building.pdf:application/pdf},
+}
+
+@article{dupradeau2007,
+	title = {R.{E}.{DD}.{B}.: {A} database for {RESP} and {ESP} atomic charges, and force field libraries},
+	volume = {36},
+	issn = {0305-1048, 1362-4962},
+	shorttitle = {R.{E}.{DD}.{B}.},
+	url = {https://academic.oup.com/nar/article-lookup/doi/10.1093/nar/gkm887},
+	doi = {10.1093/nar/gkm887},
+	abstract = {The web-based RESP ESP charge DataBase (R.E.DD.B., http://q4md-forcefieldtools.org/REDDB) is a free and new source of RESP and ESP atomic charge values and force field libraries for model systems and/or small molecules. R.E.DD.B. stores highly effective and reproducible charge values and molecular structures in the Tripos mol2 file format, information about the charge derivation procedure, scripts to integrate the charges and molecular topology in the most common molecular dynamics packages. Moreover, R.E.DD.B. allows users to freely store and distribute RESP or ESP charges and force field libraries to the scientific community, via a web interface. The first version of R.E.DD.B., released in January 2006, contains force field libraries for molecules as well as molecular fragments for standard residues and their analogs (amino acids, monosaccharides, nucleotides and ligands), hence covering a vast area of relevant biological applications.},
+	language = {en},
+	number = {Database},
+	urldate = {2019-08-06},
+	journal = {Nucleic Acids Research},
+	author = {Dupradeau, F.-Y. and Cezard, C. and Lelong, R. and Stanislawiak, E. and Pecher, J. and Delepine, J. C. and Cieplak, P.},
+	month = dec,
+	year = {2007},
+	note = {00081},
+	keywords = {RESP, RED},
+	pages = {D360--D367},
+	file = {Dupradeau_2007_R.E.DD.B._-_A_database_for_RESP_and_ESP_atomic_charges,_and_force_field_libraries.pdf:/Users/lily/OneDrive - Australian National University/Papers/Dupradeau_2007_R.E.DD.B._-_A_database_for_RESP_and_ESP_atomic_charges,_and_force_field_libraries.pdf:application/pdf},
+}
+
+@article{schauperl2020,
+	title = {Non-bonded force field model with advanced restrained electrostatic potential charges ({RESP2})},
+	volume = {3},
+	copyright = {2020 The Author(s)},
+	issn = {2399-3669},
+	url = {https://www.nature.com/articles/s42004-020-0291-4},
+	doi = {10.1038/s42004-020-0291-4},
+	abstract = {The restrained electrostatic potential (RESP) is a widely used method for assigning partial charges to organic molecules for molecular dynamics simulations, but it imperfectly accounts for self-polarization in solution. Here, RESP is updated by co-optimizing the polarity of the charges it generates, along with atomic Lennard-Jones parameters, to yield an improved model of non-bonded interactions.},
+	language = {en},
+	number = {1},
+	urldate = {2020-05-13},
+	journal = {Communications Chemistry},
+	author = {Schauperl, Michael and Nerenberg, Paul S. and Jang, Hyesu and Wang, Lee-Ping and Bayly, Christopher I. and Mobley, David L. and Gilson, Michael K.},
+	month = apr,
+	year = {2020},
+	note = {00000 
+Number: 1
+Publisher: Nature Publishing Group},
+	pages = {1--11},
+	file = {Snapshot:/Users/lily/Zotero/storage/Q8ULS29F/s42004-020-0291-4.html:text/html;Full Text PDF:/Users/lily/Zotero/storage/MCPLH9GL/Schauperl et al. - 2020 - Non-bonded force field model with advanced restrai.pdf:application/pdf},
+}
+
+@article{alenaizan2020,
+	title = {Python implementation of the restrained electrostatic potential charge model},
+	volume = {120},
+	copyright = {© 2019 Wiley Periodicals, Inc.},
+	issn = {1097-461X},
+	url = {http://onlinelibrary.wiley.com/doi/abs/10.1002/qua.26035},
+	doi = {10.1002/qua.26035},
+	abstract = {The restrained electrostatic potential (RESP) charge model is widely used in molecular dynamics simulations, especially for the AMBER and GAFF force fields. We have implemented the RESP scheme using the accessible and widely used Python language and the NumPy numerical library. This article provides a programming-oriented introduction to the RESP scheme and highlights some of the features of NumPy that are useful in scientific computing.},
+	language = {en},
+	number = {2},
+	urldate = {2020-05-01},
+	journal = {International Journal of Quantum Chemistry},
+	author = {Alenaizan, Asem and Burns, Lori A. and Sherrill, C. David},
+	year = {2020},
+	note = {00000 
+\_eprint: https://onlinelibrary.wiley.com/doi/pdf/10.1002/qua.26035},
+	keywords = {RESP},
+	pages = {e26035},
+	file = {Full Text PDF:/Users/lily/Zotero/storage/QCGEERRQ/Alenaizan et al. - 2020 - Python implementation of the restrained electrosta.pdf:application/pdf;Snapshot:/Users/lily/Zotero/storage/B2P252VB/qua.html:text/html},
+}
+
+@article{singh1984,
+	title = {An approach to computing electrostatic charges for molecules},
+	volume = {5},
+	copyright = {Copyright © 1984 John Wiley \& Sons, Inc.},
+	issn = {1096-987X},
+	url = {http://onlinelibrary.wiley.com/doi/abs/10.1002/jcc.540050204},
+	doi = {10.1002/jcc.540050204},
+	abstract = {We present an approach for deriving net atomic charges from ab initio quantum mechanical calculations using a least squares fit of the quantum mechanically calculated electrostatic potential to that of the partial charge model. Our computational approach is similar to those presented by Momany [J. Phys. Chem., 82, 592 (1978)], Smit, Derissen, and van Duijneveldt [Mol. Phys., 37, 521 (1979)], and Cox and Williams [J. Comput. Chem., 2, 304 (1981)], but differs in the approach to choosing the positions for evaluating the potential. In this article, we present applications to the molecules H2O, CH3OH, (CH3)2O, H2CO, NH3, (CH3O)2PO, deoxyribose, ribose, adenine, 9-CH3 adenine, thymine, 1-CH3 thymine, guanine, 9-CH3 guanine, cytosine, 1-CH3 cytosine, uracil, and 1-CH3 uracil. We also address the question of inclusion of “lone pairs,” their location and charge.},
+	language = {en},
+	number = {2},
+	urldate = {2020-05-11},
+	journal = {Journal of Computational Chemistry},
+	author = {Singh, U. Chandra and Kollman, Peter A.},
+	year = {1984},
+	note = {00000 
+\_eprint: https://onlinelibrary.wiley.com/doi/pdf/10.1002/jcc.540050204},
+	keywords = {RESP, ESP, partial charges},
+	pages = {129--145},
+	file = {Singh_1984_An_approach_to_computing_electrostatic_charges_for_molecules.pdf:/Users/lily/OneDrive - Australian National University/Papers/Singh_1984_An_approach_to_computing_electrostatic_charges_for_molecules2.pdf:application/pdf;Singh_1984_An_approach_to_computing_electrostatic_charges_for_molecules.pdf:/Users/lily/OneDrive - Australian National University/Papers/Singh_1984_An_approach_to_computing_electrostatic_charges_for_molecules.pdf:application/pdf;Snapshot:/Users/lily/Zotero/storage/9H5327AH/jcc.html:text/html},
+}
+
+
+@article{connolly1983,
+	title = {Analytical molecular surface calculation},
+	volume = {16},
+	issn = {1600-5767},
+	url = {http://onlinelibrary.wiley.com/doi/abs/10.1107/S0021889883010985},
+	doi = {https://doi.org/10.1107/S0021889883010985},
+	abstract = {A computer algorithm is presented for calculating the part of the van der Waals surface of molecule that is accessible to solvent. The solvent molecule is modeled by a sphere. This sphere is, in effect, rolled over the molecule to generate a smooth outer-surface contour. This surface contour is made up of pieces of spheres and tori that join at circular arcs. The spheres, tori and arcs are defined by analytical expressions in terms of the atomic coordinates, van der Waals radii and the probe radius. The area of each surface piece may be calculated analytically and the surface may be displayed on either vector or raster computer-graphics systems. These methods are useful for studying the structure and interactions of proteins and nucleic acids.},
+	language = {en},
+	number = {5},
+	urldate = {2021-04-05},
+	journal = {Journal of Applied Crystallography},
+	author = {Connolly, M. L.},
+	year = {1983},
+	note = {\_eprint: https://onlinelibrary.wiley.com/doi/pdf/10.1107/S0021889883010985},
+	pages = {548--558},
+	file = {Full Text PDF:/Users/lily/Zotero/storage/USRVLP5U/Connolly - 1983 - Analytical molecular surface calculation.pdf:application/pdf;Snapshot:/Users/lily/Zotero/storage/GA5D5F2C/S0021889883010985.html:text/html},
+}
+
+@misc{rdkit,
+	title = {{RDKit}: {Open}-source cheminformatics},
+	url = {rdkit.org},
+	author = {Landrum, Gregory},
+	note = {https://doi.org/10.5281/zenodo.4107869},
+}
+
+@article{psi4,
+	title = {Psi4: an open-source ab initio electronic structure program},
+	volume = {2},
+	copyright = {Copyright © 2011 John Wiley \& Sons, Ltd.},
+	issn = {1759-0884},
+	shorttitle = {Psi4},
+	url = {http://onlinelibrary.wiley.com/doi/abs/10.1002/wcms.93},
+	doi = {https://doi.org/10.1002/wcms.93},
+	abstract = {The Psi4 program is a new approach to modern quantum chemistry, encompassing Hartree–Fock and density-functional theory to configuration interaction and coupled cluster. The program is written entirely in C++ and relies on a new infrastructure that has been designed to permit high-efficiency computations of both standard and emerging electronic structure methods on conventional and high-performance parallel computer architectures. Psi4 offers flexible user input built on the Python scripting language that enables both new and experienced users to make full use of the program's capabilities, and even to implement new functionality with moderate effort. To maximize its impact and usefulness, Psi4 is available through an open-source license to the entire scientific community. © 2011 John Wiley \& Sons, Ltd. This article is categorized under: Software {\textgreater} Quantum Chemistry},
+	language = {en},
+	number = {4},
+	urldate = {2021-04-05},
+	journal = {WIREs Computational Molecular Science},
+	author = {Turney, Justin M. and Simmonett, Andrew C. and Parrish, Robert M. and Hohenstein, Edward G. and Evangelista, Francesco A. and Fermann, Justin T. and Mintz, Benjamin J. and Burns, Lori A. and Wilke, Jeremiah J. and Abrams, Micah L. and Russ, Nicholas J. and Leininger, Matthew L. and Janssen, Curtis L. and Seidl, Edward T. and Allen, Wesley D. and Schaefer, Henry F. and King, Rollin A. and Valeev, Edward F. and Sherrill, C. David and Crawford, T. Daniel},
+	year = {2012},
+	note = {\_eprint: https://onlinelibrary.wiley.com/doi/pdf/10.1002/wcms.93},
+	pages = {556--565},
+	file = {Full Text PDF:/Users/lily/Zotero/storage/S33QBJYB/Turney et al. - 2012 - Psi4 an open-source ab initio electronic structur.pdf:application/pdf;Snapshot:/Users/lily/Zotero/storage/TLLP89PW/wcms.html:text/html},
+}

docs/source/conf.py

@@ -221,3 +221,5 @@
 """
 
 html_js_files = []
+
+bibtex_bibfiles = ["bibliography.bib"]

docs/source/index.rst

@@ -18,7 +18,8 @@ around heavy atoms.
 
 For ease of use, PsiRESP offers pre-configured classes that correspond with
 existing popular tools such as the RESP ESP Charge Derive (R.E.D.) tools
-and the Automated Topology Builder.
+and the Automated Topology Builder. Please see :ref:`RESP` for more details
+on RESP fitting and the pre-configured classes (:ref:`Pre-configured classes`).
 
 
 ----------------
@@ -47,6 +48,7 @@ PsiRESP is licensed under the GNU Lesser General Public License (LGPL).
    installation
    usage
    examples/README
+   resp
    molecule
    charge_constraints
    hpc