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 Desktop
With 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 Desktop

7. Create New Scenario To 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 status panel on the bottom right of the MCT window flashes green and
displays “Scenario created successfully” followed by “Current sim state is Loaded”
The MCT displays an empty PVD (Plan View Display), Task Organization,
and Mission Editor window
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 Scenario
To 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 items that are found on the PVD menu and toolbar include:
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 Up on PVD

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 Mode
Zoom

19. PVD Zoomed In at Selected Area
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 Not Visible
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 Not Visible
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 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.
Move actors to different location on 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
Edit Phase
Edit 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 Execute Mission Table
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