Docs update.
diff --git a/documentation/amp.html b/documentation/amp.html
index 0b23189..3fe050f 100644
--- a/documentation/amp.html
+++ b/documentation/amp.html
@@ -22,7 +22,36 @@
</p>
<dl>
<dt>
-<span class="chapter"><a href="#Modeler.27s_Guide">1. Modeler's Guide</a></span>
+<span class="chapter"><a href="#Overview">1. Overview</a></span>
+</dt>
+<dd>
+<dl>
+<dt>
+<span class="section"><a href="#Architecture">Architecture</a></span>
+</dt>
+</dl>
+</dd>
+<dt>
+<span class="chapter"><a href="#Getting_Started">2. Getting Started</a></span>
+</dt>
+<dd>
+<dl>
+<dt>
+<span class="section"><a href="#ABM_Modelers">ABM Modelers</a></span>
+</dt>
+<dt>
+<span class="section"><a href="#ABM_Researchers">ABM Researchers</a></span>
+</dt>
+<dt>
+<span class="section"><a href="#ABM_Java_Developers">ABM Java Developers</a></span>
+</dt>
+<dt>
+<span class="section"><a href="#Eclipse_Plugin_Developers">Eclipse Plugin Developers</a></span>
+</dt>
+</dl>
+</dd>
+<dt>
+<span class="chapter"><a href="#Modeler.27s_Guide">3. Modeler's Guide</a></span>
</dt>
<dd>
<dl>
@@ -41,28 +70,28 @@
</dl>
</dd>
<dt>
-<span class="chapter"><a href="#Creating_Agent_Models">2. Creating Agent Models</a></span>
+<span class="chapter"><a href="#Creating_Agent_Models">4. Creating Agent Models</a></span>
</dt>
<dd>
<dl>
<dt>
-<span class="section"><a href="#Getting_Started">Getting Started</a></span>
+<span class="section"><a href="#Getting_Started_2">Getting Started</a></span>
</dt>
</dl>
</dd>
<dt>
-<span class="chapter"><a href="#Exploring_Agent_Models">3. Exploring Agent Models</a></span>
+<span class="chapter"><a href="#Exploring_Agent_Models">5. Exploring Agent Models</a></span>
</dt>
<dt>
-<span class="chapter"><a href="#Programer.27s_Guide">4. Programer's Guide</a></span>
+<span class="chapter"><a href="#Programer.27s_Guide">6. Programer's Guide</a></span>
</dt>
<dd>
<dl>
<dt>
-<span class="section"><a href="#Overview">Overview</a></span>
+<span class="section"><a href="#Overview_5">Overview</a></span>
</dt>
<dt>
-<span class="section"><a href="#Getting_Started_2">Getting Started</a></span>
+<span class="section"><a href="#Getting_Started_3">Getting Started</a></span>
</dt>
<dt>
<span class="section"><a href="#Installation">Installation</a></span>
@@ -76,7 +105,7 @@
</dl>
</dd>
<dt>
-<span class="chapter"><a href="#Reference_4">5. Reference</a></span>
+<span class="chapter"><a href="#Reference_3">7. Reference</a></span>
</dt>
<dd>
<dl>
@@ -86,7 +115,7 @@
</dl>
</dd>
<dt>
-<span class="chapter"><a href="#More_Information">6. More Information</a></span>
+<span class="chapter"><a href="#More_Information">8. More Information</a></span>
</dt>
<dd>
<dl>
@@ -97,12 +126,118 @@
</dd>
</dl>
</div>
-<div class="chapter" title="Chapter 1. Modeler's Guide">
+<div class="chapter" title="Chapter 1. Overview">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Modeler.27s_Guide"></a>Chapter 1. Modeler's Guide</h2>
+<a name="Overview"></a>Chapter 1. Overview</h2>
+</div>
+</div>
+</div>
+<p>The Eclipse Agent Modeling Project (AMP) provides extensible frameworks and exemplary tools for representing, editing, generating,
+ executing and visualizing agent-based models (ABMs) and any other domain requiring spatial, behavioral and functional features. </p>
+<div class="section" title="Architecture">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="Architecture"></a>Architecture</h2>
+</div>
+</div>
+</div>
+<p>AMP has two main themes that complement but don't depend on one another: </p>
+<p>The overall AMP architecture and Eclipse project dependencies are summarized below:</p>
+<p>
+
+<a class="ulink" href="/wiki/image:AMPArchitectureDiagram.jpg" target="_new">image:AMPArchitectureDiagram.jpg</a>
+
+</p>
+</div>
+</div>
+<div class="chapter" title="Chapter 2. Getting Started">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title">
+<a name="Getting_Started"></a>Chapter 2. Getting Started</h2>
+</div>
+</div>
+</div>
+<p>AMP has many potential facets and use cases. Here are a few ways to get started with it.</p>
+<p>First, if you aren't using a full download version of AMP, you'll need to
+ <a class="ulink" href="http://eclipse.org/amp/installing/" target="_new">install it</a>. Then...
+ </p>
+<div class="section" title="ABM Modelers">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="ABM_Modelers"></a>ABM Modelers</h2>
+</div>
+</div>
+</div>
+<p>Experiment with example Java and AMF based models without writing code.</p>
+<p>
+
+<a class="ulink" href="/wiki/AMP/Running_Examples" target="_new">Run Example Models</a>
+
+</p>
+</div>
+<div class="section" title="ABM Researchers">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="ABM_Researchers"></a>ABM Researchers</h2>
+</div>
+</div>
+</div>
+<p>Create Agent-Based models using simple visual tools and deploy them to a number of popular ABM platforms, including Escape.</p>
+<p>
+
+<a class="ulink" href="/wiki/AMP/UserGuide/AMF#Getting_Started" target="_new">Modeling with AMF</a>
+
+</p>
+</div>
+<div class="section" title="ABM Java Developers">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="ABM_Java_Developers"></a>ABM Java Developers</h2>
+</div>
+</div>
+</div>
+<p>Write POJO Java models within a full-featured agent-based modeling framework.</p>
+<p>
+
+<a class="ulink" href="/wiki/AMP/UserGuide/Escape#Getting_Started" target="_new">Programming with Escape</a>
+
+</p>
+</div>
+<div class="section" title="Eclipse Plugin Developers">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="Eclipse_Plugin_Developers"></a>Eclipse Plugin Developers</h2>
+</div>
+</div>
+</div>
+<p>AXF and AGF provide a number of features based around Eclipse technologies such as GEF, GEF3D, BIRT Charts and Zest. For example, AGF supports dynamic visualization of objects in space, and AXF supports managed UI and headless execution for models of any kind.</p>
+<p>
+
+<a class="ulink" href="/wiki/AMP/AGF_AXF_API" target="_new">Programming with AXF and AGF</a> (todo)
+ </p>
+</div>
+</div>
+<div class="chapter" title="Chapter 3. Modeler's Guide">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title">
+<a name="Modeler.27s_Guide"></a>Chapter 3. Modeler's Guide</h2>
</div>
</div>
</div>
@@ -225,12 +360,12 @@
</div>
</div>
</div>
-<div class="section" title="Design">
+<div class="section" title="Overview">
<div class="titlepage">
<div>
<div>
<h3 class="title">
-<a name="Design"></a>Design</h3>
+<a name="Overview_2"></a>Overview</h3>
</div>
</div>
</div>
@@ -430,7 +565,7 @@
</div>
</div>
<p>These can be anyone of the following: </p>
-<table id="N100E0">
+<table id="N10130">
<tr>
<td>Boolean</td>
@@ -824,12 +959,12 @@
</div>
</div>
<p>Actions are the most important part of an agent model. While Agents, Attributes and Spaces define what we're modeling, it is Actions that give the models life.</p>
-<div class="section" title="Background">
+<div class="section" title="Overview">
<div class="titlepage">
<div>
<div>
<h3 class="title">
-<a name="Background"></a>Background</h3>
+<a name="Overview_3"></a>Overview</h3>
</div>
</div>
</div>
@@ -855,7 +990,7 @@
<div>
<div>
<h3 class="title">
-<a name="Design_2"></a>Design</h3>
+<a name="Design"></a>Design</h3>
</div>
</div>
</div>
@@ -1640,6 +1775,15 @@
</div>
</div>
</div>
+<div class="section" title="Overview">
+<div class="titlepage">
+<div>
+<div>
+<h3 class="title">
+<a name="Overview_4"></a>Overview</h3>
+</div>
+</div>
+</div>
<p>Functions are relatively simple in terms of model design, but we need to understand how particular functions work in order to develop models. Functions are divided in two ways. By type:</p>
<div class="orderedlist">
<ol class="orderedlist" type="1">
@@ -1662,37 +1806,29 @@
</li>
</ol>
</div>
-<p>These overlap, so we have operators, logical operators, functions and logical functions.</p>
-<p>Functions are also divided into categories, as we'll see.</p>
+<p>These overlap, so we have operators, logical operators, functions and logical functions. Functions are also divided into categories. We'll go through each of these in depth below.</p>
+<p>The most important thing to point out about functions is that - as we've seen with other Acore concepts -- they provide richer sets of functionality than traditional approaches. Many functions are designed to collaborate with one another as we'll see when looking at Spatial and Graphical functions. Functions can also trigger the creation of related model artifacts as we'll see with the Distribution functions.</p>
<p>A technical note: conceptually, functions can return multi-values, but that is not currently implemented in the reference targets because of limitations of the target language Java.</p>
-<div class="section" title="Reference">
+</div>
+<div class="section" title="Details">
<div class="titlepage">
<div>
<div>
<h3 class="title">
-<a name="Reference_3"></a>Reference</h3>
+<a name="Details_5"></a>Details</h3>
</div>
</div>
</div>
-<div class="section" title="Function Library">
+<div class="section" title="General Functions">
<div class="titlepage">
<div>
<div>
<h4 class="title">
-<a name="Function_Library"></a>Function Library</h4>
+<a name="General_Functions"></a>General Functions</h4>
</div>
</div>
</div>
-<div class="section" title="Operators">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title">
-<a name="Operators"></a>Operators</h5>
-</div>
-</div>
-</div>
-</div>
+<p>Naturally, the Modeling tools provide general functions for performing calculations, comparisons and more complex mathematical expressions. The function library can be easily extended, and we'll be adding additional capabilities over time. As always, we welcome feedback and we'd like to hear what functions you need that aren't covered here.</p>
<div class="section" title="Logical Operators">
<div class="titlepage">
<div>
@@ -1966,585 +2102,6 @@
<p>The result of the expression o.</p>
</div>
</div>
-<div class="section" title="Spatial">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title">
-<a name="Spatial"></a>Spatial</h5>
-</div>
-</div>
-</div>
-<div class="section" title="Nearest">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Nearest"></a>Nearest</h6>
-</div>
-</div>
-</div>
-<p>Represents the nearest agents (including gird cells) or locations to this agent. If more than one agent or location is the same distance away they will all be considered. Note that while this function is defined for the selection of an agent, the result of this function is defined by the context within which it is used. If the selection specifies another agent within a space, this function will represent the nearest agent in that space. If the selection specifies a Cell within a grid space, this function will represent that cell.</p>
-</div>
-<div class="section" title="Toward">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Toward"></a>Toward</h6>
-</div>
-</div>
-</div>
-<p>Represents a location that is on the shortest path to a particular agent or location from the source agent (that is, the selection's selection's agent). This function collaborates with the within and neighbor functions to allow the agent to move in a particular direction towards some objective.</p>
-</div>
-<div class="section" title="Within">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Within"></a>Within</h6>
-</div>
-</div>
-</div>
-<p>Represents a limit to the distance of a spatial search. When used in combination with other spatial functions such as "nearest" requires that all agents or locations must be within the distance specified by the input value.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Numeral] <br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Neighbor">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Neighbor"></a>Neighbor</h6>
-</div>
-</div>
-</div>
-<p>Represents any agents that are nearest neighbors to the agent, that is nominally of distance 1. This function is only relevant in discrete spaces -- grids and networks -- where there are immediate neighboring cells as defined by the geometry of the selection's space.</p>
-</div>
-<div class="section" title="Include Self">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Include_Self"></a>Include Self</h6>
-</div>
-</div>
-</div>
-<p>Specifies whether the agent that we are searching from -- that is, the agent of the selection for this Query Action's selection -- is included in the results of the search.</p>
-</div>
-<div class="section" title="Within 2D Boundary">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Within_2D_Boundary"></a>Within 2D Boundary</h6>
-</div>
-</div>
-</div>
-<p>Represents agents or locations that exist within the boundary specified by the inputs.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Numeral] <br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Here">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Here"></a>Here</h6>
-</div>
-</div>
-</div>
-<p>Represents the location of the searching agent. For example, if a selection is defined for an agent cell, and that selection's selection's agent is an occupant of a cell, the cell that the agent is occupying will be used. </p>
-</div>
-<div class="section" title="Available">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Available"></a>Available</h6>
-</div>
-</div>
-</div>
-<p>Represents cells which are not currently occupied. This function is only relevant for grids which are not multi-occupant.</p>
-</div>
-<div class="section" title="Distance">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Distance"></a>Distance</h6>
-</div>
-</div>
-</div>
-<p>The distance between the source agent and an agent represented by this selection. If more than one agent is represented by the other functions in the selection, this function will the distance to an arbitrary (randomly selected) agent as defined by those other functions.</p>
-<div class="literallayout">
-<p>Outputs:<br>
-[Real] <br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Away">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Away"></a>Away</h6>
-</div>
-</div>
-</div>
-<p>Represents a location that is on the path that will take the source agent (that is, the selection's selection's agent) the farthest distance from the agent(s) represented by the search. This function collaborates with the within and neighbor functions to allow the agent to move in a particular direction away from some location or agent.</p>
-</div>
-<div class="section" title="Minimize">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Minimize"></a>Minimize</h6>
-</div>
-</div>
-</div>
-<p>This function is not currently supported.</p>
-</div>
-<div class="section" title="Maximize">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Maximize"></a>Maximize</h6>
-</div>
-</div>
-</div>
-<p>This function is not currently supported.</p>
-</div>
-<div class="section" title="Location 2D">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Location_2D"></a>Location 2D</h6>
-</div>
-</div>
-</div>
-<p>Represents the location of the current agent for use in subsequent selections.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Real] <br>
-[Real] <br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Boundary 2D">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Boundary_2D"></a>Boundary 2D</h6>
-</div>
-</div>
-</div>
-<p>Represents a two-dimensional boundary within a space. (Not currently relevant for any general usages.)</p>
-<div class="literallayout">
-<p>Outputs:<br>
-[Real] <br>
-[Real] <br>
-
-</p>
-</div>
-</div>
-</div>
-<div class="section" title="Random">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title">
-<a name="Random"></a>Random</h5>
-</div>
-</div>
-</div>
-<div class="section" title="Random In Range">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_In_Range"></a>Random In Range</h6>
-</div>
-</div>
-</div>
-<p>A pseudo-random value within that numeric range specified as drawn from a uniform distribution. The minimum values are inclusive. The maximum values are inclusive for integer inputs and exclusive for Real inputs.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Numeral] The minimum value (inclusive).<br>
-[Numeral] The maximum value (inclusive).<br>
-Outputs:<br>
-[Numeral] The random number.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Random To Limit">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_To_Limit"></a>Random To Limit</h6>
-</div>
-</div>
-</div>
-<p>A pseudo-random value between zero and the value specified by the (non-zero) input and drawn from a uniform range. That value is inclusive for Integers and exclusive for Reals. (Note that as with the random in range function in the context of real numbers the distinction between an exclusive and inclusive limit is essentially meaningless.)</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Numeral] The maximum value (inclusive).<br>
-Outputs:<br>
-[Numeral] The result.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Random Unit">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_Unit"></a>Random Unit</h6>
-</div>
-</div>
-</div>
-<p>A pseudo-random Real value between 0 and 1 drawn from a uniform distribution. (The distinction between inclusive and exclusive range is essentially meaningless in this context and we can assume that the result will never be greater or equal to 1.)</p>
-<div class="literallayout">
-<p>Outputs:<br>
-[Real] <br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Random Boolean">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_Boolean"></a>Random Boolean</h6>
-</div>
-</div>
-</div>
-<p>A value that is randomly true or false, i.e. a fair coin toss.</p>
-</div>
-<div class="section" title="Random Weighted">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_Weighted"></a>Random Weighted</h6>
-</div>
-</div>
-</div>
-<p>An indexed value weighted against a probability distribution. The total probability must sum to 1.0. For example, an input of {.1,.2,.7} under a uniform distribution would would have 10% probability of producing "0" , 20% for "1" and 70% for "2". This function can then be used with Item to return a biased result from another list.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Real] A list of values that will determine the resulting weighted index.<br>
-Outputs:<br>
-[Integer] A resulting indexed value bounded by 0 and the length of the input list - 1.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Random Member">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_Member"></a>Random Member</h6>
-</div>
-</div>
-</div>
-<p>Represents a random value drawn from the set of Real values specified.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Real] Returns a random member of the supplied list of numbers.<br>
-Outputs:<br>
-[Generic] The value of the item at a random index.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Random State">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Random_State"></a>Random State</h6>
-</div>
-</div>
-</div>
-<p>A random specified value (option) from the specified state.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Generic] The state to select items from. All items are included.<br>
-Outputs:<br>
-[Boolean] The resulting option. <br>
-
-</p>
-</div>
-</div>
-</div>
-<div class="section" title="Graphic">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title">
-<a name="Graphic"></a>Graphic</h5>
-</div>
-</div>
-</div>
-<div class="section" title="Shape Oval">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Oval"></a>Shape Oval</h6>
-</div>
-</div>
-</div>
-<p>Draw a generic oval.</p>
-</div>
-<div class="section" title="Shape Rectangle">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Rectangle"></a>Shape Rectangle</h6>
-</div>
-</div>
-</div>
-<p>Draws a rectangular shape.</p>
-</div>
-<div class="section" title="Shape Inset">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Inset"></a>Shape Inset</h6>
-</div>
-</div>
-</div>
-<p>Shrinks the current shape by the input amount. (The overall scale is currently unspecified, but in most implementations should be 20.)</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Integer] Number of nominal pixels to inset.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Shape Marker">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Marker"></a>Shape Marker</h6>
-</div>
-</div>
-</div>
-<p>Draw a marker, that is a graphical indicator that can be used to add an additional que about the object state. For example, in a two-dimensional graphics representation this might be a small shape drawn inset at the corner of the larger shape. </p>
-</div>
-<div class="section" title="Shape Marker 2">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Marker_2"></a>Shape Marker 2</h6>
-</div>
-</div>
-</div>
-<p>Represents a marker placed in a different location from the other shape markers.</p>
-</div>
-<div class="section" title="Shape Marker 3">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Shape_Marker_3"></a>Shape Marker 3</h6>
-</div>
-</div>
-</div>
-<p>Represents a marker placed in a different location from the other shape markers.</p>
-</div>
-<div class="section" title="Color RGB">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_RGB"></a>Color RGB</h6>
-</div>
-</div>
-</div>
-<p>A color specified by the three inputs for Red, Green and Blue color components. Those inputs are expected to be in the range 0..1.</p>
-<div class="literallayout">
-<p>Inputs:<br>
-[Real] A value from 0.0 to 1.0.<br>
-[Real] A value from 0.0 to 1.0.<br>
-[Real] A value from 0.0 to 1.0.<br>
-
-</p>
-</div>
-</div>
-<div class="section" title="Color Red">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Red"></a>Color Red</h6>
-</div>
-</div>
-</div>
-<p>The color red.</p>
-</div>
-<div class="section" title="Color Yellow">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Yellow"></a>Color Yellow</h6>
-</div>
-</div>
-</div>
-<p>The color yellow.</p>
-</div>
-<div class="section" title="Color Blue">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Blue"></a>Color Blue</h6>
-</div>
-</div>
-</div>
-<p>The color blue.</p>
-</div>
-<div class="section" title="Color Orange">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Orange"></a>Color Orange</h6>
-</div>
-</div>
-</div>
-<p>The color orange.</p>
-</div>
-<div class="section" title="Color Green">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Green"></a>Color Green</h6>
-</div>
-</div>
-</div>
-<p>The color green.</p>
-</div>
-<div class="section" title="Color Purple">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Purple"></a>Color Purple</h6>
-</div>
-</div>
-</div>
-<p>The color purple.</p>
-</div>
-<div class="section" title="Color Black">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Black"></a>Color Black</h6>
-</div>
-</div>
-</div>
-<p>The color black.</p>
-</div>
-<div class="section" title="Color White">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_White"></a>Color White</h6>
-</div>
-</div>
-</div>
-<p>The color white.</p>
-</div>
-<div class="section" title="Color Gray">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Color_Gray"></a>Color Gray</h6>
-</div>
-</div>
-</div>
-<p>The color gray.</p>
-</div>
-<div class="section" title="Graphic Outline">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Graphic_Outline"></a>Graphic Outline</h6>
-</div>
-</div>
-</div>
-<p>Draws an outline of the last evaluated shape, using the last specified color or the default color (usually black) if none has been specified.</p>
-</div>
-<div class="section" title="Graphic Fill">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Graphic_Fill"></a>Graphic Fill</h6>
-</div>
-</div>
-</div>
-<p>Fills the last evaluated shape with the last specified color or the default color (usually black) if none has been specified.</p>
-</div>
-</div>
-<div class="section" title="Time">
-<div class="titlepage">
-<div>
-<div>
-<h5 class="title">
-<a name="Time"></a>Time</h5>
-</div>
-</div>
-</div>
-<div class="section" title="Now">
-<div class="titlepage">
-<div>
-<div>
-<h6 class="title">
-<a name="Now"></a>Now</h6>
-</div>
-</div>
-</div>
-<p>The current simulation period, that is the number of iterations that the model has gone through, or in the case of models with callibrarted time, the number of iterations added to the model's nominal start time.</p>
-<div class="literallayout">
-<p>Outputs:<br>
-[Integer] The current period.<br>
-
-</p>
-</div>
-</div>
-</div>
<div class="section" title="Math">
<div class="titlepage">
<div>
@@ -2554,6 +2111,7 @@
</div>
</div>
</div>
+<p>The math functions use the extremely well specified and tested routines form the Java Math library. (Because of copyright restrictions, we aren't able to include the exact definitions here. Click on the links to get more details on each function.)</p>
<div class="section" title="Sine">
<div class="titlepage">
<div>
@@ -2975,12 +2533,723 @@
</p>
</div>
</div>
-<div class="section" title="List">
+</div>
+<div class="section" title="Random">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Random"></a>Random</h4>
+</div>
+</div>
+</div>
+<div class="section" title="Design">
<div class="titlepage">
<div>
<div>
<h5 class="title">
-<a name="List"></a>List</h5>
+<a name="Design_2"></a>Design</h5>
+</div>
+</div>
+</div>
+<p>Random functions are especially significant for agent models. Of particular interest are the weighted membership and random state and boolean value functions. You should be familiar with these functions so that you don't have to create more complex Action flows to accomplish the same thing.</p>
+<p>Note that we only have support for uniform distributions as of this release. We're working on a collaborative design for evaluations that allow easy mixing and matching of random functions and distributions.</p>
+</div>
+<div class="section" title="Details">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Details_6"></a>Details</h5>
+</div>
+</div>
+</div>
+<div class="section" title="Random In Range">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_In_Range"></a>Random In Range</h6>
+</div>
+</div>
+</div>
+<p>A pseudo-random value within that numeric range specified as drawn from a uniform distribution. The minimum values are inclusive. The maximum values are inclusive for integer inputs and exclusive for Real inputs.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Numeral] The minimum value (inclusive).<br>
+[Numeral] The maximum value (inclusive).<br>
+Outputs:<br>
+[Numeral] The random number.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Random To Limit">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_To_Limit"></a>Random To Limit</h6>
+</div>
+</div>
+</div>
+<p>A pseudo-random value between zero and the value specified by the (non-zero) input and drawn from a uniform range. That value is inclusive for Integers and exclusive for Reals. (Note that as with the random in range function in the context of real numbers the distinction between an exclusive and inclusive limit is essentially meaningless.)</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Numeral] The maximum value (inclusive).<br>
+Outputs:<br>
+[Numeral] The result.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Random Unit">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_Unit"></a>Random Unit</h6>
+</div>
+</div>
+</div>
+<p>A pseudo-random Real value between 0 and 1 drawn from a uniform distribution. (The distinction between inclusive and exclusive range is essentially meaningless in this context and we can assume that the result will never be greater or equal to 1.)</p>
+<div class="literallayout">
+<p>Outputs:<br>
+[Real] <br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Random Boolean">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_Boolean"></a>Random Boolean</h6>
+</div>
+</div>
+</div>
+<p>A value that is randomly true or false, i.e. a fair coin toss.</p>
+</div>
+<div class="section" title="Random Weighted">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_Weighted"></a>Random Weighted</h6>
+</div>
+</div>
+</div>
+<p>An indexed value weighted against a probability distribution. The total probability must sum to 1.0. For example, an input of {.1,.2,.7} under a uniform distribution would would have 10% probability of producing "0" , 20% for "1" and 70% for "2". This function can then be used with Item to return a biased result from another list.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Real] A list of values that will determine the resulting weighted index.<br>
+Outputs:<br>
+[Integer] A resulting indexed value bounded by 0 and the length of the input list - 1.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Random Member">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_Member"></a>Random Member</h6>
+</div>
+</div>
+</div>
+<p>Represents a random value drawn from the set of Real values specified.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Real] Returns a random member of the supplied list of numbers.<br>
+Outputs:<br>
+[Generic] The value of the item at a random index.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Random State">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Random_State"></a>Random State</h6>
+</div>
+</div>
+</div>
+<p>A random specified value (option) from the specified state.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Generic] The state to select items from. All items are included.<br>
+Outputs:<br>
+[Boolean] The resulting option. <br>
+
+</p>
+</div>
+</div>
+</div>
+</div>
+<div class="section" title="Space">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Space_2"></a>Space</h4>
+</div>
+</div>
+</div>
+<div class="section" title="Design">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Design_3"></a>Design</h5>
+</div>
+</div>
+</div>
+<p>Spatial functions provide the core functionality for Agent Models. Spatial functions are polymorphic, which basically means that they don't care what space they are operating on as long as that space is suitable for them. Spatial functions are designed to collaborate with one another. For example, by intersecting the "Neighbor", "Available" and "Toward" functions, we can design a rule that causes the agent to move to the next neighboring cell that get's it closer to some target agent. See the function details for more information.</p>
+</div>
+<div class="section" title="Details">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Details_7"></a>Details</h5>
+</div>
+</div>
+</div>
+<div class="section" title="Nearest">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Nearest"></a>Nearest</h6>
+</div>
+</div>
+</div>
+<p>Represents the nearest agents (including gird cells) or locations to this agent. If more than one agent or location is the same distance away they will all be considered. Note that while this function is defined for the selection of an agent, the result of this function is defined by the context within which it is used. If the selection specifies another agent within a space, this function will represent the nearest agent in that space. If the selection specifies a Cell within a grid space, this function will represent that cell.</p>
+</div>
+<div class="section" title="Toward">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Toward"></a>Toward</h6>
+</div>
+</div>
+</div>
+<p>Represents a location that is on the shortest path to a particular agent or location from the source agent (that is, the selection's selection's agent). This function collaborates with the within and neighbor functions to allow the agent to move in a particular direction towards some objective.</p>
+</div>
+<div class="section" title="Within">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Within"></a>Within</h6>
+</div>
+</div>
+</div>
+<p>Represents a limit to the distance of a spatial search. When used in combination with other spatial functions such as "nearest" requires that all agents or locations must be within the distance specified by the input value.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Numeral] <br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Neighbor">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Neighbor"></a>Neighbor</h6>
+</div>
+</div>
+</div>
+<p>Represents any agents that are nearest neighbors to the agent, that is nominally of distance 1. This function is only relevant in discrete spaces -- grids and networks -- where there are immediate neighboring cells as defined by the geometry of the selection's space.</p>
+</div>
+<div class="section" title="Include Self">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Include_Self"></a>Include Self</h6>
+</div>
+</div>
+</div>
+<p>Specifies whether the agent that we are searching from -- that is, the agent of the selection for this Query Action's selection -- is included in the results of the search.</p>
+</div>
+<div class="section" title="Within 2D Boundary">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Within_2D_Boundary"></a>Within 2D Boundary</h6>
+</div>
+</div>
+</div>
+<p>Represents agents or locations that exist within the boundary specified by the inputs.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Numeral] <br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Here">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Here"></a>Here</h6>
+</div>
+</div>
+</div>
+<p>Represents the location of the searching agent. For example, if a selection is defined for an agent cell, and that selection's selection's agent is an occupant of a cell, the cell that the agent is occupying will be used. </p>
+</div>
+<div class="section" title="Available">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Available"></a>Available</h6>
+</div>
+</div>
+</div>
+<p>Represents cells which are not currently occupied. This function is only relevant for grids which are not multi-occupant.</p>
+</div>
+<div class="section" title="Distance">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Distance"></a>Distance</h6>
+</div>
+</div>
+</div>
+<p>The distance between the source agent and an agent represented by this selection. If more than one agent is represented by the other functions in the selection, this function will the distance to an arbitrary (randomly selected) agent as defined by those other functions.</p>
+<div class="literallayout">
+<p>Outputs:<br>
+[Real] <br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Away">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Away"></a>Away</h6>
+</div>
+</div>
+</div>
+<p>Represents a location that is on the path that will take the source agent (that is, the selection's selection's agent) the farthest distance from the agent(s) represented by the search. This function collaborates with the within and neighbor functions to allow the agent to move in a particular direction away from some location or agent.</p>
+</div>
+<div class="section" title="Minimize">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Minimize"></a>Minimize</h6>
+</div>
+</div>
+</div>
+<p>This function is not currently supported.</p>
+</div>
+<div class="section" title="Maximize">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Maximize"></a>Maximize</h6>
+</div>
+</div>
+</div>
+<p>This function is not currently supported.</p>
+</div>
+<div class="section" title="Location 2D">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Location_2D"></a>Location 2D</h6>
+</div>
+</div>
+</div>
+<p>Represents the location of the current agent for use in subsequent selections.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Real] <br>
+[Real] <br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Boundary 2D">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Boundary_2D"></a>Boundary 2D</h6>
+</div>
+</div>
+</div>
+<p>Represents a two-dimensional boundary within a space. (Not currently relevant for any general usages.)</p>
+<div class="literallayout">
+<p>Outputs:<br>
+[Real] <br>
+[Real] <br>
+
+</p>
+</div>
+</div>
+</div>
+<div class="section" title="Example">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Example_2"></a>Example</h5>
+</div>
+</div>
+</div>
+<p>For examples of how spatial functions can be used within action flows to provide agents with complex movement behaviors, see the Modelers Guide actions examples. In the following example from that section, we define an action that causes a partner agent to move to an available neighboring space.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/ActionsExampleNew.png"></div>
+<p>
+
+</p>
+</div>
+</div>
+<div class="section" title="Time">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Time"></a>Time</h4>
+</div>
+</div>
+</div>
+<div class="section" title="Details">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Details_8"></a>Details</h5>
+</div>
+</div>
+</div>
+<div class="section" title="Now">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Now"></a>Now</h6>
+</div>
+</div>
+</div>
+<p>The current simulation period, that is the number of iterations that the model has gone through, or in the case of models with callibrarted time, the number of iterations added to the model's nominal start time.</p>
+<div class="literallayout">
+<p>Outputs:<br>
+[Integer] The current period.<br>
+
+</p>
+</div>
+</div>
+</div>
+</div>
+<div class="section" title="Graphics">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Graphics"></a>Graphics</h4>
+</div>
+</div>
+</div>
+<div class="section" title="Design">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Design_4"></a>Design</h5>
+</div>
+</div>
+</div>
+<p>Graphic functions are combined within Style Evaluate Actions to determine how to draw an agent within a visualization. One nice aspect of this approach is that the same style definition can be used in multiple places without changing any code. For example, the same style could be used to draw an agent on a two-dimensional grid within Escape, a three-dimensional shape within Escape, a Java Swing based visualization in Ascape, and an XML configured visualizaiton in Repast Simphony.</p>
+<p>To define a graphic style for an agent, design a flow in which you create Evaluate Actions for color and shape, and then create an Evaluate Action with the graphic fill or outline function as a target of these.</p>
+</div>
+<div class="section" title="Details">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Details_9"></a>Details</h5>
+</div>
+</div>
+</div>
+<div class="section" title="Shape Oval">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Oval"></a>Shape Oval</h6>
+</div>
+</div>
+</div>
+<p>Draw a generic oval.</p>
+</div>
+<div class="section" title="Shape Rectangle">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Rectangle"></a>Shape Rectangle</h6>
+</div>
+</div>
+</div>
+<p>Draws a rectangular shape.</p>
+</div>
+<div class="section" title="Shape Inset">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Inset"></a>Shape Inset</h6>
+</div>
+</div>
+</div>
+<p>Shrinks the current shape by the input amount. (The overall scale is currently unspecified, but in most implementations should be 20.)</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Integer] Number of nominal pixels to inset.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Shape Marker">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Marker"></a>Shape Marker</h6>
+</div>
+</div>
+</div>
+<p>Draw a marker, that is a graphical indicator that can be used to add an additional cue about the object state. For example, in a two-dimensional graphics representation this might be a small shape drawn inset at the corner of the larger shape. </p>
+</div>
+<div class="section" title="Shape Marker 2">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Marker_2"></a>Shape Marker 2</h6>
+</div>
+</div>
+</div>
+<p>Represents a marker placed in a different location from the other shape markers.</p>
+</div>
+<div class="section" title="Shape Marker 3">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Shape_Marker_3"></a>Shape Marker 3</h6>
+</div>
+</div>
+</div>
+<p>Represents a marker placed in a different location from the other shape markers.</p>
+</div>
+<div class="section" title="Color RGB">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_RGB"></a>Color RGB</h6>
+</div>
+</div>
+</div>
+<p>A color specified by the three inputs for Red, Green and Blue color components. Those inputs are expected to be in the range 0..1.</p>
+<div class="literallayout">
+<p>Inputs:<br>
+[Real] A value from 0.0 to 1.0.<br>
+[Real] A value from 0.0 to 1.0.<br>
+[Real] A value from 0.0 to 1.0.<br>
+
+</p>
+</div>
+</div>
+<div class="section" title="Color Red">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Red"></a>Color Red</h6>
+</div>
+</div>
+</div>
+<p>The color red.</p>
+</div>
+<div class="section" title="Color Yellow">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Yellow"></a>Color Yellow</h6>
+</div>
+</div>
+</div>
+<p>The color yellow.</p>
+</div>
+<div class="section" title="Color Blue">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Blue"></a>Color Blue</h6>
+</div>
+</div>
+</div>
+<p>The color blue.</p>
+</div>
+<div class="section" title="Color Orange">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Orange"></a>Color Orange</h6>
+</div>
+</div>
+</div>
+<p>The color orange.</p>
+</div>
+<div class="section" title="Color Green">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Green"></a>Color Green</h6>
+</div>
+</div>
+</div>
+<p>The color green.</p>
+</div>
+<div class="section" title="Color Purple">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Purple"></a>Color Purple</h6>
+</div>
+</div>
+</div>
+<p>The color purple.</p>
+</div>
+<div class="section" title="Color Black">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Black"></a>Color Black</h6>
+</div>
+</div>
+</div>
+<p>The color black.</p>
+</div>
+<div class="section" title="Color White">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_White"></a>Color White</h6>
+</div>
+</div>
+</div>
+<p>The color white.</p>
+</div>
+<div class="section" title="Color Gray">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Color_Gray"></a>Color Gray</h6>
+</div>
+</div>
+</div>
+<p>The color gray.</p>
+</div>
+<div class="section" title="Graphic Outline">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Graphic_Outline"></a>Graphic Outline</h6>
+</div>
+</div>
+</div>
+<p>Draws an outline of the last evaluated shape, using the last specified color or the default color (usually black) if none has been specified.</p>
+</div>
+<div class="section" title="Graphic Fill">
+<div class="titlepage">
+<div>
+<div>
+<h6 class="title">
+<a name="Graphic_Fill"></a>Graphic Fill</h6>
+</div>
+</div>
+</div>
+<p>Fills the last evaluated shape with the last specified color or the default color (usually black) if none has been specified.</p>
+</div>
+</div>
+<div class="section" title="Example">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Example_3"></a>Example</h5>
+</div>
+</div>
+</div>
+<p>In the following action flow for the epidemic style, we've create Query Actions to determine each agent's current state, picked a color based on that, and then used a shared target to select a shape for the agent style and fill it:</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/GraphicsFunctionExampleDesign.png"></div>
+<p>
+
+</p>
+<p>After saving the model we can execute the two and three dimensional visualizations. Note something really nice -- even the charts have used the colors we've defined!</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/GraphicsFunctionExampleRun.png"></div>
+<p>
+
+</p>
+</div>
+</div>
+<div class="section" title="Lists">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Lists"></a>Lists</h4>
+</div>
+</div>
+</div>
+<div class="section" title="Details">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Details_10"></a>Details</h5>
</div>
</div>
</div>
@@ -3024,6 +3293,17 @@
</div>
</div>
</div>
+</div>
+<div class="section" title="Attribute Distributions">
+<div class="titlepage">
+<div>
+<div>
+<h4 class="title">
+<a name="Attribute_Distributions"></a>Attribute Distributions</h4>
+</div>
+</div>
+</div>
+<p>One of the most common tasks in the Agent Modeling process is the creation of agents with particular states drawn from a distribution. For example, you might want to create a number of agents with wealth randomly distributed between some minimum and maximum values. The distribution functions greatly ease the process of setting up those initializations and their associated parameters.</p>
<div class="section" title="Distribution">
<div class="titlepage">
<div>
@@ -3116,6 +3396,51 @@
</div>
</div>
</div>
+<div class="section" title="Example">
+<div class="titlepage">
+<div>
+<div>
+<h5 class="title">
+<a name="Example_4"></a>Example</h5>
+</div>
+</div>
+</div>
+<p>In the following example, we walk through the process of using a distribution functions, demonstrating how we can easily modify the Epidemic model so that instead of simply setting an initial exposed population, we can define factors that take together will determine an individuals initial exposure state. We simply:</p>
+<div class="orderedlist">
+<ol class="orderedlist" type="1">
+<li class="listitem">
+<p>Create an Evaluate Action called "Initial Status". </p>
+</li>
+<li class="listitem">
+<p>Set the function to "Cross Distribution"</p>
+</li>
+<li class="listitem">
+<p>Opened the "Multiple Value" node in the editor, and clicked the "Multiple Values" item within it.</p>
+</li>
+<li class="listitem">
+<p>Selected the "Status" attribute.</p>
+</li>
+</ol>
+</div>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/DistributionDesignChoice.png"></div>
+<p>
+
+</p>
+<p>The appropriate attributes are automatically added to the model, as you can see below.</p>
+<p>
+
+</p>
+<div class="mediaobject">
+<img src="images/DistributionDesign.png"></div>
+<p>
+
+</p>
+<p>In order to assign these values to the agent, we'd simply need to assign the results of this Evaluate Action to the agent.</p>
+</div>
</div>
<div class="section" title="Diagrams">
<div class="titlepage">
@@ -3149,12 +3474,12 @@
</div>
</div>
</div>
-<div class="chapter" title="Chapter 2. Creating Agent Models">
+<div class="chapter" title="Chapter 4. Creating Agent Models">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Creating_Agent_Models"></a>Chapter 2. Creating Agent Models</h2>
+<a name="Creating_Agent_Models"></a>Chapter 4. Creating Agent Models</h2>
</div>
</div>
</div>
@@ -3163,28 +3488,28 @@
<div>
<div>
<h2 class="title" style="clear: both">
-<a name="Getting_Started"></a>Getting Started</h2>
+<a name="Getting_Started_2"></a>Getting Started</h2>
</div>
</div>
</div>
</div>
</div>
-<div class="chapter" title="Chapter 3. Exploring Agent Models">
+<div class="chapter" title="Chapter 5. Exploring Agent Models">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Exploring_Agent_Models"></a>Chapter 3. Exploring Agent Models</h2>
+<a name="Exploring_Agent_Models"></a>Chapter 5. Exploring Agent Models</h2>
</div>
</div>
</div>
</div>
-<div class="chapter" title="Chapter 4. Programer's Guide">
+<div class="chapter" title="Chapter 6. Programer's Guide">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Programer.27s_Guide"></a>Chapter 4. Programer's Guide</h2>
+<a name="Programer.27s_Guide"></a>Chapter 6. Programer's Guide</h2>
</div>
</div>
</div>
@@ -3193,7 +3518,7 @@
<div>
<div>
<h2 class="title" style="clear: both">
-<a name="Overview"></a>Overview</h2>
+<a name="Overview_5"></a>Overview</h2>
</div>
</div>
</div>
@@ -3211,7 +3536,7 @@
<div>
<div>
<h2 class="title" style="clear: both">
-<a name="Getting_Started_2"></a>Getting Started</h2>
+<a name="Getting_Started_3"></a>Getting Started</h2>
</div>
</div>
</div>
@@ -3468,12 +3793,12 @@
<p>Then just create new Java classes for your root model scape and agents just as you would for an Ascape project.</p>
</div>
</div>
-<div class="chapter" title="Chapter 5. Reference">
+<div class="chapter" title="Chapter 7. Reference">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="Reference_4"></a>Chapter 5. Reference</h2>
+<a name="Reference_3"></a>Chapter 7. Reference</h2>
</div>
</div>
</div>
@@ -3494,7 +3819,7 @@
<div>
<div>
<h4 class="title">
-<a name="N108CF"></a>Model</h4>
+<a name="N1099D"></a>Model</h4>
</div>
</div>
</div>
@@ -3624,12 +3949,12 @@
</div>
</div>
</div>
-<div class="chapter" title="Chapter 6. More Information">
+<div class="chapter" title="Chapter 8. More Information">
<div class="titlepage">
<div>
<div>
<h2 class="title">
-<a name="More_Information"></a>Chapter 6. More Information</h2>
+<a name="More_Information"></a>Chapter 8. More Information</h2>
</div>
</div>
</div>
@@ -3650,7 +3975,7 @@
<div>
<div>
<h4 class="title">
-<a name="N1092C"></a>Import from CVS</h4>
+<a name="N109FA"></a>Import from CVS</h4>
</div>
</div>
</div>
diff --git a/documentation/amp.pdf b/documentation/amp.pdf
index 9efac75..b541735 100644
--- a/documentation/amp.pdf
+++ b/documentation/amp.pdf
Binary files differ
diff --git a/documentation/images/DistributionDesign.png b/documentation/images/DistributionDesign.png
new file mode 100644
index 0000000..2398ec5
--- /dev/null
+++ b/documentation/images/DistributionDesign.png
Binary files differ
diff --git a/documentation/images/DistributionDesignChoice.png b/documentation/images/DistributionDesignChoice.png
new file mode 100644
index 0000000..68762ce
--- /dev/null
+++ b/documentation/images/DistributionDesignChoice.png
Binary files differ
diff --git a/documentation/images/DistributionRun.png b/documentation/images/DistributionRun.png
new file mode 100644
index 0000000..932a0d7
--- /dev/null
+++ b/documentation/images/DistributionRun.png
Binary files differ
diff --git a/documentation/images/GraphicsFunctionExampleDesign.png b/documentation/images/GraphicsFunctionExampleDesign.png
new file mode 100644
index 0000000..646526d
--- /dev/null
+++ b/documentation/images/GraphicsFunctionExampleDesign.png
Binary files differ
diff --git a/documentation/images/GraphicsFunctionExampleRun.png b/documentation/images/GraphicsFunctionExampleRun.png
new file mode 100644
index 0000000..10b304c
--- /dev/null
+++ b/documentation/images/GraphicsFunctionExampleRun.png
Binary files differ
