Osate Guided Trade Space Exploration (GTSE)

This plugin enables users to automatically explore the trade space of a system by connecting OSATE to Penn State's Trade Space Visualizer tool.

Documentation

• For a short, high-level description, see either this short video or this slightly longer video
• For a slightly-longer, general-audience description, you can view this video
• For a diagrammatic explanation of how GTSE and ATSV work together, see the Workflow documentation.
• For a more complete academic publication on GTSE, see our paper in Software and Systems Modeling (a preprint is also available)
  • The original conference publication, from MODELS19, is also available (as is a preprint)

Installation

Prerequisites

1. Java 8
2. Osate 2.5.0+
   • If you don't have OSATE you can download it, and install it according to the online instructions.

Installing the GTSE Plugin

1. Launch OSATE
2. Add the OSATE experimental update site by selecting:
   1. Help
   2. Install New Software...
   3. Add...
   4. Type Osate Experimental for the Name
   5. Copy/Paste https://osate-build.sei.cmu.edu/download/osate/experimental/ for the Location
   6. Click OK
3. Check the box next to Guided Trade Space Exploration to install both the GTSE Core and bundle of currently-available analyzers.
4. Click Next >
5. Click Next > again
6. Accept the License. The full license for this software is in license.txt.
   1. Select the radio button next to I accept the terms of the license agreement
   2. Click Finish
7. When the 'Security Warning' pops up, select OK
8. If prompted, check the box next to the Certificate to trust it, then select OK
9. When the 'Software Update' window asks to restart OSATE2, select Yes

Installing ATSV

Note: Some features of GATSE (eg, sophisticated constraints) require version 10.0.8.32bit of ATSV.

1. Download ATSV and extract it.

Generating the ATSV Pre-requisites

1. Configure the GTSE Plugin.
   1. Open Eclipse's preferences (Window, Preferences on Linux/Windows, or OSATE2, Preferences on Mac OS X).
   2. Expand the OSATE Preferences item in the list on the left.
   3. Click on ATSV Integration.
   4. Each option can be left at its default, but the Directory for ATSV Files can be set to a more easily-accessed directory if need be.
   5. Click OK.
   6. If you made any changes, restart OSATE.
2. Create, or import, an GTSE-compatible project.
   • Example projects are available in the GTSE-Examples directory of this repository.
3. If you've imported a project, open the associated .config file.
4. Saving .config files triggers the generation of pre-requisite files -- so add a newline, space, or comment and save the file.
5. [Optional] Verify that the following files have been created in the directory you specified as part of step 1.4:
   • ATSVConfig.ecf
   • connector.jar
   • input.xml
   • output.xml
   • parser.jar
   • request.properties
   • run.sh (Linux and Mac) or run.bat (Windows)
   • runATSV.bat (Windows only)

Running ATSV

1. Launch OSATE.
2. Open the project containing the GTSE-compatible packages.
3. [Optional] Test the generated setup.
   1. Note the contents of output.xml.
   2. [Optional] Modify the contents of input.xml.
   3. Note the contents of input.xml.
   4. Run a single execution of the GTSE plugin by executing run.sh on Linux / Mac OS or run.bat on Windows.
4. Launch ATSV according to the instructions:
   • Windows:
     1. Copy the runATSV.bat file generated previously to the ATSV directory.
     2. When prompted, replace the original runATSV.bat.
     3. Double click runATSV.bat.
   • Mac OS and linux: Double click ATSV.jar in ATSV's dist folder.
5. Load the generated engine configuration file into ATSV.
   1. Click File.
   2. Click Link to Exploration Engine.
   3. Verify Link to existing engine configuration is selected.
   4. Click OK.
   5. Navigate to and select the ATSVConfig.ecf file generated previously.
      • This file will be in the directory you set in the ATSV Integration preferences in OSATE.
   6. Click Open.
6. In the window titled Engine Frame: CommandLineProblem, click Start.
7. Wait for the runs to complete. Depending on model size, analyses selected, and number of runs, this may take a while.
8. In the window titled Trade Space Visualizer, click Plots.
9. Select the type of plot you would like to view.
   • Note that only Windows users will be able to view 3D plots.