Appendix A: SimGe Installation and Remarks

Transcription

1 Appendix A: SimGe Installation and Remarks In this appendix, we will give step-by-step instructions for installing SimGe on a Windows operating system. Then, we present some remarks about usage of SimGe. Hardware and Software General Prerequisites Before going into installation, let s first check the hardware and software prerequisites. SimGe does not require specialized or high-end hardware. Table A.1 presents a typical configuration. On the software side, the requirements are presented in Table A.2. Installation SimGe is freely downloadable from (SimGe 2015) and comes in a zipped file. Extract the zipped file to a folder. Right click to SimGe.msi and select install. Program installer will check whether SimGe is already installed. If a current version of SimGe installation is detected, the installer will ask whether to remove it or to repair it. If a previous version of SimGe installation is detected, then the installer will uninstall it first. The installation program is prepared with Windows Installer XML (WiX) toolset (WiX 2017). The installation begins with the License Agreement screen as depicted in Fig. A.1. Once you accept the terms in the license agreement, you can proceed with install or select the advanced setup options by clicking the related button. Click the Install button, and then installation will take place and an installation completed dialog will appear as depicted in Fig. A.4. Click the Advanced button, and then you can select a different installation folder than the default one (see Fig. A.2). After clicking Next button, Product features dialog will appear as in Fig. A.3. Currently, SimGe is offered as one package. Just click Next in this screen. The installation will end with a success message as seen in Fig. A.4. The user may now launch SimGe. Springer International Publishing AG 2017 O. Topçu and H. Oğuztüzün, Guide to Distributed Simulation with HLA, Simulation Foundations, Methods and Applications, DOI /

2 296 Appendix A: SimGe Installation and Remarks Table 1 Hardware requirements Component Absolute minimum configuration (MB) RAM GB Hard disk space MB Video graphics card Recommended minimum configuration Table 2 Software requirements Component Absolute minimum configuration Operating system Windows 10 Runtime environment Microsoft.NET framework 4.0 client profile package Installation needs local administration rights Fig. A.1 License agreement dialog Please note that the installation wizard associates the.fap (SimGe Project file extension) files with SimGe. Therefore, it needs administrator privileges.

3 Appendix A: SimGe Installation and Remarks 297 Fig. A.2 Selection dialog for installation folder Uninstallation The user can uninstall SimGe by using Windows Programs and Features or the shortcut to uninstall SimGe at SimGe folder in Programs Menu. File Extensions for SimGe and HLA Related Files The file extensions related to SimGe and HLA are presented in Table A.3. Remarks Here are some points you need to be aware of when using SimGe. Please note that SimGe versions do not adhere to backward compatibility policy. New versions sometimes do not load an older object model.

4 298 Appendix A: SimGe Installation and Remarks Fig. A.3 Product features dialog The user interface of OME always uses the local culture format of the operating system, where SimGe is installed at. That said, if the operating system culture information is set to a continental European country, the floating-point values are separated by a comma (for most of them) as opposed to the USA where the floating-point format uses a dot as a separator. The culture format of the artifacts (e.g., FDD file) generated by SimGe conforms to their related specifications. For instance, a dot is used as a separator for the values for the update rates. The default page layout for the report generator is as follows: Its orientation is portrait, and its size is A4 (29.7 cm 21 cm). But, the US users may always print the report in the Letter size. Please note that the generation of the first report may take a while.

5 Appendix A: SimGe Installation and Remarks 299 Fig. A.4 Installation completed dialog Table 3 File extensions Extension.fap.fom.fed.xml.xsd File SimGe federation architecture project SimGe object model of a project FED file FDD file XML Schema file for DIF XML Schema (IEEE DIF XML Schema 2010), FDD Schema (IEEE FDD Schema 2010), and OMT Schema (IEEE OMT Schema 2010)

