-
Notifications
You must be signed in to change notification settings - Fork 18
Expand file tree
/
Copy pathoverview.html
More file actions
272 lines (239 loc) · 8.85 KB
/
Copy pathoverview.html
File metadata and controls
272 lines (239 loc) · 8.85 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>
Overview of the DAVEtools utility packages
</title>
</head>
<body bgcolor="white">
These packages provide Java-based tools to manipulate and transform
DAVE-ML source files.
<h2>Overview</h2>
<p>There are presently three subpackages in this distribution:</p>
<ul>
<li>The <code>gov.nasa.daveml.DAVE</code> package provides a basic
utility to parse and evaluate Dynamic Aerospace Vehicle Exchange
Markup Language (DAVE-ML) files. The package provides some features as
a stand-alone program, but can be extended by other packages to add
additional capabilities.<br/><br/></li>
<li>The <code>gov.nasa.daveml.DAVE2SL</code> package builds on parsing
capabilities provided in the <code>gov.nasa.daveml.DAVE</code> package
to provide a utility to convert Dynamic Aerospace Vehicle Exchange
Markup Language (DAVE-ML) files into MATLAB® Simulink®
<code>.mdl</code> diagrams.<br/><br/></li>
<li>The <code>gov.nasa.daveml.sweeper</code> package builds on the
parsing capabilities provided by
the <code>gov.nasa.daveml.DAVE</code> package to provide a
visualization tool for a complete model; it shows 3D surface plots
of any model output as a function of any two inputs.
</li>
</ul>
<p>The DAVE2SL package requires the <code>gov.nasa.daveml.DAVE</code>
package, which in turn depends on the
<code>org.jdom</code> package, a product of the JDOM project, a
Java-based XML document parser. See
{@link <a href="http://www.jdom.org" target="_blank">http://www.jdom.org</a>} for more
information about JDOM.</p>
<p>The <b>ant</b> tool produces a single DAVEtools.jar that includes DAVE2SL
(default entry point), DAVE, ModelSweeper and the JDom and Xerces .jar contents.</p>
<p>See {@link <a href="http://daveml.org" target="_blank">http://daveml.org</a>}
for more information about the DAVE-ML standard.</p>
<p>The latest version of DAVEtools can be downloaded from {@link <a
href="http://dscb.larc.nasa.gov/Products/SW/DAVEtools.html" target="_blank">http://dscb.larc.nasa.gov/Products/SW/DAVEtools.html</a>}.</p>
<p>Copyright (c) 2007 United States Government as represented by
LAR-17460-1. No copyright is claimed in the United States under Title
17, U.S. Code. All Other Rights Reserved.</p>
<h2>Revision history</h2>
<h3>This is <em>DAVEtools</em> version 0.9.7</h3>
<h3>Changes since version 0.9.6</h3>
<ul>
<li>Added support for Logic blocks</li>
<li>
Added ignore check-case option (-x or --no-checkcase) to
both DAVE and DAVE2SL so processing will continue even if
check-cases are not passing; useful for debugging.
</li>
<li>
Reduced inter-block spacing for Simulink(r) blocks to allow
for larger models in a single diagram.
</li>
</ul>
<h3>Changes since version 0.9.5</h3>
<ul>
<li>
Changed to use newer PreLookup and Interpolation_n-D blocks
</li>
<li>
Corrected most 'if', 'while' statements in source to use
braces.
</li>
<li>
Changed exception handling to deal with syntax errors at a
lower level.
</li>
<li>
Changed order of import statements to make NetBeans happy
</li>
<li>
Deprecated <code>Block.getDests()</code> and
<code>Block.getSource()</code> in favor of
<code>getDestBlocks()</code> and
<code>getSourceBlocks()</code> to remove ambiguity of
<code>Signal</code> vs. <code>Block</code> being retrieved.
</li>
<li>
Maybe fixed vertical offset of top-level subsystem?
</li>
</ul>
<h3>Changes since version 0.9.4</h3>
<ul>
<li>
Changed behavior of -i flag to DAVE: in addition to creating
an XML snippet with internal values for any checkcase
successfully passed, it will also spit out useful intermediate
values if the -e (evaluate) flag is also used.
</li>
<li>
Corrected bug in creation command for N-d tables larger than 4
(missing comma).
</li>
</ul>
<h3>Changes since version 0.9.3</h3>
<ul>
<li>
Corrected bug in creation command for N-d tables larger than 4
(missing comma).
</li>
<li>
Added new utilities: DAVE2POST, to generate POST-II input
decks and code sections; and DAVE2OTIS, to generate OTIS4
input decks. Added FORTRAN and C code snippet writers, to
support these.
</li>
<li>
Added selectionFlag to Block and
selectOutput(), getSelectedBlocks() to Model.
</li>
<li>
Tweaked tests to run under Windows XP.
</li>
<li>
Upgraded for use with NetBeans 7.1.1 and Java SE 1.6.
</li>
<li>
Fixed incompatibility with Matlab/Simulink 2011b.
</li>
<li>
Bug fix for correct implementation of inequality operator
block in Simulink
</li>
</ul>
<h3>Changes since version 0.9.2</h3>
<ul>
<li>
Added support for MathML2's <code><min></code>,
<code><max></code>, <code><ceiling></code> and
<code><floor></code> elements. Added count of checkcases
to <code>dave</code>'s statistics summary (when used with the
<code>-c</code> option. Added support for UML diagram
generation for DAVEtools development. Separated the CHANGELOG
from the README files; the README files were rewritten to use
<a
href="http://www.medhods.co.nz/asciidoc"><code>asciidoc</code></a>.
</li>
</ul>
<h3>Changes since version 0.9.1</h3>
<ul>
<li>
Fixed bug: DAVE handles binary <code><minus></code> (as
well as unary <code><minus></code>) apply elements in
<code><variableDef></code> calculation elements.
</li>
<li>
Fixed bug: DAVE2SL saves function table data using the
<code>gtID</code> of the table (mandatory attribute as of
DAVE-ML 2.0RC4) instead of the optional <code>name</code>
attribute. Previously, unnamed tables would share the same
data array in the setup script, with bad results.
</li>
<li>
Fixed bug: exit codes are now 1 for error and 0 for no error;
these used to be non-standard -1 for no error and 0 for
error. Confused with VAX/VMS return codes, I think!
</li>
<li>
Fixed bug: ModelSweeper now doesn't bomb when looking at a
model that has no defined checkcases.
</li>
</ul>
<h3>Changes since version 0.9.0</h3>
<ul>
<li>
Support minValue and maxValue attributes on variableDef
(DAVE-ML 2.0RC4)
</li>
</ul>
<h3>Changes since version 0.8.1</h3>
<ul>
<li>
Support full use of parsing <code><piecewise></code>
elements with multiple <code><piece></code>s, per MathML
DTD. Previously DAVE was limited to a single
<code><piece></code>/<code><otherwise></code>
pair.
</li>
<li>Changed to support default DAVE-ML namespace attribute</li>
<li>Moved to Netbeans development environment</li>
<li>
Added entity definitions to template types <code>ArrayList</code> and
<code>Iterator</code>
</li>
<li>Now including JDOM and Xerces library in DAVEtools.jar file</li>
<li>
Renamed DAVE2SL.jar to DAVEtools.jar; includes DAVE, jdom, and
xerces jar-file contents in a single Jar file for a standalone
DAVE to Simulink conversion tool
</li>
<li>Added <code>ModelSweeper</code> utility program</li>
</ul>
<h3>Changes since version 0.8.0</h3>
<ul>
<li>Added support for logicals (not, and, or, xor) per MathML
DTD</li>
<li>Switched to 'ant' from 'make'</li>
</ul>
<h3>Changes since version 0.7</h3>
<ul>
<li>Added capability to extend MathML with known DAVE-ML operator atan2</li>
<li>Recognize arguments with either -c or --count (was just -c or
-count)</li>
<li>Supports immediate <ci> and <cn> subelements in a
<math> element, per MathML</li>
<li>Failing verification checkcases report miscomparing values</li>
<li>Now available under NASA open-source license.</li>
</ul>
<h3>Changes since verision 0.6</h3>
<ul>
<li>DAVE2SL now generates a _create m-script instead of .mdl file</li>
<li>Data set is now stored in model workspace instead of base
workspace</li>
<li>Added both initial unit tests and application test cases </li>
</ul>
<h3>Changes since verison 0.5</h3>
<ul>
<li>General cleanup of documentation</li>
</ul>
<p>See the individual summaries for how to use these tools.</p>
<h2>Related Documentation</h2>
<p>
For overviews, tutorials, examples, guides, and tool documentation,
please see:
</p>
<ul>
<li><a href="http://daveml.org" target="_blank">
The DAVE-ML project website</a></li>
</ul>
<!-- Put @see and @since tags down here. -->
</body>
</html>