1

OneSAF Quick Start Guide

2

Topics

• Start Runtime Loader• Select Composition (MCT)• Create / Open Simulation Scenario• MCT Display

– PVD– Task Organization– Mission Editor

• Run Scenario• Data Collection Tools• Checkpoints

3

How To Start The OneSAF Desktop• The Runtime Loader and System Composer Tool are included

in the OneSAF installation • The items are found in the OneSAF work directory• Create a shortcut onto the Desktop for the Runtime Loader and

System Composer Tool• Click on Runtime Loader on the Desktop• OneSAF loads the system compositions window…

4

OneSAF System Compositions• Available system compositions open in a window labeled “Select a Composition”• Under the Software Apps tab, the compositions loaded in OneSAF include:

– AAR (After Action Review) compositions used for analyzing simulation output data– BMT (Battle Management Tool) compositions used for managing the military scenarios– Composers tool used for developing and editing models, units, entities, and behavior– MCT (Management and Control Tool) compositions used for managing and creating simulation scenarios– MSDE (Military Scenario Development Environment) compositions used for developing military scenarios– Stealth tool used for 3D viewing of simulation executions

• Select MCT composition (shown below) to create or edit a simulation scenario

5

Overview of OneSAF DesktopWith the OneSAF Desktop now running:

• Under the Options menu, select Preference to adjust:– Plan View Display (PVD) settings – Units of Measurement (on PVD)– Composer Settings (for models, units, entities, and behavior)– Interventions (during simulation)

6

Overview of OneSAF DesktopUnder the Tools menu, select Simulation Controller -> MCTUnder the Tools menu, select Simulation Controller -> MCT

A blank MCT (Management and Control Tool) window loads onto the screen.A blank MCT (Management and Control Tool) window loads onto the screen.

7

Create New ScenarioTo create a new simulation scenario:

• Go to File under the MCT menu and select New; or

• Press Ctrl+N; or

• Click on the New button on the MCT toolbar

8

Create New Scenario

• The MCT displays an empty PVD (Plan View Display), Task Organization,

and Mission Editor window

• The status panel on the bottom right of the MCT window flashes green and

displays “Scenario created successfully” followed by “Current sim state is Loaded”

At the bottom of the MCT window you will notice a row of items that track information including:

• POV (Point of View)• Elapsed Sim Time• Sim Time• Clock (Real-Time)• Scenario Name• Node• Current Sim State• Alerts button

9

Open Existing ScenarioTo open an existing simulation scenario:

• Go to File under the MCT menu and select Open; or• Press Ctrl+O; or • Click on the Open button on the MCT toolbar

10

Open Existing Scenario

Select a scenario from the tree view window that is launched and click Open.

11

Open Existing Scenario• The status panel on the bottom right of the MCT window will flash green and display “Reading Scenario” followed by “Current sim state is Loading” and then “Current sim state is Loaded”

• The MCT will display the PVD (Plan View Display), Task Organization, and Mission Editor windows

Task Organization

Mission Editor

PVD

12

PVD• The Plan View Display (PVD) is an area for displaying, managing, and controlling a

simulation.• Once a scenario is loaded within the MCT, you will notice a row of items on the PVD toolbar.

The items that are found on the PVD menu and toolbar include:

- Projection arrows - Pan buttons - Zoom buttons - Navigate mode - Distance - Line of sight - Area of sight - Control measures - Layers- Weather

13

Navigating the PVD

• The left and right projection arrow buttons will allow the user to return to a previous map projection that was viewed or jump forward to the next map projection

14

Navigating the PVD• The zoom buttons and the map scale menu can be used to change the map viewing scale or ratio to view the PVD closer in or farther out.

15

Navigating the PVD• The Views button has a drop down list of global locations for which the perspective of the PVD can be focused.

16

Navigating the PVD• The Go To Coordinates button will open a window in which you are able to input the coordinates of a location that you want the PVD to center on.

17

Navigating the PVD• The arrows along the edges of the PVD are pan buttons which will allow you to move in any direction on the PVD map. • When you click on one of the pan buttons, the PVD map will move about ¼ of a screen in the direction of that arrow

Pan U

p on PV

D

18

