readme1.txt

一个非常好的基于MATLAB的飞机动态控制工具箱,对于从事该方面研究的读者非常有参考价值

FDC 1.3 SR2         Revision date: Juny 12, 2000.
===========

   #######################################################################
   ##                                                                   ##
   ##   IMPORTANT: BEFORE INSTALLING THE FDC TOOLBOX, PLEASE READ THE   ##
   ##              LICENSE INFORMATION IN LICENSE.TXT!                  ##
   ##                                                                   ##
   #######################################################################



NOTE: this README1.TXT contains instructions for the floppy-disk version of
the FDC toolbox. If you have downloaded the toolbox via Internet, please
follow the instructions in the accompanied README-file instead and DISREGARD
the sections "Contents of the FDC diskette" and "Installing FDC 1.3" up to
and including item 7!



Contents of the FDC diskette
============================
This diskette contains the Windows 95/NT version of the FDC 1.3 toolbox,
which uses Windows-based self-extracting ZIP technology by PKWare. If you
want to run the toolbox on a different type of computer, please contact the
author (preferrably by e-mail, see the contact address below). It is for
instance possible to obtain the package stored in `ordinary' ZIP-file
format, or an unpacked version of the toolbox. Alternatively, use a Windows
95/NT platform to extract the toolbox from the self-extracting ZIP file,
and copy the resulting files to your own computer afterwards.


Installing FDC 1.3
==================
WARNING: STARTING WITH THIS RELEASE, ONLY MATLAB 5.1 / SIMULINK 2.1 OR
HIGHER WILL BE SUPPORTED. DO NOT UPGRADE TO FDC 1.3 IF YOU STILL USE
MATLAB 4.x / SIMULINK 1.x!

Important: if you already use a previous version of the FDC toolbox you
must remove that package from your computer, unless you have used it to
generate your own updates of FDC systems. In that case, read README2.TXT
first before installing the new toolbox (or install the toolbox to a new
directory and then consult README2.TXT).


  1. Start Windows and insert the FDC floppy in your diskdrive.

  2. Check which directory your copy of Matlab uses as root-folder and make
     a note of this. The default setting used by the Matlab installation
     disk is C:\MATLAB, but if you have installed Matlab somewhere else,
     it is necessary to know where, because FDC will try to install itself
     in the \TOOLBOX subfolder.

  3. Run the setup-routine FDCSETUP.EXE from the floppy disk. This can be
     done in any of the following ways:
        - Click the Start button, select Run, type A:\FDCSETUP.EXE in
          the 'Open'-line, and click OK, or:
        - Double-click the My Computer icon, double-click Control Panel,
          double-click Add/Remove Programs, click Install, click Next,
          enter A:\FDCSETUP.EXE at the 'command line for installation
          program' (this is probably done automatically for you), and
          click Finish, or:
        - Open Windows Explorer, select the floppy-drive and double-click
          FDCSETUP.EXE,

  4. A self-extracting ZIP window will be opened. Verify the destination
     folder and drive in the field 'Extract To'. By default the FDC toolbox
     will be copied to the folder C:\MATLAB\TOOLBOX\FDC13, where C:\MATLAB
     is assumed to be the Matlab root-folder. Compare this with the note
     you made in step 2. If your Matlab copy uses a different root folder
     or drive, change this in the 'Extract To' field.

  5. Check that the 'Recreate subdirectories' and 'Display messages'
     options are activated (below the directory-list on the left-hand
     side of the self-extracting ZIP window).

  6. If you haven't read LICENSE.TXT yet, please press the Information
     button at the bottom-line of the self-extracting ZIP window to read
     the license agreement. If you don't agree with these rules, please
     quit the installation now.

  7. Click on the Extract button at the bottom of the self-extracting
     ZIP window to unpack the toolbox.

  8. Start Matlab 5.1 or higher. At the command-line, type:

        chdir a:\
        firstrun

     The macro FIRSTRUN will call PATHEDIT, which allows you to add the
     FDC root-directory to the Matlabpath and save this path for future
     sessions. Do this in order to simplify future FDC sessions.

  9. Type:

        fdc

     at the command-line. Watch the introduction messages, and verify the
     definition of the FDC root-folder once more (just to be sure that
     everything will work correctly).

 10. The user-menu will now guide you to the main FDC library FDCLIB, text-
     based on-line help about the directories in the Matlabpath (including
     the FDC subdirectories; double-click the directory names for more
     information), and HTML-based help-texts. This will get you started
     with FDC 1.3. Refer to the program manual for more information.

     Note: if your web-browser is not opened automatically when you select
     the button for HTML-based on-line help, you must first open your
     web browser manually. This situation occurs, for instance, if you
     apply Netscape Communicator 4.0. The help-texts are best viewed with
     MS Internet Explorer 3.0 or higher.


Installing FDC 1.3 to a different folder
========================================
By default, FDC 1.3 uses the \TOOLBOX folder of Matlab for storing the FDC
root-folder \FDC13 and all FDC subfolders. It is possible to extract the
toolbox to any other folder, e.g. G:\MYTOOLS\FDC13, although this is NOT
recommended. To achieve this, specify the desired destination directory in
the self-extracting ZIP window and amend step 8 in the installation process
as follows:

   5. Start Matlab 5.1 or higher. Go to the folder to where you installed
      FDC 1.3, e.g. for the example folder above, type:

          chdir g:\mytools\fdc13
          editpath

      The EDITPATH tools is called to add the FDC root-folder to the
      Matlabpath. Now type:

          fdc

      view the welcome screens, and answer 'N' to the question whether the
      FDC-tree is correct! Change the default FDC root-folder to
      G:\MYTOOLS\FDC13!  Now proceed as before.

Note: if you change your mind about the FDC root-folder AFTER installing
the toolbox, just copy the whole tree and follow the same steps again.
Change the Matlabpath definition accordingly (use EDITPATH to do so)!


Next FDC sessions
=================
Each next time you want to start an FDC session, you must run FDC.M to
include all subfolders of the toolbox. So type:

    fdc

at the command-line.

If you use the FDC toolbox frequently, it may be a good idea to add all
FDC subfolders to the Matlabpath permanently. The easiest way to do so
is to run EDITPATH directly after starting Matlab don't run FDC.M this
time), use the 'Browse' function to find the FDC subfolders, and select
the 'Add path' option for each subfolder. The FDC subfolders which should
be included are:

   \AIRCRAFT
   \APILOT
   \DATA
   \EXAMPLES
   \HELP
   \NAVIGATE
   \TOOLS
   \WIND

(adding \DOC is not really necessary).


Uninstalling FDC 1.3
====================
The toolbox can be uninstalled easily by deleting the FDC root-folder
(MATLABROOT\TOOLBOX\FDC13, which is usually C:\MATLAB\TOOLBOX\FDC13),
including all subfolders. If you have added the FDC directories permanently
to your Matlabpath, don't forget to delete the FDC directories from the
Matlabpath again.


System requirements
===================
FDC 1.3 requires Matlab 5.1 / Simulink 2.1 or higher. It was tested
successfully on a Pentium 133 PC with 24 Mbytes of main memory. The
minimum system requirements for Matlab 5.x / Simulink 2.x are most
likely sufficient for using the FDC toolbox. Note: this version of
the toolbox requires approximately 5 Mbytes space on your harddisk.


Getting started with open-loop simulations of the `Beaver'
==========================================================
If you want to make an open-loop simulation of the `Beaver', proceed as
follows:

1. Open the system OLOOP1 by typing oloop1 at the command-line, or by
double-clicking its 'button-block' in the main FDC library FDCLIB. Notice
that by default it contains a block-shaped input to the elevator, which
allows us to monitor the short-period and phugoid motions of the aircraft.

2. Double-click the 'LOADER' button to retrieve the model parameters.
In the list-box that will be displayed, select the file AIRCRAFT.DAT.

3. Double-click the 'INCOLOAD' button and select the option 'Load trimmed
flight condition'. A list-box will be opened, containing all files with
extension TRI. A file-name like 'CR4520.TRI' means: a wings-level steady-state
flight condition in CRuise flight at 45 m/s and flightlevel 020 (2000 ft). So,
for instance, select for instance CR4520.TRI.

4. Start the simulation. One of the output variables from the aircraft model
will be plotted automatically, others may be shown after the simulation has
finished (which is after having determined the aircraft motions for a period
of 120 seconds after applying the block-input).

5. Double-click the button RESULTS. This will open a Matlab macro that runs
in the command-window. Select the angles to be expressed in degrees and the
angular velocities to be expressed in degrees per second. The time-trajectories
of all outputs have now been converted to vectors in the Matlab workspace with
self-explaining variable-names. They can be plotted with commands like:

   plot(time,alpha);
   plot(time,p);
   plot(time,Hdot);
   plot(time,deltae);

and so on. Or run the plotting-macro RESPLOT by typing:

   resplot

at the command-line. See the user's manual for more information.


Possible problems and how to solve them
=======================================
   Missing block diagrams?!?
   -------------------------
   All graphical Simulink models were created under a screen-resolution
   of 800x600 pixels. In order to prevent them from being hidden for
   users who run Simulink under a lower screen-resolution, the block-
   diagrams have been positioned in the upper-left corner of the
   screen. However, there is still a chance that one or more systems
   have slipped through this positioning process. So if you don't see
   anything appearing when you open a graphical system or double-click
   a subsystem block, try using the 'tile' or 'cascade' options of MS
   Windows. It is likely that this will reveal the 'missing' block-
   diagrams.

   Nothing happens?!?
   ------------------
   Sometimes, if you double-click a title-block in a graphical Simulink
   system, or press a button of a graphical user menu, it may seem that
   nothing happens. In that case, check out the command window! It is
   very likely that the program expects you to enter something in there.
   If your screen is large enough, it is recommended to keep the command
   window constantly in view to solve this problem. Unfortunately,
   Simulink does not automatically activate the command window if
   something is displayed in there. In future versions of the FDC toolbox
   I will try to avoid using the command-window as much as possible...


More Information
================
After installing the FDC package, the subdirectory DOC will contain the
following additional information files for FDC 1.3:

CONTENTS.TXT    gives a complete overview of the files from FDC 1.3
HISTORY.TXT     gives an overview of the FDC development since the very
                fist version
LICENSE.TXT     license agreement (IMPORTANT!)
README1.TXT     this file (IMPORTANT!)
README2.TXT     gives background information about compatibility problems
                you may encounter when upgrading from a previous version
                of the FDC toolbox
SUPPORT.TXT     gives information about the user-support for FDC 1.3
WHATSNEW.TXT    lists the new features in FDC 1.3 (IMPORTANT!)
WHATSNEX.TXT    lists planned features for future versions of the FDC
                toolbox


References
==========
The main source of information regarding the FDC 1.2 toolbox is the
following report:

   FDC 1.2 - A Simulink Toolbox for Flight Dynamics and Control
   Analysis. M.O. Rauw, Zeist, The Netherlands, 1996.

If you don't have this report in your posession, it can be downloaded from
the FDC website www.dutchroll.com. Or contact the author at the adress given
below (preferrably by e-mail).


Viruses?!?
==========
The compressed FDC 1.3 distribution files have been thoroughly scanned
for viruses with an up-to-date virus-scanner. If you have obtained an
'official' version of the package, this is also true for the distribution
diskette itself. But no virus-scanner can be 100% safe, so a regular
check of your own system while keeping your own scanners up-to-date
is (of course) recommended.


Contact address
===============
M.O. Rauw
Schuilenburg 14
2036 BL  The Netherlands

FDC homepage: http://www.dutchroll.com
e-mail      : [e-mail]

Note: these addresses may be subject to change.

-------------------------------------------------------------
FDC 1.3. Copyright Marc Rauw, 1994-2000. All rights reserved.