openff-toolkit 0.18.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (236) hide show
  1. openff_toolkit-0.18.0/LICENSE +21 -0
  2. openff_toolkit-0.18.0/MANIFEST.in +5 -0
  3. openff_toolkit-0.18.0/PKG-INFO +109 -0
  4. openff_toolkit-0.18.0/README.md +90 -0
  5. openff_toolkit-0.18.0/devtools/scripts/build_cookiecutter_json.py +22 -0
  6. openff_toolkit-0.18.0/docs/conf.py +296 -0
  7. openff_toolkit-0.18.0/docs/conftest.py +23 -0
  8. openff_toolkit-0.18.0/examples/conformer_energies/conformer_energies.py +143 -0
  9. openff_toolkit-0.18.0/examples/deprecated/SMIRNOFF_comparison/compare_molecule_energies.py +48 -0
  10. openff_toolkit-0.18.0/examples/deprecated/SMIRNOFF_comparison/compare_set_energies.py +58 -0
  11. openff_toolkit-0.18.0/examples/deprecated/liquid_box/create_mol2_pdb/create_mol2_pdb.py +193 -0
  12. openff_toolkit-0.18.0/examples/deprecated/liquid_box/openff_simulation.py +72 -0
  13. openff_toolkit-0.18.0/examples/deprecated/mixedFF_structure/generate_mixedFF_complex.py +56 -0
  14. openff_toolkit-0.18.0/examples/deprecated/testing/test_impropers/tleap_tools.py +120 -0
  15. openff_toolkit-0.18.0/examples/examples_helper.py +61 -0
  16. openff_toolkit-0.18.0/openff/toolkit/__init__.py +101 -0
  17. openff_toolkit-0.18.0/openff/toolkit/_tests/__init__.py +0 -0
  18. openff_toolkit-0.18.0/openff/toolkit/_tests/_stale_tests.py +146 -0
  19. openff_toolkit-0.18.0/openff/toolkit/_tests/conftest.py +108 -0
  20. openff_toolkit-0.18.0/openff/toolkit/_tests/create_molecules.py +494 -0
  21. openff_toolkit-0.18.0/openff/toolkit/_tests/mocking.py +145 -0
  22. openff_toolkit-0.18.0/openff/toolkit/_tests/molecule/__init__.py +1 -0
  23. openff_toolkit-0.18.0/openff/toolkit/_tests/molecule/test_state_enumeration.py +302 -0
  24. openff_toolkit-0.18.0/openff/toolkit/_tests/test_energies.py +136 -0
  25. openff_toolkit-0.18.0/openff/toolkit/_tests/test_examples.py +109 -0
  26. openff_toolkit-0.18.0/openff/toolkit/_tests/test_forcefield.py +3864 -0
  27. openff_toolkit-0.18.0/openff/toolkit/_tests/test_interchange.py +19 -0
  28. openff_toolkit-0.18.0/openff/toolkit/_tests/test_io.py +19 -0
  29. openff_toolkit-0.18.0/openff/toolkit/_tests/test_links.py +73 -0
  30. openff_toolkit-0.18.0/openff/toolkit/_tests/test_mm_molecule.py +404 -0
  31. openff_toolkit-0.18.0/openff/toolkit/_tests/test_molecule.py +4246 -0
  32. openff_toolkit-0.18.0/openff/toolkit/_tests/test_nagl.py +169 -0
  33. openff_toolkit-0.18.0/openff/toolkit/_tests/test_parameter_plugins.py +89 -0
  34. openff_toolkit-0.18.0/openff/toolkit/_tests/test_parameters.py +2898 -0
  35. openff_toolkit-0.18.0/openff/toolkit/_tests/test_toolkit_io.py +1088 -0
  36. openff_toolkit-0.18.0/openff/toolkit/_tests/test_toolkits.py +4418 -0
  37. openff_toolkit-0.18.0/openff/toolkit/_tests/test_topology.py +2485 -0
  38. openff_toolkit-0.18.0/openff/toolkit/_tests/test_utils.py +101 -0
  39. openff_toolkit-0.18.0/openff/toolkit/_tests/test_utils_callback.py +178 -0
  40. openff_toolkit-0.18.0/openff/toolkit/_tests/test_utils_collections.py +263 -0
  41. openff_toolkit-0.18.0/openff/toolkit/_tests/test_utils_serialization.py +168 -0
  42. openff_toolkit-0.18.0/openff/toolkit/_tests/utils.py +1747 -0
  43. openff_toolkit-0.18.0/openff/toolkit/data/README.md +8 -0
  44. openff_toolkit-0.18.0/openff/toolkit/data/molecules/AlkEthOH_test_filt1_ff.mol2 +2026 -0
  45. openff_toolkit-0.18.0/openff/toolkit/data/molecules/AlkEthOH_test_filt1_tripos.mol2 +2026 -0
  46. openff_toolkit-0.18.0/openff/toolkit/data/molecules/AlkEthOH_tripos.tar.gz +0 -0
  47. openff_toolkit-0.18.0/openff/toolkit/data/molecules/CID20742535_anion.sdf +50 -0
  48. openff_toolkit-0.18.0/openff/toolkit/data/molecules/CID20742535_neutral.sdf +51 -0
  49. openff_toolkit-0.18.0/openff/toolkit/data/molecules/FreeSolv.tar.gz +0 -0
  50. openff_toolkit-0.18.0/openff/toolkit/data/molecules/MiniDrugBank.sdf +33988 -0
  51. openff_toolkit-0.18.0/openff/toolkit/data/molecules/MiniDrugBank_tripos.mol2 +35462 -0
  52. openff_toolkit-0.18.0/openff/toolkit/data/molecules/PT2385.sdf +90 -0
  53. openff_toolkit-0.18.0/openff/toolkit/data/molecules/QL8.sdf +401 -0
  54. openff_toolkit-0.18.0/openff/toolkit/data/molecules/README.md +21 -0
  55. openff_toolkit-0.18.0/openff/toolkit/data/molecules/benzene.crd +8 -0
  56. openff_toolkit-0.18.0/openff/toolkit/data/molecules/benzene.mol2 +34 -0
  57. openff_toolkit-0.18.0/openff/toolkit/data/molecules/benzene.top +166 -0
  58. openff_toolkit-0.18.0/openff/toolkit/data/molecules/butane_multi.sdf +231 -0
  59. openff_toolkit-0.18.0/openff/toolkit/data/molecules/cyclohexane.mol2 +44 -0
  60. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethanol.mol2 +25 -0
  61. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethanol.sdf +23 -0
  62. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethanol_partial_charges.sdf +26 -0
  63. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethanol_reordered.mol2 +25 -0
  64. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethanol_reordered.sdf +23 -0
  65. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ethene_rdkit.sdf +17 -0
  66. openff_toolkit-0.18.0/openff/toolkit/data/molecules/laromustine_ff.mol2 +71 -0
  67. openff_toolkit-0.18.0/openff/toolkit/data/molecules/laromustine_tripos.mol2 +71 -0
  68. openff_toolkit-0.18.0/openff/toolkit/data/molecules/methane_multiconformer.sdf +32 -0
  69. openff_toolkit-0.18.0/openff/toolkit/data/molecules/methane_multiconformer_properties.sdf +45 -0
  70. openff_toolkit-0.18.0/openff/toolkit/data/molecules/nh4.pdb +7 -0
  71. openff_toolkit-0.18.0/openff/toolkit/data/molecules/po4_phenylphosphate.pdb +46 -0
  72. openff_toolkit-0.18.0/openff/toolkit/data/molecules/ruxolitinib_conformers.sdf +910 -0
  73. openff_toolkit-0.18.0/openff/toolkit/data/molecules/toluene.mol2 +38 -0
  74. openff_toolkit-0.18.0/openff/toolkit/data/molecules/toluene.mol2.gz +0 -0
  75. openff_toolkit-0.18.0/openff/toolkit/data/molecules/toluene.pdb +30 -0
  76. openff_toolkit-0.18.0/openff/toolkit/data/molecules/toluene.sdf +36 -0
  77. openff_toolkit-0.18.0/openff/toolkit/data/molecules/toluene_charged.mol2 +38 -0
  78. openff_toolkit-0.18.0/openff/toolkit/data/molecules/z_3_hydroxy_propenal.sdf +23 -0
  79. openff_toolkit-0.18.0/openff/toolkit/data/proteins/5tbm_complex_solv.pdb +1928 -0
  80. openff_toolkit-0.18.0/openff/toolkit/data/proteins/5tbm_complex_solv_box.pdb +19563 -0
  81. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_ALA.pdb +20 -0
  82. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_ALA.sdf +43 -0
  83. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_ALA_ALA.pdb +30 -0
  84. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_ALA_ALA_misnamedH.pdb +30 -0
  85. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_ARG.pdb +34 -0
  86. openff_toolkit-0.18.0/openff/toolkit/data/proteins/CTerminal_TRP.pdb +34 -0
  87. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA.pdb +25 -0
  88. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA.sdf +52 -0
  89. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA_ALA.pdb +35 -0
  90. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA_ALA.sdf +69 -0
  91. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA_ALA_icodes.pdb +35 -0
  92. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ALA_ALA_no_hydrogens.pdb +17 -0
  93. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ARG.pdb +39 -0
  94. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_ARG.sdf +81 -0
  95. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_CYM.pdb +25 -0
  96. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_CYS.pdb +26 -0
  97. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_CYX.pdb +48 -0
  98. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_CYX.sdf +96 -0
  99. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_GLH.sdf +64 -0
  100. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_GLU.sdf +63 -0
  101. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_HID.pdb +32 -0
  102. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_HIE.pdb +32 -0
  103. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_HIE.sdf +67 -0
  104. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_HIP.pdb +33 -0
  105. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_HIP.sdf +70 -0
  106. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_PRO.pdb +29 -0
  107. openff_toolkit-0.18.0/openff/toolkit/data/proteins/MainChain_TRP.pdb +39 -0
  108. openff_toolkit-0.18.0/openff/toolkit/data/proteins/NTerminal_ALA.pdb +21 -0
  109. openff_toolkit-0.18.0/openff/toolkit/data/proteins/NTerminal_ALA.sdf +45 -0
  110. openff_toolkit-0.18.0/openff/toolkit/data/proteins/NTerminal_ALA_ALA.pdb +31 -0
  111. openff_toolkit-0.18.0/openff/toolkit/data/proteins/NTerminal_ARG.pdb +35 -0
  112. openff_toolkit-0.18.0/openff/toolkit/data/proteins/NTerminal_TRP.pdb +35 -0
  113. openff_toolkit-0.18.0/openff/toolkit/data/proteins/T4-protein-unprocessed-4w51.pdb +1892 -0
  114. openff_toolkit-0.18.0/openff/toolkit/data/proteins/T4-protein.mol2 +5461 -0
  115. openff_toolkit-0.18.0/openff/toolkit/data/proteins/T4-protein.pdb +2637 -0
  116. openff_toolkit-0.18.0/openff/toolkit/data/proteins/T4-protein.sdf +5318 -0
  117. openff_toolkit-0.18.0/openff/toolkit/data/proteins/T4_protein_waters.pdb +2965 -0
  118. openff_toolkit-0.18.0/openff/toolkit/data/proteins/TwoMol_SER_CYS.pdb +50 -0
  119. openff_toolkit-0.18.0/openff/toolkit/data/proteins/aa_residues_substructures_explicit_bond_orders_with_caps.json +6435 -0
  120. openff_toolkit-0.18.0/openff/toolkit/data/proteins/aa_residues_substructures_explicit_bond_orders_with_caps_explicit_connectivity.json +6675 -0
  121. openff_toolkit-0.18.0/openff/toolkit/data/proteins/aa_residues_substructures_with_caps.json +6297 -0
  122. openff_toolkit-0.18.0/openff/toolkit/data/proteins/ace-ZZZ-gly-nme.pdb +78 -0
  123. openff_toolkit-0.18.0/openff/toolkit/data/proteins/ace-ZZZ-gly-nme.sdf +98 -0
  124. openff_toolkit-0.18.0/openff/toolkit/data/proteins/ace-a10-nme.sdf +229 -0
  125. openff_toolkit-0.18.0/openff/toolkit/data/proteins/ace-ala-nh2.pdb +21 -0
  126. openff_toolkit-0.18.0/openff/toolkit/data/proteins/fluoresceine_dyed_helix_capped.pdb +338 -0
  127. openff_toolkit-0.18.0/openff/toolkit/data/proteins/neutral_arginine.pdb +31 -0
  128. openff_toolkit-0.18.0/openff/toolkit/data/proteins/split_chain.pdb +74 -0
  129. openff_toolkit-0.18.0/openff/toolkit/data/proteins/split_chain_reordered.pdb +74 -0
  130. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/README.md +6 -0
  131. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_0.8.0.json +1 -0
  132. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_0.8.0.json.txt +180 -0
  133. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_after_1007.json +1 -0
  134. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_after_1007.json.txt +350 -0
  135. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_after_802.json +1 -0
  136. openff_toolkit-0.18.0/openff/toolkit/data/reference_energies/reference_after_802.json.txt +291 -0
  137. openff_toolkit-0.18.0/openff/toolkit/data/systems/README.md +3 -0
  138. openff_toolkit-0.18.0/openff/toolkit/data/systems/amber/cyclohexane_ethanol_0.4_0.6.inpcrd +1511 -0
  139. openff_toolkit-0.18.0/openff/toolkit/data/systems/amber/cyclohexane_ethanol_0.4_0.6.prmtop +13367 -0
  140. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/butanol.mol2 +38 -0
  141. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/butanol.sdf +88 -0
  142. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/cyclohexane.mol2 +45 -0
  143. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/cyclohexane.sdf +105 -0
  144. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/ethanol.mol2 +26 -0
  145. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/ethanol.sdf +58 -0
  146. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/methane.mol2 +18 -0
  147. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/methane.sdf +38 -0
  148. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/propane.mol2 +30 -0
  149. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/propane.sdf +68 -0
  150. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/tip3p_water.mol2 +14 -0
  151. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/water.mol2 +14 -0
  152. openff_toolkit-0.18.0/openff/toolkit/data/systems/monomers/water.sdf +28 -0
  153. openff_toolkit-0.18.0/openff/toolkit/data/systems/packmol_boxes/cyclohexane_ethanol_0.4_0.6.pdb +6272 -0
  154. openff_toolkit-0.18.0/openff/toolkit/data/systems/packmol_boxes/cyclohexane_water.pdb +5524 -0
  155. openff_toolkit-0.18.0/openff/toolkit/data/systems/packmol_boxes/ethanol_water.pdb +5174 -0
  156. openff_toolkit-0.18.0/openff/toolkit/data/systems/packmol_boxes/propane_methane_butanol_0.2_0.3_0.5.pdb +7959 -0
  157. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/1_cyclohexane_1_ethanol.pdb +61 -0
  158. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/1_ethanol.pdb +24 -0
  159. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/1_ethanol_no_conect.pdb +15 -0
  160. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/1_ethanol_reordered.pdb +24 -0
  161. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/PE.pdb +67 -0
  162. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/README.md +3 -0
  163. openff_toolkit-0.18.0/openff/toolkit/data/systems/test_systems/T4_lysozyme_water_ions.pdb +29240 -0
  164. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/Frosst_AlkEthOH.offxml +61 -0
  165. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/Frosst_AlkEthOH_GBSA.offxml +78 -0
  166. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/Frosst_AlkEthOH_MDL.offxml +62 -0
  167. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/Frosst_AlkEthOH_parmAtFrosst.offxml +64 -0
  168. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/GBSA_HCT-1.0.offxml +21 -0
  169. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/GBSA_OBC1-1.0.offxml +18 -0
  170. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/GBSA_OBC2-1.0.offxml +18 -0
  171. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/README.md +23 -0
  172. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/ammonia_minimal.offxml +27 -0
  173. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/benzene_minimal.offxml +29 -0
  174. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/chargeincrement-test.offxml +16 -0
  175. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/frcmod.Frosst_AlkEthOH_withIDs +85 -0
  176. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/ion_charges.offxml +18 -0
  177. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/mangled.offxml +9 -0
  178. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/README.md +9 -0
  179. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/hbonds.offxml +11 -0
  180. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_2_spec_0_1.offxml +332 -0
  181. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_2_spec_0_2.offxml +338 -0
  182. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_2_spec_0_3.offxml +329 -0
  183. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_fixed_spec_0_1.offxml +342 -0
  184. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_fixed_spec_0_2.offxml +348 -0
  185. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_fixed_spec_0_3.offxml +337 -0
  186. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_spec_0_1.offxml +340 -0
  187. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_spec_0_2.offxml +346 -0
  188. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/old/test_ff_0_0_4_spec_0_3.offxml +337 -0
  189. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/smirff99Frosst_reference_0_1_spec.offxml +349 -0
  190. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/smirnoff99Frosst_experimental.offxml +343 -0
  191. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/smirnoff99Frosst_reference_0_1_spec.offxml +349 -0
  192. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/smirnoff99Frosst_reference_0_2_spec.offxml +356 -0
  193. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/test_forcefield.offxml +346 -0
  194. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/tip3p.offxml +22 -0
  195. openff_toolkit-0.18.0/openff/toolkit/data/test_forcefields/unsupported_smirnoff_version.offxml +9 -0
  196. openff_toolkit-0.18.0/openff/toolkit/topology/__init__.py +43 -0
  197. openff_toolkit-0.18.0/openff/toolkit/topology/_mm_molecule.py +663 -0
  198. openff_toolkit-0.18.0/openff/toolkit/topology/molecule.py +6102 -0
  199. openff_toolkit-0.18.0/openff/toolkit/topology/topology.py +2555 -0
  200. openff_toolkit-0.18.0/openff/toolkit/typing/__init__.py +1 -0
  201. openff_toolkit-0.18.0/openff/toolkit/typing/engines/__init__.py +1 -0
  202. openff_toolkit-0.18.0/openff/toolkit/typing/engines/smirnoff/__init__.py +31 -0
  203. openff_toolkit-0.18.0/openff/toolkit/typing/engines/smirnoff/forcefield.py +1440 -0
  204. openff_toolkit-0.18.0/openff/toolkit/typing/engines/smirnoff/io.py +234 -0
  205. openff_toolkit-0.18.0/openff/toolkit/typing/engines/smirnoff/parameters.py +3839 -0
  206. openff_toolkit-0.18.0/openff/toolkit/typing/engines/smirnoff/plugins.py +91 -0
  207. openff_toolkit-0.18.0/openff/toolkit/utils/__init__.py +57 -0
  208. openff_toolkit-0.18.0/openff/toolkit/utils/_viz.py +104 -0
  209. openff_toolkit-0.18.0/openff/toolkit/utils/ambertools_wrapper.py +507 -0
  210. openff_toolkit-0.18.0/openff/toolkit/utils/base_wrapper.py +268 -0
  211. openff_toolkit-0.18.0/openff/toolkit/utils/builtin_wrapper.py +136 -0
  212. openff_toolkit-0.18.0/openff/toolkit/utils/callback.py +187 -0
  213. openff_toolkit-0.18.0/openff/toolkit/utils/collections.py +247 -0
  214. openff_toolkit-0.18.0/openff/toolkit/utils/constants.py +18 -0
  215. openff_toolkit-0.18.0/openff/toolkit/utils/exceptions.py +766 -0
  216. openff_toolkit-0.18.0/openff/toolkit/utils/nagl_wrapper.py +164 -0
  217. openff_toolkit-0.18.0/openff/toolkit/utils/openeye_wrapper.py +2750 -0
  218. openff_toolkit-0.18.0/openff/toolkit/utils/rdkit_wrapper.py +3302 -0
  219. openff_toolkit-0.18.0/openff/toolkit/utils/serialization.py +466 -0
  220. openff_toolkit-0.18.0/openff/toolkit/utils/toolkit_registry.py +509 -0
  221. openff_toolkit-0.18.0/openff/toolkit/utils/toolkits.py +217 -0
  222. openff_toolkit-0.18.0/openff/toolkit/utils/utils.py +805 -0
  223. openff_toolkit-0.18.0/openff_toolkit.egg-info/PKG-INFO +109 -0
  224. openff_toolkit-0.18.0/openff_toolkit.egg-info/SOURCES.txt +235 -0
  225. openff_toolkit-0.18.0/openff_toolkit.egg-info/dependency_links.txt +1 -0
  226. openff_toolkit-0.18.0/openff_toolkit.egg-info/top_level.txt +5 -0
  227. openff_toolkit-0.18.0/pyproject.toml +94 -0
  228. openff_toolkit-0.18.0/setup.cfg +11 -0
  229. openff_toolkit-0.18.0/utilities/deprecated/convert_frosst/convert_frcmod_0.1.py +251 -0
  230. openff_toolkit-0.18.0/utilities/deprecated/convert_frosst/convert_frcmod_0.2.py +249 -0
  231. openff_toolkit-0.18.0/utilities/deprecated/convert_frosst/convert_frcmod_0.3.py +249 -0
  232. openff_toolkit-0.18.0/utilities/make_substructure_dict/_cif_to_substructure_dict.py +955 -0
  233. openff_toolkit-0.18.0/utilities/make_substructure_dict/_make_chemical_substructures.py +46 -0
  234. openff_toolkit-0.18.0/utilities/make_substructure_dict/_make_metadata_assignment_substructures.py +35 -0
  235. openff_toolkit-0.18.0/utilities/test_plugins/custom_plugins/handler_plugins.py +48 -0
  236. openff_toolkit-0.18.0/utilities/test_plugins/setup.py +19 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2016-2019 Open Force Field Initiative
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,5 @@
1
+ include LICENSE
2
+ include MANIFEST.in
3
+
4
+ graft openff
5
+ global-exclude *.py[cod] __pycache__ *.so
@@ -0,0 +1,109 @@
1
+ Metadata-Version: 2.4
2
+ Name: openff-toolkit
3
+ Version: 0.18.0
4
+ Summary: openff-toolkit
5
+ Author-email: Open Force Field Consortium <info@openforcefield.org>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/openforcefield/openff-toolkit
8
+ Keywords: force field,molecular mechanics,parameterization
9
+ Classifier: Development Status :: 3 - Alpha
10
+ Classifier: Programming Language :: Python :: 3 :: Only
11
+ Classifier: Programming Language :: Python :: 3.11
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Classifier: Programming Language :: Python :: 3.13
14
+ Classifier: Topic :: Utilities
15
+ Requires-Python: >=3.11
16
+ Description-Content-Type: text/markdown
17
+ License-File: LICENSE
18
+ Dynamic: license-file
19
+
20
+ | **Status** | [![GH Actions Status](https://github.com/openforcefield/openff-toolkit/workflows/CI/badge.svg)](https://github.com/openforcefield/openff-toolkit/actions?query=branch%3Amain+workflow%3ACI) [![Codecov coverage](https://img.shields.io/codecov/c/github/openforcefield/openff-toolkit.svg?logo=Codecov&logoColor=white)](https://codecov.io/gh/openforcefield/openff-toolkit) |
21
+ | :------ |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
22
+ | **Latest Release** | [![Last release tag](https://img.shields.io/github/release-pre/openforcefield/openff-toolkit.svg)](https://github.com/openforcefield/openff-toolkit/releases) [![Commits since release](https://img.shields.io/github/commits-since/openforcefield/openff-toolkit/0.17.1.svg)](https://github.com/openforcefield/openff-toolkit/releases/tag/0.17.1)[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17259324.svg)](https://doi.org/10.5281/zenodo.17259324)
23
+ | **Communication** | [![docs stable](https://img.shields.io/badge/docs-stable-5077AB.svg?logo=read%20the%20docs)](https://open-forcefield-toolkit.readthedocs.io/) [![user & dev discussions](https://img.shields.io/badge/user%20%26%20dev%20discussions-GitHub-red?logo=github)](https://github.com/openforcefield/discussions/discussions) |
24
+ | **Foundation** | [![license](https://img.shields.io/github/license/openforcefield/openff-toolkit.svg)](https://opensource.org/licenses/MIT) [![platforms](https://img.shields.io/badge/Platforms-Linux%2C%20MacOS-orange.svg)](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html) [![python](https://img.shields.io/badge/python-3.11%2C%203.12%2C%203.13-blue.svg)](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html) [![Funding](https://img.shields.io/badge/Funding-Open%20Force%20Field%20Consortium-brightgreen.svg)](http://openforcefield.org) |
25
+ | **Installation** | [![Releases](https://img.shields.io/badge/obtain-latest-green.svg)](https://github.com/openforcefield/openff-toolkit/releases) [![Conda](https://img.shields.io/conda/v/conda-forge/openff-toolkit.svg)](https://anaconda.org/conda-forge/openff-toolkit) [![Last updated](https://anaconda.org/conda-forge/openff-toolkit/badges/latest_release_relative_date.svg)](https://anaconda.org/conda-forge/openff-toolkit) [![Anaconda Cloud downloads](https://anaconda.org/conda-forge/openff-toolkit/badges/downloads.svg)](https://anaconda.org/conda-forge/openff-toolkit) |
26
+
27
+ # The Open Force Field toolkit
28
+
29
+ The Open Force Field Toolkit, built by the [Open Force Field Initiative](http://openforcefield.org), is a Python toolkit for the development and application of modern molecular mechanics force fields based on direct chemical perception and rigorous statistical parameterization methods.
30
+
31
+ The toolkit currently covers two main areas we have committed to stably maintain throughout their lifetimes:
32
+ * Tools for using [SMIRKS Native Open Force Field (SMIRNOFF)](https://openforcefield.github.io/standards/standards/smirnoff/) force fields
33
+ * Tools for [direct chemical environment perception](https://dx.doi.org/10.1021/acs.jctc.8b00640) and manipulation
34
+
35
+ **Note**: Prior to version 0.9.0, this toolkit and its associated repository were named `openforcefield` and used different import paths. For details on this change and migration instructions, see the [release notes](https://open-forcefield-toolkit.readthedocs.io/en/stable/releasehistory.html#namespace-migration) of version 0.9.0.
36
+
37
+ ## Documentation
38
+
39
+ [Documentation](https://open-forcefield-toolkit.readthedocs.io/en/stable/) for the Open Force Field Toolkit is hosted at [readthedocs](https://open-forcefield-toolkit.readthedocs.io/en/stable). Example notebooks are available in the `examples/` directory and also hosted on the [`Open Force Field`](https://docs.openforcefield.org/en/latest/examples.html) website.
40
+
41
+ ## How to cite
42
+
43
+ Please cite the OpenFF Toolkit using the [Zenodo record](https://zenodo.org/record/13886754) of the [latest release](https://zenodo.org/record/13886754) or the version that was used. The BibTeX reference of the latest release can be found [here](https://zenodo.org/records/13886754/export/bibtex).
44
+
45
+ ## Installation
46
+
47
+ The Open Force Field Toolkit (`openff-toolkit`) is a Python toolkit, and supports Python 3.9 through 3.11.
48
+
49
+ ### Installing via Mamba/Conda
50
+
51
+ Detailed installation instructions can be found [here](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html).
52
+
53
+ ## Force Fields
54
+
55
+ Two major force field development efforts have been undertaken by the Open Force Field Initiative, with results hosted in separate repositories.
56
+
57
+ * The [Open Force Fields repository](https://github.com/openforcefield/openff-forcefields/), which features the [Parsley](https://openforcefield.org/community/news/general/introducing-openforcefield-1.0/) and [Sage](https://openforcefield.org/community/news/general/sage2.0.0-release/) force field lines. These are the Open Force Field Initiative's efforts toward building _new_ force fields. The initial parameters are taken from smirnoff99Frosst, but software and data produced by the Initiative's efforts have been used to refit parameter values and add new SMIRKS-based parameters.
58
+ * The [smirnoff99Frosst repository](https://github.com/openforcefield/smirnoff99Frosst/), which is descended from AMBER's parm99 force field as well as Merck-Frosst's parm@frosst. This line of force fields does not aim to alter parameter values, but is instead a test of accurately converting an atom type-based force field to the SMIRNOFF format.
59
+
60
+ Force fields from both of these packages are available in their respective GitHub repositories and also as conda packages. Tables detailing the individual file names/versions within these force field lines are in the README of each repository. By default, installing the Open Force Field toolkit using `conda` or the single-file toolkit installers will also install these conda packages. A [plugin architecture](https://github.com/openforcefield/openff-toolkit/blob/main/FAQ.md#how-can-i-distribute-my-own-force-fields-in-smirnoff-format) is provided for other force field developers to produce python/conda packages that can be imported by the Open Force Field Toolkit as well.
61
+
62
+ # Toolkit features
63
+
64
+ ## The SMIRKS Native Open Force Field (SMIRNOFF) format
65
+
66
+ This repository provides tools for using the [SMIRKS Native Open Force Field (SMIRNOFF) specification](https://openforcefield.github.io/standards/standards/smirnoff/), which currently supports an XML representation for force field definition files.
67
+
68
+ By convention, files containing [XML representations](https://en.wikipedia.org/wiki/XML) of SMIRNOFF force fields carry `.offxml` extensions.
69
+
70
+ Example SMIRNOFF `.offxml` force field definitions can be found in [`openff/toolkit/data/test_forcefields/`](https://github.com/openforcefield/openff-toolkit/tree/main/openff/toolkit/data/test_forcefields). These force fields are for testing only, and we neither record versions of these files, nor do we guarantee their correctness or completeness.
71
+
72
+ ### Working with SMIRNOFF parameter sets
73
+
74
+ SMIRNOFF force fields can be parsed by the `ForceField` class, which offers methods including `create_openmm_system` for exporting to OpenMM and `create_interchange` for exporting to other formats (GROMACS, Amber, LAMMPS) via [Interchange](https://docs.openforcefield.org/projects/interchange).
75
+
76
+ ```python
77
+ # Load a molecule into the OpenFF Molecule object
78
+ from openff.toolkit import Molecule
79
+ from openff.toolkit.utils import get_data_file_path
80
+ sdf_file_path = get_data_file_path('molecules/ethanol.sdf')
81
+ molecule = Molecule.from_file(sdf_file_path)
82
+
83
+ # Create an OpenFF Topology object from the molecule
84
+ from openff.toolkit import Topology
85
+ topology = Topology.from_molecules(molecule)
86
+
87
+ # Load the latest OpenFF force field release: version 2.1.0, codename "Sage"
88
+ from openff.toolkit import ForceField
89
+ forcefield = ForceField('openff-2.1.0.offxml')
90
+
91
+ # Create an OpenMM system representing the molecule with SMIRNOFF-applied parameters
92
+ openmm_system = forcefield.create_openmm_system(topology)
93
+
94
+ # Create an Interchange object for representations in other formats
95
+ interchange = forcefield.create_interchange(topology)
96
+ ```
97
+
98
+ Detailed examples of using SMIRNOFF with the toolkit can be found [in the documentation](https://open-forcefield-toolkit.readthedocs.io/en/stable/examples.html).
99
+
100
+ # Frequently asked questions (FAQ)
101
+
102
+ See [`FAQ.md`](FAQ.md) for answers to a variety of common problems, such as:
103
+ * Why do I need to provide molecules corresponding to the components of my system, or a `Topology` with bond orders?
104
+ * Can I use an Amber, CHARMM, or GROMACS topology/coordinate file as a starting point for applying a SMIRNOFF force field?
105
+ * What if I am starting from a PDB file?
106
+
107
+ # Contributors
108
+
109
+ For a partial list of contributors, see the [GitHub Contributors page](https://github.com/openforcefield/openff-toolkit/graphs/contributors). Others whose work constitutes significant contributions but did not make it into the `git` history include Shuzhe Wang.
@@ -0,0 +1,90 @@
1
+ | **Status** | [![GH Actions Status](https://github.com/openforcefield/openff-toolkit/workflows/CI/badge.svg)](https://github.com/openforcefield/openff-toolkit/actions?query=branch%3Amain+workflow%3ACI) [![Codecov coverage](https://img.shields.io/codecov/c/github/openforcefield/openff-toolkit.svg?logo=Codecov&logoColor=white)](https://codecov.io/gh/openforcefield/openff-toolkit) |
2
+ | :------ |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
3
+ | **Latest Release** | [![Last release tag](https://img.shields.io/github/release-pre/openforcefield/openff-toolkit.svg)](https://github.com/openforcefield/openff-toolkit/releases) [![Commits since release](https://img.shields.io/github/commits-since/openforcefield/openff-toolkit/0.17.1.svg)](https://github.com/openforcefield/openff-toolkit/releases/tag/0.17.1)[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17259324.svg)](https://doi.org/10.5281/zenodo.17259324)
4
+ | **Communication** | [![docs stable](https://img.shields.io/badge/docs-stable-5077AB.svg?logo=read%20the%20docs)](https://open-forcefield-toolkit.readthedocs.io/) [![user & dev discussions](https://img.shields.io/badge/user%20%26%20dev%20discussions-GitHub-red?logo=github)](https://github.com/openforcefield/discussions/discussions) |
5
+ | **Foundation** | [![license](https://img.shields.io/github/license/openforcefield/openff-toolkit.svg)](https://opensource.org/licenses/MIT) [![platforms](https://img.shields.io/badge/Platforms-Linux%2C%20MacOS-orange.svg)](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html) [![python](https://img.shields.io/badge/python-3.11%2C%203.12%2C%203.13-blue.svg)](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html) [![Funding](https://img.shields.io/badge/Funding-Open%20Force%20Field%20Consortium-brightgreen.svg)](http://openforcefield.org) |
6
+ | **Installation** | [![Releases](https://img.shields.io/badge/obtain-latest-green.svg)](https://github.com/openforcefield/openff-toolkit/releases) [![Conda](https://img.shields.io/conda/v/conda-forge/openff-toolkit.svg)](https://anaconda.org/conda-forge/openff-toolkit) [![Last updated](https://anaconda.org/conda-forge/openff-toolkit/badges/latest_release_relative_date.svg)](https://anaconda.org/conda-forge/openff-toolkit) [![Anaconda Cloud downloads](https://anaconda.org/conda-forge/openff-toolkit/badges/downloads.svg)](https://anaconda.org/conda-forge/openff-toolkit) |
7
+
8
+ # The Open Force Field toolkit
9
+
10
+ The Open Force Field Toolkit, built by the [Open Force Field Initiative](http://openforcefield.org), is a Python toolkit for the development and application of modern molecular mechanics force fields based on direct chemical perception and rigorous statistical parameterization methods.
11
+
12
+ The toolkit currently covers two main areas we have committed to stably maintain throughout their lifetimes:
13
+ * Tools for using [SMIRKS Native Open Force Field (SMIRNOFF)](https://openforcefield.github.io/standards/standards/smirnoff/) force fields
14
+ * Tools for [direct chemical environment perception](https://dx.doi.org/10.1021/acs.jctc.8b00640) and manipulation
15
+
16
+ **Note**: Prior to version 0.9.0, this toolkit and its associated repository were named `openforcefield` and used different import paths. For details on this change and migration instructions, see the [release notes](https://open-forcefield-toolkit.readthedocs.io/en/stable/releasehistory.html#namespace-migration) of version 0.9.0.
17
+
18
+ ## Documentation
19
+
20
+ [Documentation](https://open-forcefield-toolkit.readthedocs.io/en/stable/) for the Open Force Field Toolkit is hosted at [readthedocs](https://open-forcefield-toolkit.readthedocs.io/en/stable). Example notebooks are available in the `examples/` directory and also hosted on the [`Open Force Field`](https://docs.openforcefield.org/en/latest/examples.html) website.
21
+
22
+ ## How to cite
23
+
24
+ Please cite the OpenFF Toolkit using the [Zenodo record](https://zenodo.org/record/13886754) of the [latest release](https://zenodo.org/record/13886754) or the version that was used. The BibTeX reference of the latest release can be found [here](https://zenodo.org/records/13886754/export/bibtex).
25
+
26
+ ## Installation
27
+
28
+ The Open Force Field Toolkit (`openff-toolkit`) is a Python toolkit, and supports Python 3.9 through 3.11.
29
+
30
+ ### Installing via Mamba/Conda
31
+
32
+ Detailed installation instructions can be found [here](https://open-forcefield-toolkit.readthedocs.io/en/stable/installation.html).
33
+
34
+ ## Force Fields
35
+
36
+ Two major force field development efforts have been undertaken by the Open Force Field Initiative, with results hosted in separate repositories.
37
+
38
+ * The [Open Force Fields repository](https://github.com/openforcefield/openff-forcefields/), which features the [Parsley](https://openforcefield.org/community/news/general/introducing-openforcefield-1.0/) and [Sage](https://openforcefield.org/community/news/general/sage2.0.0-release/) force field lines. These are the Open Force Field Initiative's efforts toward building _new_ force fields. The initial parameters are taken from smirnoff99Frosst, but software and data produced by the Initiative's efforts have been used to refit parameter values and add new SMIRKS-based parameters.
39
+ * The [smirnoff99Frosst repository](https://github.com/openforcefield/smirnoff99Frosst/), which is descended from AMBER's parm99 force field as well as Merck-Frosst's parm@frosst. This line of force fields does not aim to alter parameter values, but is instead a test of accurately converting an atom type-based force field to the SMIRNOFF format.
40
+
41
+ Force fields from both of these packages are available in their respective GitHub repositories and also as conda packages. Tables detailing the individual file names/versions within these force field lines are in the README of each repository. By default, installing the Open Force Field toolkit using `conda` or the single-file toolkit installers will also install these conda packages. A [plugin architecture](https://github.com/openforcefield/openff-toolkit/blob/main/FAQ.md#how-can-i-distribute-my-own-force-fields-in-smirnoff-format) is provided for other force field developers to produce python/conda packages that can be imported by the Open Force Field Toolkit as well.
42
+
43
+ # Toolkit features
44
+
45
+ ## The SMIRKS Native Open Force Field (SMIRNOFF) format
46
+
47
+ This repository provides tools for using the [SMIRKS Native Open Force Field (SMIRNOFF) specification](https://openforcefield.github.io/standards/standards/smirnoff/), which currently supports an XML representation for force field definition files.
48
+
49
+ By convention, files containing [XML representations](https://en.wikipedia.org/wiki/XML) of SMIRNOFF force fields carry `.offxml` extensions.
50
+
51
+ Example SMIRNOFF `.offxml` force field definitions can be found in [`openff/toolkit/data/test_forcefields/`](https://github.com/openforcefield/openff-toolkit/tree/main/openff/toolkit/data/test_forcefields). These force fields are for testing only, and we neither record versions of these files, nor do we guarantee their correctness or completeness.
52
+
53
+ ### Working with SMIRNOFF parameter sets
54
+
55
+ SMIRNOFF force fields can be parsed by the `ForceField` class, which offers methods including `create_openmm_system` for exporting to OpenMM and `create_interchange` for exporting to other formats (GROMACS, Amber, LAMMPS) via [Interchange](https://docs.openforcefield.org/projects/interchange).
56
+
57
+ ```python
58
+ # Load a molecule into the OpenFF Molecule object
59
+ from openff.toolkit import Molecule
60
+ from openff.toolkit.utils import get_data_file_path
61
+ sdf_file_path = get_data_file_path('molecules/ethanol.sdf')
62
+ molecule = Molecule.from_file(sdf_file_path)
63
+
64
+ # Create an OpenFF Topology object from the molecule
65
+ from openff.toolkit import Topology
66
+ topology = Topology.from_molecules(molecule)
67
+
68
+ # Load the latest OpenFF force field release: version 2.1.0, codename "Sage"
69
+ from openff.toolkit import ForceField
70
+ forcefield = ForceField('openff-2.1.0.offxml')
71
+
72
+ # Create an OpenMM system representing the molecule with SMIRNOFF-applied parameters
73
+ openmm_system = forcefield.create_openmm_system(topology)
74
+
75
+ # Create an Interchange object for representations in other formats
76
+ interchange = forcefield.create_interchange(topology)
77
+ ```
78
+
79
+ Detailed examples of using SMIRNOFF with the toolkit can be found [in the documentation](https://open-forcefield-toolkit.readthedocs.io/en/stable/examples.html).
80
+
81
+ # Frequently asked questions (FAQ)
82
+
83
+ See [`FAQ.md`](FAQ.md) for answers to a variety of common problems, such as:
84
+ * Why do I need to provide molecules corresponding to the components of my system, or a `Topology` with bond orders?
85
+ * Can I use an Amber, CHARMM, or GROMACS topology/coordinate file as a starting point for applying a SMIRNOFF force field?
86
+ * What if I am starting from a PDB file?
87
+
88
+ # Contributors
89
+
90
+ For a partial list of contributors, see the [GitHub Contributors page](https://github.com/openforcefield/openff-toolkit/graphs/contributors). Others whose work constitutes significant contributions but did not make it into the `git` history include Shuzhe Wang.
@@ -0,0 +1,22 @@
1
+ import json
2
+ import sys
3
+
4
+ release_tag = sys.argv[1]
5
+ python_version = sys.argv[2]
6
+ ci_os = sys.argv[3]
7
+
8
+ platform_mapping = {
9
+ "ubuntu-latest": "linux-64",
10
+ "macOS-latest": "osx-64",
11
+ }
12
+
13
+ data = {
14
+ "name": "openff-toolkit",
15
+ "channel": "conda-forge",
16
+ "python": [python_version],
17
+ "platform": [platform_mapping[ci_os]],
18
+ "release": release_tag,
19
+ }
20
+
21
+ with open("new_cookiecutter.json", "w") as fp:
22
+ json.dump(data, fp)
@@ -0,0 +1,296 @@
1
+ #!/usr/bin/env python3
2
+ #
3
+ # openff-toolkit documentation build configuration file, created by
4
+ # sphinx-quickstart on Sun Dec 3 23:12:54 2017.
5
+ #
6
+ # This file is execfile()d with the current directory set to its
7
+ # containing dir.
8
+ #
9
+ # Note that not all possible configuration values are present in this
10
+ # autogenerated file.
11
+ #
12
+ # All configuration values have a default; values that are commented out
13
+ # serve to show the default.
14
+
15
+ # If extensions (or modules to document with autodoc) are in another directory,
16
+ # add these directories to sys.path here. If the directory is relative to the
17
+ # documentation root, use os.path.abspath to make it absolute, like shown here.
18
+ #
19
+ import os
20
+ import sys
21
+ from importlib.util import find_spec as find_import_spec
22
+
23
+ import openff.toolkit
24
+
25
+ sys.path.insert(0, os.path.abspath("."))
26
+
27
+
28
+ # -- General configuration ------------------------------------------------
29
+
30
+ # If your documentation needs a minimal Sphinx version, state it here.
31
+ #
32
+ # needs_sphinx = "4.4.0"
33
+
34
+ # Add any Sphinx extension module names here, as strings. They can be
35
+ # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
36
+ # ones.
37
+ extensions = [
38
+ "sphinx.ext.autodoc",
39
+ "sphinx.ext.napoleon",
40
+ "sphinx.ext.autosummary",
41
+ "sphinx.ext.doctest",
42
+ "sphinx.ext.todo",
43
+ "sphinx.ext.mathjax",
44
+ "sphinx.ext.viewcode",
45
+ "sphinx.ext.intersphinx",
46
+ "openff_sphinx_theme",
47
+ "myst_nb",
48
+ # "myst_parser",
49
+ ]
50
+
51
+ # Autodoc settings
52
+ autosummary_generate = True
53
+
54
+ autodoc_default_options = {
55
+ "members": True,
56
+ "inherited-members": True,
57
+ "member-order": "bysource",
58
+ }
59
+ autodoc_preserve_defaults = True
60
+ autodoc_typehints_format = "short"
61
+ # Workaround for autodoc_typehints_format not working for attributes
62
+ # see https://github.com/sphinx-doc/sphinx/issues/10290#issuecomment-1079740009
63
+ python_use_unqualified_type_names = True
64
+
65
+ napoleon_numpy_docstring = True
66
+ napoleon_google_docstring = False
67
+ napoleon_attr_annotations = True
68
+ napoleon_custom_sections = [("attributes", "params_style")]
69
+ napoleon_use_rtype = False
70
+ napoleon_use_param = True
71
+
72
+ _python_doc_base = "https://docs.python.org/3.7"
73
+ intersphinx_mapping = {
74
+ "python": ("https://docs.python.org/3.7", None),
75
+ "numpy": ("https://numpy.org/doc/stable", None),
76
+ "scipy": ("https://docs.scipy.org/doc/scipy", None),
77
+ "scikit.learn": ("https://scikit-learn.org/stable", None),
78
+ "openmm": ("http://docs.openmm.org/latest/api-python/", None),
79
+ "rdkit": ("https://www.rdkit.org/docs", None),
80
+ "openeye": ("https://docs.eyesopen.com/toolkits/python/", None),
81
+ "mdtraj": ("https://www.mdtraj.org/1.9.5/", None),
82
+ "openff.interchange": (
83
+ "https://docs.openforcefield.org/projects/interchange/en/stable/",
84
+ None,
85
+ ),
86
+ "openff.fragmenter": (
87
+ "https://docs.openforcefield.org/projects/fragmenter/en/stable/",
88
+ None,
89
+ ),
90
+ "openff.units": (
91
+ "https://docs.openforcefield.org/projects/units/en/stable/",
92
+ None,
93
+ ),
94
+ "openff.nagl": (
95
+ "https://docs.openforcefield.org/projects/nagl/en/stable/",
96
+ None,
97
+ ),
98
+ "openff.docs": (
99
+ "https://docs.openforcefield.org/en/latest/",
100
+ None,
101
+ ),
102
+ }
103
+ myst_url_schemes = [
104
+ "http",
105
+ "https",
106
+ ]
107
+
108
+ # Add any paths that contain templates here, relative to this directory.
109
+ templates_path = ["_templates"]
110
+
111
+ # Extensions for the myst parser
112
+ myst_enable_extensions = [
113
+ "dollarmath",
114
+ "colon_fence",
115
+ "smartquotes",
116
+ "replacements",
117
+ "deflist",
118
+ ]
119
+ myst_heading_anchors = 4
120
+
121
+ # Myst NB settings
122
+ # Never execute notebooks - this should be done by CI
123
+ # Output is stored in the notebook itself
124
+ # Remember `Widgets -> Save Notebook Widget State` in the notebook.
125
+ nb_execution_mode = "off"
126
+
127
+ # sphinx-notfound-page
128
+ # https://github.com/readthedocs/sphinx-notfound-page
129
+ # Renders a 404 page with absolute links
130
+ if find_import_spec("notfound"):
131
+ extensions.append("notfound.extension")
132
+
133
+ notfound_urls_prefix = "/projects/toolkit/en/stable/"
134
+ notfound_context = {
135
+ "title": "404: File Not Found",
136
+ "body": f"""
137
+ <h1>404: File Not Found</h1>
138
+ <p>
139
+ Sorry, we couldn't find that page. This often happens as a result of
140
+ following an outdated link. Please check the
141
+ <a href="{notfound_urls_prefix}">latest stable version</a>
142
+ of the docs, unless you're sure you want an earlier version, and
143
+ try using the search box or the navigation menu on the left.
144
+ </p>
145
+ <p>
146
+ </p>
147
+ """,
148
+ }
149
+
150
+ # The suffix(es) of source filenames.
151
+ # You can specify multiple suffix as a list of string:
152
+ source_suffix = [".rst", ".md", ".ipynb"]
153
+
154
+ # The master toctree document.
155
+ master_doc = "index"
156
+
157
+ # General information about the project.
158
+ project = "OpenFF Toolkit"
159
+ copyright = "2016-2021 Open Force Field Initiative"
160
+ author = "Open Force Field Initiative"
161
+
162
+ # The version info for the project you're documenting, acts as replacement for
163
+ # |version| and |release|, also used in various other places throughout the
164
+ # built documents.
165
+ #
166
+ # The short X.Y version.
167
+ version = openff.toolkit.__version__
168
+ # The full version, including alpha/beta/rc tags.
169
+ release = openff.toolkit.__version__
170
+
171
+ # The language for content autogenerated by Sphinx. Refer to documentation
172
+ # for a list of supported languages.
173
+ #
174
+ # This is also used if you do content translation via gettext catalogs.
175
+ # Usually you set "language" from the command line for these cases.
176
+ language = "en"
177
+
178
+ # List of patterns, relative to source directory, that match files and
179
+ # directories to ignore when looking for source files.
180
+ # This patterns also effect to html_static_path and html_extra_path
181
+ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
182
+
183
+ # If true, `todo` and `todoList` produce output, else they produce nothing.
184
+ todo_include_todos = False
185
+
186
+
187
+ # -- Options for HTML output ----------------------------------------------
188
+
189
+ # The theme to use for HTML and HTML Help pages. See the documentation for
190
+ # a list of builtin themes.
191
+ html_theme = "openff_sphinx_theme"
192
+
193
+ # (Optional) Logo and favicon
194
+ html_logo = "_static/images/logos/openff_toolkit_v1_white.png"
195
+ html_favicon = "_static/images/favicon.svg"
196
+
197
+ # Theme options are theme-specific and customize the look and feel of a
198
+ # theme further.
199
+ html_theme_options = {
200
+ # Repository integration
201
+ # Set the repo url for the link to appear
202
+ "repo_url": "https://github.com/openforcefield/openff-toolkit",
203
+ # The name of the repo. If must be set if repo_url is set
204
+ "repo_name": "openff-toolkit",
205
+ # Must be one of github, gitlab or bitbucket
206
+ "repo_type": "github",
207
+ # Colour for sidebar captions and other accents. One of
208
+ # openff-toolkit-blue, openff-dataset-yellow, openff-evaluator-orange,
209
+ # red, pink, purple, deep-purple, indigo, blue, light-blue, cyan,
210
+ # teal, green, light-green, lime, yellow, amber, orange, deep-orange
211
+ "color_accent": "openff-toolkit-blue",
212
+ # Content Minification for deployment, prettification for debugging
213
+ "html_minify": False,
214
+ "html_prettify": False,
215
+ "css_minify": True,
216
+ "master_doc": False,
217
+ }
218
+
219
+ # Add any paths that contain custom static files (such as style sheets) here,
220
+ # relative to this directory. They are copied after the builtin static files,
221
+ # so a file named "default.css" will overwrite the builtin "default.css".
222
+ html_static_path = ["_static"]
223
+
224
+ # Custom sidebar templates, must be a dictionary that maps document names
225
+ # to template names.
226
+ html_sidebars = {
227
+ "**": ["globaltoc.html", "searchbox.html", "localtoc.html"],
228
+ }
229
+
230
+
231
+ # -- Options for HTMLHelp output ------------------------------------------
232
+
233
+ # Output file base name for HTML help builder.
234
+ htmlhelp_basename = "openforcefielddoc"
235
+
236
+
237
+ # -- Options for LaTeX output ---------------------------------------------
238
+
239
+ latex_elements = {
240
+ # The paper size ('letterpaper' or 'a4paper').
241
+ #
242
+ "papersize": "letterpaper",
243
+ # The font size ('10pt', '11pt' or '12pt').
244
+ #
245
+ "pointsize": "10pt",
246
+ # Additional stuff for the LaTeX preamble.
247
+ "preamble": r"""
248
+ \usepackage{charter}
249
+ \usepackage[defaultsans]{lato}
250
+ \usepackage{inconsolata}
251
+ """,
252
+ # Latex figure (float) alignment
253
+ #
254
+ # 'figure_align': 'htbp',
255
+ }
256
+
257
+ # Grouping the document tree into LaTeX files. List of tuples
258
+ # (source start file, target name, title,
259
+ # author, documentclass [howto, manual, or own class]).
260
+ latex_documents = [
261
+ (
262
+ master_doc,
263
+ "openforcefield.tex",
264
+ "OpenFF Toolkit Documentation",
265
+ "Open Force Field Consortium",
266
+ "manual",
267
+ ),
268
+ ]
269
+
270
+
271
+ # -- Options for manual page output ---------------------------------------
272
+
273
+ # One entry per manual page. List of tuples
274
+ # (source start file, name, description, authors, manual section).
275
+ man_pages = [(master_doc, "openff-toolkit", "OpenFF Toolkit Documentation", [author], 1)]
276
+
277
+
278
+ # -- Options for Texinfo output -------------------------------------------
279
+
280
+ # Grouping the document tree into Texinfo files. List of tuples
281
+ # (source start file, target name, title, author,
282
+ # dir menu entry, description, category)
283
+ texinfo_documents = [
284
+ (
285
+ master_doc,
286
+ "openff-toolkit",
287
+ "OpenFF Toolkit Documentation",
288
+ author,
289
+ "openff-toolkit",
290
+ (
291
+ "A modern, extensible library for molecular mechanics force field science from the Open Force "
292
+ "Field Consortium.",
293
+ ),
294
+ "Miscellaneous",
295
+ ),
296
+ ]
@@ -0,0 +1,23 @@
1
+ """
2
+ This is a configuration file for PyTest.
3
+
4
+ This file is designed to be used with nbval: https://nbval.readthedocs.io/
5
+
6
+ The nbval-sanitize.cfg file is also for use with nbval.
7
+ """
8
+
9
+
10
+ def pytest_collectstart(collector):
11
+ """
12
+ Ignore certain outputs when validating documentation notebooks
13
+
14
+ See https://nbval.readthedocs.io/en/latest/#Skipping-certain-output-types
15
+ """
16
+ if collector.fspath and collector.fspath.ext == ".ipynb":
17
+ collector.skip_compare += (
18
+ # SVGs are often produced by Molecule.visualize()
19
+ # The precise SVG output varies with environment and RDkit version,
20
+ # and failures of visualize() produce exceptions or text output, so
21
+ # we don't lose much by ignoring the actual content.
22
+ "image/svg+xml",
23
+ )