/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CLASS DOCUMENTATION
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/

/** \mainpage JSBSim
 * An Open Source, Object-Oriented, Cross-Platform Flight Dynamics Model in C++

 * \section intro Introduction
 *
 * JSBSim is an open source, multi-platform, object-oriented flight dynamics
 * model (FDM) framework written in the C++ programming language.  It is
 * designed to support simulation modeling of any aerospace craft without the
 * need for specific compiled and linked program code, instead relying on a
 * relatively simple model specification written in a XML format. The format is
 * formally known as JSBSim-ML (JSBSim Markup Language).
 JSBSim是一個用C ++程式語言編寫的開源，多平臺，面向物件的飛行動力學模型（FDM）框架。 
 它旨在支援任何航空航天工藝的模擬建模，而無需特定的編譯和連結程式程式碼，而是依賴於以XML格式編寫的相對簡單的模型規範。
 格式正式稱為JSBSim-ML（JSBSim標記語言）
 *
 * JSBSim (www.jsbsim.org) was created initially for the open source FlightGear
 * flight simulator (www.flightgear.org), where it replaced LaRCSim (Langley
 * Research Center Simulation) as the default FDM.  JSBSim also maintains the
 * ability to run in a standalone, batch mode.  This is useful for running tests
 * or sets of tests automatically using the internal scripting capability.
 JSBSim（www.jsbsim.org）最初是為開源FlightGear飛行模擬器（www.flightgear.org）建立的，
 它取代了LaRCSim（Langley Research Center Simulation）作為預設FDM。 
 JSBSim還保持以獨立批處理模式執行的能力。 
 這對於使用內部指令碼功能自動執行測試或測試集非常有用。
 *
 * Differently from LaRCSim, JSBSim does not model specific aircraft in program
 * code. The aircraft itself is defined in a file written in an XML-based format
 * where the aircraft mass and geometric properties are specified.  Additional
 * statements define:
 與LaRCSim不同，JSBSim不會在程式程式碼中為特定飛機建模。 
 飛機本身在以基於XML的格式編寫的檔案中定義，其中指定了飛機質量和幾何屬性。 
 附加宣告定義：
 *
 * - Landing gear location and properties.
 * - Pilot eyepoint
 * - Additional point masses (passengers, cargo, etc.)
 * - Propulsion system (engines, fuel tanks, and "thrusters")
 * - Flight control system
 * - Autopilot
 * - Aerodynamic stability derivatives and coefficients
 *  - 起落架的位置和屬性。
 *  - 飛行員眼點
 *  - 附加點質量（乘客，貨物等）
 *  - 推進系統（發動機，油箱和“推進器”）
 *  - 飛行控制系統
 *  - 自動駕駛儀
 *  - 空氣動力學穩定性導數和係數
 *
 * The configuration file format is set up to be easily comprehensible, for
 * instance featuring textbook-like coefficients, which enables newcomers to
 * become immediately fluent in describing vehicles, and requiring only prior
 * basic theoretical aero knowledge.
 配置檔案格式被設定為易於理解，例如具有類似教科書的係數，
 這使得新手能夠立即流暢地描述車輛，並且僅需要先前的基本理論空氣動力學知識。
 *
 * One of the more unique features of JSBSim is its method of modeling flight
 * control systems and an autopilot.  These are modeled by assembling strings
 * of components that represent filters, switches, summers, gains, sensors, etc.
 JSBSim的一個更獨特的功能是它的飛行控制系統建模方法和自動駕駛儀。 
 這些是通過組裝代表濾波器，開關，加法器，增益，感測器等的元件串來建模的。
 *
 * Another unique feature is displayed in the use of "properties".  Properties
 * essentially expose chosen variables as nodes in a tree, in a directory-like
 * hierarchy.  This approach facilitates plugging in different FDMs into
 * FlightGear, but it also is a fundamental tool in allowing a wide range of
 * aircraft to be modeled, each having its own unique control system,
 * aerosurfaces, and flight deck instrument panel.  The use of properties allows
 * all these items for a craft to be modeled and integrated without the need for
 * specific and unique program source code.
 使用“屬性”時會顯示另一個獨特的功能。 屬性實質上將所選變數作為樹中的節點暴露在類似目錄的層次結構中。 
 這種方法有助於將不同的FDM插入FlightGear，但它也是允許對各種飛機進行建模的基本工具，
 每種飛機都有自己獨特的控制系統，航空表面和駕駛艙儀表板。 
 使用屬性允許對工藝的所有這些專案進行建模和整合，而無需特定和唯一的程式原始碼。
 *
 * The equations of motion are modeled essentially as they are presented in
 * aerospace textbooks for the benefit of student users, but quaternions are
 * used to track orientation, avoiding "gimbal lock". While JSBSim is
 * designed to model primarily atmospheric flight at lower speeds, coriolis and
 * centripetal accelerations are incorporated into the EOM to
 * permit a wider range of vehicles to be simulated.
 運動方程基本上是為了學生使用者的利益在航空航天教科書中進行建模，但四元數用於跟蹤方向，避免“萬向節鎖定”。 
 雖然JSBSim設計用於以較低速度主要模擬大氣飛行，但科隆和向心加速度被整合到EOM中，以允許模擬更廣泛的載具。
 *
 * Currently under development is an expansion of the atmospheric modeling for
 * JSBSim.  The existing model approximates the standard atmosphere of 1976.
 * Recently, source code for the NRLMSISE-00 model was obtained and this is
 * being implemented as a C++ class that can optionally be used.  Also, a simple
 *  Mars atmosphere is being implemented.
 目前正在開發的是JSBSim的大氣模型的擴充套件。 現有模型近似於1976年的標準大氣。
 最近，獲得了NRLMSISE-00模型的原始碼，並且這是作為可以選擇使用的C ++類實現的。
 此外，正在實施簡單的火星氣氛。
 *
 * JSBSim can output (log) data in a configurable way.  Sets of data that are
 * logically related can be selected to be output at a chosen rate, and
 * individual properties can be selected for output.  The output can be streamed
 * to the console, or to a file, and can also be transmitted through a socket.
 JSBSim可以以可配置的方式輸出（記錄）資料。 
 可以選擇邏輯相關的資料集以選擇的速率輸出，並且可以選擇各個屬性用於輸出。 
 輸出可以流式傳輸到控制檯或檔案，也可以通過套接字傳輸。
 *
 * JSBSim has been used in a variety of ways:
 *
 * - For developing control laws for a sounding rocket
 * - For crafting an aircraft autopilot as part of a thesis project
 * - As a flight model for FlightGear
 * - As an FDM that drives motion base simulators for some
 *   commercial/entertainment simulators
 *
 * \section Supported Platforms:
 * JSBSim has been built on the following platforms:
 *
 *   - Linux (x86)
 *   - Windows (MSVC, Cygwin, Mingwin)
 *   - SGI (native compilers)
 *   - Mac OS X
 *   - FreeBSD
 *
 * \section depends Dependencies
 *
 * JSBSim has no dependencies at present.
 *
 * \section license Licensing
 *
 * JSBSim is licensed under the terms of the Lesser GPL (LGPL)
 *
 * \section website Website
 *
 * For more information, see the JSBSim web site: www.jsbsim.org.
 */