6 References IEEE FDD Schema. (2010). EEE1516-FDD-2010.xsd. [Online] Available at: standards.ieee.org/downloads/1516/ /ieee1516-fdd-2010.xsd. Accessed April 15, IEEE DIF XML Schema. (2010). OMT DIF XML Schema. [Online] Available at: Accessed April 15, IEEE OMT Schema. (2010). IEEE1516-DIF-2010.xsd. [Online] Available at: standards.ieee.org/downloads/1516/ /ieee1516-omt-2010.xsd. Accessed April 15, SimGe. (2015). SimGe web site. [Online] Available at: simge. Accessed November WiX. (2017). WIX toolset. [Online] Available at: Accessed February 27, Springer International Publishing AG 2017 O. Topçu and H. Oğuztüzün, Guide to Distributed Simulation with HLA, Simulation Foundations, Methods and Applications, DOI /

7 Index A Abstraction, 5 Access layer, 171 ACL. FIPA, 268 Acquire, 124 Acquiring, 61 Agent-based modeling and simulation, 261 Agent communication language, 264 Agent manager, 265, 277, 279 Aggregate Level Simulation Protocol (ALSP), 13 Announce synchronization point, 234 Application Programming Interface (API), 48 Area of responsibility, 84, 88 Array data type, 135 Array datatype table, 125 Arrays, 135 Associate regions for update, 243 Attribute, 5, 39 Attribute ownership acquisition notification, 248 Attribute ownership release response, 252 Attribute ownership unavailable, 248 Attribute relevance advisory switch, 60 Attribute table, 44 Automatic resign action, 132 Autonomy, 262 B Basic data representations table, 133 Behavior of a system, 5, 24 Best effort delivery, 130 C Call, 48, 192 Callback, 48, 192 Callback methods, 48 Centralized federation management, 70 Change attribute order type, 67 Change interaction order type, 67 Chat client, 101 Chat room, 101 C# language, 174 Class-based P/S diagrams, 56 Code explorer, 159 CodeGen, 157 Code generation configuration dialog, 164 Code generator, 98 Coherence-based agent framework, 267 Commit region modification, 240 Communication layer, 159, 170, 171 Component, 5 Composite state, 73 Computer-generated entities, 274 Conceptual model, 81 Conceptual validation, 81 Confirm federation restoration request, 237 Connectionist network, 263 Conservative time management, 65 Console window, 177 Contact, 279 Continuous time models, 9 Coupling, 30 Create region, 239 Cross-cutting concerns, 170 CRUD, 116 Cull, 290 Cyber-physical system, 274 D Data distribution management, 47, 62 Data Interchange Format (DIF), 42 Dead-reckoning, 289 Decision making, 262 Declaration management, 47, 54 DeCoAgent, 263, 278 DeCoAgent framework, 279 Default region, 63 Springer International Publishing AG 2017 O. Topçu and H. Oğuztüzün, Guide to Distributed Simulation with HLA, Simulation Foundations, Methods and Applications, DOI /

8 304 Index Default routing space, 56 Delegated event handling, 192 Delete object instance, 209 Deliberative coherence-driven agent, 263, 278 Dependent module, 46 Deployment, 72 Detailed (application) design, 87 Dimension, 63, 126 Dimensions table, 122 Discover object instance, 206 Discrete event models, 9 Discrete events, 9 Discrete-time models, 10 Dispersion, 11 DIS protocol, 12, 38 Distributed interactive simulation, 12 Distributed simulation, 11 Distributed Simulation Engineering and Execution Process (DSEEP), 15, 79 Divest, 124 Divest/acquire, 124, 143 Divesting, 61 Domain entities, 8 Draw, 290 Dynamic link library, 175 E Enable/disable interaction relevance advisory switch, 210 Encapsulation, 172 Endianness, 133 Entity, 5 Enumerated datatype table, 135 Enumeration, 135 Enumerator, 135 Environment, 5 Event, 5, 170, 192 Event-based advancement, 65 Event-based notification, 170, 192 Event handler, 192 Evoked callback model, 50 Evoking, 49 Exceptions, 47 Executable form, 7 Experiment with, 4 Extent, 245 F FAM folder, 101 FEDEP, 79 Federate, 32 Federate Ambassador, 49, 159 Federate application, 81 Federate architecture, 87 Federate-based P/S diagrams, 56 Federated agent, 267, 277 Federate hosting an agent, 267 Federate-initiated, 192 Federate-initiated methods, 48 Federate interface, 48 Federate restore complete, 54, 237 Federate rules, 34 Federate save complete, 52, 236 Federate states, 73 Federation, 33 Federation agreement, 42 Federation architecture, 81, 104 Federation architecture model, 104 Federation architecture modeling environment, 98 Federation architecture project, 101 Federation design, 81 Federation execution, 33 Federation Execution Details (FED), 16, 38 Federation execution lifecycle, 68 Federation execution properties, 106 Federation execution states, 73 Federation Foundation Library (FFL), 170, 174, 181 Federation management, 47 Federation management services, 50 Federation name, 71 Federation Object Model (FOM), 44, 45 Federation Object Model (FOM) Document Data (FDD), 16 Federation restore begun, 54, 237 Federation restored, 237 Federation rules, 34 Federation saved, 236 Federation structure, 82 Federation synchronized, 234 FedExec, 48 Fidelity, 6, 7 FOM Document Data (FDD), 38 FOM folder, 101 FOM modules, 45 Frame, 290 Functional behavior, 5 G Game engine, 89, 291 General purpose programming language, 7 Geodetic coordinate system, 89 Get federate handle, 233 Get update rate value, 59 Get update rate value for attribute, 59 Goal deliberation, 262, 278 Goal reasoning, 278