Navigating the PVD• The Navigation mouse mode button (arrows in all directions) will allow you to navigate around the PVD, as well as zoom in and out on selected objects or segments of the map

• Select the navigate mouse mode button to click on a point within the PVD. The PVD will become centered at the point clicked on the PVD; or

• Zoom in on a particular area by dragging the mouse over an area on the PVD. The PVD will zoom and center in on the area selected

Navigation Mouse ModeZoom

19

Navigating the PVD

PVD Zoomed In at Selected Area

20

Navigating the PVD• The Distance mouse mode button (compass) will determine the distance and compass angle between points, locations, and actors on the PVD.

• Click the left mouse button where you want to start the distance calculation. • Then move the mouse away from the starting point to form a radius and click the left mouse button again at the desired end point of the radius. • The distance and angle measurements are found on the left side of the status bar at the bottom of the PVD. • You can change the unit of measurements for both distance and angle by going to Options->Preferences->Units from the OneSAF Desktop menu.

Distance Mouse Mode

21

Line of Sight• The Line of Sight (LOS) mouse mode button (green line over terrain) will help determine the visibility between points, locations, and actors on the PVD.

• Press and hold left mouse button on the location or actor you want as the source. Then drag the mouse until you get to the desired target location or actor. Left click again to finalize the line path.• The LOS palette window opens which includes inputs for Step Size, and Source and Target Height Above Terrain. • The palette displays elevation and distance for graphically representing the terrain as the LOS is created on the PVD. • The Step Size represents the distance in which visibility is checked for accuracy as the LOS is measured on the PVD. • The Source and Target Height Above Terrain is the height above the terrain at the start and end points of the LOS. • Any section of the LOS displayed as green indicates visibility by the actor; otherwise, red indicates zero visibility as a result of terrain elevation or physical obstacles such as buildings or trees. • The LOS operations can be originated from location to actor, actor to location, or actor to actor. Once an LOS is attached to an actor, the actor’s location will be tracked and updated as necessary. • To exit LOS Mouse mode, close the LOS palette window or select another button on the PVD toolbar. The LOS operations on the PVD will no longer be visible.

Not Visible

22

Area of Sight• The Area of Sight (AOS) mouse mode button (dark semi-circle with white interior spots) will determine the range of vision within a selected area on the PVD. • It indicates what is visible within the designated area with either Visible or Infrared Sensor options.

• Click on AOS mouse mode button and an AOS palette window opens which allows inputs for Sensor Type, Step Size, and Source and Target Height Above Terrain • The sensor options include visible, infrared, or not defined. • The Step Size represents the distance in which visibility is checked and measured for accuracy. • The Source and Target Height Above Terrain are the height above terrain from the start point and end point.• Click the left mouse button on the location or actor you want as the source, then move the mouse outward from the source to an end point to determine the center point for the radius. • Then left click at that center point and move mouse up or down to set the size and direction of the radius. • Left click on the mouse a final time. The radius will be drawn on the PVD.• Any section that is green indicates visibility from the source. • Red area indicates zero visibility as a result of terrain elevation from physical obstacles such as buildings.

Not Visible

23

Layer Control & Weather• The layers control button (cascading blue squares) will allow you to change the appearance of the PVD by displaying and hiding detail.• Click on the layers control button which opens a Layers Control window containing the list of layers for the PVD • Left click on the light bulbs to the left of any layer to turn the layer on or off • You can tell if a layer is on when the bulb is green; otherwise, the layer is not displayed which you will notice on the PVD

• The weather button (cloud with surrounding blue sky) will allow the user to adjust the settings of the weather in the environment. • Click on the weather button and a Weather Palette window opens with the various weather settings that can influence the exercise such as temperature and wind speed. • The settings can be adjusted by: - dragging the green marker on the horizontal sliding scale; - clicking the up/down buttons next to the text box; or - directly inputting the desired value in the text box

24

Control Measures and Overlays• The create mouse mode button (black cross) will enable the user to create Point, Line, or Area control measures on the PVD, as well as create environmental objects.• Click on the create mouse mode button: - A drop box will appear next to an already existing drop box on the right side of the PVD toolbar. - You can select the type of Control Measure (CM) or Environmental object from the first drop box

