nltk 3.2__zip → 3.3__zip

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 (406) hide show
  1. {nltk-3.2 → nltk-3.3}/INSTALL.txt +6 -6
  2. {nltk-3.2 → nltk-3.3}/LICENSE.txt +13 -13
  3. {nltk-3.2 → nltk-3.3}/MANIFEST.in +6 -6
  4. {nltk-3.2/nltk.egg-info → nltk-3.3}/PKG-INFO +13 -5
  5. nltk-3.2/README.txt → nltk-3.3/README.md +49 -48
  6. nltk-3.3/nltk/VERSION +1 -0
  7. {nltk-3.2 → nltk-3.3}/nltk/__init__.py +185 -185
  8. {nltk-3.2 → nltk-3.3}/nltk/app/__init__.py +52 -53
  9. {nltk-3.2 → nltk-3.3}/nltk/app/chartparser_app.py +2276 -2276
  10. {nltk-3.2 → nltk-3.3}/nltk/app/chunkparser_app.py +1262 -1264
  11. {nltk-3.2 → nltk-3.3}/nltk/app/collocations_app.py +347 -350
  12. {nltk-3.2 → nltk-3.3}/nltk/app/concordance_app.py +568 -570
  13. {nltk-3.2 → nltk-3.3}/nltk/app/nemo_app.py +156 -155
  14. {nltk-3.2 → nltk-3.3}/nltk/app/rdparser_app.py +892 -894
  15. {nltk-3.2 → nltk-3.3}/nltk/app/srparser_app.py +809 -809
  16. {nltk-3.2 → nltk-3.3}/nltk/app/wordfreq_app.py +32 -32
  17. {nltk-3.2 → nltk-3.3}/nltk/app/wordnet_app.py +968 -968
  18. {nltk-3.2 → nltk-3.3}/nltk/book.py +91 -90
  19. {nltk-3.2 → nltk-3.3}/nltk/ccg/__init__.py +22 -22
  20. {nltk-3.2 → nltk-3.3}/nltk/ccg/api.py +359 -335
  21. {nltk-3.2 → nltk-3.3}/nltk/ccg/chart.py +394 -361
  22. {nltk-3.2 → nltk-3.3}/nltk/ccg/combinator.py +343 -312
  23. {nltk-3.2 → nltk-3.3}/nltk/ccg/lexicon.py +328 -290
  24. nltk-3.3/nltk/ccg/logic.py +46 -0
  25. {nltk-3.2 → nltk-3.3}/nltk/chat/__init__.py +49 -49
  26. {nltk-3.2 → nltk-3.3}/nltk/chat/eliza.py +244 -244
  27. {nltk-3.2 → nltk-3.3}/nltk/chat/iesha.py +140 -140
  28. {nltk-3.2 → nltk-3.3}/nltk/chat/rude.py +92 -92
  29. {nltk-3.2 → nltk-3.3}/nltk/chat/suntsu.py +117 -117
  30. {nltk-3.2 → nltk-3.3}/nltk/chat/util.py +122 -120
  31. {nltk-3.2 → nltk-3.3}/nltk/chat/zen.py +282 -282
  32. {nltk-3.2 → nltk-3.3}/nltk/chunk/__init__.py +190 -190
  33. {nltk-3.2 → nltk-3.3}/nltk/chunk/api.py +51 -51
  34. {nltk-3.2 → nltk-3.3}/nltk/chunk/named_entity.py +331 -331
  35. {nltk-3.2 → nltk-3.3}/nltk/chunk/regexp.py +1390 -1384
  36. {nltk-3.2 → nltk-3.3}/nltk/chunk/util.py +600 -600
  37. {nltk-3.2 → nltk-3.3}/nltk/classify/__init__.py +98 -98
  38. {nltk-3.2 → nltk-3.3}/nltk/classify/api.py +193 -193
  39. {nltk-3.2 → nltk-3.3}/nltk/classify/decisiontree.py +295 -295
  40. {nltk-3.2 → nltk-3.3}/nltk/classify/maxent.py +1510 -1492
  41. {nltk-3.2 → nltk-3.3}/nltk/classify/megam.py +179 -178
  42. {nltk-3.2 → nltk-3.3}/nltk/classify/naivebayes.py +245 -242
  43. {nltk-3.2 → nltk-3.3}/nltk/classify/positivenaivebayes.py +170 -170
  44. {nltk-3.2 → nltk-3.3}/nltk/classify/rte_classify.py +160 -191
  45. {nltk-3.2 → nltk-3.3}/nltk/classify/scikitlearn.py +153 -151
  46. {nltk-3.2 → nltk-3.3}/nltk/classify/senna.py +183 -181
  47. {nltk-3.2 → nltk-3.3}/nltk/classify/svm.py +15 -15
  48. {nltk-3.2 → nltk-3.3}/nltk/classify/tadm.py +113 -112
  49. {nltk-3.2 → nltk-3.3}/nltk/classify/textcat.py +193 -193
  50. {nltk-3.2 → nltk-3.3}/nltk/classify/util.py +324 -312
  51. {nltk-3.2 → nltk-3.3}/nltk/classify/weka.py +346 -345
  52. {nltk-3.2 → nltk-3.3}/nltk/cluster/__init__.py +86 -86
  53. {nltk-3.2 → nltk-3.3}/nltk/cluster/api.py +74 -70
  54. {nltk-3.2 → nltk-3.3}/nltk/cluster/em.py +247 -247
  55. {nltk-3.2 → nltk-3.3}/nltk/cluster/gaac.py +168 -168
  56. {nltk-3.2 → nltk-3.3}/nltk/cluster/kmeans.py +221 -221
  57. {nltk-3.2 → nltk-3.3}/nltk/cluster/util.py +304 -289
  58. nltk-3.3/nltk/collections.py +640 -0
  59. {nltk-3.2 → nltk-3.3}/nltk/collocations.py +388 -388
  60. nltk-3.3/nltk/compat.py +365 -0
  61. {nltk-3.2 → nltk-3.3}/nltk/corpus/__init__.py +341 -320
  62. {nltk-3.2 → nltk-3.3}/nltk/corpus/europarl_raw.py +44 -44
  63. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/__init__.py +147 -145
  64. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/aligned.py +115 -114
  65. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/api.py +448 -446
  66. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/bnc.py +252 -252
  67. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/bracket_parse.py +227 -227
  68. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/categorized_sents.py +179 -178
  69. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/chasen.py +140 -139
  70. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/childes.py +522 -494
  71. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/chunked.py +212 -212
  72. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/cmudict.py +97 -95
  73. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/comparative_sents.py +280 -278
  74. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/conll.py +528 -521
  75. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/crubadan.py +116 -116
  76. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/dependency.py +101 -101
  77. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/framenet.py +3059 -2093
  78. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/ieer.py +112 -111
  79. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/indian.py +85 -86
  80. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/ipipan.py +332 -331
  81. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/knbc.py +187 -187
  82. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/lin.py +156 -156
  83. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/mte.py +311 -310
  84. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/nkjp.py +429 -428
  85. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/nombank.py +421 -421
  86. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/nps_chat.py +73 -73
  87. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/opinion_lexicon.py +115 -115
  88. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/panlex_lite.py +165 -165
  89. nltk-3.3/nltk/corpus/reader/pl196x.py +292 -0
  90. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/plaintext.py +232 -233
  91. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/ppattach.py +96 -95
  92. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/propbank.py +479 -481
  93. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/pros_cons.py +128 -126
  94. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/reviews.py +330 -328
  95. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/rte.py +144 -146
  96. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/semcor.py +256 -256
  97. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/senseval.py +203 -201
  98. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/sentiwordnet.py +137 -137
  99. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/sinica_treebank.py +75 -75
  100. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/string_category.py +60 -59
  101. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/switchboard.py +119 -119
  102. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/tagged.py +295 -294
  103. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/timit.py +452 -450
  104. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/toolbox.py +68 -68
  105. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/twitter.py +155 -157
  106. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/udhr.py +80 -80
  107. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/util.py +804 -800
  108. nltk-3.3/nltk/corpus/reader/verbnet.py +595 -0
  109. nltk-3.3/nltk/corpus/reader/wordlist.py +134 -0
  110. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/wordnet.py +2108 -2036
  111. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/xmldocs.py +392 -387
  112. {nltk-3.2 → nltk-3.3}/nltk/corpus/reader/ycoe.py +243 -242
  113. {nltk-3.2 → nltk-3.3}/nltk/corpus/util.py +144 -127
  114. {nltk-3.2 → nltk-3.3}/nltk/data.py +1487 -1451
  115. {nltk-3.2 → nltk-3.3}/nltk/decorators.py +219 -215
  116. {nltk-3.2 → nltk-3.3}/nltk/downloader.py +2278 -2274
  117. {nltk-3.2 → nltk-3.3}/nltk/draw/__init__.py +27 -27
  118. {nltk-3.2 → nltk-3.3}/nltk/draw/cfg.py +774 -777
  119. {nltk-3.2 → nltk-3.3}/nltk/draw/dispersion.py +58 -58
  120. {nltk-3.2 → nltk-3.3}/nltk/draw/table.py +1098 -1098
  121. {nltk-3.2 → nltk-3.3}/nltk/draw/tree.py +963 -966
  122. {nltk-3.2 → nltk-3.3}/nltk/draw/util.py +2356 -2356
  123. {nltk-3.2 → nltk-3.3}/nltk/featstruct.py +2617 -2500
  124. {nltk-3.2 → nltk-3.3}/nltk/grammar.py +1559 -1516
  125. {nltk-3.2 → nltk-3.3}/nltk/help.py +56 -56
  126. {nltk-3.2 → nltk-3.3}/nltk/inference/__init__.py +20 -20
  127. {nltk-3.2 → nltk-3.3}/nltk/inference/api.py +597 -589
  128. {nltk-3.2 → nltk-3.3}/nltk/inference/discourse.py +612 -608
  129. {nltk-3.2 → nltk-3.3}/nltk/inference/mace.py +311 -311
  130. {nltk-3.2 → nltk-3.3}/nltk/inference/nonmonotonic.py +509 -509
  131. {nltk-3.2 → nltk-3.3}/nltk/inference/prover9.py +431 -431
  132. {nltk-3.2 → nltk-3.3}/nltk/inference/resolution.py +687 -687
  133. {nltk-3.2 → nltk-3.3}/nltk/inference/tableau.py +607 -607
  134. {nltk-3.2 → nltk-3.3}/nltk/internals.py +982 -982
  135. {nltk-3.2 → nltk-3.3}/nltk/jsontags.py +63 -63
  136. {nltk-3.2 → nltk-3.3}/nltk/lazyimport.py +142 -142
  137. {nltk-3.2 → nltk-3.3}/nltk/metrics/__init__.py +30 -29
  138. {nltk-3.2 → nltk-3.3}/nltk/metrics/agreement.py +421 -401
  139. nltk-3.3/nltk/metrics/aline.py +607 -0
  140. {nltk-3.2 → nltk-3.3}/nltk/metrics/association.py +414 -410
  141. {nltk-3.2 → nltk-3.3}/nltk/metrics/confusionmatrix.py +206 -206
  142. {nltk-3.2 → nltk-3.3}/nltk/metrics/distance.py +207 -202
  143. {nltk-3.2 → nltk-3.3}/nltk/metrics/paice.py +381 -381
  144. {nltk-3.2 → nltk-3.3}/nltk/metrics/scores.py +228 -228
  145. {nltk-3.2 → nltk-3.3}/nltk/metrics/segmentation.py +231 -232
  146. {nltk-3.2 → nltk-3.3}/nltk/metrics/spearman.py +69 -69
  147. {nltk-3.2 → nltk-3.3}/nltk/misc/__init__.py +11 -11
  148. {nltk-3.2 → nltk-3.3}/nltk/misc/babelfish.py +10 -10
  149. {nltk-3.2 → nltk-3.3}/nltk/misc/chomsky.py +135 -133
  150. {nltk-3.2 → nltk-3.3}/nltk/misc/minimalset.py +83 -83
  151. {nltk-3.2 → nltk-3.3}/nltk/misc/sort.py +157 -157
  152. {nltk-3.2 → nltk-3.3}/nltk/misc/wordfinder.py +129 -129
  153. {nltk-3.2 → nltk-3.3}/nltk/parse/__init__.py +81 -80
  154. {nltk-3.2 → nltk-3.3}/nltk/parse/api.py +66 -66
  155. {nltk-3.2 → nltk-3.3}/nltk/parse/bllip.py +282 -282
  156. {nltk-3.2 → nltk-3.3}/nltk/parse/chart.py +1682 -1681
  157. nltk-3.3/nltk/parse/corenlp.py +780 -0
  158. {nltk-3.2 → nltk-3.3}/nltk/parse/dependencygraph.py +760 -758
  159. {nltk-3.2 → nltk-3.3}/nltk/parse/earleychart.py +452 -451
  160. {nltk-3.2 → nltk-3.3}/nltk/parse/evaluate.py +129 -129
  161. {nltk-3.2 → nltk-3.3}/nltk/parse/featurechart.py +580 -578
  162. {nltk-3.2 → nltk-3.3}/nltk/parse/generate.py +87 -76
  163. {nltk-3.2 → nltk-3.3}/nltk/parse/malt.py +356 -356
  164. {nltk-3.2 → nltk-3.3}/nltk/parse/nonprojectivedependencyparser.py +783 -783
  165. {nltk-3.2 → nltk-3.3}/nltk/parse/pchart.py +522 -522
  166. {nltk-3.2 → nltk-3.3}/nltk/parse/projectivedependencyparser.py +579 -578
  167. {nltk-3.2 → nltk-3.3}/nltk/parse/recursivedescent.py +655 -656
  168. {nltk-3.2 → nltk-3.3}/nltk/parse/shiftreduce.py +458 -459
  169. {nltk-3.2 → nltk-3.3}/nltk/parse/stanford.py +431 -406
  170. {nltk-3.2 → nltk-3.3}/nltk/parse/transitionparser.py +774 -772
  171. {nltk-3.2 → nltk-3.3}/nltk/parse/util.py +231 -231
  172. {nltk-3.2 → nltk-3.3}/nltk/parse/viterbi.py +401 -401
  173. {nltk-3.2 → nltk-3.3}/nltk/probability.py +2410 -2355
  174. {nltk-3.2 → nltk-3.3}/nltk/sem/__init__.py +61 -61
  175. {nltk-3.2 → nltk-3.3}/nltk/sem/boxer.py +1261 -1261
  176. {nltk-3.2 → nltk-3.3}/nltk/sem/chat80.py +782 -782
  177. {nltk-3.2 → nltk-3.3}/nltk/sem/cooper_storage.py +118 -118
  178. {nltk-3.2 → nltk-3.3}/nltk/sem/drt.py +1258 -1257
  179. {nltk-3.2 → nltk-3.3}/nltk/sem/drt_glue_demo.py +485 -489
  180. {nltk-3.2 → nltk-3.3}/nltk/sem/evaluate.py +790 -784
  181. {nltk-3.2 → nltk-3.3}/nltk/sem/glue.py +696 -694
  182. {nltk-3.2 → nltk-3.3}/nltk/sem/hole.py +386 -384
  183. {nltk-3.2 → nltk-3.3}/nltk/sem/lfg.py +210 -208
  184. {nltk-3.2 → nltk-3.3}/nltk/sem/linearlogic.py +451 -449
  185. {nltk-3.2 → nltk-3.3}/nltk/sem/logic.py +1910 -1910
  186. {nltk-3.2 → nltk-3.3}/nltk/sem/relextract.py +476 -483
  187. {nltk-3.2 → nltk-3.3}/nltk/sem/skolemize.py +101 -101
  188. {nltk-3.2 → nltk-3.3}/nltk/sem/util.py +249 -249
  189. {nltk-3.2 → nltk-3.3}/nltk/sentiment/__init__.py +14 -14
  190. {nltk-3.2 → nltk-3.3}/nltk/sentiment/sentiment_analyzer.py +229 -229
  191. {nltk-3.2 → nltk-3.3}/nltk/sentiment/util.py +762 -752
  192. {nltk-3.2 → nltk-3.3}/nltk/sentiment/vader.py +443 -445
  193. {nltk-3.2 → nltk-3.3}/nltk/stem/__init__.py +31 -33
  194. {nltk-3.2 → nltk-3.3}/nltk/stem/api.py +28 -25
  195. nltk-3.3/nltk/stem/arlstem.py +369 -0
  196. {nltk-3.2 → nltk-3.3}/nltk/stem/isri.py +345 -345
  197. {nltk-3.2 → nltk-3.3}/nltk/stem/lancaster.py +337 -310
  198. nltk-3.3/nltk/stem/porter.py +710 -0
  199. {nltk-3.2 → nltk-3.3}/nltk/stem/regexp.py +61 -61
  200. {nltk-3.2 → nltk-3.3}/nltk/stem/rslp.py +142 -142
  201. {nltk-3.2 → nltk-3.3}/nltk/stem/snowball.py +4236 -3712
  202. {nltk-3.2 → nltk-3.3}/nltk/stem/util.py +22 -12
  203. {nltk-3.2 → nltk-3.3}/nltk/stem/wordnet.py +51 -51
  204. {nltk-3.2 → nltk-3.3}/nltk/tag/__init__.py +152 -127
  205. {nltk-3.2 → nltk-3.3}/nltk/tag/api.py +86 -81
  206. {nltk-3.2 → nltk-3.3}/nltk/tag/brill.py +424 -426
  207. {nltk-3.2 → nltk-3.3}/nltk/tag/brill_trainer.py +608 -608
  208. {nltk-3.2 → nltk-3.3}/nltk/tag/crf.py +204 -200
  209. {nltk-3.2 → nltk-3.3}/nltk/tag/hmm.py +1277 -1277
  210. {nltk-3.2 → nltk-3.3}/nltk/tag/hunpos.py +132 -132
  211. {nltk-3.2 → nltk-3.3}/nltk/tag/mapping.py +101 -101
  212. {nltk-3.2 → nltk-3.3}/nltk/tag/perceptron.py +329 -314
  213. {nltk-3.2 → nltk-3.3}/nltk/tag/senna.py +147 -145
  214. {nltk-3.2 → nltk-3.3}/nltk/tag/sequential.py +740 -736
  215. {nltk-3.2 → nltk-3.3}/nltk/tag/stanford.py +219 -196
  216. {nltk-3.2 → nltk-3.3}/nltk/tag/tnt.py +595 -604
  217. {nltk-3.2 → nltk-3.3}/nltk/tag/util.py +72 -72
  218. {nltk-3.2 → nltk-3.3}/nltk/tbl/__init__.py +28 -28
  219. {nltk-3.2 → nltk-3.3}/nltk/tbl/api.py +1 -1
  220. {nltk-3.2 → nltk-3.3}/nltk/tbl/demo.py +366 -366
  221. {nltk-3.2 → nltk-3.3}/nltk/tbl/erroranalysis.py +39 -39
  222. {nltk-3.2 → nltk-3.3}/nltk/tbl/feature.py +259 -261
  223. {nltk-3.2 → nltk-3.3}/nltk/tbl/rule.py +321 -321
  224. {nltk-3.2 → nltk-3.3}/nltk/tbl/template.py +303 -308
  225. {nltk-3.2 → nltk-3.3}/nltk/test/__init__.py +18 -18
  226. {nltk-3.2 → nltk-3.3}/nltk/test/all.py +24 -23
  227. {nltk-3.2 → nltk-3.3}/nltk/test/bleu.doctest +14 -14
  228. {nltk-3.2 → nltk-3.3}/nltk/test/bnc.doctest +60 -60
  229. {nltk-3.2 → nltk-3.3}/nltk/test/ccg.doctest +376 -395
  230. nltk-3.3/nltk/test/ccg_semantics.doctest +553 -0
  231. {nltk-3.2 → nltk-3.3}/nltk/test/chat80.doctest +234 -234
  232. {nltk-3.2 → nltk-3.3}/nltk/test/childes.doctest +184 -184
  233. {nltk-3.2 → nltk-3.3}/nltk/test/childes_fixt.py +14 -13
  234. {nltk-3.2 → nltk-3.3}/nltk/test/chunk.doctest +373 -373
  235. {nltk-3.2 → nltk-3.3}/nltk/test/classify.doctest +185 -185
  236. {nltk-3.2 → nltk-3.3}/nltk/test/classify_fixt.py +11 -10
  237. nltk-3.3/nltk/test/collections.doctest +20 -0
  238. {nltk-3.2 → nltk-3.3}/nltk/test/collocations.doctest +276 -276
  239. {nltk-3.2 → nltk-3.3}/nltk/test/compat.doctest +134 -138
  240. {nltk-3.2 → nltk-3.3}/nltk/test/compat_fixt.py +9 -8
  241. nltk-3.3/nltk/test/concordance.doctest +55 -0
  242. {nltk-3.2 → nltk-3.3}/nltk/test/corpus.doctest +2200 -2212
  243. {nltk-3.2 → nltk-3.3}/nltk/test/corpus_fixt.py +3 -3
  244. {nltk-3.2 → nltk-3.3}/nltk/test/crubadan.doctest +65 -65
  245. {nltk-3.2 → nltk-3.3}/nltk/test/data.doctest +379 -379
  246. {nltk-3.2 → nltk-3.3}/nltk/test/dependency.doctest +241 -241
  247. {nltk-3.2 → nltk-3.3}/nltk/test/discourse.doctest +546 -546
  248. {nltk-3.2 → nltk-3.3}/nltk/test/discourse_fixt.py +14 -13
  249. {nltk-3.2 → nltk-3.3}/nltk/test/doctest_nose_plugin.py +159 -156
  250. {nltk-3.2 → nltk-3.3}/nltk/test/drt.doctest +517 -517
  251. {nltk-3.2 → nltk-3.3}/nltk/test/featgram.doctest +607 -607
  252. {nltk-3.2 → nltk-3.3}/nltk/test/featstruct.doctest +1229 -1230
  253. {nltk-3.2 → nltk-3.3}/nltk/test/framenet.doctest +288 -239
  254. {nltk-3.2 → nltk-3.3}/nltk/test/generate.doctest +67 -67
  255. {nltk-3.2 → nltk-3.3}/nltk/test/gensim.doctest +140 -141
  256. {nltk-3.2 → nltk-3.3}/nltk/test/gensim_fixt.py +10 -9
  257. {nltk-3.2 → nltk-3.3}/nltk/test/gluesemantics.doctest +384 -386
  258. {nltk-3.2 → nltk-3.3}/nltk/test/gluesemantics_malt.doctest +68 -68
  259. {nltk-3.2 → nltk-3.3}/nltk/test/gluesemantics_malt_fixt.py +12 -11
  260. {nltk-3.2 → nltk-3.3}/nltk/test/grammar.doctest +48 -48
  261. {nltk-3.2 → nltk-3.3}/nltk/test/grammartestsuites.doctest +109 -109
  262. {nltk-3.2 → nltk-3.3}/nltk/test/index.doctest +100 -100
  263. {nltk-3.2 → nltk-3.3}/nltk/test/inference.doctest +534 -534
  264. {nltk-3.2 → nltk-3.3}/nltk/test/inference_fixt.py +12 -11
  265. {nltk-3.2 → nltk-3.3}/nltk/test/internals.doctest +140 -140
  266. {nltk-3.2 → nltk-3.3}/nltk/test/japanese.doctest +48 -48
  267. {nltk-3.2 → nltk-3.3}/nltk/test/logic.doctest +1098 -1098
  268. {nltk-3.2 → nltk-3.3}/nltk/test/metrics.doctest +270 -270
  269. {nltk-3.2 → nltk-3.3}/nltk/test/misc.doctest +118 -118
  270. {nltk-3.2 → nltk-3.3}/nltk/test/nonmonotonic.doctest +286 -286
  271. {nltk-3.2 → nltk-3.3}/nltk/test/nonmonotonic_fixt.py +12 -11
  272. {nltk-3.2 → nltk-3.3}/nltk/test/paice.doctest +35 -35
  273. {nltk-3.2 → nltk-3.3}/nltk/test/parse.doctest +884 -884
  274. {nltk-3.2 → nltk-3.3}/nltk/test/portuguese_en.doctest +565 -565
  275. {nltk-3.2 → nltk-3.3}/nltk/test/portuguese_en_fixt.py +16 -16
  276. {nltk-3.2 → nltk-3.3}/nltk/test/probability.doctest +304 -304
  277. {nltk-3.2 → nltk-3.3}/nltk/test/probability_fixt.py +13 -12
  278. {nltk-3.2 → nltk-3.3}/nltk/test/propbank.doctest +176 -176
  279. {nltk-3.2 → nltk-3.3}/nltk/test/relextract.doctest +263 -263
  280. {nltk-3.2 → nltk-3.3}/nltk/test/resolution.doctest +221 -221
  281. {nltk-3.2 → nltk-3.3}/nltk/test/runtests.py +86 -64
  282. {nltk-3.2 → nltk-3.3}/nltk/test/segmentation_fixt.py +10 -10
  283. {nltk-3.2 → nltk-3.3}/nltk/test/semantics.doctest +665 -665
  284. {nltk-3.2 → nltk-3.3}/nltk/test/semantics_fixt.py +7 -7
  285. {nltk-3.2 → nltk-3.3}/nltk/test/sentiment.doctest +233 -233
  286. {nltk-3.2 → nltk-3.3}/nltk/test/sentiwordnet.doctest +41 -41
  287. {nltk-3.2 → nltk-3.3}/nltk/test/simple.doctest +85 -85
  288. {nltk-3.2 → nltk-3.3}/nltk/test/stem.doctest +78 -78
  289. {nltk-3.2 → nltk-3.3}/nltk/test/tag.doctest +33 -33
  290. {nltk-3.2 → nltk-3.3}/nltk/test/tokenize.doctest +273 -166
  291. {nltk-3.2 → nltk-3.3}/nltk/test/toolbox.doctest +307 -307
  292. {nltk-3.2 → nltk-3.3}/nltk/test/translate.doctest +242 -242
  293. {nltk-3.2 → nltk-3.3}/nltk/test/translate_fixt.py +3 -3
  294. {nltk-3.2 → nltk-3.3}/nltk/test/tree.doctest +1101 -1101
  295. {nltk-3.2 → nltk-3.3}/nltk/test/treeprettyprinter.doctest +127 -127
  296. {nltk-3.2 → nltk-3.3}/nltk/test/treetransforms.doctest +156 -156
  297. nltk-3.3/nltk/test/unit/test_2x_compat.py +63 -0
  298. nltk-3.3/nltk/test/unit/test_aline.py +52 -0
  299. nltk-3.3/nltk/test/unit/test_chunk.py +56 -0
  300. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_classify.py +55 -53
  301. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_collocations.py +88 -79
  302. nltk-3.3/nltk/test/unit/test_concordance.py +98 -0
  303. nltk-3.3/nltk/test/unit/test_corenlp.py +1000 -0
  304. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_corpora.py +200 -183
  305. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_corpus_views.py +45 -45
  306. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_hmm.py +88 -88
  307. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_json2csv_corpus.py +188 -187
  308. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_naivebayes.py +26 -26
  309. nltk-3.3/nltk/test/unit/test_rte_classify.py +86 -0
  310. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_seekable_unicode_stream_reader.py +124 -124
  311. nltk-3.3/nltk/test/unit/test_senna.py +74 -0
  312. nltk-3.3/nltk/test/unit/test_stem.py +121 -0
  313. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_tag.py +20 -20
  314. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_tgrep.py +628 -626
  315. nltk-3.3/nltk/test/unit/test_tokenize.py +168 -0
  316. {nltk-3.2 → nltk-3.3}/nltk/test/unit/test_twitter_auth.py +185 -185
  317. nltk-3.3/nltk/test/unit/test_wordnet.py +134 -0
  318. nltk-3.3/nltk/test/unit/translate/test_bleu.py +244 -0
  319. nltk-3.3/nltk/test/unit/translate/test_gdfa.py +57 -0
  320. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm1.py +75 -75
  321. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm2.py +87 -87
  322. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm3.py +105 -105
  323. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm4.py +126 -126
  324. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm5.py +166 -166
  325. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_ibm_model.py +270 -270
  326. nltk-3.3/nltk/test/unit/translate/test_nist.py +37 -0
  327. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/test_stack_decoder.py +300 -300
  328. {nltk-3.2 → nltk-3.3}/nltk/test/unit/utils.py +41 -41
  329. {nltk-3.2 → nltk-3.3}/nltk/test/util.doctest +48 -48
  330. {nltk-3.2 → nltk-3.3}/nltk/test/wordnet.doctest +595 -581
  331. {nltk-3.2 → nltk-3.3}/nltk/test/wordnet_fixt.py +7 -6
  332. {nltk-3.2 → nltk-3.3}/nltk/test/wordnet_lch.doctest +53 -53
  333. {nltk-3.2 → nltk-3.3}/nltk/test/wsd.doctest +68 -68
  334. {nltk-3.2 → nltk-3.3}/nltk/text.py +663 -610
  335. {nltk-3.2 → nltk-3.3}/nltk/tgrep.py +938 -937
  336. {nltk-3.2 → nltk-3.3}/nltk/tokenize/__init__.py +130 -107
  337. {nltk-3.2 → nltk-3.3}/nltk/tokenize/api.py +77 -78
  338. {nltk-3.2 → nltk-3.3}/nltk/tokenize/casual.py +343 -342
  339. {nltk-3.2 → nltk-3.3}/nltk/tokenize/mwe.py +120 -120
  340. nltk-3.3/nltk/tokenize/nist.py +173 -0
  341. {nltk-3.2 → nltk-3.3}/nltk/tokenize/punkt.py +1620 -1601
  342. {nltk-3.2 → nltk-3.3}/nltk/tokenize/regexp.py +208 -202
  343. nltk-3.3/nltk/tokenize/repp.py +151 -0
  344. {nltk-3.2 → nltk-3.3}/nltk/tokenize/sexpr.py +140 -142
  345. {nltk-3.2 → nltk-3.3}/nltk/tokenize/simple.py +138 -136
  346. {nltk-3.2 → nltk-3.3}/nltk/tokenize/stanford.py +117 -113
  347. nltk-3.3/nltk/tokenize/stanford_segmenter.py +246 -0
  348. {nltk-3.2 → nltk-3.3}/nltk/tokenize/texttiling.py +458 -460
  349. nltk-3.3/nltk/tokenize/toktok.py +155 -0
  350. nltk-3.3/nltk/tokenize/treebank.py +363 -0
  351. nltk-3.3/nltk/tokenize/util.py +261 -0
  352. {nltk-3.2 → nltk-3.3}/nltk/toolbox.py +499 -497
  353. {nltk-3.2 → nltk-3.3}/nltk/translate/__init__.py +24 -24
  354. {nltk-3.2 → nltk-3.3}/nltk/translate/api.py +331 -321
  355. {nltk-3.2 → nltk-3.3}/nltk/translate/bleu_score.py +615 -556
  356. nltk-3.3/nltk/translate/chrf_score.py +137 -0
  357. {nltk-3.2 → nltk-3.3}/nltk/translate/gale_church.py +248 -235
  358. {nltk-3.2 → nltk-3.3}/nltk/translate/gdfa.py +135 -131
  359. nltk-3.3/nltk/translate/gleu_score.py +193 -0
  360. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm1.py +250 -241
  361. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm2.py +308 -308
  362. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm3.py +337 -337
  363. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm4.py +467 -467
  364. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm5.py +639 -639
  365. {nltk-3.2 → nltk-3.3}/nltk/translate/ibm_model.py +536 -533
  366. {nltk-3.2 → nltk-3.3}/nltk/translate/metrics.py +40 -40
  367. nltk-3.3/nltk/translate/nist_score.py +178 -0
  368. {nltk-3.2 → nltk-3.3}/nltk/translate/phrase_based.py +175 -175
  369. {nltk-3.2 → nltk-3.3}/nltk/translate/ribes_score.py +325 -325
  370. {nltk-3.2 → nltk-3.3}/nltk/translate/stack_decoder.py +499 -495
  371. {nltk-3.2 → nltk-3.3}/nltk/tree.py +1605 -1603
  372. {nltk-3.2 → nltk-3.3}/nltk/treeprettyprinter.py +564 -564
  373. {nltk-3.2 → nltk-3.3}/nltk/treetransforms.py +309 -309
  374. {nltk-3.2 → nltk-3.3}/nltk/twitter/__init__.py +28 -28
  375. {nltk-3.2 → nltk-3.3}/nltk/twitter/api.py +141 -136
  376. {nltk-3.2 → nltk-3.3}/nltk/twitter/common.py +264 -258
  377. {nltk-3.2 → nltk-3.3}/nltk/twitter/twitter_demo.py +288 -288
  378. {nltk-3.2 → nltk-3.3}/nltk/twitter/twitterclient.py +530 -530
  379. {nltk-3.2 → nltk-3.3}/nltk/twitter/util.py +147 -146
  380. nltk-3.3/nltk/util.py +751 -0
  381. {nltk-3.2 → nltk-3.3}/nltk/wsd.py +53 -53
  382. {nltk-3.2 → nltk-3.3/nltk.egg-info}/PKG-INFO +13 -5
  383. {nltk-3.2 → nltk-3.3}/nltk.egg-info/SOURCES.txt +26 -3
  384. nltk-3.3/nltk.egg-info/requires.txt +31 -0
  385. {nltk-3.2 → nltk-3.3}/setup.cfg +0 -1
  386. {nltk-3.2 → nltk-3.3}/setup.py +102 -75
  387. nltk-3.2/nltk/VERSION +0 -1
  388. nltk-3.2/nltk/compat.py +0 -680
  389. nltk-3.2/nltk/corpus/reader/pl196x.py +0 -278
  390. nltk-3.2/nltk/corpus/reader/verbnet.py +0 -408
  391. nltk-3.2/nltk/corpus/reader/wordlist.py +0 -37
  392. nltk-3.2/nltk/sentiment/vader_lexicon.txt +0 -7517
  393. nltk-3.2/nltk/six.py +0 -868
  394. nltk-3.2/nltk/stem/porter.py +0 -692
  395. nltk-3.2/nltk/test/unit/test_2x_compat.py +0 -26
  396. nltk-3.2/nltk/test/unit/test_stem.py +0 -36
  397. nltk-3.2/nltk/test/unit/test_tokenize.py +0 -23
  398. nltk-3.2/nltk/test/unit/translate/test_bleu.py +0 -84
  399. nltk-3.2/nltk/tokenize/treebank.py +0 -124
  400. nltk-3.2/nltk/tokenize/util.py +0 -90
  401. nltk-3.2/nltk/util.py +0 -1364
  402. {nltk-3.2 → nltk-3.3}/nltk/test/unit/__init__.py +0 -0
  403. {nltk-3.2 → nltk-3.3}/nltk/test/unit/translate/__init__.py +0 -0
  404. {nltk-3.2 → nltk-3.3}/nltk.egg-info/dependency_links.txt +0 -0
  405. {nltk-3.2 → nltk-3.3}/nltk.egg-info/not-zip-safe +0 -0
  406. {nltk-3.2 → nltk-3.3}/nltk.egg-info/top_level.txt +0 -0
