毕业设计&课设-一个开源的飞行动力学&amp；控制软件库.zip

# JSBSim interface with MATLAB JSBSim provides an S-Function to interface your flight dynamics model with MATLAB and Simulink. Below are the instructions to build the S-Function from JSBSim Windows installer. ## Build instructions for MacOS ### Download and build JSBSim from source Download the JSBSim source from [JSBSim release section](https://github.com/JSBSim-Team/jsbsim/releases/tag/v1.2.0). Alternatively, you can clone the source using git: ```bash > git clone https://github.com/JSBSim-Team/jsbsim/tree/v1.2.0 ``` Build the source following the instructions in the [JSBSim Manual](https://jsbsim-team.github.io/jsbsim-reference-manual/mypages/quickstart-building-the-program/). Since we are using MacOS, we must build with CMake. ### Preparation for MATLAB In order to work with the JSBSim MATLAB S-Function block, we must move some files into the `build/` directory. From the command line, make sure your current directory is the root of the `jsbsim/` source code. ```bash > pwd /path/to/jsbsim ``` Then, we must copy some files into the build. These are necessary for the S-Function to operate. ```bash > cp -r aircraft build/src/aircraft > cp -r engine build/src/engine > cp -r scripts build/src/scripts ``` ### Compile the S-Function and Move Compiled Files In `jsbsim/matlab` open `JSBSimSimulinkCompiler.m` and entire that the line below `For MacOS:` is the only one that is not commented out. In the MATLAB command line, run the script. Then, from the root of the source code, copy the following files into the build source: ```bash > cp matlab/JSBSim_SFunction.mexmaci64 build/src/JSBSim_SFunction.mexmaci64 > cp matlab/ex737cruise.slx build/src/ex737cruise.slx > cp matlab/TestJSBSim.m build/src/TestJSBSim.m > cp matlab/clearSF.m build/src/clearSF.m ``` You can now follow the test instructions below in order to ensure it is in working condition. Once you have the S-Function compiled, you just need `aircraft/` and `engine/` alongside the compiled `JSBSim_SFunction.mexmaci64` in order for it to work. You also nede to be sure that the script in the S-Function parameter is in the correct location. ## Build instructions for the Windows platform ### Download and install JSBSim A Windows installer `JSBSim-1.2.0-setup.exe` is available from [JSBSim release section](https://github.com/JSBSim-Team/jsbsim/releases/tag/v1.2.0). Download the installer and set up JSBSim in the following local directory tree ```bash <JSBSim root>/ aeromatic++/ aircraft/ data_output/ engine/ include/ lib/ matlab/ scripts/ systems/ COPYING JSBSim.exe msvcp140.dll ``` The exact location `<JSBSim root>/` on your system depends on where you choose to install JSBSim. > **NOTE:** The JSBSim library file located at `lib\JSBSim.lib` has been compiled with Microsoft Visual Studio Enterprise 2019 (build 16.11.34114.132) ### Prepare MATLAB The following steps are tested for *Matlab v2020b*. To compile the file `<JSBSim root>/matlab/JSBSim_SFunction.cpp` and get the MEX-File `JSBSim_SFunction.mexw64` on Windows, you need a working C++ compiler. Among the available options, we suggest using [Visual Studio Community Edition](https://visualstudio.microsoft.com/). Once you have a working C++ development environment, you need to tell the MEX utility what is the default C++ compiler. This can be achieved by executing the following command from the Matlab command line: `[Matlab prompt]>> mex -setup CPP` MEX will detect your C++ compiler and will be configured to build your `*.mexw64` files. ### Run the JSBSim script for MATLAB The MATLAB script `<JSBSim root>/matlab/JSBSimSimulinkCompile.m` default setting is to compile the S-Function from the folder `<JSBSim root>/matlab`. If needed, you can customize the script to your own needs. Once done, change the current *Matlab Working Directory* to `<JSBSim root>/matlab` and run `JSBSimSimulinkCompile.m` either from the Matlab editor or from the command line: `[Matlab prompt]>> JSBSimSimulinkCompile` After the completion of the compilation you should have the following MEX-file `<JSBSim root>/matlab/JSBSim_SFunction.mexw64`. ### Test the S-Function To verify that the MEX file has been built successfully, we will now run the example script provided with JSBSim. First of all, copy the script `<JSBSim root>/matlab/TestJSBSim.m` to the root directory `<JSBSim root>`. This makes sense, because we want a Matlab EXecutable (MEX) that lives besides `<JSBSim root>/JSBSim.exe`, and that must be able to reach all input files in the directories `aircraft`, `engine`, `scripts`, and `systems`. Proceed with the Simulink example file `ex737cruise.slx` and the MEX file `JSBSim_SFunction.mexw64` and copy them both from the folder `<JSBSim root>/matlab/` to the root directory `<JSBSim root>/`. You should now have a script `<JSBSim root>/TestJSBSim.m` that contains the following instructions: ```matlab disp('Run 737 example'); fprintf('Current directory: %s', pwd) sim('ex737cruise'); clear functions; clear all; disp('JSBSim S-Function Reset'); ``` and this is a Simulink screenshot once the file `<JSBSim root>/ex737cruise.slx` is open:  In particular, this is how the Simulink block named `JSBSim_SFunction` appears when you double-click on it:  When you run the test script you'll get the foloowing output in the Matlab command window: ```matlab >> TestJSBSim Run 737 example Current directory: C:\Users\agodemar\JSBSim Warning: 'Output Port 3' of 'ex737cruise/S-Function' is not connected. > In TestJSBSim (line 3) JSBSim Flight Dynamics Model v1.1.8 [GitHub build 588/commit c943f83deeb3e14bed7939ac65dfac789a7a0181] Jul 24 2021 16:18:42 [JSBSim-ML v2.0] JSBSim startup beginning ... Simulation dt set to 0.008333 Script input: scripts/737_cruise Reset file: 'cruise_init' . JSBSim S-Function is initializing... Note: For Aircraft with integrators in the FCS, please type 'clearSF' to completely reset S-Function. Setting up JSBSim with standard 'aircraft', 'engine', and 'system' paths. Loading aircraft '737' ... Reading Aircraft Configuration File: 737 Version: 2.0 This aircraft model is a BETA release!!! This aircraft model probably will not fly as expected. Use this model for development purposes ONLY!!! Description: Models a Boeing 737. Model Author: Dave Culp Creation Date: 2006-01-04 Version: $Revision: 1.43 $ Aircraft Metrics: WingArea: 1171 WingSpan: 94.7 Incidence: 0 Chord: 12.31 H. Tail Area: 348 H. Tail Arm: 48.04 V. Tail Area: 297 V. Tail Arm: 44.5 Eyepoint (x, y, z): 80 , -30 , 70 Ref Pt (x, y, z): 625 , 0 , 24 Visual Ref Pt (x, y, z): 0 , 0 , 0 Mass and Balance: baseIxx: 562000 slug-ft2 baseIyy: 1.473e+06 slug-ft2 baseIzz: 1.894e+06 slug-ft2 baseIxy: -0 slug-ft2 baseIxz: 8000 slug-ft2 baseIyz: -0 slug-ft2 Empty Weight: 83000 lbm CG (x, y, z): 639 , 0 , -40 Ground Reactions: BOGEY Nose Gear Location: 158 , 0 , -84 Spring Constant: 90000 Damping Constant: 4000 (linear) Rebound Damping Constant: 8000 (linear) Dynamic Friction: 0.5 Static Friction: 0.8 Rolling Friction: 0.02 Steering Type: STEERABLE Grouping: NONE Max Steer Angle: 35 Retractable: 1 BOGEY Left Main Gear Location: 648 , -100 , -84 Spring Constant: 120000 Damping Constant: 10000 (linear) Rebound Damping Constant: 20000 (linear) Dynamic Friction: 0.5 Static Friction: 0.8 Rolling Friction: 0.02 Steering Type: FIXED Grouping: LEFT Max Steer Angle: 0 Retractable: 1 BOGEY Right Main Gear Locati