<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>partials</title>
<link rel="stylesheet" href="csound.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2" />
<link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
<link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
<link rel="prev" href="pareq.html" title="pareq" />
<link rel="next" href="partikkel.html" title="partikkel" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">partials</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="pareq.html">Prev</a> </td>
<th width="60%" align="center">Orchestra Opcodes and Operators</th>
<td width="20%" align="right"> <a accesskey="n" href="partikkel.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry" title="partials">
<a id="partials"></a>
<div class="titlepage"></div>
<a id="Indexpartials" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">partials</span>
</h2>
<p>partials —
Partial track spectral analysis.
</p>
</div>
<div class="refsect1" title="Description">
<a id="id3085207"></a>
<h2>Description</h2>
<p>
The partials opcode takes two input PV streaming signals containg AMP_FREQ and AMP_PHASE signals (as generated
for instance by pvsifd or in the first case, by pvsanal) and performs partial track analysis,
as described in Lazzarini et al, "Time-stretching using the Instantaneous Frequency Distribution and Partial
Tracking", Proc.of ICMC05, Barcelona. It generates a TRACKS PV streaming signal, containing amplitude, frequency,
phase and track ID for each output track. This type of signal will contain a variable number of output tracks,
up to the total number of analysis bins contained in the inputs (fftsize/2 + 1 bins). The second input (AMP_PHASE)
is optional, as it can take the same signal as the first input. In this case, however, all phase information will
be NULL and resynthesis using phase information cannot be performed.
</p>
</div>
<div class="refsect1" title="Syntax">
<a id="id3085217"></a>
<h2>Syntax</h2>
<pre class="synopsis">ftrks <span class="command"><strong>partials</strong></span> ffr, fphs, kthresh, kminpts, kmaxgap, imaxtracks</pre>
</div>
<div class="refsect1" title="Performance">
<a id="id3085438"></a>
<h2>Performance</h2>
<p>
<span class="emphasis"><em>ftrks</em></span> -- output pv stream in TRACKS format
</p>
<p>
<span class="emphasis"><em>ffr</em></span> -- input pv stream in AMP_FREQ format
</p>
<p>
<span class="emphasis"><em>fphs</em></span> -- input pv stream in AMP_PHASE format
</p>
<p>
<span class="emphasis"><em>kthresh</em></span> -- analysis threshold. Tracks below ktresh*max_magnitude will be discarded
(1 > ktresh >= 0).
</p>
<p>
<span class="emphasis"><em>kminpoints</em></span> -- minimum number of time points for a detected peak to make a track (1
is the minimum). Since this opcode works with streaming signals, larger numbers will increase the delay between
input and output, as we have to wait for the required minimum number of points.
</p>
<p>
<span class="emphasis"><em>kmaxgap</em></span> -- maximum gap between time-points for track continuation (> 0). Tracks that have
no continuation after kmaxgap will be discarded.
</p>
<p>
<span class="emphasis"><em>imaxtracks</em></span> -- maximum number of analysis tracks (number of bins >= imaxtracks)
</p>
<p>
</p>
</div>
<div class="refsect1" title="Examples">
<a id="id3086160"></a>
<h2>Examples</h2>
<p>
</p>
<div class="example">
<a id="id3086167"></a>
<p class="title">
<b>Example 415. Example</b>
</p>
<div class="example-contents">
<pre class="programlisting">
ain inch 1 ; input signal
fs1,fsi2 pvsifd ain,2048,512,1 ; ifd analysis
fst partials fs1,fsi2,.003,1,3,500 ; partial tracking
aout resyn fst, 1, 1.5, 500, 1 ; resynthesis (up a 5th)
out aout
</pre>
</div>
</div>
<p><br class="example-break" />
</p>
<p>
The example above shows partial tracking of an ifd-analysis signal and
cubic-phase additive resynthesis with pitch shifting.
</p>
</div>
<div class="refsect1" title="Credits">
<a id="id3086191"></a>
<h2>Credits</h2>
<p>
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr>
<td>Author: Victor Lazzarini</td>
</tr>
<tr>
<td>June 2005 </td>
</tr>
</table>
<p>
</p>
<p>New plugin in version 5</p>
<p>November 2004.</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="pareq.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="OpcodesTop.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="partikkel.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">pareq </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> partikkel</td>
</tr>
</table>
</div>
</body>
</html>
