0
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 1 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 2 Some features of the LTPDA Toolbox require additional 3rd-party software to be installed. These are listed below.
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 3 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 4 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 5 <hr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 6 <h2>Graphviz</h2>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 7
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 8 <p>In order to use the commands listed below, the <a href="matlab:web('http://www.graphviz.org/')">Graphviz</a> package must be installed.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 9
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 10 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 11 <table cellspacing="0" class="body" cellpadding="4" border="2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 12 <colgroup>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 13 <col width="37%"/>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 14 <col width="63%"/>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 15 </colgroup>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 16 <thead>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 17 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 18 <th bgcolor="#B2B2B2">Method</th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 19 <th bgcolor="#B2B2B2">Description</th>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 20 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 21 </thead>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 22 <tbody>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 23
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 24 <!-- history/dotview -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 25 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 26 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 27 <p><tt>history/dotview</tt></p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 28 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 29 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 30 <p>Convert a history object to a tree-diagram using the DOT interpreter.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 31 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 32 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 33
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 34 <!-- ssm/dotview -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 35 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 36 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 37 <p><tt>ssm/dotview</tt></p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 38 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 39 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 40 <p>Convert the statespace model object to a block-diagram using the DOT interpreter.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 41 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 42 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 43
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 44 <!-- report -->
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 45 <tr valign="top">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 46 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 47 <p><tt>report</tt></p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 48 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 49 <td bgcolor="#F2F2F2">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 50 <p>Generates a HTML report about the input objects which includes a DOT block-diagram of the history.</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 51 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 52 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 53
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 54 </tbody>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 55 </table>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 56 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 57
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 58 <p>The following installation guidelines can be used for different platforms</p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 59 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 60 <li><p><a href="#windows"/>Installation Guide for Windows</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 61 <li><p><a href="#mac"/>Installation Guide for Mac OS X</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 62 <li><p><a href="#linux"/>Installation Guide for Linux</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 63 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 64
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 65 <h3><a name="windows"/> Windows </h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 66
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 67 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 68 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 69 <li><p>Download the relevant package from Downloads section of <a href="matlab:web('http://www.graphviz.org/')">www.graphviz.org</a>.</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 70 <li><p>Install the package by following the relevant instructions.</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 71 <li><p>Set the two relevant preferences with your LTPDA Preferences Panel</p></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 72 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 73 <li>For this start the LTPDApres<br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 74 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 75 <table cellspacing="0" class="note" summary="Note" cellpadding="5" border="1">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 76 <tr width="90%">
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 77 <td>>> LTPDAprefs
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 78 </td>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 79 </tr>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 80 </table>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 81 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 82 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 83 <li>or press the "LTPDA Preferences" button on the LTPDA Launch Bay<br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 84 <br></br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 85 <img src="images/LTPDAlauncher.png" alt="Interpolate" border="0"></img>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 86 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 87 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 88 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 89 <li style="margin-top:1ex">Select on your LTPDA Preferences Panel the category "External Programs"<br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 90 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 91 <img src="images/LTPDAprefs_ExtProg.png" alt="Interpolate" border="0"></img> <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 92 <br />
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 93 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 94 <li style="margin-top:1ex">Set the path to the 'dot.exe' binary in the editable text field "DOT binary". If you perform the default installation, this should be something like:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 95 <br>'c:\Program Files\Graphviz2.20\bin\dot.exe';</br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 96 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 97 <li>Define in the editable text field "DOT format" the graphics format to output. See <a href="matlab:web('http://www.graphviz.org/doc/info/output.html')">formats</a> for available formats. To view the final graphics file you must have a suitable viewer for that graphics format installed on the system. For example, to output as PDF
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 98 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 99 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 100 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 101 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 102
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 103 <h3><a name="mac"/> Mac OS X </h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 104 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 105 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 106 <li>Choose from:</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 107 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 108 <li> From graphviz:</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 109 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 110 <li>Download the relevant package from Downloads section of <a href="matlab:web('http://www.graphviz.org/')">www.graphviz.org</a>.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 111 <li>Install the package by following the relevant instructions.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 112 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 113 <li> From Fink:</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 114 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 115 <li> If you use the fink package manager, in a terminal: <tt>> fink install graphviz</tt></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 116 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 117 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 118 <li>Set the two relevant preferences with your LTPDA Preferences Panel.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 119 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 120 <li>Start the LTPDA Preferences Panel. For this follow the step 3.1 or 3.2 of the window installation.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 121 <li>Set the path to the 'dot' binary in the editable text field "DOT binary". If you perform the default installation from fink, this should be something like:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 122 <br>'/sw/bin/dot'</br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 123 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 124 <li>Define in the editable text field "DOT format" the graphics format to output. See <a href="matlab:web('http://www.graphviz.org/doc/info/output.html')">formats</a> for available formats. To view the final graphics file you must have a suitable viewer for that graphics format installed on the system. For example, to output as PDF
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 125 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 126 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 127 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 128 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 129
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 130 <h3><a name="linux"/> Linux </h3>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 131
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 132 <p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 133 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 134 <li>Choose from:</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 135 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 136 <li> From graphviz:</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 137 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 138 <li>Download the relevant package from Downloads section of <a href="matlab:web('http://www.graphviz.org/')">www.graphviz.org</a>.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 139 <li>Install the package by following the relevant instructions.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 140 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 141 <li> From terminal (Ubuntu):</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 142 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 143 <li>Please type in a terminal: <tt>>sudo apt-get install graphviz</tt></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 144 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 145 <li> From graphical package manager like <b>YaSt, Synaptic, Adept, ...</b></li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 146 <ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 147 <li>Start your graphical package manager</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 148 <li>Search for the <tt>>graphviz</tt> package</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 149 <li>Select the package and all depending packes and install these packages.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 150 </ul>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 151 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 152 <li>Set the two relevant preferences with your LTPDA Preferences Panel.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 153 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 154 <li>Start the LTPDA Preferences Panel. For this follow the step 3.1 or 3.2 of the window installation.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 155 <li>Set the path to the 'dot' binary in the editable text field "DOT binary". If you perform the default installation from the terminal, this should be something like:
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 156 <br>'/usr/bin/dot';</br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 157 <br>even 'dot' without the path should work</br>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 158 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 159 <li>Define in the editable text field "DOT format" the graphics format to output. See <a href="matlab:web('http://www.graphviz.org/doc/info/output.html')">formats</a> for available formats. To view the final graphics file you must have a suitable viewer for that graphics format installed on the system. For example, to output as PDF
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 160 </li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 161 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 162 <li>Define a programm in MATLAB which opens the file.</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 163 <ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 164 <li>The default programm to open a pdf file is the Acrobat Reader</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 165 <li>Define another program under File -> Preferences -> Help -> PDF Reader</li>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 166 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 167 </ol>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 168 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 169 </p>
Daniele Nicolodi <nicolodi@science.unitn.it>
parents:
diff
changeset
+ − 170