and the actual CM or Environment object from the second box.• Create CM or Create Environment Palette window opens with fields for the Name, Visibility, and Overlay of the CM or Environment object.• Once you set the details for the CM, you can place the CM on the PVD by clicking on the PVD at the location where you want the CM to begin.• Then complete the drawing of the CM and finish by double-clicking at the desired end point. • The name of the CM appears next to the CM on the PVD

25

Task Organization• The Task Organization window displays the sides and types of forces that will

participate in a scenario simulation and allow the user to view a troop list.  

• The Task Organization window also allows forces to be edited or created. This menu allows you to easily create, copy, or delete a side, force, unit or entity.

• The Task Organization also includes a Quick View window to apply mode and filter for a force.

26

Task Organization - Side• You can select up to 25 sides and establish relationships between each side. • The relationships are defined as friendly, hostile, suspect, or neutral. If undefined by the user, the default relationship is suspect.

• Sides can be created within the Task Organization window: - Right click on “Top Level” node in the tree view, then point to Add->Side - A Create Side window opens in which the user defines the name of the side and chooses the Doctrine

on which the side will operate - Click OK. The new side will appear as the last side in the tree view.

27

Task Organization - Force• Forces are used to manage the units and entities that are controlled under the same side.• Forces only organize units and entities under a side and cannot be given orders as a group. - Right Click on a side in the tree view and point to Add -> Force - A Create Force window opens in which the user defines the name of the force and the chooses the Doctrine on which it will operate - Click OK. The new force will appear as the last force under the selected side.

28

Task Organization - Units• Units provide the ability to individually control entities within that unit• Units are controlled under a designated force. - Right Click on a side, force, or unit in the tree view and point to Add -> Unit. - A Create Unit window opens in which the user defines the Name, Heading, Formation, and Spacing for the unit. - The user must browse to find the Composition for the unit in the OneSAF database. - Click on Query PVD. Then click on the PVD to determine the Location for the unit. The coordinates for

the selected location are automatically filled in the table. - Click Apply if you plan to create more units for the scenario or click OK to finish. - The new unit will appear as the last unit under the selected force.

29

Task Organization - Entities• Entities can be instantiated without being controlled as part of a unit• By creating individual entities, the user is able to maintain control and visibility of the specific

entity.

– Right Click on a side, force, or unit in the tree view and point to Add -> Entity.– A Create Entity window opens in which the user defines the Name, Heading, and Rank for the entity.– The user must browse to find the Composition for the entity in the OneSAF database.– Click on Query PVD. Then click on the PVD to determine the Location for the entity. The coordinates

for the selected location are automatically filled in the table.– Click Apply if you plan to create more entities for the scenario or click OK to finish. – The new entity will appear as the last entity under the selected side, force, or unit.

30

Tether / Center Objects• To Tether an Object on the PVD:

- Right click on an object and select Tether PVD towards the bottom of the list - Two white rings will surround the object once this action is performed - You can also un-tether the object from the PVD.

• To Center an Object on the PVD: - Right click on an object and select Center PVD at the bottom of the list - The PVD will adjust so that the object selected is now centered on the PVD

31

Tether / Center Objects

Selected actor is now tethered and centered on PVD

32

Move Objects

Move actors to different location on PVD

• To Move an Object on the PVD: - Select a single object or multiple objects by dragging the mouse over

the desired object(s). - The object(s) will be outlined with blue boxes. - Hold down Shift key, press and hold left mouse button over the selection, and drag the selection to the desired location on the PVD.

33

Move Objects

Actors now at new location on PVD

34

Mission Editor• The Mission Editor is used to plan and execute missions and tasks.

• Units and entities can be added to the table so that tasks can be assigned for each unit or entity.

• Parameters are set for the assigned tasks and monitoring of the mission can be conducted during the simulation.

• Phases are used to organize tasks and the execution of tasks. – Phases can be assigned execution triggers or be executed manually by the user.– Triggers can be set to execute on command, completion of previous, phase of task, at a

specified time, or at a specified time delay.• Tasks are the actions or behaviors that are to be performed by the unit or entity.

– All tasks assigned to units and entities within a phase will be executed according to their specific triggers.

35

