/apidocs/echonest.audio.AudioSegment-class.html

http://echo-nest-remix.googlecode.com/ · HTML · 322 lines · 284 code · 15 blank · 23 comment · 0 complexity · 5b5d6bab561ae9f5f611bf07166432ad 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>echonest.audio.AudioSegment</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="echonest-module.html">Package&nbsp;echonest</a> ::
  38. <a href="echonest.audio-module.html">Module&nbsp;audio</a> ::
  39. Class&nbsp;AudioSegment
  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="echonest.audio.AudioSegment-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 AudioSegment</h1><p class="nomargin-top"><span class="codelink"><a href="echonest.audio-pysrc.html#AudioSegment">source&nbsp;code</a></span></p>
  57. <center>
  58. </center>
  59. <hr />
  60. Subclass of <a href="echonest.audio.AudioQuantum-class.html" class="link">AudioQuantum</a> for the data-rich segments returned by
  61. the Analyze API.
  62. <!-- ==================== INSTANCE METHODS ==================== -->
  63. <a name="section-InstanceMethods"></a>
  64. <table class="summary" border="1" cellpadding="3"
  65. cellspacing="0" width="100%" bgcolor="white">
  66. <tr bgcolor="#70b0f0" class="table-header">
  67. <td colspan="2" class="table-header">
  68. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  69. <tr valign="top">
  70. <td align="left"><span class="table-header">Instance Methods</span></td>
  71. <td align="right" valign="top"
  72. ><span class="options">[<a href="#section-InstanceMethods"
  73. class="privatelink" onclick="toggle_private();"
  74. >hide private</a>]</span></td>
  75. </tr>
  76. </table>
  77. </td>
  78. </tr>
  79. <tr>
  80. <td width="15%" align="right" valign="top" class="summary">
  81. <span class="summary-type">&nbsp;</span>
  82. </td><td class="summary">
  83. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  84. <tr>
  85. <td><span class="summary-sig"><a href="echonest.audio.AudioSegment-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
  86. <span class="summary-sig-arg">start</span>=<span class="summary-sig-default">0.0</span>,
  87. <span class="summary-sig-arg">duration</span>=<span class="summary-sig-default">0.0</span>,
  88. <span class="summary-sig-arg">pitches</span>=<span class="summary-sig-default">None</span>,
  89. <span class="summary-sig-arg">timbre</span>=<span class="summary-sig-default">None</span>,
  90. <span class="summary-sig-arg">loudness_begin</span>=<span class="summary-sig-default">0.0</span>,
  91. <span class="summary-sig-arg">loudness_max</span>=<span class="summary-sig-default">0.0</span>,
  92. <span class="summary-sig-arg">time_loudness_max</span>=<span class="summary-sig-default">0.0</span>,
  93. <span class="summary-sig-arg">loudness_end</span>=<span class="summary-sig-default">None</span>,
  94. <span class="summary-sig-arg">kind</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">segment</code><code class="variable-quote">'</code></span>,
  95. <span class="summary-sig-arg">source</span>=<span class="summary-sig-default">None</span>)</span><br />
  96. Initializes an <a href="echonest.audio.AudioSegment-class.html" class="link">AudioSegment</a>.</td>
  97. <td align="right" valign="top">
  98. <span class="codelink"><a href="echonest.audio-pysrc.html#AudioSegment.__init__">source&nbsp;code</a></span>
  99. </td>
  100. </tr>
  101. </table>
  102. </td>
  103. </tr>
  104. <tr>
  105. <td colspan="2" class="summary">
  106. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="echonest.audio.AudioQuantum-class.html">AudioQuantum</a></code></b>:
  107. <code><a href="echonest.audio.AudioQuantum-class.html#__getstate__">__getstate__</a></code>,
  108. <code><a href="echonest.audio.AudioQuantum-class.html#__repr__">__repr__</a></code>,
  109. <code><a href="echonest.audio.AudioQuantum-class.html#__str__">__str__</a></code>,
  110. <code><a href="echonest.audio.AudioQuantum-class.html#absolute_context">absolute_context</a></code>,
  111. <code><a href="echonest.audio.AudioQuantum-class.html#children">children</a></code>,
  112. <code><a href="echonest.audio.AudioQuantum-class.html#context_string">context_string</a></code>,
  113. <code><a href="echonest.audio.AudioQuantum-class.html#get_end">get_end</a></code>,
  114. <code><a href="echonest.audio.AudioQuantum-class.html#get_source">get_source</a></code>,
  115. <code><a href="echonest.audio.AudioQuantum-class.html#group">group</a></code>,
  116. <code><a href="echonest.audio.AudioQuantum-class.html#local_context">local_context</a></code>,
  117. <code><a href="echonest.audio.AudioQuantum-class.html#next">next</a></code>,
  118. <code><a href="echonest.audio.AudioQuantum-class.html#parent">parent</a></code>,
  119. <code><a href="echonest.audio.AudioQuantum-class.html#prev">prev</a></code>,
  120. <code><a href="echonest.audio.AudioQuantum-class.html#render">render</a></code>,
  121. <code><a href="echonest.audio.AudioQuantum-class.html#set_source">set_source</a></code>,
  122. <code><a href="echonest.audio.AudioQuantum-class.html#toxml">toxml</a></code>
  123. </p>
  124. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="echonest.audio.AudioRenderable-class.html">AudioRenderable</a></code></b>:
  125. <code><a href="echonest.audio.AudioRenderable-class.html#encode">encode</a></code>,
  126. <code><a href="echonest.audio.AudioRenderable-class.html#resolve_source">resolve_source</a></code>,
  127. <code><a href="echonest.audio.AudioRenderable-class.html#sources">sources</a></code>
  128. </p>
  129. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  130. <code>__delattr__</code>,
  131. <code>__format__</code>,
  132. <code>__getattribute__</code>,
  133. <code>__hash__</code>,
  134. <code>__new__</code>,
  135. <code>__reduce__</code>,
  136. <code>__reduce_ex__</code>,
  137. <code>__setattr__</code>,
  138. <code>__sizeof__</code>,
  139. <code>__subclasshook__</code>
  140. </p>
  141. </td>
  142. </tr>
  143. </table>
  144. <!-- ==================== STATIC METHODS ==================== -->
  145. <a name="section-StaticMethods"></a>
  146. <table class="summary" border="1" cellpadding="3"
  147. cellspacing="0" width="100%" bgcolor="white">
  148. <tr bgcolor="#70b0f0" class="table-header">
  149. <td colspan="2" class="table-header">
  150. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  151. <tr valign="top">
  152. <td align="left"><span class="table-header">Static Methods</span></td>
  153. <td align="right" valign="top"
  154. ><span class="options">[<a href="#section-StaticMethods"
  155. class="privatelink" onclick="toggle_private();"
  156. >hide private</a>]</span></td>
  157. </tr>
  158. </table>
  159. </td>
  160. </tr>
  161. <tr>
  162. <td colspan="2" class="summary">
  163. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="echonest.audio.AudioRenderable-class.html">AudioRenderable</a></code></b>:
  164. <code><a href="echonest.audio.AudioRenderable-class.html#init_audio_data">init_audio_data</a></code>
  165. </p>
  166. </td>
  167. </tr>
  168. </table>
  169. <!-- ==================== PROPERTIES ==================== -->
  170. <a name="section-Properties"></a>
  171. <table class="summary" border="1" cellpadding="3"
  172. cellspacing="0" width="100%" bgcolor="white">
  173. <tr bgcolor="#70b0f0" class="table-header">
  174. <td colspan="2" class="table-header">
  175. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  176. <tr valign="top">
  177. <td align="left"><span class="table-header">Properties</span></td>
  178. <td align="right" valign="top"
  179. ><span class="options">[<a href="#section-Properties"
  180. class="privatelink" onclick="toggle_private();"
  181. >hide private</a>]</span></td>
  182. </tr>
  183. </table>
  184. </td>
  185. </tr>
  186. <tr>
  187. <td colspan="2" class="summary">
  188. <p class="indent-wrapped-lines"><b>Inherited from <code><a href="echonest.audio.AudioQuantum-class.html">AudioQuantum</a></code></b>:
  189. <code><a href="echonest.audio.AudioQuantum-class.html#end">end</a></code>,
  190. <code><a href="echonest.audio.AudioQuantum-class.html#source">source</a></code>
  191. </p>
  192. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  193. <code>__class__</code>
  194. </p>
  195. </td>
  196. </tr>
  197. </table>
  198. <!-- ==================== METHOD DETAILS ==================== -->
  199. <a name="section-MethodDetails"></a>
  200. <table class="details" border="1" cellpadding="3"
  201. cellspacing="0" width="100%" bgcolor="white">
  202. <tr bgcolor="#70b0f0" class="table-header">
  203. <td colspan="2" class="table-header">
  204. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  205. <tr valign="top">
  206. <td align="left"><span class="table-header">Method Details</span></td>
  207. <td align="right" valign="top"
  208. ><span class="options">[<a href="#section-MethodDetails"
  209. class="privatelink" onclick="toggle_private();"
  210. >hide private</a>]</span></td>
  211. </tr>
  212. </table>
  213. </td>
  214. </tr>
  215. </table>
  216. <a name="__init__"></a>
  217. <div>
  218. <table class="details" border="1" cellpadding="3"
  219. cellspacing="0" width="100%" bgcolor="white">
  220. <tr><td>
  221. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  222. <tr valign="top"><td>
  223. <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
  224. <span class="sig-arg">start</span>=<span class="sig-default">0.0</span>,
  225. <span class="sig-arg">duration</span>=<span class="sig-default">0.0</span>,
  226. <span class="sig-arg">pitches</span>=<span class="sig-default">None</span>,
  227. <span class="sig-arg">timbre</span>=<span class="sig-default">None</span>,
  228. <span class="sig-arg">loudness_begin</span>=<span class="sig-default">0.0</span>,
  229. <span class="sig-arg">loudness_max</span>=<span class="sig-default">0.0</span>,
  230. <span class="sig-arg">time_loudness_max</span>=<span class="sig-default">0.0</span>,
  231. <span class="sig-arg">loudness_end</span>=<span class="sig-default">None</span>,
  232. <span class="sig-arg">kind</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">segment</code><code class="variable-quote">'</code></span>,
  233. <span class="sig-arg">source</span>=<span class="sig-default">None</span>)</span>
  234. <br /><em class="fname">(Constructor)</em>
  235. </h3>
  236. </td><td align="right" valign="top"
  237. ><span class="codelink"><a href="echonest.audio-pysrc.html#AudioSegment.__init__">source&nbsp;code</a></span>&nbsp;
  238. </td>
  239. </tr></table>
  240. Initializes an <a href="echonest.audio.AudioSegment-class.html" class="link">AudioSegment</a>.
  241. <dl class="fields">
  242. <dt>Parameters:</dt>
  243. <dd><ul class="nomargin-top">
  244. <li><strong class="pname"><code>start</code></strong> - offset from start of the track, in seconds</li>
  245. <li><strong class="pname"><code>duration</code></strong> - duration of the <a href="echonest.audio.AudioSegment-class.html" class="link">AudioSegment</a>, in seconds</li>
  246. <li><strong class="pname"><code>pitches</code></strong> - a twelve-element list with relative loudnesses of each
  247. pitch class, from C (pitches[0]) to B (pitches[11])</li>
  248. <li><strong class="pname"><code>timbre</code></strong> - a twelve-element list with the loudness of each of a
  249. principal component of time and/or frequency profile</li>
  250. <li><strong class="pname"><code>kind</code></strong> - string identifying the kind of AudioQuantum: &quot;segment&quot;</li>
  251. <li><strong class="pname"><code>loudness_begin</code></strong> - loudness in dB at the start of the segment</li>
  252. <li><strong class="pname"><code>loudness_max</code></strong> - loudness in dB at the loudest moment of the
  253. segment</li>
  254. <li><strong class="pname"><code>time_loudness_max</code></strong> - time (in sec from start of segment) of
  255. loudest moment</li>
  256. <li><strong class="pname"><code>loudness_end</code></strong> - loudness at end of segment (if it is given)</li>
  257. </ul></dd>
  258. <dt>Overrides:
  259. object.__init__
  260. </dt>
  261. </dl>
  262. </td></tr></table>
  263. </div>
  264. <br />
  265. <!-- ==================== NAVIGATION BAR ==================== -->
  266. <table class="navbar" border="0" width="100%" cellpadding="0"
  267. bgcolor="#a0c0ff" cellspacing="0">
  268. <tr valign="middle">
  269. <!-- Tree link -->
  270. <th>&nbsp;&nbsp;&nbsp;<a
  271. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  272. <!-- Index link -->
  273. <th>&nbsp;&nbsp;&nbsp;<a
  274. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  275. <!-- Help link -->
  276. <th>&nbsp;&nbsp;&nbsp;<a
  277. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  278. <!-- Project homepage -->
  279. <th class="navbar" align="right" width="100%">
  280. <table border="0" cellpadding="0" cellspacing="0">
  281. <tr><th class="navbar" align="center"
  282. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  283. </tr></table></th>
  284. </tr>
  285. </table>
  286. <table border="0" cellpadding="0" cellspacing="0" width="100%%">
  287. <tr>
  288. <td align="left" class="footer">
  289. Generated by Epydoc 3.0.1 on Wed Sep 1 16:08:58 2010
  290. </td>
  291. <td align="right" class="footer">
  292. <a target="mainFrame" href="http://epydoc.sourceforge.net"
  293. >http://epydoc.sourceforge.net</a>
  294. </td>
  295. </tr>
  296. </table>
  297. <script type="text/javascript">
  298. <!--
  299. // Private objects are initially displayed (because if
  300. // javascript is turned off then we want them to be
  301. // visible); but by default, we want to hide them. So hide
  302. // them unless we have a cookie that says to show them.
  303. checkCookie();
  304. // -->
  305. </script>
  306. </body>
  307. </html>