中文使用者手冊
OMNeT++ version 5.0
資料來源：OMNeT++ version 5.0 User Manual
時間過很快，v4.6的手冊還沒寫完v5.0已經出來了，所以就直接放棄v4.6的撰寫移到v5.0。還是一樣時間有限有空才寫，所以這一份文件的完成沒有期限
章節目錄
1 簡介(Introduction)
2 概述 (Overview)
3 NED語言 (The NED Language)
4 簡單模組 (Simple Modules)
5 訊息與封包 (Messages and Packets)
6 訊息定義 (Message Definitions)
7 模擬資料庫 (The Simulation Library)
8 建立模擬程式 (Building Simulation Programs)
9 模擬組態設定 (Configuring Simulations)
10 執行模擬 (Running Simulations)
11 網路圖形與動畫 (Network Graphics And Animation)
12 結果紀錄與分析 (Result Recording and Analysis)
13 事件紀錄器 (Eventlog)
14 製作 NED和訊息文件 (Documenting NED and Messages)
15 測試 (Testing)
16 平行分散式模擬 (Parallel Distributed Simulation)
17 OMNET++擴展與客製化 (Customizing and Extending OMNeT++)
18 Embedding the Simulation Kernel
19 Appendix: NED Reference
20 Appendix: NED Language Grammar
21 Appendix: NED XML Binding
22 Appendix: NED Functions
23 Appendix: Message Definitions Grammar
24 Appendix: Display String Tags
25 Appendix: Configuration Options
26 Appendix: Result File Formats
27 Appendix: Eventlog File Format
28 Appendix: Figure Definitions
目錄
1 簡介 (Introduction)
1.1 OMNeT++ 簡介 (What Is OMNeT++?)
1.2 中文手冊內容說明 (Organization of This Manual)
2 概述 (Overview)
2.1 建模基本觀念 (Modeling Concepts)
2.1.1 階層式模組架構 (Hierarchical Modules)
2.1.2 模組型別 (Module Types)
2.1.3 訊息、閘、與連結 (Messages, Gates, Links)
2.1.4 封包傳遞模型 (Modeling of Packet Transmissions)
2.1.5 參數設定 (Parameters)
2.1.6 拓樸描述法 (Topology Description Method)
2.2 演算法編程 (Programming the Algorithms)
2.3 使用OMNeT++ (Using OMNeT++)
2.3.1 建立與執行模擬 (Building and Running Simulations)
2.3.2 OMNeT++ 4.6版內容 (What Is in the Distribution)
3 NED語言 (The NED Language)
3.1 NED簡介 (NED Overview)
3.2 NED快速學習 (NED Quickstart)
3.2.1 網路 (The Network)
3.2.2 通道的介紹 (Introducing a Channel)
3.2.3 簡單模組：App、Routing、以及Queue (The App, Routing, and Queue Simple Modules)
3.2.4 複合式模組：Node (The Node Compound Module)
3.2.5 整合在一起 (Putting It Together)
3.3 簡單模組 (Simple Modules)
3.4 複合式模組 (Compound Modules)
3.5 通道 (Channels)
3.6 參數 (Parameters)
3.7 閘 (Gates)
3.8 子模組 (Submodules)
3.9 連線 (Connections)
3.10 複數連線 (Multiple Connections)
3.10.1 連線模板 (Connection Patterns)
3.11 參數型子模組與連線型別 (Parametric Submodule and Connection Types)
3.11.1 參數型子模組型別 (Parametric Submodule Types)
3.11.2 參數型連線型別 (Parametric Connection Types)
3.12 後設資料註解 (屬性) ((Metadata Annotations (Properties))
3.13 繼承 (Inheritance)
3.14 套件 (Packages)
4 Simple Modules
4.1 Simulation Concepts
4.1.1 Discrete Event Simulation
4.1.2 The Event Loop
4.1.3 Events and Event Execution Order in OMNeT++
4.1.4 Simulation Time
4.1.5 FES Implementation
4.2 Components, Simple Modules, Channels
4.3 Defining Simple Module Types
4.3.1 Overview
4.3.2 Constructor
4.3.3 Initialization and Finalization
4.4 Adding Functionality to cSimpleModule
4.4.1 handleMessage()
4.4.2 activity()
4.4.3 How to Avoid Global Variables
4.4.4 Reusing Module Code via Subclassing
4.5 Accessing Module Parameters
4.5.1 Volatile and Non-Volatile Parameters
4.5.2 Changing a Parameter’s Value
4.5.3 Further cPar Methods
4.5.4 Emulating Parameter Arrays
4.5.5 handleParameterChange()
4.6 Accessing Gates and Connections
4.6.1 Gate Objects
4.6.2 Connections
4.6.3 The Connection’s Channel
4.7 Sending and Receiving Messages
4.7.1 Self-Messages
4.7.2 Sending Messages
4.7.3 Broadcasts and Retransmissions
4.7.4 Delayed Sending
4.7.5 Direct Message Sending
4.7.6 Packet Transmissions
4.7.7 Receiving Messages with activity()
4.8 Channels
4.8.1 Overview
4.8.2 The Channel API
4.8.3 Channel Examples
4.9 Stopping the Simulation
4.9.1 Normal Termination
4.9.2 Raising Errors
4.10 Finite State Machines
4.10.1 Overview
4.11 Navigating the Module Hierarchy
4.11.1 Module Vectors
4.11.2 Module IDs
4.11.3 Walking Up and Down the Module Hierarchy
4.11.4 Iterating over Submodules
4.11.5 Navigating Connections
4.12 Direct Method Calls Between Modules
4.13 Dynamic Module Creation
4.13.1 When To Use
4.13.2 Overview
4.13.3 Creating Modules
4.13.4 Deleting Modules
4.13.5 Module Deletion and finish()
4.13.6 Creating Connections
4.13.7 Removing Connections
4.14 Signals
4.14.1 Design Considerations and Rationale
4.14.2 The Signals Mechanism
4.14.3 Listening to Model Changes
4.15 Signal-Based Statistics Recording
4.15.1 Motivation
4.15.2 Declaring Statistics
4.15.3 Statistics Recording for Dynamically Registered Signals
4.15.4 Adding Result Filters and Recorders Programmatically
4.15.5 Emitting Signals
4.15.6 Writing Result Filters and Recorders
5 Messages and Packets
5.1 Overview
5.2 The cMessage Class
5.2.1 Basic Usage
5.2.2 Duplicating Messages
5.2.3 Message IDs
5.2.4 Control Info
5.2.5 Information About the Last Arrival
5.2.6 Display String
5.3 Self-Messages
5.3.1 Using a Message as Self-Message
5.3.2 Context Pointer
5.4 The cPacket Class
5.4.1 Basic Usage
5.4.2 Identifying the Protocol
5.4.3 Information About the Last Transmission
5.4.4 Encapsulating Packets
5.4.5 Reference Counting
5.4.6 Encapsulating Several Packets
5.5 Attaching Parameters and Objects
5.5.1 Attaching Objects
5.5.2 Attaching Parameters
6 Message Definitions
6.1 Introduction
6.1.1 The First Message Class
6.2 Messages and Packets
6.2.1 Defining Messages and Packets
6.2.2 Field Data Types
6.2.3 Initial Values
6.2.4 Enums
6.2.5 Fixed-Size Arrays
6.2.6 Variable-Size Arrays
6.2.7 Classes and Structs as Fields
6.2.8 Pointer Fields
6.2.9 Inheritance
6.2.10 Assignment of Inherited Fields
6.3 Classes
6.4 Structs
6.5 Literal C++ Blocks
6.6 Using C++ Types
6.6.1 Announcing Types to the Message Compiler
6.6.2 Making the C++ Declarations Available
6.6.3 Putting it Together
6.7 Customizing the Generated Class
6.7.1 Customizing Method Names
6.7.2 Customizing the Class via Inheritance
6.7.3 Abstract Fields
6.8 Using Standard Container Classes for Fields
6.8.1 Typedefs
6.8.2 Abstract Fields
6.9 Namespaces
6.9.1 Declaring a Namespace
6.9.2 C++ Blocks and Namespace
6.9.3 Type Announcements and Namespace
6.10 Descriptor Classes
6.11 Summary
7 The Simulation Library
7.1 Fundamentals
7.1.1 Using the Library
7.1.2 The cObject Base Class
7.1.3 Iterators
7.1.4 Runtime Errors
7.2 Logging from Modules
7.2.1 Log Output
7.2.2 Log Levels
7.2.3 Log Statements
7.2.4 Log Categories
7.2.5 Composition and New lines
7.2.6 Implementation
7.3 Random Number Generators
7.3.1 RNG Implementations
7.3.2 Global and Component-Local RNGs
7.3.3 Accessing the RNGs
7.4 Generating Random Variates
7.4.1 Component Methods
7.4.2 Random Number Stream Classes
7.4.3 Generator Functions
7.4.4 Random Numbers from Histograms
7.4.5 Adding New Distributions
7.5 Container Classes
7.5.1 Queue class: cQueue
7.5.2 Expandable Array: cArray
7.6 Routing Support: cTopology
7.6.1 Overview
7.6.2 Basic Usage
7.6.3 Shortest Paths
7.7 Pattern Matching
7.7.1 cPatternMatcher
7.7.2 cMatchExpression
7.8 Statistics and Distribution Estimation
7.8.1 cStatistic and Descendants
7.8.2 Distribution Estimation
7.8.3 The k-split Algorithm
7.8.4 Transient Detection and Result Accuracy
7.9 Recording Simulation Results
7.9.1 Output Vectors: cOutVector
7.9.2 Output Scalars
7.10 Watches and Snapshots
7.10.1 Basic Watches
7.10.2 Read-write Watches
7.10.3 Structured Watches
7.10.4 STL Watches
7.10.5 Snapshots
7.10.6 Getting Coroutine Stack Usage
7.11 Defining New NED Functions
7.11.1 Define_NED_Function()
7.11.2 Define_NED_Math_Function()
7.12 Deriving New Classes
7.12.1 cObject or Not?
7.12.2 cObject Virtual Methods
7.12.3 Class Registration
7.12.4 Details
7.13 Object Ownership Management
7.13.1 The Ownership Tree
7.13.2 Managing Ownership
8 Visualization
8.1 Overview
8.2 Placement of Visualization Code
8.2.1 The refreshDisplay() Method
8.2.2 Advantages
8.2.3 Why is refreshDisplay() const?
8.3 Display Strings
8.3.1 Syntax and Placement
8.3.2 Inheritance
8.3.3 Submodule Tags
8.3.4 Background Tags
8.3.5 Connection Display Strings
8.3.6 Message Display Strings
8.3.7 Parameter Substitution
8.3.8 Colors
8.3.9 Icons
8.3.10 Layouting
8.3.11 Changing Display Strings at Runtime
8.4 Bubbles
8.5 The Canvas
8.5.1 Overview
8.5.2 Creating, Accessing and Viewing Canvases
8.5.3 Figure Classes
8.5.4 Figure Hierarchy
8.5.5 Creating and Manipulating Figures from NED and C++
8.5.6 Transforms
8.5.7 Showing/Hiding Figures
8.5.8 Specifying Positions, Colors, Fonts and Other Properties
8.5.9 Primitive Figures
8.5.10 Compound Figures
8.5.11 Defining New Figure Types
8.6 3D Visualization
8.6.1 Introduction
8.6.2 The OMNeT++ API for OpenSceneGraph
8.6.3 Using OSG
8.6.4 Using osgEarth
8.6.5 OpenSceneGraph/osgEarth Programming Resources
9 Building Simulation Programs
9.1 Overview
9.2 Using opp_makemake and Makefiles
9.2.1 Command-line Options
9.2.2 Basic Use
9.2.3 Debug and Release Builds
9.2.4 Debugging the Makefile
9.2.5 Using External C/C++ Libraries
9.2.6 Building Directory Trees
9.2.7 Automatic Include Dirs
9.2.8 Dependency Handling
9.2.9 Out-of-Directory Build
9.2.10 Building Shared and Static Libraries
9.2.11 Recursive Builds
9.2.12 Customizing the Makefile
9.2.13 Projects with Multiple Source Trees
9.2.14 A Multi-Directory Example
9.3 Project Features
9.3.1 The opp_featuretool Program
9.3.2 What is a Project Feature
9.3.3 The .oppfeatures File
9.3.4 How to Introduce a Project Feature
10 Configuring Simulations
10.1 The Configuration File
10.1.1 An Example
10.1.2 File Syntax
10.1.3 File Inclusion
10.2 Sections
10.2.1 The [General] Section
10.2.2 Named Configurations
10.2.3 Section Inheritance
10.3 Assigning Module Parameters
10.3.1 Using Wildcard Patterns
10.3.2 Using the Default Values
10.4 Parameter Studies
10.4.1 Iterations
10.4.2 Named Iteration Variables
10.4.3 Parallel Iteration
10.4.4 Predefined Variables, Run ID
10.4.5 Constraint Expression
10.4.6 Repeating Runs with Different Seeds
10.4.7 Experiment-Measurement-Replication
10.5 Configuring the Random Number Generators
10.5.1 Number of RNGs
10.5.2 RNG Choice
10.5.3 RNG Mapping
10.5.4 Automatic Seed Selection
10.5.5 Manual Seed Configuration
10.6 Logging
10.6.1 Compile-Time Filtering
10.6.2 Runtime Filtering
10.6.3 Log Prefix Format
10.6.4 Configuring Cmdenv
10.6.5 Configuring Tkenv and Qtenv
11 Running Simulations
11.1 Introduction
11.1.1 Running a Simulation Executable
11.1.2 Running a Shared Library
11.1.3 Controlling the Run
11.2 Cmdenv: the Command-Line Interface
11.2.1 Example Run
11.2.2 Command-Line Options
11.2.3 Cmdenv Ini File Options
11.2.4 Interpreting Cmdenv Output
11.3 The Tkenv Graphical User Interface
11.3.1 Command-Line and Configuration Options
11.4 The Qtenv Graphical User Interface
11.4.1 Command-Line and Configuration Options
11.5 Batch Execution
11.5.1 Using Cmdenv
11.5.2 Using Shell Scripts
11.5.3 Using opp_runall
11.6 Akaroa Support: Multiple Replications in Parallel
11.6.1 Introduction
11.6.2 What Is Akaroa
11.6.3 Using Akaroa with OMNeT++
11.7 Troubleshooting
11.7.1 Unrecognized Configuration Option
11.7.2 Stack Problems
11.7.3 Memory Leaks and Crashes
11.7.4 Simulation Executes Slowly
12 Result Recording and Analysis
12.1 Result Recording
12.1.1 Using Signals and Declared Statistics
12.1.2 Direct Result Recording
12.2 Configuring Result Collection
12.2.1 Result File Names
12.2.2 Enabling/Disabling Result Items
12.2.3 Selecting Recording Modes for Signal-Based Statistics
12.2.4 Warm-up Period
12.2.5 Output Vectors Recording Intervals
12.2.6 Recording Event Numbers in Output Vectors
12.2.7 Saving Parameters as Scalars
12.2.8 Recording Precision
12.3 Overview of the Result File Formats
12.3.1 Output Vector Files
12.3.2 Scalar Result Files
12.4 The Analysis Tool in the Simulation IDE
12.5 Scave Tool
12.5.1 The filter Command
12.5.2 The index Command
12.5.3 The summary Command
12.6 Alternative Statistical Analysis and Plotting Tools
12.6.1 GNU R
12.6.2 NumPy, SciPy and MatPlotLib
12.6.3 MATLAB or Octave
12.6.4 Gnuplot
12.6.5 ROOT
12.6.6 Grace
12.6.7 Spreadsheet Programs
13 Eventlog
13.1 Introduction
13.2 Configuration
13.2.1 File Name
13.2.2 Recording Intervals
13.2.3 Recording Modules
13.2.4 Recording Message Data
13.3 Eventlog Tool
13.3.1 Filter
13.3.2 Echo
14 Documenting NED and Messages
14.1 Overview
14.2 Documentation Comments
14.2.1 Private Comments
14.2.2 More on Comment Placement
14.3 Referring to Other NED and Message Types
14.3.1 Automatic Linking
14.3.2 Tilde Linking
14.4 Text Layout and Formatting
14.4.1 Paragraphs and Lists
14.4.2 Special Tags
14.4.3 Text Formatting Using HTML
14.4.4 Escaping HTML Tags
14.5 Customizing and Adding Pages
14.5.1 Adding a Custom Title Page
14.5.2 Adding Extra Pages
14.5.3 Incorporating Externally Created Pages
14.6 File Inclusion
15 Testing
15.1 Overview
15.1.1 Verification, Validation
15.1.2 Unit Testing, Regression Testing
15.2 The opp_test Tool
15.2.1 Introduction
15.2.2 Terminology
15.2.3 Test File Syntax
15.2.4 Test Description
15.2.5 Test Code Generation
15.2.6 PASS Criteria
15.2.7 Extra Processing Steps
15.2.8 Unresolved
15.2.9 opp_test Synopsys
15.2.10 Writing the Control Script
15.3 Smoke Tests
15.4 Fingerprint Tests
15.4.1 Fingerprint Computation
15.4.2 Fingerprint Tests
15.5 Unit Tests
15.6 Module Tests
15.7 Statistical Tests
15.7.1 Validation Tests
15.7.2 Statistical Regression Tests
15.7.3 Implementation
16 Parallel Distributed Simulation
16.1 Introduction to Parallel Discrete Event Simulation
16.2 Assessing Available Parallelism in a Simulation Model
16.3 Parallel Distributed Simulation Support in OMNeT++
16.3.1 Overview
16.3.2 Parallel Simulation Example
16.3.3 Placeholder Modules, Proxy Gates
16.3.4 Configuration
16.3.5 Design of PDES Support in OMNeT++
17 Customizing and Extending OMNeT++
17.1 Overview
17.2 Adding a New Configuration Option
17.2.1 Registration
17.2.2 Reading the Value
17.3 Simulation Lifetime Listeners
17.4 cEvent
17.5 Defining a New Random Number Generator
17.6 Defining a New Event Scheduler
17.7 Defining a New FES Data Structure
17.8 Defining a New Fingerprint Algorithm
17.9 Defining a New Output Scalar Manager
17.10 Defining a New Output Vector Manager
17.11 Defining a New Eventlog Manager
17.12 Defining a New Snapshot Manager
17.13 Defining a New Configuration Provider
17.13.1 Overview
17.13.2 The Startup Sequence
17.13.3 Providing a Custom Configuration Class
17.13.4 Providing a Custom Reader for SectionBasedConfiguration
17.14 Implementing a New User Interface
18 Embedding the Simulation Kernel
18.1 Architecture
18.2 Embedding the OMNeT++ Simulation Kernel
18.2.1 The main() Function
18.2.2 The simulate() Function
18.2.3 Providing an Environment Object
18.2.4 Providing a Configuration Object
18.2.5 Loading NED Files
18.2.6 How to Eliminate NED Files
18.2.7 Assigning Module Parameters
18.2.8 Extracting Statistics from the Model
18.2.9 The Simulation Loop
18.2.10 Multiple, Coexisting Simulations
18.2.11 Installing a Custom Scheduler
18.2.12 Multi-Threaded Programs
19 Appendix: NED Reference
19.1 Syntax
19.1.1 NED File Name Extension
19.1.2 NED File Encoding
19.1.3 Reserved Words
19.1.4 Identifiers
19.1.5 Case Sensitivity
19.1.6 Literals
19.1.7 Comments
19.1.8 Grammar
19.2 Built-in Definitions
19.3 Packages
19.3.1 Package Declaration
19.3.2 Directory Structure, package.ned
19.4 Components
19.4.1 Simple Modules
19.4.2 Compound Modules
19.4.3 Networks
19.4.4 Channels
19.4.5 Module Interfaces
19.4.6 Channel Interfaces
19.4.7 Resolving the C++ Implementation Class
19.4.8 Properties
19.4.9 Parameters
19.4.10 Pattern Assignments
19.4.11 Gates
19.4.12 Submodules
19.4.13 Connections
19.4.14 Conditional and Loop Connections, Connection Groups
19.4.15 Inner Types
19.4.16 Name Uniqueness
19.4.17 Parameter Assignment Order
19.4.18 Type Name Resolution
19.4.19 Resolution of Parametric Types
19.4.20 Implementing an Interface
19.4.21 Inheritance
19.4.22 Network Build Order
19.5 Expressions
19.5.1 Operators
19.5.2 Referencing Parameters and Loop Variables
19.5.3 The index Operator
19.5.4 The sizeof() Operator
19.5.5 Functions
19.5.6 Units of Measurement
20 Appendix: NED Language Grammar
22 Appendix: NED Functions
22.1 Category “conversion”:
22.2 Category “math”:
22.3 Category “misc”:
22.4 Category “ned”:
22.5 Category “random/continuous”:
22.6 Category “random/discrete”:
22.7 Category “strings”:
22.8 Category “units”:
22.9 Category “xml”:
23 Appendix: Message Definitions Grammar
24 Appendix: Display String Tags
24.1 Module and Connection Display String Tags
24.2 Message Display String Tags
25 Appendix: Configuration Options
25.1 Configuration Options
25.2 Predefined Variables
26 Appendix: Result File Formats
26.1 Version
26.2 Run Declaration
26.3 Attributes
26.4 Module Parameters
26.5 Scalar Data
26.6 Vector Declaration
26.7 Vector Data
26.8 Index Header
26.9 Index Data
26.10 Statistics Object
26.11 Field
26.12 Histogram Bin
27 Appendix: Eventlog File Format
27.1 Supported Entry Types and Their Attributes
28 Appendix: Figure Definitions
28.1 Built-in Figure Types
28.2 Attribute Types
28.3 Figure Attributes