Software User Manual (PDF)
Total Page:16
File Type:pdf, Size:1020Kb
EuroSim Mk5.0-pl5 Software User’s Manual National Aerospace Laboratory NLR iss: 6 rev: 0 SUM NLR-EFO-SUM-2 Summary EuroSim Mk5.0-pl5 is an engineering simulator to support the design, development and verification of space (sub) systems defined by ESA programmes of various scales. The facility provides a reconfigurable real-time execution environment with the possibility of man-in-the-loop and/or hardware-in-the-loop additions. This document describes the facilities available for usage in EuroSim Mk5.0-pl5, and how those facilities can be used. c Copyright Dutch Space BV All rights reserved. Disclosure to third parties of this document or any part thereof, or the use of any information contained therein for purposes other than provided for by this document, is not permitted, except with the prior and express written permission of Dutch Space BV, PO Box 32070, 2303 DB, Leiden, The Netherlands. ii c Dutch Space BV NLR-EFO-SUM-2 SUM iss: 6 rev: 0 Table of Contents c Dutch Space BV iii NLR-EFO-SUM-2 SUM iss: 6 rev: 0 Table of Contentsv I EuroSim Basics1 1 Introduction 3 1.1 Purpose...........................................3 1.2 Scope............................................3 1.3 Where to start........................................3 1.4 Document conventions...................................4 2 Concepts 5 2.1 EuroSim simulation life-cycle...............................5 2.2 Simulator elements.....................................6 2.2.1 The model.....................................6 2.2.2 Tasks and schedule.................................6 2.2.3 The data dictionary.................................7 2.2.4 Simulation definition................................7 2.2.5 The simulator....................................7 2.3 Services and tools......................................8 2.3.1 Project Manager..................................8 2.3.2 Model Editor....................................8 2.3.3 Model Description Editor.............................8 2.3.4 Parameter Exchange Editor.............................8 2.3.5 Calibration Editor.................................8 2.3.6 Schedule Editor...................................8 2.3.7 Simulation Controller...............................8 2.3.8 Action Editors...................................9 2.3.9 Initial Condition Editor...............................9 2.3.10 Test Analyzer....................................9 2.4 Facility and project management..............................9 2.4.1 Facility manager..................................9 2.4.2 Project file.....................................9 2.4.3 Project.......................................9 2.5 Application Programmers Interface.............................9 2.6 Version management.................................... 11 3 The EuroSim GUI 13 3.1 GUI conventions in EuroSim................................ 13 3.2 Mouse buttons........................................ 13 3.3 Keyboard shortcuts..................................... 14 3.4 Common buttons...................................... 14 3.5 Common menu items.................................... 15 3.5.1 File menu...................................... 15 3.5.2 Edit menu...................................... 15 3.5.3 Tools menu..................................... 15 3.5.4 Tools:Version menu................................ 15 3.5.5 Help menu..................................... 17 4 EuroSim tutorial 19 4.1 The case study........................................ 19 4.2 Starting EuroSim...................................... 19 4.2.1 Linux........................................ 19 4.2.2 Windows NT/XP.................................. 19 c Dutch Space BV v iss: 6 rev: 0 SUM NLR-EFO-SUM-2 4.3 Creating a project yourself................................. 20 4.4 Creating a shared project.................................. 20 4.5 Creating a model...................................... 20 4.5.1 Model........................................ 21 4.5.2 Adding the sub-models............................... 22 4.5.3 Adding the source code............................... 22 4.5.4 Adding the API headers.............................. 24 4.6 Building the simulator................................... 26 4.7 Creating the schedule.................................... 27 4.7.1 Initializing schedule................................ 27 4.7.2 Executing schedule................................. 28 4.7.3 Closing the Schedule Editor............................ 29 4.8 Creating a simulation definition............................... 29 4.8.1 Creating a graphical monitor............................ 29 4.8.2 Creating an intervening action........................... 30 4.8.3 Creating a recorder................................. 31 4.9 Executing a simulation run................................. 33 4.10 Analyzing the simulation results.............................. 33 4.11 Concluding remarks..................................... 35 II EuroSim Reference 37 5 EuroSim reference 39 5.1 Starting EuroSim...................................... 39 5.2 Menu items......................................... 40 5.2.1 File menu...................................... 40 5.2.2 Edit menu...................................... 40 5.2.3 Tools menu..................................... 41 5.2.4 Help menu..................................... 42 5.2.5 Automatic addition of files to the project..................... 42 6 Model Editor reference 43 6.1 Starting the Model Editor.................................. 43 6.2 Model Editor views..................................... 43 6.2.1 Files tab...................................... 43 6.2.2 Dictionary view tab................................ 44 6.3 Model Editor objects.................................... 45 6.3.1 Root node...................................... 45 6.3.2 Org node...................................... 45 6.3.3 lib node....................................... 45 6.3.4 File node...................................... 45 6.3.5 Entry nodes..................................... 47 6.3.6 Variable nodes................................... 47 6.3.7 Object node..................................... 49 6.3.8 Port node...................................... 49 6.4 Selecting an API variable.................................. 50 6.4.1 Selection within a sub-model............................ 50 6.4.2 Selection from two or more sub-models...................... 50 6.5 Menu items......................................... 50 6.5.1 File menu...................................... 50 6.5.2 Edit menu...................................... 51 6.5.3 Edit:SMP2 Library menu.............................. 52 6.5.4 View menu..................................... 52 vi c Dutch Space BV NLR-EFO-SUM-2 SUM iss: 6 rev: 0 6.5.5 Interface menu................................... 52 6.5.6 Tools menu..................................... 53 6.5.7 Tools:SMP2 Tools menu.............................. 57 6.6 Model Editor Preferences.................................. 57 6.7 The environment editor and viewer............................. 58 6.7.1 The environment viewer.............................. 58 6.7.2 The environment editor............................... 58 7 Model Description Editor reference 59 7.1 Introduction......................................... 59 7.2 Datapool........................................... 59 7.2.1 User defined variables............................... 60 7.3 Scheduling datapool updates................................ 60 7.4 Starting the Model Description Editor........................... 60 7.5 Model Description Editor objects.............................. 60 7.5.1 Root node...................................... 61 7.5.2 Model node..................................... 61 7.5.3 Entry point node.................................. 61 7.5.4 Inputs and Outputs group nodes.......................... 61 7.5.5 Input and output nodes............................... 61 7.6 Menu items......................................... 61 7.6.1 File menu...................................... 62 7.6.2 Edit menu...................................... 62 7.6.3 Tools menu..................................... 62 7.6.4 Properties Dialog Box............................... 62 8 Parameter Exchange Editor reference 65 8.1 Introduction......................................... 65 8.2 Scheduling parameter exchanges.............................. 65 8.3 Starting the Parameter Exchange Editor.......................... 66 8.4 Parameter Exchange Editor objects............................. 66 8.4.1 Source view..................................... 66 8.4.2 Destination view.................................. 66 8.4.3 Exchange view................................... 66 8.5 Menu items......................................... 67 8.5.1 File menu...................................... 67 8.5.2 Edit menu...................................... 67 8.5.3 Tools menu..................................... 68 9 Calibration Editor reference 69 9.1 Introduction......................................... 69 9.2 Starting the Calibration Editor............................... 69 9.3 Calibration types...................................... 69 9.3.1 Calibration view.................................. 70 9.3.2 Table view..................................... 70 9.3.3 Graph view..................................... 71 9.4 Menu items......................................... 71 9.4.1 Edit menu...................................... 71 9.5 Curve Restrictions..................................... 71 9.6 Using Calibrations..................................... 71 9.6.1 Calibration API..................................