Mercurial > hg > ltpda

comparison m-toolbox/html_help/help/ug/ssm_building_content.html @ 0:f0afece42f48

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import.
author Daniele Nicolodi <nicolodi@science.unitn.it>
date Wed, 23 Nov 2011 19:22:13 +0100
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:f0afece42f48
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4 <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
5 <TITLE></TITLE>
6 <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Win32)">
7 <META NAME="CREATED" CONTENT="0;0">
8 <META NAME="CHANGEDBY" CONTENT="Adrien G">
9 <META NAME="CHANGED" CONTENT="20090827;17393200">
10 </HEAD>
11 <BODY LANG="en-US" DIR="LTR">
12 <H2>How to build a ssm object.
13 </H2>
14 <UL>
15 <LI><P><FONT COLOR="#000000">The empty constructor creates an empty
16 statespace model</FONT></P>
17 <DIV CLASS="fragment"><PRE><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm()</PRE></DIV>
18 </UL>
19 <UL>
20 <LI><P><FONT COLOR="#000000">Models can be built out of built-in
21 models (mfiles stored in a folder), out of a description with a
22 plist, from a repository or a xml file, but also out of a pzmodel, a
23 rational or a miir model. Conversion out of a parFrac object is not
24 implemented yet.</FONT></P>
25 <DIV CLASS="fragment"><PRE><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm(&lt;pzmodel&gt;)<BR><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm(&lt;miir&gt;)<BR><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm(&lt;rational&gt;)</PRE></DIV>
26 </UL>
27 <UL>
28 <LI><P><FONT COLOR="#000000">This creates a new statespace model by
29 loading the object from disk, either out of an xml file or a .mat
30 file. The latter is not recommended as Matlab data format poses some
31 new retro-compatibility issues at each new release.</FONT></P>
32 <DIV CLASS="fragment"><PRE><FONT SIZE=2><FONT FACE="Courier New, monospace"><FONT COLOR="#000000">&gt;&gt; s = ssm(</FONT><FONT COLOR="#a020f0">'a1.xml'</FONT><FONT COLOR="#000000">)<BR></FONT></FONT></FONT><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; s = ssm(</FONT></FONT></FONT><FONT COLOR="#a020f0"><FONT FACE="Courier New, monospace"><FONT SIZE=2>'a1.mat'</FONT></FONT></FONT><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>)</FONT></FONT></FONT></PRE></DIV>
33 </UL>
34 <UL>
35 <LI><P><FONT COLOR="#000000">For internal use (see built-in models),
36 a structure constructor is available. This is constructor should not
37 be used &ndash; except inside a built-in model &ndash; as it does
38 not increment history, making it impossible to rebuild the object.</FONT></P>
39 <DIV CLASS="fragment"><PRE><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm(&lt;struct&gt;)</PRE></DIV>
40 </UL>
41 <UL>
42 <LI><P><FONT COLOR="#000000">There are dedicated help pages on how
43 to build a model out of a built-in object or a plist description.</FONT></P>
44 <DIV CLASS="fragment"><PRE><FONT COLOR="#000000">&gt;&gt; system = ssm(plist(<FONT COLOR="#a020f0">'built-in'</FONT>, <FONT COLOR="#a020f0">'&lt;model name&gt;'</FONT>))<BR></FONT><FONT COLOR="#000000">&gt;&gt; system = ssm(plist(</FONT><FONT COLOR="#a020f0">'built-in'</FONT><FONT COLOR="#000000">, </FONT><FONT COLOR="#000000">&lt;model number&gt;))</FONT>
45 &gt;&gt; system = ssm(plist(<FONT COLOR="#a020f0">'amats'</FONT>, &lt;a matrices&gt; ... ))</PRE></DIV>
46 </UL>
47 </BODY>
48 </HTML>