Mercurial > hg > ltpda

comparison m-toolbox/html_help/help/ug/ssm_building.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.01 Transitional//EN"
2 "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
3
4 <html lang="en">
5 <head>
6 <meta name="generator" content=
7 "HTML Tidy for Mac OS X (vers 1st December 2004), see www.w3.org">
8 <meta http-equiv="Content-Type" content=
9 "text/html; charset=us-ascii">
10
11 <title>Building Statespace models (LTPDA Toolbox)</title>
12 <link rel="stylesheet" href="docstyle.css" type="text/css">
13 <meta name="generator" content="DocBook XSL Stylesheets V1.52.2">
14 <meta name="description" content=
15 "Presents an overview of the features, system requirements, and starting the toolbox.">
16 </head>
17
18 <body>
19 <a name="top_of_page" id="top_of_page"></a>
20
21 <p style="font-size:1px;">&nbsp;</p>
22
23 <table class="nav" summary="Navigation aid" border="0" width=
24 "100%" cellpadding="0" cellspacing="0">
25 <tr>
26 <td valign="baseline"><b>LTPDA Toolbox</b></td><td><a href="../helptoc.html">contents</a></td>
27
28 <td valign="baseline" align="right"><a href=
29 "ssm_introduction.html"><img src="b_prev.gif" border="0" align=
30 "bottom" alt="Introduction to Statespace Models with LTPDA"></a>&nbsp;&nbsp;&nbsp;<a href=
31 "ssm_build_description.html"><img src="b_next.gif" border="0" align=
32 "bottom" alt="Building from scratch"></a></td>
33 </tr>
34 </table>
35
36 <h1 class="title"><a name="f3-12899" id="f3-12899"></a>Building Statespace models</h1>
37 <hr>
38
39 <p>
40 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
41 <HTML>
42 <HEAD>
43 <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
44 <TITLE></TITLE>
45 <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Win32)">
46 <META NAME="CREATED" CONTENT="0;0">
47 <META NAME="CHANGEDBY" CONTENT="Adrien G">
48 <META NAME="CHANGED" CONTENT="20090827;17393200">
49 </HEAD>
50 <BODY LANG="en-US" DIR="LTR">
51 <H2>How to build a ssm object.
52 </H2>
53 <UL>
54 <LI><P><FONT COLOR="#000000">The empty constructor creates an empty
55 statespace model</FONT></P>
56 <DIV CLASS="fragment"><PRE><FONT COLOR="#000000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;&gt; </FONT></FONT></FONT>s = ssm()</PRE></DIV>
57 </UL>
58 <UL>
59 <LI><P><FONT COLOR="#000000">Models can be built out of built-in
60 models (mfiles stored in a folder), out of a description with a
61 plist, from a repository or a xml file, but also out of a pzmodel, a
62 rational or a miir model. Conversion out of a parFrac object is not
63 implemented yet.</FONT></P>
64 <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>
65 </UL>
66 <UL>
67 <LI><P><FONT COLOR="#000000">This creates a new statespace model by
68 loading the object from disk, either out of an xml file or a .mat
69 file. The latter is not recommended as Matlab data format poses some
70 new retro-compatibility issues at each new release.</FONT></P>
71 <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>
72 </UL>
73 <UL>
74 <LI><P><FONT COLOR="#000000">For internal use (see built-in models),
75 a structure constructor is available. This is constructor should not
76 be used &ndash; except inside a built-in model &ndash; as it does
77 not increment history, making it impossible to rebuild the object.</FONT></P>
78 <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>
79 </UL>
80 <UL>
81 <LI><P><FONT COLOR="#000000">There are dedicated help pages on how
82 to build a model out of a built-in object or a plist description.</FONT></P>
83 <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>
84 &gt;&gt; system = ssm(plist(<FONT COLOR="#a020f0">'amats'</FONT>, &lt;a matrices&gt; ... ))</PRE></DIV>
85 </UL>
86 </BODY>
87 </HTML>
88 </p>
89
90 <br>
91 <br>
92 <table class="nav" summary="Navigation aid" border="0" width=
93 "100%" cellpadding="0" cellspacing="0">
94 <tr valign="top">
95 <td align="left" width="20"><a href="ssm_introduction.html"><img src=
96 "b_prev.gif" border="0" align="bottom" alt=
97 "Introduction to Statespace Models with LTPDA"></a>&nbsp;</td>
98
99 <td align="left">Introduction to Statespace Models with LTPDA</td>
100
101 <td>&nbsp;</td>
102
103 <td align="right">Building from scratch</td>
104
105 <td align="right" width="20"><a href=
106 "ssm_build_description.html"><img src="b_next.gif" border="0" align=
107 "bottom" alt="Building from scratch"></a></td>
108 </tr>
109 </table><br>
110
111 <p class="copy">&copy;LTP Team</p>
112 </body>
113 </html>