/doc/tagger.Rater-class.html

http://github.com/apresta/tagger · HTML · 341 lines · 293 code · 27 blank · 21 comment · 0 complexity · d67988c878ccfc23d5136ad77f6558e4 MD5 · raw file

  1. <?xml version="1.0" encoding="ascii"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3. "DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  5. <head>
  6. <title>tagger.Rater</title>
  7. <link rel="stylesheet" href="epydoc.css" type="text/css" />
  8. <script type="text/javascript" src="epydoc.js"></script>
  9. </head>
  10. <body bgcolor="white" text="black" link="blue" vlink="#204080"
  11. alink="#204080">
  12. <!-- ==================== NAVIGATION BAR ==================== -->
  13. <table class="navbar" border="0" width="100%" cellpadding="0"
  14. bgcolor="#a0c0ff" cellspacing="0">
  15. <tr valign="middle">
  16. <!-- Tree link -->
  17. <th>&nbsp;&nbsp;&nbsp;<a
  18. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  19. <!-- Index link -->
  20. <th>&nbsp;&nbsp;&nbsp;<a
  21. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  22. <!-- Help link -->
  23. <th>&nbsp;&nbsp;&nbsp;<a
  24. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  25. <!-- Project homepage -->
  26. <th class="navbar" align="right" width="100%">
  27. <table border="0" cellpadding="0" cellspacing="0">
  28. <tr><th class="navbar" align="center"
  29. ><a class="navbar" target="_top" href="http://github.com/apresta/tagger">tagger</a></th>
  30. </tr></table></th>
  31. </tr>
  32. </table>
  33. <table width="100%" cellpadding="0" cellspacing="0">
  34. <tr valign="top">
  35. <td width="100%">
  36. <span class="breadcrumbs">
  37. <a href="tagger-module.html">Module&nbsp;tagger</a> ::
  38. Class&nbsp;Rater
  39. </span>
  40. </td>
  41. <td>
  42. <table cellpadding="0" cellspacing="0">
  43. <!-- hide/show private -->
  44. <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  45. onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  46. <tr><td align="right"><span class="options"
  47. >[<a href="frames.html" target="_top">frames</a
  48. >]&nbsp;|&nbsp;<a href="tagger.Rater-class.html"
  49. target="_top">no&nbsp;frames</a>]</span></td></tr>
  50. </table>
  51. </td>
  52. </tr>
  53. </table>
  54. <!-- ==================== CLASS DESCRIPTION ==================== -->
  55. <h1 class="epydoc">Class Rater</h1><p class="nomargin-top"><span class="codelink"><a href="tagger-pysrc.html#Rater">source&nbsp;code</a></span></p>
  56. <center>
  57. <center> <map id="class_hierarchy_for_rater" name="class_hierarchy_for_rater">
  58. <area shape="rect" id="node1" href="extras.NaiveRater-class.html" title="extras.NaiveRater" alt="" coords="5,61,139,88"/>
  59. <area shape="rect" id="node2" href="tagger.Rater-class.html" title="Rater" alt="" coords="44,5,100,32"/>
  60. </map>
  61. <img src="class_hierarchy_for_rater.gif" alt='' usemap="#class_hierarchy_for_rater" ismap="ismap" class="graph-without-title" />
  62. </center>
  63. </center>
  64. <hr />
  65. <p>Class for estimating the relevance of tags</p>
  66. <p>(the default implementation uses TF (term frequency) multiplied by
  67. weight, but any other reasonable measure is fine; a quite rudimental
  68. heuristic tries to discard redundant tags)</p>
  69. <!-- ==================== INSTANCE METHODS ==================== -->
  70. <a name="section-InstanceMethods"></a>
  71. <table class="summary" border="1" cellpadding="3"
  72. cellspacing="0" width="100%" bgcolor="white">
  73. <tr bgcolor="#70b0f0" class="table-header">
  74. <td colspan="2" class="table-header">
  75. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  76. <tr valign="top">
  77. <td align="left"><span class="table-header">Instance Methods</span></td>
  78. <td align="right" valign="top"
  79. ><span class="options">[<a href="#section-InstanceMethods"
  80. class="privatelink" onclick="toggle_private();"
  81. >hide private</a>]</span></td>
  82. </tr>
  83. </table>
  84. </td>
  85. </tr>
  86. <tr>
  87. <td width="15%" align="right" valign="top" class="summary">
  88. <span class="summary-type">&nbsp;</span>
  89. </td><td class="summary">
  90. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  91. <tr>
  92. <td><span class="summary-sig"><a href="tagger.Rater-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
  93. <span class="summary-sig-arg">weights</span>,
  94. <span class="summary-sig-arg">multitag_size</span>=<span class="summary-sig-default">3</span>)</span><br />
  95. Returns:
  96. a new <a href="tagger.Rater-class.html" class="link">Rater</a> object</td>
  97. <td align="right" valign="top">
  98. <span class="codelink"><a href="tagger-pysrc.html#Rater.__init__">source&nbsp;code</a></span>
  99. </td>
  100. </tr>
  101. </table>
  102. </td>
  103. </tr>
  104. <tr>
  105. <td width="15%" align="right" valign="top" class="summary">
  106. <span class="summary-type">&nbsp;</span>
  107. </td><td class="summary">
  108. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  109. <tr>
  110. <td><span class="summary-sig"><a href="tagger.Rater-class.html#__call__" class="summary-sig-name">__call__</a>(<span class="summary-sig-arg">self</span>,
  111. <span class="summary-sig-arg">tags</span>)</span><br />
  112. Returns:
  113. a list of unique (multi)tags sorted by relevance</td>
  114. <td align="right" valign="top">
  115. <span class="codelink"><a href="tagger-pysrc.html#Rater.__call__">source&nbsp;code</a></span>
  116. </td>
  117. </tr>
  118. </table>
  119. </td>
  120. </tr>
  121. <tr>
  122. <td width="15%" align="right" valign="top" class="summary">
  123. <span class="summary-type">&nbsp;</span>
  124. </td><td class="summary">
  125. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  126. <tr>
  127. <td><span class="summary-sig"><a href="tagger.Rater-class.html#rate_tags" class="summary-sig-name">rate_tags</a>(<span class="summary-sig-arg">self</span>,
  128. <span class="summary-sig-arg">tags</span>)</span></td>
  129. <td align="right" valign="top">
  130. <span class="codelink"><a href="tagger-pysrc.html#Rater.rate_tags">source&nbsp;code</a></span>
  131. </td>
  132. </tr>
  133. </table>
  134. </td>
  135. </tr>
  136. <tr>
  137. <td width="15%" align="right" valign="top" class="summary">
  138. <span class="summary-type">&nbsp;</span>
  139. </td><td class="summary">
  140. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  141. <tr>
  142. <td><span class="summary-sig"><a href="tagger.Rater-class.html#create_multitags" class="summary-sig-name">create_multitags</a>(<span class="summary-sig-arg">self</span>,
  143. <span class="summary-sig-arg">tags</span>)</span><br />
  144. Returns:
  145. a list of multitags</td>
  146. <td align="right" valign="top">
  147. <span class="codelink"><a href="tagger-pysrc.html#Rater.create_multitags">source&nbsp;code</a></span>
  148. </td>
  149. </tr>
  150. </table>
  151. </td>
  152. </tr>
  153. </table>
  154. <!-- ==================== METHOD DETAILS ==================== -->
  155. <a name="section-MethodDetails"></a>
  156. <table class="details" border="1" cellpadding="3"
  157. cellspacing="0" width="100%" bgcolor="white">
  158. <tr bgcolor="#70b0f0" class="table-header">
  159. <td colspan="2" class="table-header">
  160. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  161. <tr valign="top">
  162. <td align="left"><span class="table-header">Method Details</span></td>
  163. <td align="right" valign="top"
  164. ><span class="options">[<a href="#section-MethodDetails"
  165. class="privatelink" onclick="toggle_private();"
  166. >hide private</a>]</span></td>
  167. </tr>
  168. </table>
  169. </td>
  170. </tr>
  171. </table>
  172. <a name="__init__"></a>
  173. <div>
  174. <table class="details" border="1" cellpadding="3"
  175. cellspacing="0" width="100%" bgcolor="white">
  176. <tr><td>
  177. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  178. <tr valign="top"><td>
  179. <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
  180. <span class="sig-arg">weights</span>,
  181. <span class="sig-arg">multitag_size</span>=<span class="sig-default">3</span>)</span>
  182. <br /><em class="fname">(Constructor)</em>
  183. </h3>
  184. </td><td align="right" valign="top"
  185. ><span class="codelink"><a href="tagger-pysrc.html#Rater.__init__">source&nbsp;code</a></span>&nbsp;
  186. </td>
  187. </tr></table>
  188. <dl class="fields">
  189. <dt>Parameters:</dt>
  190. <dd><ul class="nomargin-top">
  191. <li><strong class="pname"><code>weights</code></strong> - a dictionary of weights normalized in the interval [0,1]</li>
  192. <li><strong class="pname"><code>multitag_size</code></strong> - maximum size of tags formed by multiple unit tags</li>
  193. </ul></dd>
  194. <dt>Returns:</dt>
  195. <dd>a new <a href="tagger.Rater-class.html" class="link">Rater</a>
  196. object</dd>
  197. </dl>
  198. </td></tr></table>
  199. </div>
  200. <a name="__call__"></a>
  201. <div>
  202. <table class="details" border="1" cellpadding="3"
  203. cellspacing="0" width="100%" bgcolor="white">
  204. <tr><td>
  205. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  206. <tr valign="top"><td>
  207. <h3 class="epydoc"><span class="sig"><span class="sig-name">__call__</span>(<span class="sig-arg">self</span>,
  208. <span class="sig-arg">tags</span>)</span>
  209. <br /><em class="fname">(Call operator)</em>
  210. </h3>
  211. </td><td align="right" valign="top"
  212. ><span class="codelink"><a href="tagger-pysrc.html#Rater.__call__">source&nbsp;code</a></span>&nbsp;
  213. </td>
  214. </tr></table>
  215. <dl class="fields">
  216. <dt>Parameters:</dt>
  217. <dd><ul class="nomargin-top">
  218. <li><strong class="pname"><code>tags</code></strong> - a list of (preferably stemmed) tags</li>
  219. </ul></dd>
  220. <dt>Returns:</dt>
  221. <dd>a list of unique (multi)tags sorted by relevance</dd>
  222. </dl>
  223. </td></tr></table>
  224. </div>
  225. <a name="rate_tags"></a>
  226. <div>
  227. <table class="details" border="1" cellpadding="3"
  228. cellspacing="0" width="100%" bgcolor="white">
  229. <tr><td>
  230. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  231. <tr valign="top"><td>
  232. <h3 class="epydoc"><span class="sig"><span class="sig-name">rate_tags</span>(<span class="sig-arg">self</span>,
  233. <span class="sig-arg">tags</span>)</span>
  234. </h3>
  235. </td><td align="right" valign="top"
  236. ><span class="codelink"><a href="tagger-pysrc.html#Rater.rate_tags">source&nbsp;code</a></span>&nbsp;
  237. </td>
  238. </tr></table>
  239. <dl class="fields">
  240. <dt>Parameters:</dt>
  241. <dd><ul class="nomargin-top">
  242. <li><strong class="pname"><code>tags</code></strong> - a list of tags to be assigned a rating</li>
  243. </ul></dd>
  244. </dl>
  245. </td></tr></table>
  246. </div>
  247. <a name="create_multitags"></a>
  248. <div>
  249. <table class="details" border="1" cellpadding="3"
  250. cellspacing="0" width="100%" bgcolor="white">
  251. <tr><td>
  252. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  253. <tr valign="top"><td>
  254. <h3 class="epydoc"><span class="sig"><span class="sig-name">create_multitags</span>(<span class="sig-arg">self</span>,
  255. <span class="sig-arg">tags</span>)</span>
  256. </h3>
  257. </td><td align="right" valign="top"
  258. ><span class="codelink"><a href="tagger-pysrc.html#Rater.create_multitags">source&nbsp;code</a></span>&nbsp;
  259. </td>
  260. </tr></table>
  261. <dl class="fields">
  262. <dt>Parameters:</dt>
  263. <dd><ul class="nomargin-top">
  264. <li><strong class="pname"><code>tags</code></strong> - a list of tags (respecting the order in the text)</li>
  265. </ul></dd>
  266. <dt>Returns:</dt>
  267. <dd>a list of multitags</dd>
  268. </dl>
  269. </td></tr></table>
  270. </div>
  271. <br />
  272. <!-- ==================== NAVIGATION BAR ==================== -->
  273. <table class="navbar" border="0" width="100%" cellpadding="0"
  274. bgcolor="#a0c0ff" cellspacing="0">
  275. <tr valign="middle">
  276. <!-- Tree link -->
  277. <th>&nbsp;&nbsp;&nbsp;<a
  278. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  279. <!-- Index link -->
  280. <th>&nbsp;&nbsp;&nbsp;<a
  281. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  282. <!-- Help link -->
  283. <th>&nbsp;&nbsp;&nbsp;<a
  284. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  285. <!-- Project homepage -->
  286. <th class="navbar" align="right" width="100%">
  287. <table border="0" cellpadding="0" cellspacing="0">
  288. <tr><th class="navbar" align="center"
  289. ><a class="navbar" target="_top" href="http://github.com/apresta/tagger">tagger</a></th>
  290. </tr></table></th>
  291. </tr>
  292. </table>
  293. <table border="0" cellpadding="0" cellspacing="0" width="100%%">
  294. <tr>
  295. <td align="left" class="footer">
  296. Generated by Epydoc 3.0.1 on Fri May 13 11:13:08 2011
  297. </td>
  298. <td align="right" class="footer">
  299. <a target="mainFrame" href="http://epydoc.sourceforge.net"
  300. >http://epydoc.sourceforge.net</a>
  301. </td>
  302. </tr>
  303. </table>
  304. <script type="text/javascript">
  305. <!--
  306. // Private objects are initially displayed (because if
  307. // javascript is turned off then we want them to be
  308. // visible); but by default, we want to hide them. So hide
  309. // them unless we have a cookie that says to show them.
  310. checkCookie();
  311. // -->
  312. </script>
  313. </body>
  314. </html>