/apidocs/pyechonest.song.Song-class.html

http://echo-nest-remix.googlecode.com/ · HTML · 780 lines · 718 code · 39 blank · 23 comment · 0 complexity · 1ec1f457964f62048debf8adbb454301 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>pyechonest.song.Song</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://code.google.com/p/echo-nest-remix/">Project Homepage</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="pyechonest-module.html">Package&nbsp;pyechonest</a> ::
  38. <a href="pyechonest.song-module.html">Module&nbsp;song</a> ::
  39. Class&nbsp;Song
  40. </span>
  41. </td>
  42. <td>
  43. <table cellpadding="0" cellspacing="0">
  44. <!-- hide/show private -->
  45. <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  46. onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  47. <tr><td align="right"><span class="options"
  48. >[<a href="frames.html" target="_top">frames</a
  49. >]&nbsp;|&nbsp;<a href="pyechonest.song.Song-class.html"
  50. target="_top">no&nbsp;frames</a>]</span></td></tr>
  51. </table>
  52. </td>
  53. </tr>
  54. </table>
  55. <!-- ==================== CLASS DESCRIPTION ==================== -->
  56. <h1 class="epydoc">Class Song</h1><p class="nomargin-top"><span class="codelink"><a href="pyechonest.song-pysrc.html#Song">source&nbsp;code</a></span></p>
  57. <center>
  58. </center>
  59. <hr />
  60. <p>A Song object</p>
  61. <dl class="rst-docutils">
  62. <dt>Create a song object like so:</dt>
  63. <dd>s = song.Song('SOXZYYG127F3E1B7A2')</dd>
  64. <dt>Attributes: (<strong>attributes</strong> are guaranteed to exist as soon as an artist object exists)</dt>
  65. <dd><strong>id</strong>: Echo Nest Song ID
  66. <strong>title</strong>: Song Title
  67. <strong>artist_name</strong>: Artist Name
  68. <strong>artist_id</strong>: Artist ID
  69. audio_summary: An Audio Summary Result object
  70. song_hotttnesss: A float representing a song's hotttnesss
  71. artist_hotttnesss: A float representing a song's parent artist's hotttnesss
  72. artist_familiarity: A float representing a song's parent artist's familiarity
  73. artist_location: A string specifying a song's parent artist's location
  74. tracks: A list of track result objects</dd>
  75. </dl>
  76. <!-- ==================== INSTANCE METHODS ==================== -->
  77. <a name="section-InstanceMethods"></a>
  78. <table class="summary" border="1" cellpadding="3"
  79. cellspacing="0" width="100%" bgcolor="white">
  80. <tr bgcolor="#70b0f0" class="table-header">
  81. <td colspan="2" class="table-header">
  82. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  83. <tr valign="top">
  84. <td align="left"><span class="table-header">Instance Methods</span></td>
  85. <td align="right" valign="top"
  86. ><span class="options">[<a href="#section-InstanceMethods"
  87. class="privatelink" onclick="toggle_private();"
  88. >hide private</a>]</span></td>
  89. </tr>
  90. </table>
  91. </td>
  92. </tr>
  93. <tr>
  94. <td width="15%" align="right" valign="top" class="summary">
  95. <span class="summary-type">&nbsp;</span>
  96. </td><td class="summary">
  97. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  98. <tr>
  99. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
  100. <span class="summary-sig-arg">id</span>,
  101. <span class="summary-sig-arg">buckets</span>=<span class="summary-sig-default">None</span>,
  102. <span class="summary-sig-arg">**kwargs</span>)</span><br />
  103. x.__init__(...) initializes x; see x.__class__.__doc__ for signature</td>
  104. <td align="right" valign="top">
  105. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__init__">source&nbsp;code</a></span>
  106. </td>
  107. </tr>
  108. </table>
  109. </td>
  110. </tr>
  111. <tr>
  112. <td width="15%" align="right" valign="top" class="summary">
  113. <span class="summary-type">&nbsp;</span>
  114. </td><td class="summary">
  115. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  116. <tr>
  117. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br />
  118. repr(x)</td>
  119. <td align="right" valign="top">
  120. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__repr__">source&nbsp;code</a></span>
  121. </td>
  122. </tr>
  123. </table>
  124. </td>
  125. </tr>
  126. <tr>
  127. <td width="15%" align="right" valign="top" class="summary">
  128. <span class="summary-type">&nbsp;</span>
  129. </td><td class="summary">
  130. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  131. <tr>
  132. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br />
  133. str(x)</td>
  134. <td align="right" valign="top">
  135. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__str__">source&nbsp;code</a></span>
  136. </td>
  137. </tr>
  138. </table>
  139. </td>
  140. </tr>
  141. <tr>
  142. <td width="15%" align="right" valign="top" class="summary">
  143. <span class="summary-type">&nbsp;</span>
  144. </td><td class="summary">
  145. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  146. <tr>
  147. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_audio_summary" class="summary-sig-name">get_audio_summary</a>(<span class="summary-sig-arg">self</span>,
  148. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  149. Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.</td>
  150. <td align="right" valign="top">
  151. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_audio_summary">source&nbsp;code</a></span>
  152. </td>
  153. </tr>
  154. </table>
  155. </td>
  156. </tr>
  157. <tr>
  158. <td width="15%" align="right" valign="top" class="summary">
  159. <span class="summary-type">&nbsp;</span>
  160. </td><td class="summary">
  161. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  162. <tr>
  163. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_song_hotttnesss" class="summary-sig-name">get_song_hotttnesss</a>(<span class="summary-sig-arg">self</span>,
  164. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  165. Get our numerical description of how hottt a song currently is</td>
  166. <td align="right" valign="top">
  167. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_song_hotttnesss">source&nbsp;code</a></span>
  168. </td>
  169. </tr>
  170. </table>
  171. </td>
  172. </tr>
  173. <tr>
  174. <td width="15%" align="right" valign="top" class="summary">
  175. <span class="summary-type">&nbsp;</span>
  176. </td><td class="summary">
  177. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  178. <tr>
  179. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_hotttnesss" class="summary-sig-name">get_artist_hotttnesss</a>(<span class="summary-sig-arg">self</span>,
  180. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  181. Get our numerical description of how hottt a song's artist currently is</td>
  182. <td align="right" valign="top">
  183. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_hotttnesss">source&nbsp;code</a></span>
  184. </td>
  185. </tr>
  186. </table>
  187. </td>
  188. </tr>
  189. <tr>
  190. <td width="15%" align="right" valign="top" class="summary">
  191. <span class="summary-type">&nbsp;</span>
  192. </td><td class="summary">
  193. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  194. <tr>
  195. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_familiarity" class="summary-sig-name">get_artist_familiarity</a>(<span class="summary-sig-arg">self</span>,
  196. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  197. Get our numerical estimation of how familiar a song's artist currently is to the world</td>
  198. <td align="right" valign="top">
  199. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_familiarity">source&nbsp;code</a></span>
  200. </td>
  201. </tr>
  202. </table>
  203. </td>
  204. </tr>
  205. <tr>
  206. <td width="15%" align="right" valign="top" class="summary">
  207. <span class="summary-type">&nbsp;</span>
  208. </td><td class="summary">
  209. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  210. <tr>
  211. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_location" class="summary-sig-name">get_artist_location</a>(<span class="summary-sig-arg">self</span>,
  212. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  213. Get the location of a song's artist.</td>
  214. <td align="right" valign="top">
  215. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_location">source&nbsp;code</a></span>
  216. </td>
  217. </tr>
  218. </table>
  219. </td>
  220. </tr>
  221. <tr>
  222. <td width="15%" align="right" valign="top" class="summary">
  223. <span class="summary-type">&nbsp;</span>
  224. </td><td class="summary">
  225. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  226. <tr>
  227. <td><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_tracks" class="summary-sig-name">get_tracks</a>(<span class="summary-sig-arg">self</span>,
  228. <span class="summary-sig-arg">catalog</span>,
  229. <span class="summary-sig-arg">limit</span>=<span class="summary-sig-default">False</span>,
  230. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span><br />
  231. Get the tracks for a song given a catalog.</td>
  232. <td align="right" valign="top">
  233. <span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_tracks">source&nbsp;code</a></span>
  234. </td>
  235. </tr>
  236. </table>
  237. </td>
  238. </tr>
  239. <tr>
  240. <td colspan="2" class="summary">
  241. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="pyechonest.proxies.SongProxy-class.html">proxies.SongProxy</a></code></b>:
  242. <code><a href="pyechonest.proxies.SongProxy-class.html#get_attribute">get_attribute</a></code>
  243. </p>
  244. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="pyechonest.proxies.GenericProxy-class.html">proxies.GenericProxy</a></code></b>:
  245. <code><a href="pyechonest.proxies.GenericProxy-class.html#post_attribute">post_attribute</a></code>
  246. </p>
  247. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  248. <code>__delattr__</code>,
  249. <code>__format__</code>,
  250. <code>__getattribute__</code>,
  251. <code>__hash__</code>,
  252. <code>__new__</code>,
  253. <code>__reduce__</code>,
  254. <code>__reduce_ex__</code>,
  255. <code>__setattr__</code>,
  256. <code>__sizeof__</code>,
  257. <code>__subclasshook__</code>
  258. </p>
  259. </td>
  260. </tr>
  261. </table>
  262. <!-- ==================== PROPERTIES ==================== -->
  263. <a name="section-Properties"></a>
  264. <table class="summary" border="1" cellpadding="3"
  265. cellspacing="0" width="100%" bgcolor="white">
  266. <tr bgcolor="#70b0f0" class="table-header">
  267. <td colspan="2" class="table-header">
  268. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  269. <tr valign="top">
  270. <td align="left"><span class="table-header">Properties</span></td>
  271. <td align="right" valign="top"
  272. ><span class="options">[<a href="#section-Properties"
  273. class="privatelink" onclick="toggle_private();"
  274. >hide private</a>]</span></td>
  275. </tr>
  276. </table>
  277. </td>
  278. </tr>
  279. <tr>
  280. <td width="15%" align="right" valign="top" class="summary">
  281. <span class="summary-type">&nbsp;</span>
  282. </td><td class="summary">
  283. <a href="pyechonest.song.Song-class.html#audio_summary" class="summary-name">audio_summary</a><br />
  284. Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.
  285. </td>
  286. </tr>
  287. <tr>
  288. <td width="15%" align="right" valign="top" class="summary">
  289. <span class="summary-type">&nbsp;</span>
  290. </td><td class="summary">
  291. <a href="pyechonest.song.Song-class.html#song_hotttnesss" class="summary-name">song_hotttnesss</a><br />
  292. Get our numerical description of how hottt a song currently is
  293. </td>
  294. </tr>
  295. <tr>
  296. <td width="15%" align="right" valign="top" class="summary">
  297. <span class="summary-type">&nbsp;</span>
  298. </td><td class="summary">
  299. <a href="pyechonest.song.Song-class.html#artist_hotttnesss" class="summary-name">artist_hotttnesss</a><br />
  300. Get our numerical description of how hottt a song's artist currently is
  301. </td>
  302. </tr>
  303. <tr>
  304. <td width="15%" align="right" valign="top" class="summary">
  305. <span class="summary-type">&nbsp;</span>
  306. </td><td class="summary">
  307. <a href="pyechonest.song.Song-class.html#artist_familiarity" class="summary-name">artist_familiarity</a><br />
  308. Get our numerical estimation of how familiar a song's artist currently is to the world
  309. </td>
  310. </tr>
  311. <tr>
  312. <td width="15%" align="right" valign="top" class="summary">
  313. <span class="summary-type">&nbsp;</span>
  314. </td><td class="summary">
  315. <a href="pyechonest.song.Song-class.html#artist_location" class="summary-name">artist_location</a><br />
  316. Get the location of a song's artist.
  317. </td>
  318. </tr>
  319. <tr>
  320. <td colspan="2" class="summary">
  321. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  322. <code>__class__</code>
  323. </p>
  324. </td>
  325. </tr>
  326. </table>
  327. <!-- ==================== METHOD DETAILS ==================== -->
  328. <a name="section-MethodDetails"></a>
  329. <table class="details" border="1" cellpadding="3"
  330. cellspacing="0" width="100%" bgcolor="white">
  331. <tr bgcolor="#70b0f0" class="table-header">
  332. <td colspan="2" class="table-header">
  333. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  334. <tr valign="top">
  335. <td align="left"><span class="table-header">Method Details</span></td>
  336. <td align="right" valign="top"
  337. ><span class="options">[<a href="#section-MethodDetails"
  338. class="privatelink" onclick="toggle_private();"
  339. >hide private</a>]</span></td>
  340. </tr>
  341. </table>
  342. </td>
  343. </tr>
  344. </table>
  345. <a name="__init__"></a>
  346. <div>
  347. <table class="details" border="1" cellpadding="3"
  348. cellspacing="0" width="100%" bgcolor="white">
  349. <tr><td>
  350. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  351. <tr valign="top"><td>
  352. <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
  353. <span class="sig-arg">id</span>,
  354. <span class="sig-arg">buckets</span>=<span class="sig-default">None</span>,
  355. <span class="sig-arg">**kwargs</span>)</span>
  356. <br /><em class="fname">(Constructor)</em>
  357. </h3>
  358. </td><td align="right" valign="top"
  359. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__init__">source&nbsp;code</a></span>&nbsp;
  360. </td>
  361. </tr></table>
  362. x.__init__(...) initializes x; see x.__class__.__doc__ for signature
  363. <dl class="fields">
  364. <dt>Overrides:
  365. object.__init__
  366. <dd><em class="note">(inherited documentation)</em></dd>
  367. </dt>
  368. </dl>
  369. </td></tr></table>
  370. </div>
  371. <a name="__repr__"></a>
  372. <div>
  373. <table class="details" border="1" cellpadding="3"
  374. cellspacing="0" width="100%" bgcolor="white">
  375. <tr><td>
  376. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  377. <tr valign="top"><td>
  378. <h3 class="epydoc"><span class="sig"><span class="sig-name">__repr__</span>(<span class="sig-arg">self</span>)</span>
  379. <br /><em class="fname">(Representation operator)</em>
  380. </h3>
  381. </td><td align="right" valign="top"
  382. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__repr__">source&nbsp;code</a></span>&nbsp;
  383. </td>
  384. </tr></table>
  385. repr(x)
  386. <dl class="fields">
  387. <dt>Overrides:
  388. object.__repr__
  389. <dd><em class="note">(inherited documentation)</em></dd>
  390. </dt>
  391. </dl>
  392. </td></tr></table>
  393. </div>
  394. <a name="__str__"></a>
  395. <div>
  396. <table class="details" border="1" cellpadding="3"
  397. cellspacing="0" width="100%" bgcolor="white">
  398. <tr><td>
  399. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  400. <tr valign="top"><td>
  401. <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span class="sig-arg">self</span>)</span>
  402. <br /><em class="fname">(Informal representation operator)</em>
  403. </h3>
  404. </td><td align="right" valign="top"
  405. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.__str__">source&nbsp;code</a></span>&nbsp;
  406. </td>
  407. </tr></table>
  408. str(x)
  409. <dl class="fields">
  410. <dt>Overrides:
  411. object.__str__
  412. <dd><em class="note">(inherited documentation)</em></dd>
  413. </dt>
  414. </dl>
  415. </td></tr></table>
  416. </div>
  417. <a name="get_audio_summary"></a>
  418. <div>
  419. <table class="details" border="1" cellpadding="3"
  420. cellspacing="0" width="100%" bgcolor="white">
  421. <tr><td>
  422. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  423. <tr valign="top"><td>
  424. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_audio_summary</span>(<span class="sig-arg">self</span>,
  425. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  426. </h3>
  427. </td><td align="right" valign="top"
  428. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_audio_summary">source&nbsp;code</a></span>&nbsp;
  429. </td>
  430. </tr></table>
  431. <p>Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.</p>
  432. <dl class="rst-docutils">
  433. <dt>Args:</dt>
  434. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  435. <dt>Returns:</dt>
  436. <dd>A dictionary containing mode, tempo, key, duration, time signature, loudness, and analysis_url keys.</dd>
  437. </dl>
  438. <dl class="fields">
  439. </dl>
  440. </td></tr></table>
  441. </div>
  442. <a name="get_song_hotttnesss"></a>
  443. <div>
  444. <table class="details" border="1" cellpadding="3"
  445. cellspacing="0" width="100%" bgcolor="white">
  446. <tr><td>
  447. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  448. <tr valign="top"><td>
  449. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_song_hotttnesss</span>(<span class="sig-arg">self</span>,
  450. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  451. </h3>
  452. </td><td align="right" valign="top"
  453. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_song_hotttnesss">source&nbsp;code</a></span>&nbsp;
  454. </td>
  455. </tr></table>
  456. <p>Get our numerical description of how hottt a song currently is</p>
  457. <dl class="rst-docutils">
  458. <dt>Args:</dt>
  459. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  460. <dt>Returns:</dt>
  461. <dd>A float representing hotttnesss.</dd>
  462. </dl>
  463. <dl class="fields">
  464. </dl>
  465. </td></tr></table>
  466. </div>
  467. <a name="get_artist_hotttnesss"></a>
  468. <div>
  469. <table class="details" border="1" cellpadding="3"
  470. cellspacing="0" width="100%" bgcolor="white">
  471. <tr><td>
  472. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  473. <tr valign="top"><td>
  474. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_artist_hotttnesss</span>(<span class="sig-arg">self</span>,
  475. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  476. </h3>
  477. </td><td align="right" valign="top"
  478. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_hotttnesss">source&nbsp;code</a></span>&nbsp;
  479. </td>
  480. </tr></table>
  481. <p>Get our numerical description of how hottt a song's artist currently is</p>
  482. <dl class="rst-docutils">
  483. <dt>Args:</dt>
  484. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  485. <dt>Returns:</dt>
  486. <dd>A float representing hotttnesss.</dd>
  487. </dl>
  488. <dl class="fields">
  489. </dl>
  490. </td></tr></table>
  491. </div>
  492. <a name="get_artist_familiarity"></a>
  493. <div>
  494. <table class="details" border="1" cellpadding="3"
  495. cellspacing="0" width="100%" bgcolor="white">
  496. <tr><td>
  497. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  498. <tr valign="top"><td>
  499. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_artist_familiarity</span>(<span class="sig-arg">self</span>,
  500. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  501. </h3>
  502. </td><td align="right" valign="top"
  503. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_familiarity">source&nbsp;code</a></span>&nbsp;
  504. </td>
  505. </tr></table>
  506. <p>Get our numerical estimation of how familiar a song's artist currently is to the world</p>
  507. <dl class="rst-docutils">
  508. <dt>Args:</dt>
  509. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  510. <dt>Returns:</dt>
  511. <dd>A float representing familiarity.</dd>
  512. </dl>
  513. <dl class="fields">
  514. </dl>
  515. </td></tr></table>
  516. </div>
  517. <a name="get_artist_location"></a>
  518. <div>
  519. <table class="details" border="1" cellpadding="3"
  520. cellspacing="0" width="100%" bgcolor="white">
  521. <tr><td>
  522. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  523. <tr valign="top"><td>
  524. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_artist_location</span>(<span class="sig-arg">self</span>,
  525. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  526. </h3>
  527. </td><td align="right" valign="top"
  528. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_artist_location">source&nbsp;code</a></span>&nbsp;
  529. </td>
  530. </tr></table>
  531. <p>Get the location of a song's artist.</p>
  532. <dl class="rst-docutils">
  533. <dt>Args:</dt>
  534. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  535. <dt>Returns:</dt>
  536. <dd>An artist location object.</dd>
  537. </dl>
  538. <dl class="fields">
  539. </dl>
  540. </td></tr></table>
  541. </div>
  542. <a name="get_tracks"></a>
  543. <div>
  544. <table class="details" border="1" cellpadding="3"
  545. cellspacing="0" width="100%" bgcolor="white">
  546. <tr><td>
  547. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  548. <tr valign="top"><td>
  549. <h3 class="epydoc"><span class="sig"><span class="sig-name">get_tracks</span>(<span class="sig-arg">self</span>,
  550. <span class="sig-arg">catalog</span>,
  551. <span class="sig-arg">limit</span>=<span class="sig-default">False</span>,
  552. <span class="sig-arg">cache</span>=<span class="sig-default">True</span>)</span>
  553. </h3>
  554. </td><td align="right" valign="top"
  555. ><span class="codelink"><a href="pyechonest.song-pysrc.html#Song.get_tracks">source&nbsp;code</a></span>&nbsp;
  556. </td>
  557. </tr></table>
  558. <p>Get the tracks for a song given a catalog.</p>
  559. <dl class="rst-docutils">
  560. <dt>Args:</dt>
  561. <dd>catalog: a string representing the catalog whose track you want to retrieve.</dd>
  562. <dt>Returns:</dt>
  563. <dd>A list of Track dicts.</dd>
  564. </dl>
  565. <dl class="fields">
  566. </dl>
  567. </td></tr></table>
  568. </div>
  569. <br />
  570. <!-- ==================== PROPERTY DETAILS ==================== -->
  571. <a name="section-PropertyDetails"></a>
  572. <table class="details" border="1" cellpadding="3"
  573. cellspacing="0" width="100%" bgcolor="white">
  574. <tr bgcolor="#70b0f0" class="table-header">
  575. <td colspan="2" class="table-header">
  576. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  577. <tr valign="top">
  578. <td align="left"><span class="table-header">Property Details</span></td>
  579. <td align="right" valign="top"
  580. ><span class="options">[<a href="#section-PropertyDetails"
  581. class="privatelink" onclick="toggle_private();"
  582. >hide private</a>]</span></td>
  583. </tr>
  584. </table>
  585. </td>
  586. </tr>
  587. </table>
  588. <a name="audio_summary"></a>
  589. <div>
  590. <table class="details" border="1" cellpadding="3"
  591. cellspacing="0" width="100%" bgcolor="white">
  592. <tr><td>
  593. <h3 class="epydoc">audio_summary</h3>
  594. <p>Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.</p>
  595. <dl class="rst-docutils">
  596. <dt>Args:</dt>
  597. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  598. <dt>Returns:</dt>
  599. <dd>A dictionary containing mode, tempo, key, duration, time signature, loudness, and analysis_url keys.</dd>
  600. </dl>
  601. <dl class="fields">
  602. <dt>Get Method:</dt>
  603. <dd class="value"><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_audio_summary" class="summary-sig-name">get_audio_summary</a>(<span class="summary-sig-arg">self</span>,
  604. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span>
  605. - Get an audio summary of a song containing mode, tempo, key, duration, time signature, loudness, and analysis_url.
  606. </dd>
  607. </dl>
  608. </td></tr></table>
  609. </div>
  610. <a name="song_hotttnesss"></a>
  611. <div>
  612. <table class="details" border="1" cellpadding="3"
  613. cellspacing="0" width="100%" bgcolor="white">
  614. <tr><td>
  615. <h3 class="epydoc">song_hotttnesss</h3>
  616. <p>Get our numerical description of how hottt a song currently is</p>
  617. <dl class="rst-docutils">
  618. <dt>Args:</dt>
  619. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  620. <dt>Returns:</dt>
  621. <dd>A float representing hotttnesss.</dd>
  622. </dl>
  623. <dl class="fields">
  624. <dt>Get Method:</dt>
  625. <dd class="value"><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_song_hotttnesss" class="summary-sig-name">get_song_hotttnesss</a>(<span class="summary-sig-arg">self</span>,
  626. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span>
  627. - Get our numerical description of how hottt a song currently is
  628. </dd>
  629. </dl>
  630. </td></tr></table>
  631. </div>
  632. <a name="artist_hotttnesss"></a>
  633. <div>
  634. <table class="details" border="1" cellpadding="3"
  635. cellspacing="0" width="100%" bgcolor="white">
  636. <tr><td>
  637. <h3 class="epydoc">artist_hotttnesss</h3>
  638. <p>Get our numerical description of how hottt a song's artist currently is</p>
  639. <dl class="rst-docutils">
  640. <dt>Args:</dt>
  641. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  642. <dt>Returns:</dt>
  643. <dd>A float representing hotttnesss.</dd>
  644. </dl>
  645. <dl class="fields">
  646. <dt>Get Method:</dt>
  647. <dd class="value"><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_hotttnesss" class="summary-sig-name">get_artist_hotttnesss</a>(<span class="summary-sig-arg">self</span>,
  648. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span>
  649. - Get our numerical description of how hottt a song's artist currently is
  650. </dd>
  651. </dl>
  652. </td></tr></table>
  653. </div>
  654. <a name="artist_familiarity"></a>
  655. <div>
  656. <table class="details" border="1" cellpadding="3"
  657. cellspacing="0" width="100%" bgcolor="white">
  658. <tr><td>
  659. <h3 class="epydoc">artist_familiarity</h3>
  660. <p>Get our numerical estimation of how familiar a song's artist currently is to the world</p>
  661. <dl class="rst-docutils">
  662. <dt>Args:</dt>
  663. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  664. <dt>Returns:</dt>
  665. <dd>A float representing familiarity.</dd>
  666. </dl>
  667. <dl class="fields">
  668. <dt>Get Method:</dt>
  669. <dd class="value"><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_familiarity" class="summary-sig-name">get_artist_familiarity</a>(<span class="summary-sig-arg">self</span>,
  670. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span>
  671. - Get our numerical estimation of how familiar a song's artist currently is to the world
  672. </dd>
  673. </dl>
  674. </td></tr></table>
  675. </div>
  676. <a name="artist_location"></a>
  677. <div>
  678. <table class="details" border="1" cellpadding="3"
  679. cellspacing="0" width="100%" bgcolor="white">
  680. <tr><td>
  681. <h3 class="epydoc">artist_location</h3>
  682. <p>Get the location of a song's artist.</p>
  683. <dl class="rst-docutils">
  684. <dt>Args:</dt>
  685. <dd>cache: A boolean indicating whether or not the cached value should be used (if available). Defaults to True.</dd>
  686. <dt>Returns:</dt>
  687. <dd>An artist location object.</dd>
  688. </dl>
  689. <dl class="fields">
  690. <dt>Get Method:</dt>
  691. <dd class="value"><span class="summary-sig"><a href="pyechonest.song.Song-class.html#get_artist_location" class="summary-sig-name">get_artist_location</a>(<span class="summary-sig-arg">self</span>,
  692. <span class="summary-sig-arg">cache</span>=<span class="summary-sig-default">True</span>)</span>
  693. - Get the location of a song's artist.
  694. </dd>
  695. </dl>
  696. </td></tr></table>
  697. </div>
  698. <br />
  699. <!-- ==================== NAVIGATION BAR ==================== -->
  700. <table class="navbar" border="0" width="100%" cellpadding="0"
  701. bgcolor="#a0c0ff" cellspacing="0">
  702. <tr valign="middle">
  703. <!-- Tree link -->
  704. <th>&nbsp;&nbsp;&nbsp;<a
  705. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  706. <!-- Index link -->
  707. <th>&nbsp;&nbsp;&nbsp;<a
  708. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  709. <!-- Help link -->
  710. <th>&nbsp;&nbsp;&nbsp;<a
  711. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  712. <!-- Project homepage -->
  713. <th class="navbar" align="right" width="100%">
  714. <table border="0" cellpadding="0" cellspacing="0">
  715. <tr><th class="navbar" align="center"
  716. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  717. </tr></table></th>
  718. </tr>
  719. </table>
  720. <table border="0" cellpadding="0" cellspacing="0" width="100%%">
  721. <tr>
  722. <td align="left" class="footer">
  723. Generated by Epydoc 3.0.1 on Wed Sep 1 16:08:59 2010
  724. </td>
  725. <td align="right" class="footer">
  726. <a target="mainFrame" href="http://epydoc.sourceforge.net"
  727. >http://epydoc.sourceforge.net</a>
  728. </td>
  729. </tr>
  730. </table>
  731. <script type="text/javascript">
  732. <!--
  733. // Private objects are initially displayed (because if
  734. // javascript is turned off then we want them to be
  735. // visible); but by default, we want to hide them. So hide
  736. // them unless we have a cookie that says to show them.
  737. checkCookie();
  738. // -->
  739. </script>
  740. </body>
  741. </html>