Mercurial > hg > ltpda
diff m-toolbox/html_help/help/ug/constructor_examples_general_content.html @ 0:f0afece42f48
Import.
author | Daniele Nicolodi <nicolodi@science.unitn.it> |
---|---|
date | Wed, 23 Nov 2011 19:22:13 +0100 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/m-toolbox/html_help/help/ug/constructor_examples_general_content.html Wed Nov 23 19:22:13 2011 +0100 @@ -0,0 +1,270 @@ +<!-- $Id: constructor_examples_general_content.html,v 1.1 2009/09/30 21:39:43 ingo Exp $ --> + +<!-- -------------------------------------------------- --> +<!-- --------------- BEGIN CONTENT FILE --------------- --> +<!-- -------------------------------------------------- --> + + +<!-- --------------- Link box: begin --------------- --> +<table border="0" summary="Simple list" class="simplelist_nottable_last"> + <tr> + <td> + <a href="#copy">Copy a LTPDA object</a> + </td> + </tr> + <tr> + <td> + <a href="#empty">Construct an empty LTPDA object</a> + </td> + </tr> + <tr> + <td> + <a href="#zero">Construct an empty LTPDA object with the size zero</a> + </td> + </tr> + <tr> + <td> + <a href="#file">Construct a LTPDA object by loading the object from a file</a> + </td> + </tr> + <tr> + <td> + <a href="#plist">Construct an LTPDA object from a parameter list object (PLIST)</a> + </td> + </tr> +</table> +<p>All here described constructors works for all LTPDAobjects.</p> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="copy"></a>Copy a LTPDA object</h2> +<p>The following example creates a copy of a LTPDA object (blue command) by an example of the PARFRAC object. +The copy constructor should work for all classes.</p> +<div class="fragment"><pre class="programlisting"> + >> pf1 = parfrac([1 2+1i 2-1i], [6 1+3i 1-3i], 3) + ---- parfrac 1 ---- + model: None + res: [1;2+i*1;2-i*1] + poles: [6;1+i*3;1-i*3] + dir: 3 + pmul: [1;1;1] + iunits: [] + ounits: [] + description: + UUID: 7c57ab84-3f49-486b-be49-6ed9926fbd66 + ------------------- + <span class="blue">>> pf2 = parfrac(pf1)</span> + ---- parfrac 1 ---- + model: None + res: [1;2+i*1;2-i*1] + poles: [6;1+i*3;1-i*3] + dir: 3 + pmul: [1;1;1] + iunits: [] + ounits: [] + description: + UUID: c892f70e-d113-407c-accc-67f988b31e7e + ------------------- +</pre></div> +<br></br> +<p>REMARK: The following command copies only the handle of an object and doesn't create a copy of the object (as above). This means that everything that happens to the copy or original happens to the other object.</p> +<div class="fragment"><pre class="programlisting"> + >> pf1 = parfrac() + ---- parfrac 1 ---- + model: none + res: [] + poles: [] + dir: 0 + pmul: [] + iunits: [] + ounits: [] + description: + UUID: bd7c9c71-e633-402b-964b-0a270f80764a + ------------------- + >> pf2 = pf1; + >> pf2.setName(<span class="string">'my new name'</span>) + ---- parfrac 1 ---- + model: <span class="string">my new name</span> + res: [] + poles: [] + dir: 0 + pmul: [] + iunits: [] + ounits: [] + description: + UUID: 47a5e458-84fd-4d6b-beb2-11ff574ae661 + ------------------- +</pre></div> +<br></br> +<p>If we display pf1 again then we see that the property 'name' was changed although we only have changed pf2.</p> +<div class="fragment"><pre class="programlisting"> + >> pf1 + ---- parfrac 1 ---- + model: <span class="string">my new name</span> + res: [] + poles: [] + dir: 0 + pmul: [] + iunits: [] + ounits: [] + description: + UUID: 47a5e458-84fd-4d6b-beb2-11ff574ae661 + ------------------- +</pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="empty"></a>Construct an empty LTPDA object</h2> +<p>The following example creates an empty LTPDA object by an example of a rational object.</p> +<div class="fragment"><pre class="programlisting"> + >> rat = rational() + ---- rational 1 ---- + model: none + num: [] + den: [] + iunits: [] + ounits: [] + description: + UUID: eb240e62-ff2f-4c31-a683-0f395b9a5242 + -------------------- +</pre></div> +<p></p> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="zero"></a>Construct an empty LTPDA object with the size zero.</h2> +<p>Sometimes it is necessary to create LTPDA objects which have at least one dimension of zero. +This mean that the MATLAB method "isempty" is true for these objects. This constructor is shown by an example of a matrix object.</p> +<div class="fragment"><pre class="programlisting"> + >> m = matrix.initObjectWithSize(1,0) + ------ matrix ------- + empty-object [1,0] + --------------------- +</pre></div> +<p>It is also possible with this constructor to create a matrix of objects with a different input as zero.</p> +<div class="fragment"><pre class="programlisting"> + >> m = matrix.initObjectWithSize(2,1); + ---- matrix 1 ---- + name: none + size: 0x0 + description: + UUID: ed13da80-92a7-4d1f-8d78-a88f7d77cec3 + ------------------ + ---- matrix 2 ---- + name: none + size: 0x0 + description: + UUID: ed13da80-92a7-4d1f-8d78-a88f7d77cec3 + ------------------ +</pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="file"></a>Construct a LTPDA object by loading the object from a file</h2> +<p>The following example creates a new parfrac object by loading the object from disk.</p> +<div class="fragment"><pre class="programlisting"> + pf = ao<span class="string">'parfrac_object.mat'</span>) + pf = ao<span class="string">'parfrac_object.xml'</span>) +</pre></div> + +<!-- --------------- NEXT EXAMPLE --------------- --> + +<hr> +<h2 class="title"><a name="plist"></a>Construct an LTPDA object from a parameter list object (PLIST)</h2> +<p>Each constructor have different sets of PLISTS which create the object in a different way.</p> +<table border="1" width="80%"> + <tr> + <td> + <table border="0" cellpadding="5" class="categorylist" width="100%"> + <colgroup> + <col width="37%"/> + <col width="63%"/> + </colgroup> + <tbody> + <tr valign="top"> + <td>AO class</td> + <td> + <a href="matlab:web(ao.getInfo('ao').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>SSM class</td> + <td> + <a href="matlab:web(ssm.getInfo('ssm').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>SMODEL class</td> + <td> + <a href="matlab:web(smodel.getInfo('smodel').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>TIMESPAN class</td> + <td> + <a href="matlab:web(timespan.getInfo('timespan').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>MATRIX class</td> + <td> + <a href="matlab:web(matrix.getInfo('matrix').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>COLLECTION class</td> + <td> + <a href="matlab:web(collection.getInfo('collection').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>PZMODEL class</td> + <td> + <a href="matlab:web(pzmodel.getInfo('pzmodel').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>PARFRAC class</td> + <td> + <a href="matlab:web(parfrac.getInfo('parfrac').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>RATIONAL class</td> + <td> + <a href="matlab:web(rational.getInfo('rational').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>FILTERBANK class</td> + <td> + <a href="matlab:web(filterbank.getInfo('filterbank').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>MIIR class</td> + <td> + <a href="matlab:web(miir.getInfo('miir').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>MFIR class</td> + <td> + <a href="matlab:web(mfir.getInfo('mfir').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + <tr valign="top"> + <td>PLIST class</td> + <td> + <a href="matlab:web(plist.getInfo('plist').tohtml, '-helpbrowser')">Parameter Sets</a> + </td> + </tr> + </tbody> + </table> + </td> + </tr> +</table>