--------------------------------------------
INSTALLATION PROCESS (& BRIEF INTRODUCTION):
--------------------------------------------

00-subscribe to the CAOS mailing-list !
   ... either by pointing your browser to
      http://www.arcetri.astro.it/mailman/listinfo/caos
   and following the instructions therein, or by sending a blankmessage to
      caos-subscribe@arcetri.astro.it
   [Subscribing to this mailing-list will insure you to receive new
   versions, patches, and updates related to the Software Package CAOS, the
   CAOS Library, and the CAOS Application Builder.]

01-first install the whole "CAOS system" (or better called the "CAOS
   Problem Solving Environment") including the CAOS Application Builder 6.0+
   and the CAOS Library 5.0+.

02-change directory to .../caos/packages/

03-unpack there CAOS_Software_Package_5.2.tar.gz, containing the directory
   named "CAOS_Software_Package_5.0" where the modules of the Software
   Package CAOS 5.2 are located. note that you need to eliminate the tar
   file when unpacking is concluded. in fact NO OTHER FILES than the set
   of modules (packages) have to stay in the "packages" directory.

04-please note that some modules of this distribution also need the IDL
   Astronomy User's Library, commonly called "astrolib". This library is
   available from http://idlastro.gsfc.nasa.gov.

05-change directory to .../work_caos/

06-unpack there CAOSSoftPack5.2_ExampleProjects.tar.gz, containing the directory
   "Projects" where some examples using the CAOS Soft.Pack.5.2 are included.

07-verify that you have write permission on the unpacked files.

08-UNIX/LINUX/MACOSX CASES: type "source caos_env.csh" (or .sh).
   [Note that this is to be done for each opened shell where you will use
   IDL together with CAOS. Alternatively you can move the content of the
   file caos_env.csh into your .cshrc].

09-launch IDL

10-type "caos_init" at the IDL prompt in order to use the whole CAOS system
   (gives acces to the CAOS Application Builder and all the installed
   Software Packages)

11-type "worksheet" at the CAOS prompt in order to use the CAOS Application
   Builder

12-you can find some examples in work_caos/Projects to play around with.
   let open one from the Application Builder (button "File" -> "Open
   Project").
   [follow the printed instruction to run the open example project
   (typically ".r ./Projects/name_of_the_project/project.pro"). new
   projects start with button "File" -> "New Project". modules are put
   within the Application Builder through button "Modules", and can be
   cloned or deleted using button "Edit" -> "Clone module" or "Edit" ->
   "Delete item". each color at the left- or right-side of a module
   represents a type of input or output. currently defined types are
   atmosphere (atm_t - brown), wavefront (wfp_t - yellow), image (img_t -
   blue), multiple image (mim_t - dark blue), measure (mes_t - green),
   source (src_t - purple), commands (com_t - ligth blue), and structure
   function (stf_t - red). to link two modules click on the output of the
   first one and then click on the input of the second one. to close a loop
   use special module "S*S - feedback stop". when the design of your
   simulation is completed, including setting of the total number of
   iterations, save the project using "File" -> "Save Project". then you
   can set the parameters related to each module using its dedicated GUI
   called by clicking on the module. for a detailed example refer to the
   tutorial given on the CAOS web-page.]

NB: steps 0,1,3,4,6,7 are necessary just once: during installation.



-------------------
SOME FINAL REMARKS:
-------------------

00-read the Known_Issues in which you can find the solution on some
   problems encountered when using CAOS the first time.

01-refer to the Template Package and included module xxx for a guide for
   writing a new module and so include your IDL code within the CAOS
   structure - a ReadMe file is also included.

02-refer to
      http://www.arcetri.astro.it/caos
      http://www-astro.unice.fr/caos
   and to
      caos-team@arcetri.astro.it
   for further informations on the CAOS system (or for submission of bug
   fixes, new useful modules, etc.).

03-please never redistribute any CAOS part by yourself, rather refer to
   previous step -- or at least recomend step 0!

04-a paper about this version of the CAOS Software Package is published in
   MNRAS (Monthly Notices of the Royal Astronomical Society). complete
   reference is:

   Marcel Carbillet, Christophe Verinaud, Bruno Femenia, Armando Riccardi
   and Luca Fini
   Modelling Astronomical Adaptive Optics - I. The Software Package CAOS 
   MNRAS Volume 356 Number 4, page 1263 (1st February 2005 Issue)

05-in order to be able to use the FFTWND C-written routine in alternative
   to the standard IDL FFT routine, please read (and follow the
   instructions within) the file "FFTWNDPackage_Installation.txt".


---------------------------------------------------------------------
CONTRIBUTORS TO THIS DISTRIBUTION OF THE SOFTWARE PACKAGE CAOS (5.2):
---------------------------------------------------------------------
- Marcel Carbillet       (LUAN)          [marcel.carbillet@unice.fr]


-----------------------------------
written april 2007 - Marcel Carbillet