Version 5.7 Copyright © 2020 VT MAK All rights Reserved. Printed in the United States. Under copyright laws, no part of this document may be copied or reproduced in any form without prior written consent of MAK Technologies. VR-Exchange™, VR-TheWorld™, VR-Vantage™, DI-Guy™, and DI-Guy Scenario™ are trademarks of VT MAK. MÄK Technologies®, VR-Forces®, RTIspy®, B-HAVE®, and VR-Link® are registered trademarks of VT MAK. GL Studio® is a registered trademark of The DiSTI® Corporation. Portions of this software utilize SpeedTree® technology (©2008 Interactive Data Visualization, Inc.). SpeedTree is a registered trademark of Interactive Data Visualization, Inc. All rights reserved. SilverLining™ is a trademark of Sundog Software. Terrain Profiles are based in part on the work of the Qwt project (http://qwt.sourceforge.net). 3ds Max® is a registered trademark of Autodesk, Inc. All other trademarks are owned by their respective companies. For third-party license information, please see “Third Party Licenses,” on page xvii. MAK Technologies 150 Cambridge Park Drive, 3rd Floor Cambridge, MA 02140 USA Voice: 617-876-8085 Fax: 617-876-9208 [email protected] www.mak.com Revision LOG-5.7-1-200722 Contents Preface How the Manual is Organized ................................................................ xi Logger Documentation.................................................................... xii MAK Products ...................................................................................... xiii How to Contact Us ................................................................................. xv Document Conventions ......................................................................... xvi Mouse Button Naming Conventions ............................................ xvii Third Party Licenses ............................................................................ xvii Boost License.................................................................................. xix libXML and libICONV ................................................................... xix Chapter 1. Introduction 1.1. Logger Features ............................................................................. 1-2 1.1.1. Logger Interfaces ................................................................. 1-3 1.1.2. Filtering ............................................................................... 1-3 1.1.3. Annotations ......................................................................... 1-3 1.1.4. Editing ................................................................................. 1-3 1.1.5. Streaming Video .................................................................. 1-4 1.1.6. Data Export ......................................................................... 1-4 1.1.7. HLA Traffic Analyzer .......................................................... 1-4 1.1.8. The Remote Control Logger ................................................ 1-4 1.1.9. Sample Logger Files ............................................................ 1-5 1.1.10. Sample Programs .............................................................. 1-6 1.2. Distributed Simulation Standards Supported ............................. 1-7 1.2.1. RTI Support ......................................................................... 1-7 1.2.2. FOM Support ....................................................................... 1-7 Chapter 2. Installing the Logger 2.1. Installing the MAK Data Logger .................................................. 2-2 2.1.1. Installing the MAK Data Logger on Windows .................. 2-2 2.1.2. Installing the Logger on a Linux System .......................... 2-2 MAK Data Logger Users Guide iii Contents 2.2. The Logger Directory Structure .................................................... 2-3 2.3. Installing and Setting Up the MAK License Manager ................ 2-4 2.3.1. Specifying the License Server ............................................ 2-5 2.4. Installing an RTI ........................................................................... 2-7 2.4.1. Installing the MAK RTI ...................................................... 2-7 2.5. Localizing the Graphical User Interface ...................................... 2-9 2.5.1. Translating Other Interface Files .................................... 2-12 2.5.2. Applying the Language Files ........................................... 2-13 Chapter 3. Logger Concepts 3.1. What the Logger Does During Recording and Playback ............. 3-2 3.1.1. The Exercise Connection .................................................... 3-2 3.1.2. What The Logger Does During Recording ......................... 3-3 3.1.3. What The Logger Does During Playback .......................... 3-3 3.1.4. Recording and Playback Using HLA Time Management .............................................................. 3-4 3.2. Timescale During Playback .......................................................... 3-6 3.2.1. Using Time Scaling with Time Management .................... 3-6 3.2.2. Compensating for Timescale Effects During Playback ..... 3-6 3.3. HLA Support .................................................................................. 3-8 3.3.1. FOM Flexibility ................................................................... 3-8 3.3.2. Backward Compatibility ..................................................... 3-8 Chapter 4. Configuring the Logger Connection 4.1. Configuring the Exercise Connection ........................................... 4-3 4.1.1. Viewing Connection Properties .......................................... 4-3 4.1.2. Editing a Connection .......................................................... 4-4 4.2. Configuring the Logger for HLA ................................................... 4-6 4.2.1. Specifying the Name of the Logger Federate (HLA Evolved Only) ...................................................................... 4-7 4.2.2. Specifying the Type of the Logger Federate ...................... 4-7 4.2.3. Specifying the Federation Execution Name ...................... 4-8 4.2.4. Specifying a FED File ......................................................... 4-8 4.2.5. Specifying FOM Modules (HLA Evolved Only) ................. 4-9 4.2.6. Specifying the MIM (HLA Evolved Only) .......................... 4-9 4.2.7. Specifying the RPR FOM Version .................................... 4-10 4.2.8. Specifying the RPR FOM Revision .................................. 4-10 4.2.9. Ignoring Advisory Messages ............................................. 4-11 4.2.10. Specifying a FOM Mapper .............................................. 4-11 4.2.11. Configuring Time Management ..................................... 4-14 4.2.12. Specifying the Logger Subscription List ........................ 4-15 4.2.13. Subscribing Passively to Objects and Interactions ....... 4-17 4.2.14. Enabling Request Attribute Updates ............................ 4-18 4.2.15. Sending Only Updated Values ....................................... 4-18 4.3. Configuring the Logger for DIS .................................................. 4-19 4.3.1. Specifying a UDP Port ...................................................... 4-20 4.3.2. Setting the Exercise ID ..................................................... 4-20 4.3.3. Setting the Site ID ............................................................ 4-20 4.3.4. Setting the Application Number ...................................... 4-21 iv MAK Technologies Contents 4.3.5. Using Asynchronous I/O ................................................... 4-21 4.3.6. Specifying a Destination Address for Outgoing and Incoming Data ................................................................... 4-21 4.3.7. Setting the Subnet Mask .................................................. 4-22 4.3.8. Setting the Buffer Size for Sending and Receiving PDUs ................................................................ 4-22 4.3.9. Setting the Multicast Time to Live Value ........................ 4-22 4.3.10. Setting the Network Interface Address ......................... 4-23 4.3.11. Specifying the Heartbeat ................................................ 4-24 4.3.12. Specifying the Timeout ................................................... 4-25 4.3.13. Specifying the DIS Version ............................................. 4-25 4.3.14. Subscribing to Multicast Groups .................................... 4-26 Chapter 5. Configuring the Logger 5.1. Configuring the Logger .................................................................. 5-2 5.2. Configuring Indexing ..................................................................... 5-2 5.2.1. Configuring Indexing Using the Command Interfaces ..... 5-4 5.3. Configuring Faster Playback ......................................................... 5-4 5.3.1. The SetEntityTracking Command ..................................... 5-5 5.3.2. The SetFastJumpsWithoutDiff Command ........................ 5-6 5.3.3. The SetPlaybackReadTimeLimit Command ..................... 5-7 5.3.4. Configuring HLA Heartbeating .......................................... 5-8 5.3.5. Configuring HLA Timeouts ................................................ 5-9 5.4. Setting the Dead Reckoning Algorithm on Pause ........................ 5-9 5.5. Configuring Network Read Time ................................................ 5-10 5.6. Using Data Distribution Management ....................................... 5-11 5.6.1. Specifying Subscription Regions .....................................