@@ -1,687 +1,687 @@
1
- # Natural Language Toolkit: First-order Resolution-based Theorem Prover
2
- #
3
- # Author: Dan Garrette <dhgarrette@gmail.com>
4
- #
5
- # Copyright (C) 2001-2015 NLTK Project
6
- # URL: <http://nltk.org>
7
- # For license information, see LICENSE.TXT
8
-
9
- """
10
- Module for a resolution-based First Order theorem prover.
11
- """
12
- from __future__ import print_function, unicode_literals
13
-
14
- import operator
15
- from collections import defaultdict
16
- from functools import reduce
17
-
18
- from nltk.sem import skolemize
19
- from nltk.sem.logic import (VariableExpression, EqualityExpression,
20
- ApplicationExpression, Expression,
21
- NegatedExpression, Variable,
22
- AndExpression, unique_variable, OrExpression,
23
- is_indvar, IndividualVariableExpression, Expression)
24
-
25
- from nltk.inference.api import Prover, BaseProverCommand
26
- from nltk.compat import python_2_unicode_compatible
27
-
28
- class ProverParseError(Exception): pass
29
-
30
- class ResolutionProver(Prover):
31
- ANSWER_KEY = 'ANSWER'
32
- _assume_false=True
33
-
34
- def _prove(self, goal=None, assumptions=None, verbose=False):
35
- """
36
- :param goal: Input expression to prove
37
- :type goal: sem.Expression
38
- :param assumptions: Input expressions to use as assumptions in the proof
39
- :type assumptions: list(sem.Expression)
40
- """
41
- if not assumptions:
42
- assumptions = []
43
-
44
- result = None
45
- try:
46
- clauses = []
47
- if goal:
48
- clauses.extend(clausify(-goal))
49
- for a in assumptions:
50
- clauses.extend(clausify(a))
51
- result, clauses = self._attempt_proof(clauses)
52
- if verbose:
53
- print(ResolutionProverCommand._decorate_clauses(clauses))
54
- except RuntimeError as e:
55
- if self._assume_false and str(e).startswith('maximum recursion depth exceeded'):
56
- result = False
57
- clauses = []
58
- else:
59
- if verbose:
60
- print(e)
61
- else:
62
- raise e
63
- return (result, clauses)
64
-
65
- def _attempt_proof(self, clauses):
66
- #map indices to lists of indices, to store attempted unifications
67
- tried = defaultdict(list)
68
-
69
- i = 0
70
- while i < len(clauses):
71
- if not clauses[i].is_tautology():
72
- #since we try clauses in order, we should start after the last
73
- #index tried
74
- if tried[i]:
75
- j = tried[i][-1] + 1
76
- else:
77
- j = i + 1 #nothing tried yet for 'i', so start with the next
78
-
79
- while j < len(clauses):
80
- #don't: 1) unify a clause with itself,
81
- # 2) use tautologies
82
- if i != j and j and not clauses[j].is_tautology():
83
- tried[i].append(j)
84
- newclauses = clauses[i].unify(clauses[j])
85
- if newclauses:
86
- for newclause in newclauses:
87
- newclause._parents = (i+1, j+1)
88
- clauses.append(newclause)
89
- if not len(newclause): #if there's an empty clause
90
- return (True, clauses)
91
- i=-1 #since we added a new clause, restart from the top
92
- break
93
- j += 1
94
- i += 1
95
- return (False, clauses)
96
-
97
- class ResolutionProverCommand(BaseProverCommand):
98
- def __init__(self, goal=None, assumptions=None, prover=None):
99
- """
100
- :param goal: Input expression to prove
101
- :type goal: sem.Expression
102
- :param assumptions: Input expressions to use as assumptions in
103
- the proof.
104
- :type assumptions: list(sem.Expression)
105
- """
106
- if prover is not None:
107
- assert isinstance(prover, ResolutionProver)
108
- else:
109
- prover = ResolutionProver()
110
-
111
- BaseProverCommand.__init__(self, prover, goal, assumptions)
112
- self._clauses = None
113
-
114
- def prove(self, verbose=False):
115
- """
116
- Perform the actual proof. Store the result to prevent unnecessary
117
- re-proving.
118
- """
119
- if self._result is None:
120
- self._result, clauses = self._prover._prove(self.goal(),
121
- self.assumptions(),
122
- verbose)
123
- self._clauses = clauses
124
- self._proof = ResolutionProverCommand._decorate_clauses(clauses)
125
- return self._result
126
-
127
- def find_answers(self, verbose=False):
128
- self.prove(verbose)
129
-
130
- answers = set()
131
- answer_ex = VariableExpression(Variable(ResolutionProver.ANSWER_KEY))
132
- for clause in self._clauses:
133
- for term in clause:
134
- if isinstance(term, ApplicationExpression) and\
135
- term.function == answer_ex and\
136
- not isinstance(term.argument, IndividualVariableExpression):
137
- answers.add(term.argument)
138
- return answers
139
-
140
- @staticmethod
141
- def _decorate_clauses(clauses):
142
- """
143
- Decorate the proof output.
144
- """
145
- out = ''
146
- max_clause_len = max([len(str(clause)) for clause in clauses])
147
- max_seq_len = len(str(len(clauses)))
148
- for i in range(len(clauses)):
149
- parents = 'A'
150
- taut = ''
151
- if clauses[i].is_tautology():
152
- taut = 'Tautology'
153
- if clauses[i]._parents:
154
- parents = str(clauses[i]._parents)
155
- parents = ' '*(max_clause_len-len(str(clauses[i]))+1) + parents
156
- seq = ' '*(max_seq_len-len(str(i+1))) + str(i+1)
157
- out += '[%s] %s %s %s\n' % (seq, clauses[i], parents, taut)
158
- return out
159
-
160
- @python_2_unicode_compatible
161
- class Clause(list):
162
- def __init__(self, data):
163
- list.__init__(self, data)
164
- self._is_tautology = None
165
- self._parents = None
166
-
167
- def unify(self, other, bindings=None, used=None, skipped=None, debug=False):
168
- """
169
- Attempt to unify this Clause with the other, returning a list of
170
- resulting, unified, Clauses.
171
-
172
- :param other: ``Clause`` with which to unify
173
- :param bindings: ``BindingDict`` containing bindings that should be used
174
- during the unification
175
- :param used: tuple of two lists of atoms. The first lists the
176
- atoms from 'self' that were successfully unified with atoms from
177
- 'other'. The second lists the atoms from 'other' that were successfully
178
- unified with atoms from 'self'.
179
- :param skipped: tuple of two ``Clause`` objects. The first is a list of all
180
- the atoms from the 'self' Clause that have not been unified with
181
- anything on the path. The second is same thing for the 'other' Clause.
182
- :param debug: bool indicating whether debug statements should print
183
- :return: list containing all the resulting ``Clause`` objects that could be
184
- obtained by unification
185
- """
186
- if bindings is None: bindings = BindingDict()
187
- if used is None: used = ([],[])
188
- if skipped is None: skipped = ([],[])
189
- if isinstance(debug, bool): debug = DebugObject(debug)
190
-
191
- newclauses = _iterate_first(self, other, bindings, used, skipped, _complete_unify_path, debug)
192
-
193
- #remove subsumed clauses. make a list of all indices of subsumed
194
- #clauses, and then remove them from the list
195
- subsumed = []
196
- for i, c1 in enumerate(newclauses):
197
- if i not in subsumed:
198
- for j, c2 in enumerate(newclauses):
199
- if i!=j and j not in subsumed and c1.subsumes(c2):
200
- subsumed.append(j)
201
- result = []
202
- for i in range(len(newclauses)):
203
- if i not in subsumed:
204
- result.append(newclauses[i])
205
-
206
- return result
207
-
208
- def isSubsetOf(self, other):
209
- """
210
- Return True iff every term in 'self' is a term in 'other'.
211
-
212
- :param other: ``Clause``
213
- :return: bool
214
- """
215
- for a in self:
216
- if a not in other:
217
- return False
218
- return True
219
-
220
- def subsumes(self, other):
221
- """
222
- Return True iff 'self' subsumes 'other', this is, if there is a
223
- substitution such that every term in 'self' can be unified with a term
224
- in 'other'.
225
-
226
- :param other: ``Clause``
227
- :return: bool
228
- """
229
- negatedother = []
230
- for atom in other:
231
- if isinstance(atom, NegatedExpression):
232
- negatedother.append(atom.term)
233
- else:
234
- negatedother.append(-atom)
235
-
236
- negatedotherClause = Clause(negatedother)
237
-
238
- bindings = BindingDict()
239
- used = ([],[])
240
- skipped = ([],[])
241
- debug = DebugObject(False)
242
-
243
- return len(_iterate_first(self, negatedotherClause, bindings, used,
244
- skipped, _subsumes_finalize,
245
- debug)) > 0
246
-
247
- def __getslice__(self, start, end):
248
- return Clause(list.__getslice__(self, start, end))
249
-
250
- def __sub__(self, other):
251
- return Clause([a for a in self if a not in other])
252
-
253
- def __add__(self, other):
254
- return Clause(list.__add__(self, other))
255
-
256
- def is_tautology(self):
257
- """
258
- Self is a tautology if it contains ground terms P and -P. The ground
259
- term, P, must be an exact match, ie, not using unification.
260
- """
261
- if self._is_tautology is not None:
262
- return self._is_tautology
263
- for i,a in enumerate(self):
264
- if not isinstance(a, EqualityExpression):
265
- j = len(self)-1
266
- while j > i:
267
- b = self[j]
268
- if isinstance(a, NegatedExpression):
269
- if a.term == b:
270
- self._is_tautology = True
271
- return True
272
- elif isinstance(b, NegatedExpression):
273
- if a == b.term:
274
- self._is_tautology = True
275
- return True
276
- j -= 1
277
- self._is_tautology = False
278
- return False
279
-
280
- def free(self):
281
- return reduce(operator.or_, ((atom.free() | atom.constants()) for atom in self))
282
-
283
- def replace(self, variable, expression):
284
- """
285
- Replace every instance of variable with expression across every atom
286
- in the clause
287
-
288
- :param variable: ``Variable``
289
- :param expression: ``Expression``
290
- """
291
- return Clause([atom.replace(variable, expression) for atom in self])
292
-
293
- def substitute_bindings(self, bindings):
294
- """
295
- Replace every binding
296
-
297
- :param bindings: A list of tuples mapping Variable Expressions to the
298
- Expressions to which they are bound
299
- :return: ``Clause``
300
- """
301
- return Clause([atom.substitute_bindings(bindings) for atom in self])
302
-
303
- def __str__(self):
304
- return '{' + ', '.join("%s" % item for item in self) + '}'
305
-
306
- def __repr__(self):
307
- return "%s" % self
308
-
309
- def _iterate_first(first, second, bindings, used, skipped, finalize_method, debug):
310
- """
311
- This method facilitates movement through the terms of 'self'
312
- """
313
- debug.line('unify(%s,%s) %s'%(first, second, bindings))
314
-
315
- if not len(first) or not len(second): #if no more recursions can be performed
316
- return finalize_method(first, second, bindings, used, skipped, debug)
317
- else:
318
- #explore this 'self' atom
319
- result = _iterate_second(first, second, bindings, used, skipped, finalize_method, debug+1)
320
-
321
- #skip this possible 'self' atom
322
- newskipped = (skipped[0]+[first[0]], skipped[1])
323
- result += _iterate_first(first[1:], second, bindings, used, newskipped, finalize_method, debug+1)
324
-
325
- try:
326
- newbindings, newused, unused = _unify_terms(first[0], second[0], bindings, used)
327
- #Unification found, so progress with this line of unification
328
- #put skipped and unused terms back into play for later unification.
329
- newfirst = first[1:] + skipped[0] + unused[0]
330
- newsecond = second[1:] + skipped[1] + unused[1]
331
- result += _iterate_first(newfirst, newsecond, newbindings, newused, ([],[]), finalize_method, debug+1)
332
- except BindingException:
333
- #the atoms could not be unified,
334
- pass
335
-
336
- return result
337
-
338
- def _iterate_second(first, second, bindings, used, skipped, finalize_method, debug):
339
- """
340
- This method facilitates movement through the terms of 'other'
341
- """
342
- debug.line('unify(%s,%s) %s'%(first, second, bindings))
343
-
344
- if not len(first) or not len(second): #if no more recursions can be performed
345
- return finalize_method(first, second, bindings, used, skipped, debug)
346
- else:
347
- #skip this possible pairing and move to the next
348
- newskipped = (skipped[0], skipped[1]+[second[0]])
349
- result = _iterate_second(first, second[1:], bindings, used, newskipped, finalize_method, debug+1)
350
-
351
- try:
352
- newbindings, newused, unused = _unify_terms(first[0], second[0], bindings, used)
353
- #Unification found, so progress with this line of unification
354
- #put skipped and unused terms back into play for later unification.
355
- newfirst = first[1:] + skipped[0] + unused[0]
356
- newsecond = second[1:] + skipped[1] + unused[1]
357
- result += _iterate_second(newfirst, newsecond, newbindings, newused, ([],[]), finalize_method, debug+1)
358
- except BindingException:
359
- #the atoms could not be unified,
360
- pass
361
-
362
- return result
363
-
364
- def _unify_terms(a, b, bindings=None, used=None):
365
- """
366
- This method attempts to unify two terms. Two expressions are unifiable
367
- if there exists a substitution function S such that S(a) == S(-b).
368
-
369
- :param a: ``Expression``
370
- :param b: ``Expression``
371
- :param bindings: ``BindingDict`` a starting set of bindings with which
372
- the unification must be consistent
373
- :return: ``BindingDict`` A dictionary of the bindings required to unify
374
- :raise ``BindingException``: If the terms cannot be unified
375
- """
376
- assert isinstance(a, Expression)
377
- assert isinstance(b, Expression)
378
-
379
- if bindings is None: bindings = BindingDict()
380
- if used is None: used = ([],[])
381
-
382
- # Use resolution
383
- if isinstance(a, NegatedExpression) and isinstance(b, ApplicationExpression):
384
- newbindings = most_general_unification(a.term, b, bindings)
385
- newused = (used[0]+[a], used[1]+[b])
386
- unused = ([],[])
387
- elif isinstance(a, ApplicationExpression) and isinstance(b, NegatedExpression):
388
- newbindings = most_general_unification(a, b.term, bindings)
389
- newused = (used[0]+[a], used[1]+[b])
390
- unused = ([],[])
391
-
392
- # Use demodulation
393
- elif isinstance(a, EqualityExpression):
394
- newbindings = BindingDict([(a.first.variable, a.second)])
395
- newused = (used[0]+[a], used[1])
396
- unused = ([],[b])
397
- elif isinstance(b, EqualityExpression):
398
- newbindings = BindingDict([(b.first.variable, b.second)])
399
- newused = (used[0], used[1]+[b])
400
- unused = ([a],[])
401
-
402
- else:
403
- raise BindingException((a, b))
404
-
405
- return newbindings, newused, unused
406
-
407
- def _complete_unify_path(first, second, bindings, used, skipped, debug):
408
- if used[0] or used[1]: #if bindings were made along the path
409
- newclause = Clause(skipped[0] + skipped[1] + first + second)
410
- debug.line(' -> New Clause: %s' % newclause)
411
- return [newclause.substitute_bindings(bindings)]
412
- else: #no bindings made means no unification occurred. so no result
413
- debug.line(' -> End')
414
- return []
415
-
416
- def _subsumes_finalize(first, second, bindings, used, skipped, debug):
417
- if not len(skipped[0]) and not len(first):
418
- #If there are no skipped terms and no terms left in 'first', then
419
- #all of the terms in the original 'self' were unified with terms
420
- #in 'other'. Therefore, there exists a binding (this one) such that
421
- #every term in self can be unified with a term in other, which
422
- #is the definition of subsumption.
423
- return [True]
424
- else:
425
- return []
426
-
427
- def clausify(expression):
428
- """
429
- Skolemize, clausify, and standardize the variables apart.
430
- """
431
- clause_list = []
432
- for clause in _clausify(skolemize(expression)):
433
- for free in clause.free():
434
- if is_indvar(free.name):
435
- newvar = VariableExpression(unique_variable())
436
- clause = clause.replace(free, newvar)
437
- clause_list.append(clause)
438
- return clause_list
439
-
440
- def _clausify(expression):
441
- """
442
- :param expression: a skolemized expression in CNF
443
- """
444
- if isinstance(expression, AndExpression):
445
- return _clausify(expression.first) + _clausify(expression.second)
446
- elif isinstance(expression, OrExpression):
447
- first = _clausify(expression.first)
448
- second = _clausify(expression.second)
449
- assert len(first) == 1
450
- assert len(second) == 1
451
- return [first[0] + second[0]]
452
- elif isinstance(expression, EqualityExpression):
453
- return [Clause([expression])]
454
- elif isinstance(expression, ApplicationExpression):
455
- return [Clause([expression])]
456
- elif isinstance(expression, NegatedExpression):
457
- if isinstance(expression.term, ApplicationExpression):
458
- return [Clause([expression])]
459
- elif isinstance(expression.term, EqualityExpression):
460
- return [Clause([expression])]
461
- raise ProverParseError()
462
-
463
-
464
- @python_2_unicode_compatible
465
- class BindingDict(object):
466
- def __init__(self, binding_list=None):
467
- """
468
- :param binding_list: list of (``AbstractVariableExpression``, ``AtomicExpression``) to initialize the dictionary
469
- """
470
- self.d = {}
471
-
472
- if binding_list:
473
- for (v, b) in binding_list:
474
- self[v] = b
475
-
476
- def __setitem__(self, variable, binding):
477
- """
478
- A binding is consistent with the dict if its variable is not already bound, OR if its
479
- variable is already bound to its argument.
480
-
481
- :param variable: ``Variable`` The variable to bind
482
- :param binding: ``Expression`` The atomic to which 'variable' should be bound
483
- :raise BindingException: If the variable cannot be bound in this dictionary
484
- """
485
- assert isinstance(variable, Variable)
486
- assert isinstance(binding, Expression)
487
-
488
- try:
489
- existing = self[variable]
490
- except KeyError:
491
- existing = None
492
-
493
- if not existing or binding == existing:
494
- self.d[variable] = binding
495
- elif isinstance(binding, IndividualVariableExpression):
496
- # Since variable is already bound, try to bind binding to variable
497
- try:
498
- existing = self[binding.variable]
499
- except KeyError:
500
- existing = None
501
-
502
- binding2 = VariableExpression(variable)
503
-
504
- if not existing or binding2 == existing:
505
- self.d[binding.variable] = binding2
506
- else:
507
- raise BindingException('Variable %s already bound to another '
508
- 'value' % (variable))
509
- else:
510
- raise BindingException('Variable %s already bound to another '
511
- 'value' % (variable))
512
-
513
- def __getitem__(self, variable):
514
- """
515
- Return the expression to which 'variable' is bound
516
- """
517
- assert isinstance(variable, Variable)
518
-
519
- intermediate = self.d[variable]
520
- while intermediate:
521
- try:
522
- intermediate = self.d[intermediate]
523
- except KeyError:
524
- return intermediate
525
-
526
- def __contains__(self, item):
527
- return item in self.d
528
-
529
- def __add__(self, other):
530
- """
531
- :param other: ``BindingDict`` The dict with which to combine self
532
- :return: ``BindingDict`` A new dict containing all the elements of both parameters
533
- :raise BindingException: If the parameter dictionaries are not consistent with each other
534
- """
535
- try:
536
- combined = BindingDict()
537
- for v in self.d:
538
- combined[v] = self.d[v]
539
- for v in other.d:
540
- combined[v] = other.d[v]
541
- return combined
542
- except BindingException:
543
- raise BindingException("Attempting to add two contradicting "
544
- "BindingDicts: '%s' and '%s'"
545
- % (self, other))
546
-
547
- def __len__(self):
548
- return len(self.d)
549
-
550
- def __str__(self):
551
- data_str = ', '.join('%s: %s' % (v, self.d[v]) for v in sorted(self.d.keys()))
552
- return '{' + data_str + '}'
553
-
554
- def __repr__(self):
555
- return "%s" % self
556
-
557
-
558
- def most_general_unification(a, b, bindings=None):
559
- """
560
- Find the most general unification of the two given expressions
561
-
562
- :param a: ``Expression``
563
- :param b: ``Expression``
564
- :param bindings: ``BindingDict`` a starting set of bindings with which the
565
- unification must be consistent
566
- :return: a list of bindings
567
- :raise BindingException: if the Expressions cannot be unified
568
- """
569
- if bindings is None:
570
- bindings = BindingDict()
571
-
572
- if a == b:
573
- return bindings
574
- elif isinstance(a, IndividualVariableExpression):
575
- return _mgu_var(a, b, bindings)
576
- elif isinstance(b, IndividualVariableExpression):
577
- return _mgu_var(b, a, bindings)
578
- elif isinstance(a, ApplicationExpression) and\
579
- isinstance(b, ApplicationExpression):
580
- return most_general_unification(a.function, b.function, bindings) +\
581
- most_general_unification(a.argument, b.argument, bindings)
582
- raise BindingException((a, b))
583
-
584
- def _mgu_var(var, expression, bindings):
585
- if var.variable in expression.free()|expression.constants():
586
- raise BindingException((var, expression))
587
- else:
588
- return BindingDict([(var.variable, expression)]) + bindings
589
-
590
-
591
- class BindingException(Exception):
592
- def __init__(self, arg):
593
- if isinstance(arg, tuple):
594
- Exception.__init__(self, "'%s' cannot be bound to '%s'" % arg)
595
- else:
596
- Exception.__init__(self, arg)
597
-
598
- class UnificationException(Exception):
599
- def __init__(self, a, b):
600
- Exception.__init__(self, "'%s' cannot unify with '%s'" % (a,b))
601
-
602
-
603
- class DebugObject(object):
604
- def __init__(self, enabled=True, indent=0):
605
- self.enabled = enabled
606
- self.indent = indent
607
-
608
- def __add__(self, i):
609
- return DebugObject(self.enabled, self.indent+i)
610
-
611
- def line(self, line):
612
- if self.enabled:
613
- print(' '*self.indent + line)
614
-
615
-
616
- def testResolutionProver():
617
- resolution_test(r'man(x)')
618
- resolution_test(r'(man(x) -> man(x))')
619
- resolution_test(r'(man(x) -> --man(x))')
620
- resolution_test(r'-(man(x) and -man(x))')
621
- resolution_test(r'(man(x) or -man(x))')
622
- resolution_test(r'(man(x) -> man(x))')
623
- resolution_test(r'-(man(x) and -man(x))')
624
- resolution_test(r'(man(x) or -man(x))')
625
- resolution_test(r'(man(x) -> man(x))')
626
- resolution_test(r'(man(x) iff man(x))')
627
- resolution_test(r'-(man(x) iff -man(x))')
628
- resolution_test('all x.man(x)')
629
- resolution_test('-all x.some y.F(x,y) & some x.all y.(-F(x,y))')
630
- resolution_test('some x.all y.sees(x,y)')
631
-
632
- p1 = Expression.fromstring(r'all x.(man(x) -> mortal(x))')
633
- p2 = Expression.fromstring(r'man(Socrates)')
634
- c = Expression.fromstring(r'mortal(Socrates)')
635
- print('%s, %s |- %s: %s' % (p1, p2, c, ResolutionProver().prove(c, [p1,p2])))
636
-
637
- p1 = Expression.fromstring(r'all x.(man(x) -> walks(x))')
638
- p2 = Expression.fromstring(r'man(John)')
639
- c = Expression.fromstring(r'some y.walks(y)')
640
- print('%s, %s |- %s: %s' % (p1, p2, c, ResolutionProver().prove(c, [p1,p2])))
641
-
642
- p = Expression.fromstring(r'some e1.some e2.(believe(e1,john,e2) & walk(e2,mary))')
643
- c = Expression.fromstring(r'some e0.walk(e0,mary)')
644
- print('%s |- %s: %s' % (p, c, ResolutionProver().prove(c, [p])))
645
-
646
- def resolution_test(e):
647
- f = Expression.fromstring(e)
648
- t = ResolutionProver().prove(f)
649
- print('|- %s: %s' % (f, t))
650
-
651
- def test_clausify():
652
- lexpr = Expression.fromstring
653
-
654
- print(clausify(lexpr('P(x) | Q(x)')))
655
- print(clausify(lexpr('(P(x) & Q(x)) | R(x)')))
656
- print(clausify(lexpr('P(x) | (Q(x) & R(x))')))
657
- print(clausify(lexpr('(P(x) & Q(x)) | (R(x) & S(x))')))
658
-
659
- print(clausify(lexpr('P(x) | Q(x) | R(x)')))
660
- print(clausify(lexpr('P(x) | (Q(x) & R(x)) | S(x)')))
661
-
662
- print(clausify(lexpr('exists x.P(x) | Q(x)')))
663
-
664
- print(clausify(lexpr('-(-P(x) & Q(x))')))
665
- print(clausify(lexpr('P(x) <-> Q(x)')))
666
- print(clausify(lexpr('-(P(x) <-> Q(x))')))
667
- print(clausify(lexpr('-(all x.P(x))')))
668
- print(clausify(lexpr('-(some x.P(x))')))
669
-
670
- print(clausify(lexpr('some x.P(x)')))
671
- print(clausify(lexpr('some x.all y.P(x,y)')))
672
- print(clausify(lexpr('all y.some x.P(x,y)')))
673
- print(clausify(lexpr('all z.all y.some x.P(x,y,z)')))
674
- print(clausify(lexpr('all x.(all y.P(x,y) -> -all y.(Q(x,y) -> R(x,y)))')))
675
-
676
-
677
- def demo():
678
- test_clausify()
679
- print()
680
- testResolutionProver()
681
- print()
682
-
683
- p = Expression.fromstring('man(x)')
684
- print(ResolutionProverCommand(p, [p]).prove())
685
-
686
- if __name__ == '__main__':
687
- demo()
1
+ # Natural Language Toolkit: First-order Resolution-based Theorem Prover
2
+ #
3
+ # Author: Dan Garrette <dhgarrette@gmail.com>
4
+ #
5
+ # Copyright (C) 2001-2018 NLTK Project
6
+ # URL: <http://nltk.org>
7
+ # For license information, see LICENSE.TXT
8
+
9
+ """
10
+ Module for a resolution-based First Order theorem prover.
11
+ """
12
+ from __future__ import print_function, unicode_literals
13
+
14
+ import operator
15
+ from collections import defaultdict
16
+ from functools import reduce
17
+
18
+ from nltk.sem import skolemize
19
+ from nltk.sem.logic import (VariableExpression, EqualityExpression,
20
+ ApplicationExpression, Expression,
21
+ NegatedExpression, Variable,
22
+ AndExpression, unique_variable, OrExpression,
23
+ is_indvar, IndividualVariableExpression, Expression)
24
+
25
+ from nltk.inference.api import Prover, BaseProverCommand
26
+ from nltk.compat import python_2_unicode_compatible
27
+
28
+ class ProverParseError(Exception): pass
29
+
30
+ class ResolutionProver(Prover):
31
+ ANSWER_KEY = 'ANSWER'
32
+ _assume_false=True
33
+
34
+ def _prove(self, goal=None, assumptions=None, verbose=False):
35
+ """
36
+ :param goal: Input expression to prove
37
+ :type goal: sem.Expression
38
+ :param assumptions: Input expressions to use as assumptions in the proof
39
+ :type assumptions: list(sem.Expression)
40
+ """
41
+ if not assumptions:
42
+ assumptions = []
43
+
44
+ result = None
45
+ try:
46
+ clauses = []
47
+ if goal:
48
+ clauses.extend(clausify(-goal))
49
+ for a in assumptions:
50
+ clauses.extend(clausify(a))
51
+ result, clauses = self._attempt_proof(clauses)
52
+ if verbose:
53
+ print(ResolutionProverCommand._decorate_clauses(clauses))
54
+ except RuntimeError as e:
55
+ if self._assume_false and str(e).startswith('maximum recursion depth exceeded'):
56
+ result = False
57
+ clauses = []
58
+ else:
59
+ if verbose:
60
+ print(e)
61
+ else:
62
+ raise e
63
+ return (result, clauses)
64
+
65
+ def _attempt_proof(self, clauses):
66
+ #map indices to lists of indices, to store attempted unifications
67
+ tried = defaultdict(list)
68
+
69
+ i = 0
70
+ while i < len(clauses):
71
+ if not clauses[i].is_tautology():
72
+ #since we try clauses in order, we should start after the last
73
+ #index tried
74
+ if tried[i]:
75
+ j = tried[i][-1] + 1
76
+ else:
77
+ j = i + 1 #nothing tried yet for 'i', so start with the next
78
+
79
+ while j < len(clauses):
80
+ #don't: 1) unify a clause with itself,
81
+ # 2) use tautologies
82
+ if i != j and j and not clauses[j].is_tautology():
83
+ tried[i].append(j)
84
+ newclauses = clauses[i].unify(clauses[j])
85
+ if newclauses:
86
+ for newclause in newclauses:
87
+ newclause._parents = (i+1, j+1)
88
+ clauses.append(newclause)
89
+ if not len(newclause): #if there's an empty clause
90
+ return (True, clauses)
91
+ i=-1 #since we added a new clause, restart from the top
92
+ break
93
+ j += 1
94
+ i += 1
95
+ return (False, clauses)
96
+
97
+ class ResolutionProverCommand(BaseProverCommand):
98
+ def __init__(self, goal=None, assumptions=None, prover=None):
99
+ """
100
+ :param goal: Input expression to prove
101
+ :type goal: sem.Expression
102
+ :param assumptions: Input expressions to use as assumptions in
103
+ the proof.
104
+ :type assumptions: list(sem.Expression)
105
+ """
106
+ if prover is not None:
107
+ assert isinstance(prover, ResolutionProver)
108
+ else:
109
+ prover = ResolutionProver()
110
+
111
+ BaseProverCommand.__init__(self, prover, goal, assumptions)
112
+ self._clauses = None
113
+
114
+ def prove(self, verbose=False):
115
+ """
116
+ Perform the actual proof. Store the result to prevent unnecessary
117
+ re-proving.
118
+ """
119
+ if self._result is None:
120
+ self._result, clauses = self._prover._prove(self.goal(),
121
+ self.assumptions(),
122
+ verbose)
123
+ self._clauses = clauses
124
+ self._proof = ResolutionProverCommand._decorate_clauses(clauses)
125
+ return self._result
126
+
127
+ def find_answers(self, verbose=False):
128
+ self.prove(verbose)
129
+
130
+ answers = set()
131
+ answer_ex = VariableExpression(Variable(ResolutionProver.ANSWER_KEY))
132
+ for clause in self._clauses:
133
+ for term in clause:
134
+ if isinstance(term, ApplicationExpression) and\
135
+ term.function == answer_ex and\
136
+ not isinstance(term.argument, IndividualVariableExpression):
137
+ answers.add(term.argument)
138
+ return answers
139
+
140
+ @staticmethod
141
+ def _decorate_clauses(clauses):
142
+ """
143
+ Decorate the proof output.
144
+ """
145
+ out = ''
146
+ max_clause_len = max([len(str(clause)) for clause in clauses])
147
+ max_seq_len = len(str(len(clauses)))
148
+ for i in range(len(clauses)):
149
+ parents = 'A'
150
+ taut = ''
151
+ if clauses[i].is_tautology():
152
+ taut = 'Tautology'
153
+ if clauses[i]._parents:
154
+ parents = str(clauses[i]._parents)
155
+ parents = ' '*(max_clause_len-len(str(clauses[i]))+1) + parents
156
+ seq = ' '*(max_seq_len-len(str(i+1))) + str(i+1)
157
+ out += '[%s] %s %s %s\n' % (seq, clauses[i], parents, taut)
158
+ return out
159
+
160
+ @python_2_unicode_compatible
161
+ class Clause(list):
162
+ def __init__(self, data):
163
+ list.__init__(self, data)
164
+ self._is_tautology = None
165
+ self._parents = None
166
+
167
+ def unify(self, other, bindings=None, used=None, skipped=None, debug=False):
168
+ """
169
+ Attempt to unify this Clause with the other, returning a list of
170
+ resulting, unified, Clauses.
171
+
172
+ :param other: ``Clause`` with which to unify
173
+ :param bindings: ``BindingDict`` containing bindings that should be used
174
+ during the unification
175
+ :param used: tuple of two lists of atoms. The first lists the
176
+ atoms from 'self' that were successfully unified with atoms from
177
+ 'other'. The second lists the atoms from 'other' that were successfully
178
+ unified with atoms from 'self'.
179
+ :param skipped: tuple of two ``Clause`` objects. The first is a list of all
180
+ the atoms from the 'self' Clause that have not been unified with
181
+ anything on the path. The second is same thing for the 'other' Clause.
182
+ :param debug: bool indicating whether debug statements should print
183
+ :return: list containing all the resulting ``Clause`` objects that could be
184
+ obtained by unification
185
+ """
186
+ if bindings is None: bindings = BindingDict()
187
+ if used is None: used = ([],[])
188
+ if skipped is None: skipped = ([],[])
189
+ if isinstance(debug, bool): debug = DebugObject(debug)
190
+
191
+ newclauses = _iterate_first(self, other, bindings, used, skipped, _complete_unify_path, debug)
192
+
193
+ #remove subsumed clauses. make a list of all indices of subsumed
194
+ #clauses, and then remove them from the list
195
+ subsumed = []
196
+ for i, c1 in enumerate(newclauses):
197
+ if i not in subsumed:
198
+ for j, c2 in enumerate(newclauses):
199
+ if i!=j and j not in subsumed and c1.subsumes(c2):
200
+ subsumed.append(j)
201
+ result = []
202
+ for i in range(len(newclauses)):
203
+ if i not in subsumed:
204
+ result.append(newclauses[i])
205
+
206
+ return result
207
+
208
+ def isSubsetOf(self, other):
209
+ """
210
+ Return True iff every term in 'self' is a term in 'other'.
211
+
212
+ :param other: ``Clause``
213
+ :return: bool
214
+ """
215
+ for a in self:
216
+ if a not in other:
217
+ return False
218
+ return True
219
+
220
+ def subsumes(self, other):
221
+ """
222
+ Return True iff 'self' subsumes 'other', this is, if there is a
223
+ substitution such that every term in 'self' can be unified with a term
224
+ in 'other'.
225
+
226
+ :param other: ``Clause``
227
+ :return: bool
228
+ """
229
+ negatedother = []
230
+ for atom in other:
231
+ if isinstance(atom, NegatedExpression):
232
+ negatedother.append(atom.term)
233
+ else:
234
+ negatedother.append(-atom)
235
+
236
+ negatedotherClause = Clause(negatedother)
237
+
238
+ bindings = BindingDict()
239
+ used = ([],[])
240
+ skipped = ([],[])
241
+ debug = DebugObject(False)
242
+
243
+ return len(_iterate_first(self, negatedotherClause, bindings, used,
244
+ skipped, _subsumes_finalize,
245
+ debug)) > 0
246
+
247
+ def __getslice__(self, start, end):
248
+ return Clause(list.__getslice__(self, start, end))
249
+
250
+ def __sub__(self, other):
251
+ return Clause([a for a in self if a not in other])
252
+
253
+ def __add__(self, other):
254
+ return Clause(list.__add__(self, other))
255
+
256
+ def is_tautology(self):
257
+ """
258
+ Self is a tautology if it contains ground terms P and -P. The ground
259
+ term, P, must be an exact match, ie, not using unification.
260
+ """
261
+ if self._is_tautology is not None:
262
+ return self._is_tautology
263
+ for i,a in enumerate(self):
264
+ if not isinstance(a, EqualityExpression):
265
+ j = len(self)-1
266
+ while j > i:
267
+ b = self[j]
268
+ if isinstance(a, NegatedExpression):
269
+ if a.term == b:
270
+ self._is_tautology = True
271
+ return True
272
+ elif isinstance(b, NegatedExpression):
273
+ if a == b.term:
274
+ self._is_tautology = True
275
+ return True
276
+ j -= 1
277
+ self._is_tautology = False
278
+ return False
279
+
280
+ def free(self):
281
+ return reduce(operator.or_, ((atom.free() | atom.constants()) for atom in self))
282
+
283
+ def replace(self, variable, expression):
284
+ """
285
+ Replace every instance of variable with expression across every atom
286
+ in the clause
287
+
288
+ :param variable: ``Variable``
289
+ :param expression: ``Expression``
290
+ """
291
+ return Clause([atom.replace(variable, expression) for atom in self])
292
+
293
+ def substitute_bindings(self, bindings):
294
+ """
295
+ Replace every binding
296
+
297
+ :param bindings: A list of tuples mapping Variable Expressions to the
298
+ Expressions to which they are bound
299
+ :return: ``Clause``
300
+ """
301
+ return Clause([atom.substitute_bindings(bindings) for atom in self])
302
+
303
+ def __str__(self):
304
+ return '{' + ', '.join("%s" % item for item in self) + '}'
305
+
306
+ def __repr__(self):
307
+ return "%s" % self
308
+
309
+ def _iterate_first(first, second, bindings, used, skipped, finalize_method, debug):
310
+ """
311
+ This method facilitates movement through the terms of 'self'
312
+ """
313
+ debug.line('unify(%s,%s) %s'%(first, second, bindings))
314
+
315
+ if not len(first) or not len(second): #if no more recursions can be performed
316
+ return finalize_method(first, second, bindings, used, skipped, debug)
317
+ else:
318
+ #explore this 'self' atom
319
+ result = _iterate_second(first, second, bindings, used, skipped, finalize_method, debug+1)
320
+
321
+ #skip this possible 'self' atom
322
+ newskipped = (skipped[0]+[first[0]], skipped[1])
323
+ result += _iterate_first(first[1:], second, bindings, used, newskipped, finalize_method, debug+1)
324
+
325
+ try:
326
+ newbindings, newused, unused = _unify_terms(first[0], second[0], bindings, used)
327
+ #Unification found, so progress with this line of unification
328
+ #put skipped and unused terms back into play for later unification.
329
+ newfirst = first[1:] + skipped[0] + unused[0]
330
+ newsecond = second[1:] + skipped[1] + unused[1]
331
+ result += _iterate_first(newfirst, newsecond, newbindings, newused, ([],[]), finalize_method, debug+1)
332
+ except BindingException:
333
+ #the atoms could not be unified,
334
+ pass
335
+
336
+ return result
337
+
338
+ def _iterate_second(first, second, bindings, used, skipped, finalize_method, debug):
339
+ """
340
+ This method facilitates movement through the terms of 'other'
341
+ """
342
+ debug.line('unify(%s,%s) %s'%(first, second, bindings))
343
+
344
+ if not len(first) or not len(second): #if no more recursions can be performed
345
+ return finalize_method(first, second, bindings, used, skipped, debug)
346
+ else:
347
+ #skip this possible pairing and move to the next
348
+ newskipped = (skipped[0], skipped[1]+[second[0]])
349
+ result = _iterate_second(first, second[1:], bindings, used, newskipped, finalize_method, debug+1)
350
+
351
+ try:
352
+ newbindings, newused, unused = _unify_terms(first[0], second[0], bindings, used)
353
+ #Unification found, so progress with this line of unification
354
+ #put skipped and unused terms back into play for later unification.
355
+ newfirst = first[1:] + skipped[0] + unused[0]
356
+ newsecond = second[1:] + skipped[1] + unused[1]
357
+ result += _iterate_second(newfirst, newsecond, newbindings, newused, ([],[]), finalize_method, debug+1)
358
+ except BindingException:
359
+ #the atoms could not be unified,
360
+ pass
361
+
362
+ return result
363
+
364
+ def _unify_terms(a, b, bindings=None, used=None):
365
+ """
366
+ This method attempts to unify two terms. Two expressions are unifiable
367
+ if there exists a substitution function S such that S(a) == S(-b).
368
+
369
+ :param a: ``Expression``
370
+ :param b: ``Expression``
371
+ :param bindings: ``BindingDict`` a starting set of bindings with which
372
+ the unification must be consistent
373
+ :return: ``BindingDict`` A dictionary of the bindings required to unify
374
+ :raise ``BindingException``: If the terms cannot be unified
375
+ """
376
+ assert isinstance(a, Expression)
377
+ assert isinstance(b, Expression)
378
+
379
+ if bindings is None: bindings = BindingDict()
380
+ if used is None: used = ([],[])
381
+
382
+ # Use resolution
383
+ if isinstance(a, NegatedExpression) and isinstance(b, ApplicationExpression):
384
+ newbindings = most_general_unification(a.term, b, bindings)
385
+ newused = (used[0]+[a], used[1]+[b])
386
+ unused = ([],[])
387
+ elif isinstance(a, ApplicationExpression) and isinstance(b, NegatedExpression):
388
+ newbindings = most_general_unification(a, b.term, bindings)
389
+ newused = (used[0]+[a], used[1]+[b])
390
+ unused = ([],[])
391
+
392
+ # Use demodulation
393
+ elif isinstance(a, EqualityExpression):
394
+ newbindings = BindingDict([(a.first.variable, a.second)])
395
+ newused = (used[0]+[a], used[1])
396
+ unused = ([],[b])
397
+ elif isinstance(b, EqualityExpression):
398
+ newbindings = BindingDict([(b.first.variable, b.second)])
399
+ newused = (used[0], used[1]+[b])
400
+ unused = ([a],[])
401
+
402
+ else:
403
+ raise BindingException((a, b))
404
+
405
+ return newbindings, newused, unused
406
+
407
+ def _complete_unify_path(first, second, bindings, used, skipped, debug):
408
+ if used[0] or used[1]: #if bindings were made along the path
409
+ newclause = Clause(skipped[0] + skipped[1] + first + second)
410
+ debug.line(' -> New Clause: %s' % newclause)
411
+ return [newclause.substitute_bindings(bindings)]
412
+ else: #no bindings made means no unification occurred. so no result
413
+ debug.line(' -> End')
414
+ return []
415
+
416
+ def _subsumes_finalize(first, second, bindings, used, skipped, debug):
417
+ if not len(skipped[0]) and not len(first):
418
+ #If there are no skipped terms and no terms left in 'first', then
419
+ #all of the terms in the original 'self' were unified with terms
420
+ #in 'other'. Therefore, there exists a binding (this one) such that
421
+ #every term in self can be unified with a term in other, which
422
+ #is the definition of subsumption.
423
+ return [True]
424
+ else:
425
+ return []
426
+
427
+ def clausify(expression):
428
+ """
429
+ Skolemize, clausify, and standardize the variables apart.
430
+ """
431
+ clause_list = []
432
+ for clause in _clausify(skolemize(expression)):
433
+ for free in clause.free():
434
+ if is_indvar(free.name):
435
+ newvar = VariableExpression(unique_variable())
436
+ clause = clause.replace(free, newvar)
437
+ clause_list.append(clause)
438
+ return clause_list
439
+
440
+ def _clausify(expression):
441
+ """
442
+ :param expression: a skolemized expression in CNF
443
+ """
444
+ if isinstance(expression, AndExpression):
445
+ return _clausify(expression.first) + _clausify(expression.second)
446
+ elif isinstance(expression, OrExpression):
447
+ first = _clausify(expression.first)
448
+ second = _clausify(expression.second)
449
+ assert len(first) == 1
450
+ assert len(second) == 1
451
+ return [first[0] + second[0]]
452
+ elif isinstance(expression, EqualityExpression):
453
+ return [Clause([expression])]
454
+ elif isinstance(expression, ApplicationExpression):
455
+ return [Clause([expression])]
456
+ elif isinstance(expression, NegatedExpression):
457
+ if isinstance(expression.term, ApplicationExpression):
458
+ return [Clause([expression])]
459
+ elif isinstance(expression.term, EqualityExpression):
460
+ return [Clause([expression])]
461
+ raise ProverParseError()
462
+
463
+
464
+ @python_2_unicode_compatible
465
+ class BindingDict(object):
466
+ def __init__(self, binding_list=None):
467
+ """
468
+ :param binding_list: list of (``AbstractVariableExpression``, ``AtomicExpression``) to initialize the dictionary
469
+ """
470
+ self.d = {}
471
+
472
+ if binding_list:
473
+ for (v, b) in binding_list:
474
+ self[v] = b
475
+
476
+ def __setitem__(self, variable, binding):
477
+ """
478
+ A binding is consistent with the dict if its variable is not already bound, OR if its
479
+ variable is already bound to its argument.
480
+
481
+ :param variable: ``Variable`` The variable to bind
482
+ :param binding: ``Expression`` The atomic to which 'variable' should be bound
483
+ :raise BindingException: If the variable cannot be bound in this dictionary
484
+ """
485
+ assert isinstance(variable, Variable)
486
+ assert isinstance(binding, Expression)
487
+
488
+ try:
489
+ existing = self[variable]
490
+ except KeyError:
491
+ existing = None
492
+
493
+ if not existing or binding == existing:
494
+ self.d[variable] = binding
495
+ elif isinstance(binding, IndividualVariableExpression):
496
+ # Since variable is already bound, try to bind binding to variable
497
+ try:
498
+ existing = self[binding.variable]
499
+ except KeyError:
500
+ existing = None
501
+
502
+ binding2 = VariableExpression(variable)
503
+
504
+ if not existing or binding2 == existing:
505
+ self.d[binding.variable] = binding2
506
+ else:
507
+ raise BindingException('Variable %s already bound to another '
508
+ 'value' % (variable))
509
+ else:
510
+ raise BindingException('Variable %s already bound to another '
511
+ 'value' % (variable))
512
+
513
+ def __getitem__(self, variable):
514
+ """
515
+ Return the expression to which 'variable' is bound
516
+ """
517
+ assert isinstance(variable, Variable)
518
+
519
+ intermediate = self.d[variable]
520
+ while intermediate:
521
+ try:
522
+ intermediate = self.d[intermediate]
523
+ except KeyError:
524
+ return intermediate
525
+
526
+ def __contains__(self, item):
527
+ return item in self.d
528
+
529
+ def __add__(self, other):
530
+ """
531
+ :param other: ``BindingDict`` The dict with which to combine self
532
+ :return: ``BindingDict`` A new dict containing all the elements of both parameters
533
+ :raise BindingException: If the parameter dictionaries are not consistent with each other
534
+ """
535
+ try:
536
+ combined = BindingDict()
537
+ for v in self.d:
538
+ combined[v] = self.d[v]
539
+ for v in other.d:
540
+ combined[v] = other.d[v]
541
+ return combined
542
+ except BindingException:
543
+ raise BindingException("Attempting to add two contradicting "
544
+ "BindingDicts: '%s' and '%s'"
545
+ % (self, other))
546
+
547
+ def __len__(self):
548
+ return len(self.d)
549
+
550
+ def __str__(self):
551
+ data_str = ', '.join('%s: %s' % (v, self.d[v]) for v in sorted(self.d.keys()))
552
+ return '{' + data_str + '}'
553
+
554
+ def __repr__(self):
555
+ return "%s" % self
556
+
557
+
558
+ def most_general_unification(a, b, bindings=None):
559
+ """
560
+ Find the most general unification of the two given expressions
561
+
562
+ :param a: ``Expression``
563
+ :param b: ``Expression``
564
+ :param bindings: ``BindingDict`` a starting set of bindings with which the
565
+ unification must be consistent
566
+ :return: a list of bindings
567
+ :raise BindingException: if the Expressions cannot be unified
568
+ """
569
+ if bindings is None:
570
+ bindings = BindingDict()
571
+
572
+ if a == b:
573
+ return bindings
574
+ elif isinstance(a, IndividualVariableExpression):
575
+ return _mgu_var(a, b, bindings)
576
+ elif isinstance(b, IndividualVariableExpression):
577
+ return _mgu_var(b, a, bindings)
578
+ elif isinstance(a, ApplicationExpression) and\
579
+ isinstance(b, ApplicationExpression):
580
+ return most_general_unification(a.function, b.function, bindings) +\
581
+ most_general_unification(a.argument, b.argument, bindings)
582
+ raise BindingException((a, b))
583
+
584
+ def _mgu_var(var, expression, bindings):
585
+ if var.variable in expression.free()|expression.constants():
586
+ raise BindingException((var, expression))
587
+ else:
588
+ return BindingDict([(var.variable, expression)]) + bindings
589
+
590
+
591
+ class BindingException(Exception):
592
+ def __init__(self, arg):
593
+ if isinstance(arg, tuple):
594
+ Exception.__init__(self, "'%s' cannot be bound to '%s'" % arg)
595
+ else:
596
+ Exception.__init__(self, arg)
597
+
598
+ class UnificationException(Exception):
599
+ def __init__(self, a, b):
600
+ Exception.__init__(self, "'%s' cannot unify with '%s'" % (a,b))
601
+
602
+
603
+ class DebugObject(object):
604
+ def __init__(self, enabled=True, indent=0):
605
+ self.enabled = enabled
606
+ self.indent = indent
607
+
608
+ def __add__(self, i):
609
+ return DebugObject(self.enabled, self.indent+i)
610
+
611
+ def line(self, line):
612
+ if self.enabled:
613
+ print(' '*self.indent + line)
614
+
615
+
616
+ def testResolutionProver():
617
+ resolution_test(r'man(x)')
618
+ resolution_test(r'(man(x) -> man(x))')
619
+ resolution_test(r'(man(x) -> --man(x))')
620
+ resolution_test(r'-(man(x) and -man(x))')
621
+ resolution_test(r'(man(x) or -man(x))')
622
+ resolution_test(r'(man(x) -> man(x))')
623
+ resolution_test(r'-(man(x) and -man(x))')
624
+ resolution_test(r'(man(x) or -man(x))')
625
+ resolution_test(r'(man(x) -> man(x))')
626
+ resolution_test(r'(man(x) iff man(x))')
627
+ resolution_test(r'-(man(x) iff -man(x))')
628
+ resolution_test('all x.man(x)')
629
+ resolution_test('-all x.some y.F(x,y) & some x.all y.(-F(x,y))')
630
+ resolution_test('some x.all y.sees(x,y)')
631
+
632
+ p1 = Expression.fromstring(r'all x.(man(x) -> mortal(x))')
633
+ p2 = Expression.fromstring(r'man(Socrates)')
634
+ c = Expression.fromstring(r'mortal(Socrates)')
635
+ print('%s, %s |- %s: %s' % (p1, p2, c, ResolutionProver().prove(c, [p1,p2])))
636
+
637
+ p1 = Expression.fromstring(r'all x.(man(x) -> walks(x))')
638
+ p2 = Expression.fromstring(r'man(John)')
639
+ c = Expression.fromstring(r'some y.walks(y)')
640
+ print('%s, %s |- %s: %s' % (p1, p2, c, ResolutionProver().prove(c, [p1,p2])))
641
+
642
+ p = Expression.fromstring(r'some e1.some e2.(believe(e1,john,e2) & walk(e2,mary))')
643
+ c = Expression.fromstring(r'some e0.walk(e0,mary)')
644
+ print('%s |- %s: %s' % (p, c, ResolutionProver().prove(c, [p])))
645
+
646
+ def resolution_test(e):
647
+ f = Expression.fromstring(e)
648
+ t = ResolutionProver().prove(f)
649
+ print('|- %s: %s' % (f, t))
650
+
651
+ def test_clausify():
652
+ lexpr = Expression.fromstring
653
+
654
+ print(clausify(lexpr('P(x) | Q(x)')))
655
+ print(clausify(lexpr('(P(x) & Q(x)) | R(x)')))
656
+ print(clausify(lexpr('P(x) | (Q(x) & R(x))')))
657
+ print(clausify(lexpr('(P(x) & Q(x)) | (R(x) & S(x))')))
658
+
659
+ print(clausify(lexpr('P(x) | Q(x) | R(x)')))
660
+ print(clausify(lexpr('P(x) | (Q(x) & R(x)) | S(x)')))
661
+
662
+ print(clausify(lexpr('exists x.P(x) | Q(x)')))
663
+
664
+ print(clausify(lexpr('-(-P(x) & Q(x))')))
665
+ print(clausify(lexpr('P(x) <-> Q(x)')))
666
+ print(clausify(lexpr('-(P(x) <-> Q(x))')))
667
+ print(clausify(lexpr('-(all x.P(x))')))
668
+ print(clausify(lexpr('-(some x.P(x))')))
669
+
670
+ print(clausify(lexpr('some x.P(x)')))
671
+ print(clausify(lexpr('some x.all y.P(x,y)')))
672
+ print(clausify(lexpr('all y.some x.P(x,y)')))
673
+ print(clausify(lexpr('all z.all y.some x.P(x,y,z)')))
674
+ print(clausify(lexpr('all x.(all y.P(x,y) -> -all y.(Q(x,y) -> R(x,y)))')))
675
+
676
+
677
+ def demo():
678
+ test_clausify()
679
+ print()
680
+ testResolutionProver()
681
+ print()
682
+
683
+ p = Expression.fromstring('man(x)')
684
+ print(ResolutionProverCommand(p, [p]).prove())
685
+
686
+ if __name__ == '__main__':
687
+ demo()