Instructions for installing and running the demos may be found in a
series of PDF files in the AdventiumMetaDemoSep2011 folder.  HOWEVER,
this zip includes only the demo models and FUSED tools because a fully
self-contained toolchain (which includes several third-party tools)
substantially exceeds the maximum Sharepoint upload limit.

At the end of this file is a list of all third-party tools and their
sources.  We can make available a DVD in which much of the tooling has
been pre-configured and pre-installed (this is what is described in
the PDF install instructions).

Copyright (c) 2011, Adventium Enterprises except as explicitly noted below.

Developed with the sponsorship of the Defense Advanced Research
Projects Agency (DARPA).

The Installed and ToBeInstalled folders contain third-party tools that
are used in the demos.  These are tools that we are permitted to
distribute as a convenience to users of this demo.  All data rights in
these third-party tools are as specified by the original sources of
these tools.  Installation of these tools by the user constitutes an
acceptance of the terms and conditions established by these third
parties.

The executables in the DemoWorkspace/fused_lib folder may contain
portions of the Silver run-time libraries.  These portions are
currently provided under the terms and conditions of the University of
Minnesota OpenSource License.

The following terms and conditions apply to all other data.

Permission is hereby granted, free of charge, to any person obtaining
a copy of this data, including any software or models in source or
binary form, as well as any drawings, specifications, and
documentation (collectively "the Data"), to deal in the Data without
restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, sublicense, and/or sell copies of
the Data, and to permit persons to whom the Data is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Data.

THE DATA IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS, SPONSORS, DEVELOPERS,
CONTRIBUTORS, OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE DATA OR THE USE OR
OTHER DEALINGS IN THE DATA.

TOOLS REQUIRED FROM OTHER SOURCES

The following tools obtained from other parties are used in various
demos.  We have endeavored to develop software and demonstrations that
will run on Windows, Mac, and Linux platforms as much as possible.
However, there are cases where tools are not available on one of these
platforms or where we have not verified that tool behavior used in the
demo is the same on all platforms.  The demo was given on Windows 7
Professional, that is the only platform on which all of the demo
scenarios have been tested.

Version numbers are important.  TOPCASED in particular must use the
specified version number.

The file DemoWorkspace/fused_lib/installpaths.properties must be updated to point
to the folders in which certain tools are installed.  Look at that
file and make sure it properly specifies the locations in which these
tools are installed on your machine.

TOPCASED Version 4.1.3 from http://www.topcased.org/ (download the
prepackaged RCP file and be careful with extraction.  On windows
7-zip, http://www.7-zip.org/ , is an excellent alternative to the
built-in decompression tool).  TOPCASED bundles Eclipse, the Open
Source AADL Tool Environment (OSATE), a SysML plug-in, and other
meta-modeling and system engineering tools.  TOPCASED is necessary to
edit SysML, AADL, and graphical FUSED models.  It should be possible
to run some of the demos without it, though we have not tested this
much.

ant-contrib-1.03b-bin.zip from
http://sourceforge.net/projects/ant-contrib/files/.  ANT with
ant-contrib added are required to run the demos.  Unzip this download
and copy the file ant-contrib-1.03b.jar into the folder
TOPCASED/plugins/org.apache.ant*/lib (where TOPCASED is the directory
where you installed TOPCASED).  You must also check to see where ant
is defined in your default path (e.g. use the command "type ant" in a
bash shell) and put a copy there, if you want to use ATSV to sample
FUSED-composed models.  If you are not using Topcased, you must have
ANT installed (e.g. included in your Cygwin install) and must add the
ant-contrib jar to that install folder.

GEMS version 3.0 from http://www.eclipse.org/gmt/gems/download.php.
Unzip this download and copy the files into the TOPCASED/plugins
folder.  GEMS is required to run the graphical FUSED editor in Eclipse
and automatically generate model composition scripts.  GEMS also
depends on GEF and EMF to be installed in Eclipse.  Both can be
installed from within Eclipse and the GEMS installation instructions
provide links to installation guides for these two additional tools.

ToBeInstalled/plugins contains FUSED plugins for a graphical FUSED model
composition language.  These must be copied into the TOPCASED/plugins
folder.  These are required to run the graphical FUSED editor in
Eclipse and automatically generate model composition scripts,
including running the graphical workFlow/models specifications.

Only on Windows, Cygwin from http://cygwin.com/install.html.  During
the install, you will be shown a page to select optional packages to
include -- search for and include the M4 preprocessor (which is not a
default install option).  If you are not using Topcased, you should
search for and include the optional ANT tool.  Cygwin is required to
run the demos on windows.

OpenModelica and the MDT Eclipse plugin Version 1.7.0 from
http://www.openmodelica.org/index.php/download/.  Note that
OpenModelica for your platform and MDT for Eclipse are separate
installs with separate install procedures.  OpenModelica is required
to run any demo that uses Modelica models and is installed using an
installer while MDT is installed from within Eclipse.

Athena Vortex Lattice (AVL) Version 3.27 from
http://web.mit.edu/drela/Public/web/avl/.  AVL is required to run any
demo that involves AVL models. Make sure to download the Windows
executable version of AVL when running on a Windows machine.

Trade Space Visualizer (TSV) Version 4.8.2 (available on Windows and
MacOS X, but the MacOS X version cannot interact with Excel and so the
FUSED automated demo scripts involving TSV would not work with that).
This is available by request under a no-cost license from
http://www.atsv.psu.edu/download.html.  TSV is required to run any
demo that involves trade space visualization and exploration.

Excel from Microsoft is required to look at the abstract and
mixed fidelity equational models and do automated TSV explorations.
This is a commercial tool and costs money.  The model composition
scripts are normally used to invoke Excel.  If you want to manually
invoke Excel on a specific file by double-clicking, you should
probably do so outside the Eclipse framework, as Eclipse seems to hang
sometimes otherwise.  Excel is required for any demos that involve the
abstract or mixed fidelity equational models, such as the trade space
visualization demos.

Creo Elements/Pro 5.0 from Parametric Technology Corporation (PTC),
http://creo.ptc.com/.  This is a commercial tool and costs money.
Creo is necessary to examine and edit the UAV solid model and generate
a mass properties analysis report.  This tool should also be invoked
outside the Eclipse framework.  We have included mass properties
analysis reports, though, and the demos can be run to publish these
results into the FUSED pub/sub infrastructure without Creo installed.

Z3 from Microsoft Research is what the current stripts invoke as
a solver for models written in the SMTLib 2.0 language.  You can
download a copy for educational & research purposes only from
http://research.microsoft.com/en-us/um/redmond/projects/z3/index.html
In theory, any SMT solver that accepts full SMTLib 2.0 will work, but
Z3 is the only one we've tried so far.

Minizinc 1.3.2 from University of Melbourne can be downloaded from
http://www.g12.csse.unimelb.edu.au/minizinc/download.html.

ECLiPSe, a non-linear constrained optimization solver from the ECLiPSe
organizatoin, can be downloaded from
http://sourceforge.net/projects/eclipse-clp/.  There are several
optimization tools that accept the minizinc language, but this is the
only one we've tried so far.

