Updated docs with what's new, etc..
diff --git a/documentation/amp.pdf b/documentation/amp.pdf
index e4835d6..f8d7bab 100644
--- a/documentation/amp.pdf
+++ b/documentation/amp.pdf
Binary files differ
diff --git a/documentation/contents/Installation_Guide.html b/documentation/contents/Installation_Guide.html
index 7287296..7b41494 100644
--- a/documentation/contents/Installation_Guide.html
+++ b/documentation/contents/Installation_Guide.html
@@ -7,7 +7,7 @@
<link rel="home" href="index.html" title="Agent Modeling Guide">
<link rel="up" href="index.html" title="Agent Modeling Guide">
<link rel="prev" href="Programer_Guide.html" title="Chapter 5. Programer Guide">
-<link rel="next" href="Resources.html" title="Chapter 7. Resources">
+<link rel="next" href="New_and_Noteworthy.html" title="Chapter 7. New and Noteworthy">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
@@ -16,7 +16,7 @@
<th align="center" colspan="3">Chapter 6. Installation Guide</th>
</tr>
<tr>
-<td align="left" width="20%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Resources.html">Next</a></td>
+<td align="left" width="20%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="New_and_Noteworthy.html">Next</a></td>
</tr>
</table>
<hr>
@@ -338,10 +338,10 @@
<hr>
<table summary="Navigation footer" width="100%">
<tr>
-<td align="left" width="40%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Resources.html">Next</a></td>
+<td align="left" width="40%"><a accesskey="p" href="Programer_Guide.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="New_and_Noteworthy.html">Next</a></td>
</tr>
<tr>
-<td valign="top" align="left" width="40%">Chapter 5. Programer Guide </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 7. Resources</td>
+<td valign="top" align="left" width="40%">Chapter 5. Programer Guide </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 7. New and Noteworthy</td>
</tr>
</table>
</div>
diff --git a/documentation/contents/New_and_Noteworthy.html b/documentation/contents/New_and_Noteworthy.html
new file mode 100644
index 0000000..8f1e77d
--- /dev/null
+++ b/documentation/contents/New_and_Noteworthy.html
@@ -0,0 +1,403 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Chapter 7. New and Noteworthy</title>
+<link href="book.css" rel="stylesheet" type="text/css">
+<meta content="DocBook XSL Stylesheets V1.75.1" name="generator">
+<link rel="home" href="index.html" title="Agent Modeling Guide">
+<link rel="up" href="index.html" title="Agent Modeling Guide">
+<link rel="prev" href="Installation_Guide.html" title="Chapter 6. Installation Guide">
+<link rel="next" href="Resources.html" title="Chapter 8. Resources">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<div class="navheader">
+<table summary="Navigation header" width="100%">
+<tr>
+<th align="center" colspan="3">Chapter 7. New and Noteworthy</th>
+</tr>
+<tr>
+<td align="left" width="20%"><a accesskey="p" href="Installation_Guide.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Resources.html">Next</a></td>
+</tr>
+</table>
+<hr>
+</div>
+<div class="chapter" title="Chapter 7. New and Noteworthy">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title">
+<a name="New_and_Noteworthy"></a>Chapter 7. New and Noteworthy</h2>
+</div>
+</div>
+</div>
+<div class="toc">
+<dl>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Release_0.8.0">Release 0.8.0</a></span>
+</dt>
+<dd>
+<dl>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Model_Visualization">Model Visualization</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Modeling_Framework">Modeling Framework</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Model_Editing">Model Editing</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Modeling_Tools">Modeling Tools</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#User_Experience">User Experience</a></span>
+</dt>
+</dl>
+</dd>
+</dl>
+</div>
+<div class="section" title="Release 0.8.0">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="Release_0.8.0"></a>Release 0.8.0</h2>
+</div>
+</div>
+</div>
+<p>The first official release of AMP includes many new or expanded features in addition to overall quality and usability improvements. The highlights are listed below.</p>
+<div class="section" title="Model Visualization">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="Model_Visualization"></a>Model Visualization</h3>
+</div>
+</div>
+</div>
+<table id="N114CD">
+<tr>
+
+<td>
+ <span class="bold"><strong>Graph Visualization</strong></span>
+ </td>
+ <td>Built in support for visualization and generation (as always with AMF, no code to write!) of graph models.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/execution/ViewGraph.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>3D View Improvements</strong></span>
+ </td>
+ <td>2 1/2 visualizations now support interpolated positions for agents. You can't see that here, but it means that the agents move smoothly through space, even if they are on a fixed grid. You can turn that feature on and off and you can change perspective easily.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/execution/View3D.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>API Improvements</strong></span>
+ </td>
+ <td>There have been significant changes to the APIs. As always, we've followed common Eclipse and EMF idioms, which means that to customize model visualization you typically only need to implement figure, shape or color providers and then adapt them to your model. And of course all of your existing models will generate code for the new APIs.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>More Legacy Views</strong></span>
+ </td>
+ <td>In addition, we've supported all existing Ascape views (not all of these are supported through AMF generated code..yet!).</td>
+
+</tr>
+</table>
+</div>
+<div class="section" title="Modeling Framework">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="Modeling_Framework"></a>Modeling Framework</h3>
+</div>
+</div>
+</div>
+<table id="N11534">
+<tr>
+
+<td>
+ <span class="bold"><strong>New Actions</strong></span>
+ </td>
+ <td>Some key new Actions have just been introduced. These provide support for recursion (Cause and Perform), minimization and maximization queries, diffusion (Diffuse) and derived (Derive) values and give the framework a much more general purpose flavor while preserving model generality. You should be able to build many more kinds of models without resorting to custom coding. See the Modeler's guide Actions section for the details.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Improved Model Representation and Generation</strong></span>
+ </td>
+ <td>There have been many improvements to how models can be designed and the code that is generated from those designs. As just one example, you can now search for agents within a model without having to specify an explicit space. As with model editing improvements, many of these changes have been driven by user input. If there is something you'd like to be able to do with AMF but can't, let us know by filing a feature request or posting to the newsgroup.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Multiscale Support</strong></span>
+ </td>
+ <td>Support for modeling across scales has been greatly improved. For the Escape target it is very easy to define models with enclosing hierarchies. For example in the EpidemicRegion model, we've defined Regions which contain Cities which contain Individuals.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/examples/EpidemicRegional.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>When the model is executed, views are automatically created for each member Scape (context) and data is collected for each level of scale.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/examples/EpidemicRegionalRun.png"></div>
+
+</td>
+
+</tr>
+</table>
+</div>
+<div class="section" title="Model Editing">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="Model_Editing"></a>Model Editing</h3>
+</div>
+</div>
+</div>
+<table id="N11597">
+<tr>
+
+<td>
+ <span class="bold"><strong>Overall Usability</strong></span>
+ </td>
+ <td>Significant effort has gone into improving the overall user interface for editing models. User feedback has been enormously helpful here -- please keep letting us know what works and what doesn't! In addition to the obvious changes, a lot of work has been done under the covers to provide a more seamless model building experience. We've fixed some glitches, but we've also added a number of things to help simplify and automate the model building process. As an example, when you create an agent, a style is automatically created along with default color, shape and paint actions.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>New Icons</strong></span>
+ </td>
+ <td>Most of the existing icons have been replaced or custom designed (which has incidentally required a lot of documentation to be recreated) to provide a better and more consistent user interface.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Action Lists</strong></span>
+ </td>
+ <td>Actions are now displayed in lists, not in a tree structure. As the actual Actions are graph structures, the tree structure never matched well with this representation. Taking a simpler approach has made the action definition process much more transparent.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/tools/ActionsExample.png"></div>
+
+</td>
+
+</tr>
+</table>
+</div>
+<div class="section" title="Modeling Tools">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="Modeling_Tools"></a>Modeling Tools</h3>
+</div>
+</div>
+</div>
+<table id="N115DD">
+<tr>
+
+<td>
+ <span class="bold"><strong>Parameter Management Support</strong></span>
+ </td>
+ <td>AMP now has full support for editing and launching of parameter files, including code completion. There is also support for creation of tests and analysis of test results. Finally, data can now be generated to a common EMD based (adata) data format.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/params/Edit.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Test-Driven Modeling and Simulation</strong></span>
+ </td>
+ <td>Tests can now easily be defined and analyzed.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/params/TestResults.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Automated Data Export</strong></span>
+ </td>
+ <td>Data can now be easily generated to a common EMF based (adata) data format.</td>
+
+</tr>
+</table>
+</div>
+<div class="section" title="User Experience">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="User_Experience"></a>User Experience</h3>
+</div>
+</div>
+</div>
+<table id="N11634">
+<tr>
+
+<td>
+ <span class="bold"><strong>Overall</strong></span>
+ </td>
+ <td>Last but certainly not least, a lot of effort has gone into making it easier to get into AMP as well as to understand how to work with its more powerful features. Eclipse supports a number of sophisticated User Assistance features, and we've taken advantage of most of them.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Documentation</strong></span>
+ </td>
+ <td>Over a 100 pages of documentation, plus another 100 pages of Ascape documentation converted to Eclipse Help and PDF.</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Welcome and Intro</strong></span>
+ </td>
+ <td>When starting AMP you'll be met by a custom welcome screen providing an easy path into Agent Modeling on Eclipse.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/users/WelcomeScreen.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Cheat Sheets</strong></span>
+ </td>
+ <td>Helpful guides walk you through initial steps.</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/users/CheatSheets.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Integrated Models</strong></span>
+ </td>
+ <td>You can run example Ascape models directly from the documentation!</td>
+
+</tr>
+<tr>
+
+<td> </td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/users/IntegratedModels.png"></div>
+
+</td>
+
+</tr>
+</table>
+</div>
+</div>
+</div>
+<div class="navfooter">
+<hr>
+<table summary="Navigation footer" width="100%">
+<tr>
+<td align="left" width="40%"><a accesskey="p" href="Installation_Guide.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Resources.html">Next</a></td>
+</tr>
+<tr>
+<td valign="top" align="left" width="40%">Chapter 6. Installation Guide </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 8. Resources</td>
+</tr>
+</table>
+</div>
+</body>
+</html>
diff --git a/documentation/contents/Resources.html b/documentation/contents/Resources.html
index bdcc622..e5c9242 100644
--- a/documentation/contents/Resources.html
+++ b/documentation/contents/Resources.html
@@ -1,32 +1,32 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Chapter 7. Resources</title>
+<title>Chapter 8. Resources</title>
<link href="book.css" rel="stylesheet" type="text/css">
<meta content="DocBook XSL Stylesheets V1.75.1" name="generator">
<link rel="home" href="index.html" title="Agent Modeling Guide">
<link rel="up" href="index.html" title="Agent Modeling Guide">
-<link rel="prev" href="Installation_Guide.html" title="Chapter 6. Installation Guide">
-<link rel="next" href="Support.html" title="Chapter 8. Support">
+<link rel="prev" href="New_and_Noteworthy.html" title="Chapter 7. New and Noteworthy">
+<link rel="next" href="Support.html" title="Chapter 9. Support">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table summary="Navigation header" width="100%">
<tr>
-<th align="center" colspan="3">Chapter 7. Resources</th>
+<th align="center" colspan="3">Chapter 8. Resources</th>
</tr>
<tr>
-<td align="left" width="20%"><a accesskey="p" href="Installation_Guide.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Support.html">Next</a></td>
+<td align="left" width="20%"><a accesskey="p" href="New_and_Noteworthy.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Support.html">Next</a></td>
</tr>
</table>
<hr>
</div>
-<div class="chapter" title="Chapter 7. Resources">
+<div class="chapter" title="Chapter 8. Resources">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Resources"></a>Chapter 7. Resources</h2>
+<a name="Resources"></a>Chapter 8. Resources</h2>
</div>
</div>
</div>
@@ -89,10 +89,10 @@
<hr>
<table summary="Navigation footer" width="100%">
<tr>
-<td align="left" width="40%"><a accesskey="p" href="Installation_Guide.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Support.html">Next</a></td>
+<td align="left" width="40%"><a accesskey="p" href="New_and_Noteworthy.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Support.html">Next</a></td>
</tr>
<tr>
-<td valign="top" align="left" width="40%">Chapter 6. Installation Guide </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 8. Support</td>
+<td valign="top" align="left" width="40%">Chapter 7. New and Noteworthy </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> Chapter 9. Support</td>
</tr>
</table>
</div>
diff --git a/documentation/contents/Support.html b/documentation/contents/Support.html
index d28b013..fbdb987 100644
--- a/documentation/contents/Support.html
+++ b/documentation/contents/Support.html
@@ -1,18 +1,18 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Chapter 8. Support</title>
+<title>Chapter 9. Support</title>
<link href="book.css" rel="stylesheet" type="text/css">
<meta content="DocBook XSL Stylesheets V1.75.1" name="generator">
<link rel="home" href="index.html" title="Agent Modeling Guide">
<link rel="up" href="index.html" title="Agent Modeling Guide">
-<link rel="prev" href="Resources.html" title="Chapter 7. Resources">
+<link rel="prev" href="Resources.html" title="Chapter 8. Resources">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table summary="Navigation header" width="100%">
<tr>
-<th align="center" colspan="3">Chapter 8. Support</th>
+<th align="center" colspan="3">Chapter 9. Support</th>
</tr>
<tr>
<td align="left" width="20%"><a accesskey="p" href="Resources.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> </td>
@@ -20,12 +20,12 @@
</table>
<hr>
</div>
-<div class="chapter" title="Chapter 8. Support">
+<div class="chapter" title="Chapter 9. Support">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Support"></a>Chapter 8. Support</h2>
+<a name="Support"></a>Chapter 9. Support</h2>
</div>
</div>
</div>
@@ -192,7 +192,7 @@
<td align="left" width="40%"><a accesskey="p" href="Resources.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> </td>
</tr>
<tr>
-<td valign="top" align="left" width="40%">Chapter 7. Resources </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> </td>
+<td valign="top" align="left" width="40%">Chapter 8. Resources </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td valign="top" align="right" width="40%"> </td>
</tr>
</table>
</div>
diff --git a/documentation/contents/Tutorials.html b/documentation/contents/Tutorials.html
index 38393bd..fd6535c 100644
--- a/documentation/contents/Tutorials.html
+++ b/documentation/contents/Tutorials.html
@@ -728,7 +728,7 @@
<div>
<div>
<h5 class="title">
-<a name="N110D3"></a>Create Select and Query Actions</h5>
+<a name="N11208"></a>Create Select and Query Actions</h5>
</div>
</div>
</div>
diff --git a/documentation/contents/User_Guide.html b/documentation/contents/User_Guide.html
index e813d79..c672f61 100644
--- a/documentation/contents/User_Guide.html
+++ b/documentation/contents/User_Guide.html
@@ -146,11 +146,14 @@
<span class="section"><a href="User_Guide.html#Executing_a_Model_.28Java_.2F_3D.29">Executing a Model (Java / 3D)</a></span>
</dt>
<dt>
-<span class="section"><a href="User_Guide.html#Controlling_Model_Execution">Controlling Model Execution</a></span>
+<span class="section"><a href="User_Guide.html#Controlling_Models">Controlling Models</a></span>
</dt>
<dd>
<dl>
<dt>
+<span class="section"><a href="User_Guide.html#Model_Execution_Controls"></a></span>
+</dt>
+<dt>
<span class="section"><a href="User_Guide.html#The_Active_Model">The Active Model</a></span>
</dt>
</dl>
@@ -180,6 +183,12 @@
<span class="section"><a href="User_Guide.html#2D_Views">2D Views</a></span>
</dt>
<dt>
+<span class="section"><a href="User_Guide.html#3D_Views">3D Views</a></span>
+</dt>
+<dt>
+<span class="section"><a href="User_Guide.html#Graph_Views">Graph Views</a></span>
+</dt>
+<dt>
<span class="section"><a href="User_Guide.html#Charts">Charts</a></span>
</dt>
</dl>
@@ -211,6 +220,9 @@
<dt>
<span class="section"><a href="User_Guide.html#Example_3">Example</a></span>
</dt>
+<dt>
+<span class="section"><a href="User_Guide.html#Model_Data">Model Data</a></span>
+</dt>
</dl>
</dd>
</dl>
@@ -952,13 +964,18 @@
<table id="N10D13">
<tr>
-<td>Launching AMF and Escape models is easy. When an AMF file is selected -- in any of the perspectives -- the toolbar and Application menus are updated to reflect the file you've selected and provide convenient access to other functions. For example, when we click on a metaabm file in the package explorer, model execution buttons appear in the toolbar. If you right-click on a file a pop-up menu appears like the one to the far right -- in this case we're selecting the "Execute Headless" option. To launch a model, just select one of the options. (Note that the execution framework doesn't know whether your code exists in an Escape project or another target project. If you attempt to execute a .metaabm model in an Ascape project for example, you will get an error.)</td>
+<td>Launching AMF and Escape models is easy. When an AMF file is selected -- in any of the perspectives -- the toolbar and Application menus are updated to reflect the file you've selected and provide convenient access to other functions. For example, when we click on a metaabm file in the package explorer, model execution buttons appear in the toolbar.</td>
<td>
<div class="mediaobject">
<img src="images/tools/EditorToolbar.png"></div>
</td>
+
+</tr>
+<tr>
+
+<td>If you right-click on a file a pop-up menu appears like the one to the far right -- in this case we're selecting the "Execute Headless" option. To launch a model, just select one of the options. (Note that the execution framework doesn't know whether your code exists in an Escape project or another target project. If you attempt to execute a .metaabm model in an Ascape project for example, you will get an error.)</td>
<td>
<div class="mediaobject">
@@ -1021,7 +1038,7 @@
</div>
</div>
</div>
-<p>You can execute any Escape model directly from its Java file by right-clicking on it. This is used for models that have been written directly in Java, or that you have created or that have been automatically generated, such as the 3D versions of AMF models. In order for the model to launch correctly, it must have as a superclass the Escape "Scape" class. In the following screenshot, we've launched a 3D version of the Epidemic model. The 3D models are automatically generated for all .metaabm models.</p>
+<p>You can execute any Escape model directly from its Java file by right-clicking on it. This is used for models that have been written directly in Java, or that you have created or that have been automatically generated, such as the 3D versions of AMF models. In order for the model to launch correctly, it must have as a superclass the Escape "Scape" class. In the following screenshot, we've launched a 3D version of the Epidemic model. The 3D models are automatically generated for all .metaabm models. You can also launch a model into 3D by clicking on the model file and clicking the second (Execute Model with 3D) execute button.</p>
<p>
</p>
@@ -1031,12 +1048,12 @@
</p>
</div>
-<div class="section" title="Controlling Model Execution">
+<div class="section" title="Controlling Models">
<div class="titlepage">
<div>
<div>
<h3 class="title">
-<a name="Controlling_Model_Execution"></a>Controlling Model Execution</h3>
+<a name="Controlling_Models"></a>Controlling Models</h3>
</div>
</div>
</div>
@@ -1045,19 +1062,64 @@
</p>
<div class="mediaobject">
-<img src="images/execution/EpidemicModelControls.png"></div>
+<img src="images/execution/ExecControl.png"></div>
<p>
</p>
+<div class="section">
+<div class="titlepage"></div>
+<div class="section" title="Model Execution Controls">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="N10D6F"></a>Model Execution Controls</h5>
+</div>
+</div>
+</div>
<p>From right to left, you can start, restart, pause, step, stop and close a model. You can even run multiple models and control them independently. You can also move views around, close them and so on as with any other Eclipse views. Here we're running two separate models for comparison.</p>
<p>
-
+
</p>
<div class="mediaobject">
<img src="images/execution/EpidemicModelComparison.png"></div>
<p>
-
+
</p>
+</div>
+<div class="section" title="Speed Slider">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Speed_Slider"></a>Speed Slider</h5>
+</div>
+</div>
+</div>
+<p>A special feature of the modeling tools is the "Speed Slider". This allows you to dynamically "speed up" and "slow down" the model execution. You can see where you've set the current speed in the status bar in the lower left hand corner of the environment.</p>
+<p>Actually, you're not controlling the speed of model
+ <span class="italic">execution</span> at all. Agent models are almost always constrained not by the time of model execution -- a typical model can execute many thousands of iterations a second -- but by the time it takes to draw visualizations. By updating the views less frequently we allow the model to run at full speed until the next visualization period. This gives the illusion that we're speeding up the model. When we slow the model down, we're inserting a wait period between each model iteration.
+ </p>
+<p>To increase model execution speed, move the slider to the right. Here we're only updating the model every 56 iterations.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/SliderRight.png"></div>
+<p>
+
+</p>
+<p>To decrease speed, move the slider to the left. Here, we're pausing between each iteration for 1.65 seconds.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/SliderLeft.png"></div>
+<p>
+
+</p>
+</div>
+</div>
<div class="section" title="The Active Model">
<div class="titlepage">
<div>
@@ -1248,6 +1310,203 @@
</div>
</div>
</div>
+<div class="section" title="3D Views">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="3D_Views"></a>3D Views</h4>
+</div>
+</div>
+</div>
+<p>The 3D views provide a three-dimensional representation of a running model. Currently they support 2D models only, which makes them 2 1/2 D views.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/View3D.png"></div>
+<p>
+
+</p>
+<p>You can navigate and customize the model with the following controls:</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/View3DMenuBar.png"></div>
+<p>
+
+</p>
+<p>From left to right, they are:</p>
+<div class="section" title="Animation">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Animation"></a>Animation</h5>
+</div>
+</div>
+</div>
+<p>Turns on and off the interpolated (smooth) movement of agents from one cell to another. This is a unique feature of AMP and provides a very nice visualization, but it does slow down model execution. For very large models, you can switch it off -- visualization will be "jerky" but much quicker.</p>
+</div>
+<div class="section" title="Perspectives">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Perspectives"></a>Perspectives</h5>
+</div>
+</div>
+</div>
+<p>The three perspectives are used to control the camera location -- in other words the perspective from which the movie is being made. Note that if the camera is currently moving to a given perspective and you select a new perspective the camera may become confused! It is best to wait until the camera comes to a stop before choosing a different perspective. You can speed up camera movement by pausing the model temporarily.</p>
+<div class="section" title="First Person">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="First_Person"></a>First Person</h6>
+</div>
+</div>
+</div>
+<p>Moves the point of view to ground level, as if the observer were in the space itself.</p>
+</div>
+<div class="section" title="Overhead">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Overhead"></a>Overhead</h6>
+</div>
+</div>
+</div>
+<p>Moves the point of view to overhead, giving a similar view as you have with the 2D view. Note that in many cases the 3D view is actually faster than the 2D view, so this is a good way to observe any kind of 2D model.</p>
+</div>
+<div class="section" title="Helicopter">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Helicopter"></a>Helicopter</h6>
+</div>
+</div>
+</div>
+<p>Moves the point to an oblique perspective. This is useful for getting an overall sense of model behavior.</p>
+</div>
+</div>
+</div>
+<div class="section" title="Graph Views">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Graph_Views"></a>Graph Views</h4>
+</div>
+</div>
+</div>
+<p>Graph views allow you to undestand the network relationships between various agents in the model. By default, a graph is creaed for all relationships, but you can customize that behavior programmatically. Graphs are also super-imposed on 2D models, as we can see in the following example running the EpidemicContact model.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/ViewGraph.png"></div>
+<p>
+
+</p>
+<p>Note that complex models can take a long time to visualize and we'll be looking for opportuntites to optimize performance further in the future. If you think the visualization is stuck it is likely that it is simply calculating the next visualization step -- wait a bit before canceling the model or closing it.</p>
+<p>Graph views can be customized with the following controls:</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/execution/View3DMenuBar.png"></div>
+<p>
+
+</p>
+<p>From left to right, they are:</p>
+<div class="section" title="Layout">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Layout"></a>Layout</h5>
+</div>
+</div>
+</div>
+<p>The layout buttons control how the nodes are placed within the graph. You can swithc between layout dynamically to gain insight into network relationships.</p>
+<table id="N10E83">
+<tr>
+
+<td>
+
+<div class="mediaobject">
+<img src="images/execution/ViewGraphDown.png"></div>
+
+</td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/execution/ViewGraphRight.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Tree (Down):</strong></span> Places the graph nodes into a downward oriented tree formation. You'll find that the tree views are more effecient at visualizing, and can be very ood at representing models with an inherent hierarchical structure such as kinship diagrams, but don't always give the best insight into the model for complex network relations.
+ </td>
+ <td>
+ <span class="bold"><strong>Tree (Right):</strong></span> The same tree layout oriented from the root-most nodes rightward.
+ </td>
+
+</tr>
+<tr>
+
+<td>
+
+<div class="mediaobject">
+<img src="images/execution/ViewGraphRadial.png"></div>
+
+</td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/execution/ViewGraphSpring.png"></div>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Radial:</strong></span> Places the nodes in a radial layout with the root-most nodes at the center. This is a great way to represent semi-hierarchical models with complex structure, but is a little slower than the tree layouts.
+ </td>
+ <td>
+ <span class="bold"><strong>Spring:</strong></span> This layout uses a spring and strain approach that allows nodes to find their own location within the visualization. It can provide beautiful and insightful diagrams, but it is also slower than the other layouts. For more complex models it often works well to use the radial layout and then switch to the Spring layout when examining relationships in depth.
+ </td>
+
+</tr>
+</table>
+</div>
+<div class="section" title="Spring Layout Customization">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Spring_Layout_Customization"></a>Spring Layout Customization</h5>
+</div>
+</div>
+</div>
+<p>You can customize how the Spring by clicking on the customization button. This allows you to change a number of values that determine how nodes are layed out. While the default settings work well with many graph structures it can be helpful (and fun) to play with different settings to get the best visualization.
+ |
+ </p>
+<div class="mediaobject">
+<img src="images/execution/ViewGraphSpringDialog.png"></div>
+<p>
+
+</p>
+</div>
+</div>
<div class="section" title="Charts">
<div class="titlepage">
<div>
@@ -1278,32 +1537,60 @@
</div>
</div>
<p>Several chart types are supported: The line, area, bar and pie chart. Click on one of the icons to select that type.</p>
-<p>
-
-</p>
+<table id="N10EFA">
+<tr>
+
+<td>
+
<div class="mediaobject">
<img src="images/execution/LineChart.png"></div>
-<p>
-
-
-</p>
+
+</td>
+ <td>
+
<div class="mediaobject">
<img src="images/execution/AreaChart.png"></div>
-<p>
-
+
+</td>
-</p>
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Line</strong></span>
+ </td>
+ <td>
+ <span class="bold"><strong>Area</strong></span>
+ </td>
+
+</tr>
+<tr>
+
+<td>
+
<div class="mediaobject">
<img src="images/execution/BarChart.png"></div>
-<p>
-
-
-</p>
+
+</td>
+ <td>
+
<div class="mediaobject">
<img src="images/execution/PieChart.png"></div>
-<p>
-
-</p>
+
+</td>
+
+</tr>
+<tr>
+
+<td>
+ <span class="bold"><strong>Bar</strong></span>
+ </td>
+ <td>
+ <span class="bold"><strong>Pie</strong></span>
+ </td>
+
+</tr>
+</table>
</div>
<div class="section" title="Chart Legend">
<div class="titlepage">
@@ -1548,6 +1835,29 @@
</div>
<p>Here we have a nice description, a reference to the parameterization we want to use, and then the set of constraints we will apply to them. After running this test, a test result file like the one above will be created and placed in our "test-results" directory.</p>
</div>
+<div class="section" title="Model Data">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Model_Data"></a>Model Data</h4>
+</div>
+</div>
+</div>
+<table id="N1101A">
+<tr>
+
+<td>As discussed above, you can collect data for any model by selecting it or a paramters file and clicking the "Execute Model with data collection" button. If you use a parameters file setting the StopPeriod parameter will cause the model to stop executing and save the model at the specified time. Or you can stop the model manually. The model data will be collected into an "adata" file and stored in the "output" directory in your project. A new run entry will be created for each execution of a model. We are currently developing tools for exporting this data to various file formats as well as providing more seemless integration to sophisticated Eclipse hosted charting and report tools. You can use BIRT to interact with the data set using an XML schema data source and there is also an Ecore driver available. Model data can also be produced by writing custom views for data output. See the Ascape programmer guide for more information on how to do that.</td>
+ <td>
+
+<div class="mediaobject">
+<img src="images/data/Editor.png"></div>
+
+</td>
+
+</tr>
+</table>
+</div>
</div>
</div>
</div>
diff --git a/documentation/contents/images/data/Editor.png b/documentation/contents/images/data/Editor.png
new file mode 100644
index 0000000..7566c3e
--- /dev/null
+++ b/documentation/contents/images/data/Editor.png
Binary files differ
diff --git a/documentation/contents/images/examples/EpidemicRegional.png b/documentation/contents/images/examples/EpidemicRegional.png
new file mode 100644
index 0000000..3da8c63
--- /dev/null
+++ b/documentation/contents/images/examples/EpidemicRegional.png
Binary files differ
diff --git a/documentation/contents/images/examples/EpidemicRegionalRun.png b/documentation/contents/images/examples/EpidemicRegionalRun.png
new file mode 100644
index 0000000..d7c5acd
--- /dev/null
+++ b/documentation/contents/images/examples/EpidemicRegionalRun.png
Binary files differ
diff --git a/documentation/contents/images/execution/AreaChart.png b/documentation/contents/images/execution/AreaChart.png
index 4a7bda9..8d44180 100644
--- a/documentation/contents/images/execution/AreaChart.png
+++ b/documentation/contents/images/execution/AreaChart.png
Binary files differ
diff --git a/documentation/contents/images/execution/BarChart.png b/documentation/contents/images/execution/BarChart.png
index ee0b0f9..016271c 100644
--- a/documentation/contents/images/execution/BarChart.png
+++ b/documentation/contents/images/execution/BarChart.png
Binary files differ
diff --git a/documentation/contents/images/execution/Epidemic3D.png b/documentation/contents/images/execution/Epidemic3D.png
index 0f2cb94..09d690b 100644
--- a/documentation/contents/images/execution/Epidemic3D.png
+++ b/documentation/contents/images/execution/Epidemic3D.png
Binary files differ
diff --git a/documentation/contents/images/execution/ExecControl.png b/documentation/contents/images/execution/ExecControl.png
new file mode 100644
index 0000000..0d2b089
--- /dev/null
+++ b/documentation/contents/images/execution/ExecControl.png
Binary files differ
diff --git a/documentation/contents/images/execution/LineChart.png b/documentation/contents/images/execution/LineChart.png
index ca746d6..20c4273 100644
--- a/documentation/contents/images/execution/LineChart.png
+++ b/documentation/contents/images/execution/LineChart.png
Binary files differ
diff --git a/documentation/contents/images/execution/PieChart.png b/documentation/contents/images/execution/PieChart.png
index 1c8df01..baf6afe 100644
--- a/documentation/contents/images/execution/PieChart.png
+++ b/documentation/contents/images/execution/PieChart.png
Binary files differ
diff --git a/documentation/contents/images/execution/SliderLeft.png b/documentation/contents/images/execution/SliderLeft.png
new file mode 100644
index 0000000..2219715
--- /dev/null
+++ b/documentation/contents/images/execution/SliderLeft.png
Binary files differ
diff --git a/documentation/contents/images/execution/SliderRight.png b/documentation/contents/images/execution/SliderRight.png
new file mode 100644
index 0000000..cc94f08
--- /dev/null
+++ b/documentation/contents/images/execution/SliderRight.png
Binary files differ
diff --git a/documentation/contents/images/execution/View3D.png b/documentation/contents/images/execution/View3D.png
new file mode 100644
index 0000000..5d90024
--- /dev/null
+++ b/documentation/contents/images/execution/View3D.png
Binary files differ
diff --git a/documentation/contents/images/execution/View3DMenuBar.png b/documentation/contents/images/execution/View3DMenuBar.png
new file mode 100644
index 0000000..5f41c7a
--- /dev/null
+++ b/documentation/contents/images/execution/View3DMenuBar.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraph.png b/documentation/contents/images/execution/ViewGraph.png
new file mode 100644
index 0000000..ddb87b2
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraph.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphDown.png b/documentation/contents/images/execution/ViewGraphDown.png
new file mode 100644
index 0000000..c867c57
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphDown.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphMenuBar.png b/documentation/contents/images/execution/ViewGraphMenuBar.png
new file mode 100644
index 0000000..c2b7d81
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphMenuBar.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphRadial.png b/documentation/contents/images/execution/ViewGraphRadial.png
new file mode 100644
index 0000000..9bed7c6
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphRadial.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphRight.png b/documentation/contents/images/execution/ViewGraphRight.png
new file mode 100644
index 0000000..0ebef6c
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphRight.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphSpring.png b/documentation/contents/images/execution/ViewGraphSpring.png
new file mode 100644
index 0000000..2d7d031
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphSpring.png
Binary files differ
diff --git a/documentation/contents/images/execution/ViewGraphSpringDialog.png b/documentation/contents/images/execution/ViewGraphSpringDialog.png
new file mode 100644
index 0000000..7f6e8d6
--- /dev/null
+++ b/documentation/contents/images/execution/ViewGraphSpringDialog.png
Binary files differ
diff --git a/documentation/contents/images/tools/EditorToolbar.png b/documentation/contents/images/tools/EditorToolbar.png
index 2354aa2..f9b1d5d 100644
--- a/documentation/contents/images/tools/EditorToolbar.png
+++ b/documentation/contents/images/tools/EditorToolbar.png
Binary files differ
diff --git a/documentation/contents/images/users/CheatSheets.png b/documentation/contents/images/users/CheatSheets.png
new file mode 100644
index 0000000..5152ab8
--- /dev/null
+++ b/documentation/contents/images/users/CheatSheets.png
Binary files differ
diff --git a/documentation/contents/images/users/IntegratedModels.png b/documentation/contents/images/users/IntegratedModels.png
new file mode 100644
index 0000000..296f15d
--- /dev/null
+++ b/documentation/contents/images/users/IntegratedModels.png
Binary files differ
diff --git a/documentation/contents/images/users/WelcomeScreen.png b/documentation/contents/images/users/WelcomeScreen.png
new file mode 100644
index 0000000..514da7f
--- /dev/null
+++ b/documentation/contents/images/users/WelcomeScreen.png
Binary files differ
diff --git a/documentation/contents/index.html b/documentation/contents/index.html
index 9758b11..a7570cb 100644
--- a/documentation/contents/index.html
+++ b/documentation/contents/index.html
@@ -220,7 +220,7 @@
<span class="section"><a href="User_Guide.html#Executing_a_Model_.28Java_.2F_3D.29">Executing a Model (Java / 3D)</a></span>
</dt>
<dt>
-<span class="section"><a href="User_Guide.html#Controlling_Model_Execution">Controlling Model Execution</a></span>
+<span class="section"><a href="User_Guide.html#Controlling_Models">Controlling Models</a></span>
</dt>
<dt>
<span class="section"><a href="User_Guide.html#Views_2">Views</a></span>
@@ -405,7 +405,36 @@
</dl>
</dd>
<dt>
-<span class="chapter"><a href="Resources.html">7. Resources</a></span>
+<span class="chapter"><a href="New_and_Noteworthy.html">7. New and Noteworthy</a></span>
+</dt>
+<dd>
+<dl>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Release_0.8.0">Release 0.8.0</a></span>
+</dt>
+<dd>
+<dl>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Model_Visualization">Model Visualization</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Modeling_Framework">Modeling Framework</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Model_Editing">Model Editing</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#Modeling_Tools">Modeling Tools</a></span>
+</dt>
+<dt>
+<span class="section"><a href="New_and_Noteworthy.html#User_Experience">User Experience</a></span>
+</dt>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt>
+<span class="chapter"><a href="Resources.html">8. Resources</a></span>
</dt>
<dd>
<dl>
@@ -418,7 +447,7 @@
</dl>
</dd>
<dt>
-<span class="chapter"><a href="Support.html">8. Support</a></span>
+<span class="chapter"><a href="Support.html">9. Support</a></span>
</dt>
<dd>
<dl>