9 Index 305 Graphical user interface, 170 Graphics library, 89, 291 Graphics termination, 71 Greatest available logical time, 66 H Handle, 40, 172 Heterogeneity, 11 High Level Architecture, 13 High-level graphics libraries, 291 High-level method, 185 HLA, 30 HLAbestEffort, 129 HLA class, 38 HLA evolved, 14, 29 HLA federate interface specification, 14 HLA framework and rules, 14, 31 HLA gateway, 264 HLA layer, 266 HLA object model, 38, 159 HLA object model template, 14 HLAreliable, 129 Human-operated simulation entities, 274 Hybrid automata, 10 I Immediate callback model, 50 Initialization, 70, 71 Initiate federate save, 235 Input data analysis, 6 Integrated development environment, 89, 157, 174 Interaction, 40 Interaction class structure table, 44, 122 Interactive, 262 Interface specification (IF), 32 Interface specification services usage table, 141 Interoperability, 30 Intrusive pull, 61, 248 J Joined federate, 32 K Knowledge query and manipulation language, 268 L Layered architectural style, 169 Layered architecture, 158 Layered simulation architecture, 159 Layering, 169 Learning, 262 Least incoming time stamp, 66 Level of accuracy, 6 Level of detail, 6, 7 List federation executions, 253 Local data structures, 160, 171 Local model termination, 71 Logical time, 65 Lollipop diagram, 82 Lookahead, 65, 222 Low-level graphics libraries, 291 Low-level methods, 184 M Main simulation loop, 71, 212 Management Object Model (MOM), 36, 45, 145 Man-in-the-loop simulation, 274 Maritime simulation, 275 Marshalling, 205 Master-slave table, 6, 135 Mathematical programming language, 7 MATLAB, 6 Member application, 15 Message exchange, 37 Messages, 65 Method calls, 170 Middleware, 34 MIM, 45, 112 Model, 4 Modeling, 4 Modeling and simulation, 3 MOM and initialization module, 145 MOM data by an Initialization Module (MIM), 45 Monolithic simulation, 10, 24 N Negotiated push, 62, 248 Network information, 72 Next message request, 67 Node, 72 Non-centralized federation management, 70 Note, 141 Notes table, 141 NSTMSS, 179 NuGet package, 177 O Object, 39 Object class structure table, 43 Object exchange, 37 Object instance name, 60 Object management, 47, 59 Object model editor, 97 Object Model Identification Table, 42