譯文：

JSBSim是一個用C ++程式語言編寫的開源，多平臺，面向物件的飛行動力學模型（FDM）框架。
它旨在支援任何航空航天工藝的模擬建模，而無需特定的編譯和連結程式程式碼，而是依賴於以XML格式編寫的相對簡單的模型規範。
格式正式稱為JSBSim-ML（JSBSim標記語言）

JSBSim（www.jsbsim.org）最初是為開源FlightGear飛行模擬器（www.flightgear.org）建立的，
它取代了LaRCSim（Langley Research Center Simulation）作為預設FDM。
JSBSim還保持以獨立批處理模式執行的能力。
這對於使用內部指令碼功能自動執行測試或測試集非常有用。

與LaRCSim不同，JSBSim不會在程式程式碼中為特定飛機建模。
飛機本身在以基於XML的格式編寫的檔案中定義，其中指定了飛機質量和幾何屬性。
附加宣告定義：

* - 起落架的位置和屬性。
 * - 飛行員眼點
 * - 附加點質量（乘客，貨物等）
 * - 推進系統（發動機，油箱和“推進器”）
 * - 飛行控制系統
 * - 自動駕駛儀
 * - 空氣動力學穩定性導數和係數

配置檔案格式被設定為易於理解，例如具有類似教科書的係數，
這使得新手能夠立即流暢地描述車輛，並且僅需要先前的基本理論空氣動力學知識。

JSBSim的一個更獨特的功能是它的飛行控制系統建模方法和自動駕駛儀。
這些是通過組裝代表濾波器，開關，加法器，增益，感測器等的元件串來建模的。

使用“屬性”時會顯示另一個獨特的功能。 屬性實質上將所選變數作為樹中的節點暴露在類似目錄的層次結構中。
這種方法有助於將不同的FDM插入FlightGear，但它也是允許對各種飛機進行建模的基本工具，
每種飛機都有自己獨特的控制系統，航空表面和駕駛艙儀表板。
使用屬性允許對工藝的所有這些專案進行建模和整合，而無需特定和唯一的程式原始碼。

運動方程基本上是為了學生使用者的利益在航空航天教科書中進行建模，但四元數用於跟蹤方向，避免“萬向節鎖定”。
雖然JSBSim設計用於以較低速度主要模擬大氣飛行，但科隆和向心加速度被整合到EOM中，以允許模擬更廣泛的載具。

目前正在開發的是JSBSim的大氣模型的擴充套件。 現有模型近似於1976年的標準大氣。
最近，獲得了NRLMSISE-00模型的原始碼，並且這是作為可以選擇使用的C ++類實現的。
此外，正在實施簡單的火星氣氛。

JSBSim可以以可配置的方式輸出（記錄）資料。
可以選擇邏輯相關的資料集以選擇的速率輸出，並且可以選擇各個屬性用於輸出。
輸出可以流式傳輸到控制檯或檔案，也可以通過套接字傳輸。