Create New Mission Table• The Mission Editor toolbar provides buttons for executing and stopping missions, creating, opening, and deleting mission tables, adding or removing units/entities, inserting new phases and tasks, and cutting/copying/pasting/deleting tasks.• On the Mission Editor toolbar, select the New Mission Table button.

• A Mission Table window opens. • Enter a Mission Table Name.• Check the checkboxes for the Units and/or Entities in order for those types to be included in the mission table.• Under Available Units/Entities, select each unit or entity (if multiple selections, use Ctrl+Left Click) to be included in the mission table.• Click the Add button.• The selected units and/or entities transfer to the Chosen Units/Entities textbox area.• Click OK.

36

Create New Task• A tab is created for the newly created mission table within the mission editor. • The units and entities that were selected for the mission table are listed vertically on the left edge of the table.• A “Phase 1” column appears next to the units/entities on the table with the trigger “On Command” and a status of “Ready”.• Create a new task for one of the units/entities in the mission table by right clicking in the blank task box next to the unit/entity. - Select Insert New Task. - A New Task window opens with a list of tasks that can be assigned to the unit/entity. - Select a task from the list and click OK.

37

Edit Task Parameters• When a new task is added to the mission table, an Edit Task Parameters window opens.

• The user must select the trigger and set the weapon control status, speed, formation, location, and other settings for the new unit/entity task.

38

Edit Phases and Tasks

Edit Phase Edit Task

• Right click on a phase to add, move or delete phases, to edit phase parameters, or to allow a phase to be executed or stopped

• Right click on a task to cut/copy/delete/move a task, to edit task parameters, or to execute or stop a task

39

Initialize Scenario• Now the task organization, mission editor, and PVD actors and control measures are set.• You can now initialize the simulation scenario.

• To initialize the scenario: - Select Simulation on the MCT menu and then select Initialize; or - Press Ctrl+I; or - Click the Initialize button on the MCT toolbar

• A Start Simulation window opens. • Adjust the Start Date and Time and the End Date and Time as necessary.• Set the simulation scale to determine simulation time ratio to real time.• Select Initialize.• “Current sim state is Initialized” flashes at bottom right of MCT.

40

Run Scenario• To run the scenario:

- Select Simulation on the MCT menu and then select Run; or - Press Ctrl+R; or - Click the Run button on the MCT toolbar

• “Current sim state is Running” flashes at bottom right of MCT.

41

Execute Mission• The previously created mission table can be executed once the simulation scenario has been initialized and ran.• Select the execute button within the mission editor.• Execute a phase or task by right clicking on the desired phase/task.• Status for the phase/task will change from “Ready” to “Executing” and the status box will change from white to green.• If a problem occurs with a phase or task, or the user suspends the execution, the status box will turn to red and contain a reason for the error.

Execute Mission Table

42

Pause Scenario• To pause the scenario:

- Select Simulation on the MCT menu and then select Pause; or - Press Ctrl+P; or - Click the Pause button on the MCT toolbar

• “Current sim state is Paused” flashes at bottom right of MCT.

43

Stop Scenario• To stop the scenario:

- Select Simulation on the MCT menu and then select Stop; or - Press Ctrl+T; or - Click the Stop button on the MCT toolbar

• A warning box opens asking if the user wants to stop and reset the simulation.• Select Yes.• “Current sim state is Resetting” flashes at bottom right of MCT followed by “Current sim state is Idle”. • MCT is now empty.

44

Tools• Under Tools on the MCT menu, you can utilize data analysis features such as:

– Specify C4I Devices– Fire Support Editor– Data Collection– Reports– Add User Actions– Modify/Delete User Actions– Collect AAR Data– Collect Analysis Data– Icon State Editor

45

Checkpoints• Checkpoints are used to save snapshots of the runtime simulation state so that the

current state can be restored at a later time.• Click on Checkpoint on the MCT menu to create, access, or restore checkpoints. • Checkpoint options include:

– Checkpoint Now– Schedule Checkpoint– View Scheduled Checkpoint– View Saved Checkpoint– Restore Saved Checkpoint

• Benefits:– Allows for fault recovery– Supports exercise management and control– Provides the capability for alternative actions

46

End of Tutorial