<?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>phs</title>
<link rel="stylesheet" type="text/css" href="csound.css" />
<link rel="stylesheet" type="text/css" href="syntax-highlighting.css" />
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" />
<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="phasorbnk.html" title="phasorbnk" />
<link rel="next" href="pindex.html" title="pindex" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">phs</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="phasorbnk.html">Prev</a> </td>
<th width="60%" align="center">Orchestra Opcodes and Operators</th>
<td width="20%" align="right"> <a accesskey="n" href="pindex.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="refentry">
<a id="phs"></a>
<div class="titlepage"></div>
<a id="IndexPhs" class="indexterm"></a>
<div class="refnamediv">
<h2>
<span class="refentrytitle">phs</span>
</h2>
<p>phs —
Obtains the phases of a complex-number array
</p>
</div>
<div class="refsect1">
<a id="idm281472903745880"></a>
<h2>Description</h2>
<p>
This opcode returns the phases of a complex-number array, as a real-valued array with half the size of its input plus one. The reason for the extra point is to keep the array size equivalent to the output of the mags opcode (which is often used alongside this one).
</p>
</div>
<div class="refsect1">
<a id="idm281472903754424"></a>
<h2>Syntax</h2>
<pre class="synopsis">kout[] <span class="command"><strong>phs</strong></span> kin[]</pre>
</div>
<div class="refsect1">
<a id="idm281472903752248"></a>
<h2>Performance</h2>
<p>
<span class="emphasis"><em>kout[]</em></span> -- output array containing the phases. It will be created if it does not exist.
</p>
<p>
<span class="emphasis"><em>kin[]</em></span> -- input array containing the complex-valued real-imaginary input.
</p>
</div>
<div class="refsect1">
<a id="idm281472903684056"></a>
<h2>Examples</h2>
<p>
Here is an example of the phs opcode. It uses the file <a class="ulink" href="examples/phs.csd" target="_top"><em class="citetitle">phs.csd</em></a>.</p>
<div class="example">
<a id="idm281472903682248"></a>
<p class="title">
<strong>Example 691. Example of the phs opcode.</strong>
</p>
<div class="example-contents">
<p>See the sections <a class="link" href="UsingRealTime.html" title="Real-Time Audio"><em class="citetitle">Real-time Audio</em></a> and <a class="link" href="CommandFlags.html" title="Csound command line"><em class="citetitle">Command Line Flags</em></a> for more information on using command line flags.</p>
<div class="refsect1">
<a id="idm281472725210072"></a>
<pre class="programlisting">
<span class="nt"><CsoundSynthesizer></span>
<span class="nt"><CsOptions></span>
-d -o dac
<span class="nt"></CsOptions></span>
<span class="nt"><CsInstruments></span>
<span class="cm">/* ksmps needs to be an integer div of
hopsize */</span>
<span class="vg">ksmps</span> <span class="o">=</span> <span class="mi">64</span>
<span class="kd">instr</span> <span class="nf">1</span>
i<span class="n">hopsize</span> <span class="o">=</span> <span class="mi">256</span> <span class="c1">; hopsize</span>
i<span class="n">fftsize</span> <span class="o">=</span> <span class="mi">2048</span> <span class="c1">; FFT size </span>
i<span class="n">olaps</span> <span class="o">=</span> i<span class="n">fftsize</span><span class="o">/</span>i<span class="n">hopsize</span> <span class="c1">; overlaps</span>
i<span class="n">bw</span> <span class="o">=</span> <span class="vg">sr</span><span class="o">/</span>i<span class="n">fftsize</span> <span class="c1">; bin bandwidth</span>
k<span class="n">cnt</span> <span class="nb">init</span> <span class="mi">0</span> <span class="c1">; counting vars</span>
k<span class="n">row</span> <span class="nb">init</span> <span class="mi">0</span>
k<span class="n">Ola</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span> <span class="c1">; overlap-add buffer</span>
k<span class="n">In</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span> <span class="c1">; input buffer</span>
k<span class="n">Olph</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span><span class="o">+</span><span class="mi">1</span> <span class="c1">; old phases</span>
k<span class="n">Phs</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span><span class="o">+</span><span class="mi">1</span> <span class="c1">; synthesis phases</span>
k<span class="n">DeltaOut</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span><span class="o">+</span><span class="mi">1</span> <span class="c1">; synthesis freqs</span>
k<span class="n">MagsOut</span><span class="p">[]</span> <span class="nb">init</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span><span class="o">+</span><span class="mi">1</span> <span class="c1">; synthesis mags</span>
k<span class="n">Out</span><span class="p">[][]</span> <span class="nb">init</span> i<span class="n">olaps</span><span class="p">,</span> i<span class="n">fftsize</span> <span class="c1">; output buffers</span>
a<span class="n">1</span> <span class="nb">diskin2</span> <span class="s">"fox.wav"</span><span class="p">,</span><span class="mi">1</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span> <span class="c1">; audio input</span>
<span class="cm">/* every hopsize samples */</span>
<span class="k">if</span> k<span class="n">cnt</span> <span class="o">==</span> i<span class="n">hopsize</span> <span class="k">then</span>
<span class="cm">/* window and take FFT */</span>
k<span class="n">Win</span><span class="p">[]</span> <span class="nb">window</span> k<span class="n">In</span><span class="p">,</span>k<span class="n">row</span><span class="o">*</span>i<span class="n">hopsize</span>
k<span class="n">Spec</span><span class="p">[]</span> <span class="nb">rfft</span> k<span class="n">Win</span>
<span class="cm">/* mags & phases */</span>
k<span class="n">Mags</span><span class="p">[]</span> <span class="nb">mags</span> k<span class="n">Spec</span>
k<span class="n">Pha</span><span class="p">[]</span> <span class="nb">phs</span> k<span class="n">Spec</span>
<span class="cm">/* phase diffs */</span>
k<span class="n">Delta</span><span class="p">[]</span> <span class="o">=</span> k<span class="n">Pha</span> <span class="o">-</span> k<span class="n">Olph</span>
k<span class="n">Olph</span> <span class="o">=</span> k<span class="n">Pha</span>
<span class="cm">/* pitch shift */</span>
k<span class="n">i</span> <span class="o">=</span> <span class="mi">0</span>
i<span class="n">scal</span> <span class="o">=</span> <span class="mf">1.25</span> <span class="c1">; maj 3rd up</span>
<span class="k">until</span> k<span class="n">i</span> <span class="o">==</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span> <span class="k">do</span>
<span class="k">if</span> k<span class="n">i</span><span class="o">*</span>i<span class="n">scal</span> <span class="o"><</span> i<span class="n">fftsize</span><span class="o">/</span><span class="mi">2</span> <span class="k">then</span>
k<span class="n">DeltaOut</span><span class="p">[</span>k<span class="n">i</span><span class="o">*</span>i<span class="n">scal</span><span class="p">]</span> <span class="o">=</span> k<span class="n">Delta</span><span class="p">[</span>k<span class="n">i</span><span class="p">]</span><span class="o">*</span>i<span class="n">scal</span>
k<span class="n">MagsOut</span><span class="p">[</span>k<span class="n">i</span><span class="o">*</span>i<span class="n">scal</span><span class="p">]</span> <span class="o">=</span> k<span class="n">Mags</span><span class="p">[</span>k<span class="n">i</span><span class="p">]</span>
<span class="k">endif</span>
k<span class="n">i</span> <span class="o">+=</span> <span class="mi">1</span>
<span class="k">od</span>
<span class="cm">/* accum phases */</span>
k<span class="n">Phs</span> <span class="o">=</span> k<span class="n">DeltaOut</span> <span class="o">+</span> k<span class="n">Phs</span>
k<span class="n">Spec</span> <span class="nb">pol2rect</span> k<span class="n">MagsOut</span><span class="p">,</span>k<span class="n">Phs</span>
<span class="cm">/* IFFT + window */</span>
k<span class="n">Row</span><span class="p">[]</span> <span class="nb">rifft</span> k<span class="n">Spec</span>
k<span class="n">Win</span> <span class="nb">window</span> k<span class="n">Row</span><span class="p">,</span> k<span class="n">row</span><span class="o">*</span>i<span class="n">hopsize</span>
<span class="cm">/* place it on out buffer */</span>
k<span class="n">Out</span> <span class="nb">setrow</span> k<span class="n">Win</span><span class="p">,</span> k<span class="n">row</span>
<span class="cm">/* zero the ola buffer */</span>
k<span class="n">Ola</span> <span class="o">=</span> <span class="mi">0</span>
<span class="cm">/* overlap-add */</span>
k<span class="n">i</span> <span class="o">=</span> <span class="mi">0</span>
<span class="k">until</span> k<span class="n">i</span> <span class="o">==</span> i<span class="n">olaps</span> <span class="k">do</span>
k<span class="n">Row</span> <span class="nb">getrow</span> k<span class="n">Out</span><span class="p">,</span> k<span class="n">i</span>
k<span class="n">Ola</span> <span class="o">=</span> k<span class="n">Ola</span> <span class="o">+</span> k<span class="n">Row</span>
k<span class="n">i</span> <span class="o">+=</span> <span class="mi">1</span>
<span class="k">od</span>
<span class="cm">/* update counters */</span>
k<span class="n">row</span> <span class="o">=</span> <span class="p">(</span>k<span class="n">row</span><span class="o">+</span><span class="mi">1</span><span class="p">)</span><span class="o">%</span>i<span class="n">olaps</span>
k<span class="n">cnt</span> <span class="o">=</span> <span class="mi">0</span>
<span class="k">endif</span>
<span class="cm">/* shift audio in/out of buffers */</span>
k<span class="n">In</span> <span class="nb">shiftin</span> a<span class="n">1</span>
a<span class="n">2</span> <span class="nb">shiftout</span> k<span class="n">Ola</span>
a<span class="n">1</span> <span class="nb">delay</span> a<span class="n">1</span><span class="p">,</span> <span class="p">(</span>i<span class="n">fftsize</span><span class="o">+</span>i<span class="n">hopsize</span><span class="p">)</span><span class="o">/</span><span class="vg">sr</span>
<span class="nb">out</span> a<span class="n">1</span><span class="o">*</span><span class="mf">0.3</span><span class="o">+</span>a<span class="n">2</span><span class="o">/</span>i<span class="n">olaps</span>
<span class="cm">/* increment counter */</span>
k<span class="n">cnt</span> <span class="o">+=</span> <span class="vg">ksmps</span>
<span class="kd">endin</span>
<span class="nt"></CsInstruments></span>
<span class="nt"><CsScore></span>
<span class="nb">i</span><span class="mi">1</span> <span class="mi">0</span> <span class="mi">10</span>
<span class="nt"></CsScore></span>
<span class="nt"></CsoundSynthesizer></span>
</pre>
</div>
</div>
</div>
<br class="example-break" />
</div>
<div class="refsect1">
<a id="idm281472903678088"></a>
<h2>See Also</h2>
<p>
<a class="link" href="vectorial.html" title="Vectorial Opcodes"><em class="citetitle"></em>Vectorial opcodes</a>,
<a class="link" href="arrayOpcodes.html" title="Array Opcodes"><em class="citetitle"></em>array opcodes</a>
</p>
</div>
<div class="refsect1">
<a id="idm281472903675080"></a>
<h2>Credits</h2>
<p>
</p>
<table border="0" summary="Simple list" class="simplelist">
<tr>
<td>Author: Victor Lazzarini</td>
</tr>
<tr>
<td>NUI Maynooth</td>
</tr>
<tr>
<td>2014</td>
</tr>
</table>
<p>
</p>
<p>New in version 6.04</p>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="phasorbnk.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="pindex.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">phasorbnk </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> pindex</td>
</tr>
</table>
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
5fcfcb7517038d1f44ab4e478e6e61fa
>
files
>
2648