10 306 Index Object Model Template (OMT), 32, 42 Object not known error, 243 OM explorer, 146 Operation, 71 Operational systems, 8 Optimistic advancement, 65 Optimistic time management, 65 Options, 103 Orphaned attribute, 61 Orphaned-attribute pull, 61 Ownership management, 47, 60, 246 P Parallel simulation, 11, 24 Parameters, 40 Parameter table, 44 Partial class, 163 Physics-based models, 9 Post-conditions, 47 Pre-conditions, 47 Preferred order type, 67 Presentation layer, 159, 170 Proactivity, 262 Process, 5 Processing layer, 170 Project explorer, 99 Project home folder, 100 Project settings, 102 Project Start Page, 102 Project workspace, 99 Protocol Data Units (PDUs), 13 Provide attribute value update, 209 Publish/subscribe pattern, 36, 38 Publishable, 55 Publish and Subscribe (P/S), 38 Publish and subscribe diagram, 55 Publishing, 38 Publish interaction class, 55 Publish object class attributes, 55 Pull strategy, 61, 248 Push strategy, 62 R RACoN, 15, 16, 98, 171 Range, 63 Reality, 4, 9, 81 Receive interaction, 60 Receive order, 122 Receive order message, 49 Record data type, 137 Record fields, 137 Referent, 7 Reflect attribute values, 207 Region, 63 Region realization, 63 Region specification, 63 Region template, 63 Reliable delivery, 130 Remove object instance, 209 Report federation executions, 253 Report generator, 98, 149 Request federation restore, 53, 237 Request federation save, 52, 235 Request retraction, 231 Request value update with regions, 242 Reserve object instance name, 60 Resolution, 7 Results validation, 6, 81 Retract, 231 Reusability, 11 Routing space, 56, 142, 243 Routing spaces Table, 142 RTI Ambassador, 49, 159 RtiExec, 48 RTI executive, 48 RTI-initiated, 192 RTI-initiated methods, 48 RTI library type, 166 RTI method, 48 RTI service, 46, 48 RTI termination, 71 Runtime Infrastructure (RTI), 14, 16, 30, 33 S Save-and-restore, 235 Scenario, 6 Scene graph, 291 Send interaction, 60 Send interaction with regions, 246 Ship application, 83 Shutdown, 71 SimGe, 15, 16, 97 SimGe object model editor, 111 SIMNET, 12 Simple data type, 134 Simuland, 5, 10, 24 Simulation conceptual model, 8 Simulation conceptual model and fidelity, 8 Simulation data exchange model, 33 Simulation engineering, 8 Simulation environment, 15 Simulation execution, 6 Simulation Interoperability Standards Organization (SISO), 14 Simulation layer, 159, 170 Simulation manager, 185 Simulation Object Model (SOM), 44 Simulation-oriented programming language, 7

11 Index 307 Simulation project, 98 Simulation run, 6 Simulation user, 6 Situational awareness, 262 Skeleton code, 158 Smart update reduction, 58, 131 Social ability, 262 Software design, 81 SOM, 45 Source code folder, 101 Stand-alone desktop application, 170 Standalone module, 46 Start registration for object class, 203 Start/stop registration for object instance, 60 States, 5 Station application, 84 Stop registration for object class, 203 Subscribe interaction class, 55 Subscribe/unsubscribe, 55 Subscribing, 38 Support services, 47 Switch, 131 Switches table, 131 Synchronization point, 51, 128, 231 Synchronization point achieved, 51 Synchronization point registration failed, 233 Synchronization point registration succeeded, 233 Synchronization table, 51, 129 SysML, 9 System, 5 System initialization and termination, 70 T Task environment, 277 Termination, 70, 71 The enable/disable object class relevance advisory switch, 203 Theory of deliberative coherence, 263 Ticking, 49 Time, 9 Time advance grant, 67 Time advancement strategies, 65 Time advance request, 67 Time axis, 9, 65 Time constrained enabled, 224 Time dimension, 9 Time management, 47, 64 Time management mechanisms, 65 Time-stamp, 52 Time-stamp order, 122 Time-stamp-order message, 49 Time step advancement, 65 Transferable/acceptable, 143 Transportation table, 122 Try-catch, 48 Turn interactions off, 210 Turn interactions on, 210 Turn updates on for object instance, 59, 205 U UML, 9 UML class diagram, 183 Unassociate regions for updates, 243 Unconditional attribute ownership divestiture, 250 Unconditional push, 62, 248 Unpublish interaction class, 55 Unpublish object class attributes, 55 Updateable/reflectable, 143 Update attribute values, 205, 209 Update rate, 58, 131 Update rate designator, 58 Update rate table, 131 Update reduction, 58, 131 User interface controller, 170 User interface layer, 170 UsvFd, 280 V Variant record, 139 Verb-noun analysis, 85 Verification, 6, 81 Virtual boat, 274 Virtual environment, 275 W Web client, 170