-------------------------------------------- INSTALLATION PROCESS (& BRIEF INTRODUCTION): -------------------------------------------- (A few minutes only are necessary for reading and installing!) 00-Subscribe to the Software Package AIRY mailing-list ! Either by pointing your browser to https://sympa-n.oca.eu/wws/info/airy and following the instructions therein, or by sending a message to sympanice@oca.eu with no subject and the following instruction in the body of the message: subscribe airy my.email@address [Subscribing to this mailing-list will insure you to receive new versions/patches/updates related to the Software Package AIRY and the CAOS Problem-Solving Environment (PSE).] 01-First install the structure of the CAOS PSE (from http://lagrange.oca.eu/caos/caos_pse/). 02-Change directory to .../caos_pse/packages/, then click on the link "Soft.Pack.AIRY 7.2 archive file" and download the file "AIRY_Software_Package_7.2.tar.gz" (with, e.g., "tar xvfz"). A directory called "AIRY_Software_Package_7.2" will be created. Note that you will need to eliminate the ".tar" file when unpacking is concluded - in fact NO OTHER FILES than the set of modules (packages) have to be present in the "packages" directory. 03-Please note that some modules of this distribution also need 3 other libraries: - the IDL Astronomy User's Library, commonly called "astrolib". This library is available from http://idlastro.gsfc.nasa.gov. - the "Coyote" routines (the version distributed on the same web-page as "astrolib"). - the "Markwardt IDL Library", by Craig B. Markwardt, available from: https://www.physics.wisc.edu/~craigm/idl Please note that within the Soft.Pack.AIRY, only the MPFIT package is used, thus, if you prefer, you can install only that package (available from https://www.physics.wisc.edu/~craigm/idl/fitting.html). 04-Change directory to .../work_caos/ (or "work_airy"), then click on the link "Example projects using the Soft.Pack.AIRY 7.2" and unpack the downloaded file Projects.tar.gz, containing the directory "Projects" where some example projects can be found. 05-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 or .bashrc and .profile files. See the "trick" (point 04 of the "Final Remarks") given at the end of this file to avoid this step and step 09 here below.] 06-Launch IDL [See the "trick" (point 04 of the "Final Remarks") given at the end of this file to avoid this step and step 08 here above in the UNIX/LINUX/ MACOSX cases.] 07-Type "worksheet" at the CAOS prompt in order to use the CAOS Application Builder (global user interface of the CAOS PSE.) 08-Type "@compile_all_AIRY_modules" in order to re-generate the default parameter files of the whole set of modules (upgrading so any possible pre-defined path). 09-You can find some examples in work_caos/Projects to play around with. Let open one example project from the worksheet ("File"->"Open Project"). NB: steps 00,01,02,03,04,08 are necessary just once: during installation. ------------------- SOME FINAL REMARKS: ------------------- 00-Refer to the template module XXX for a guide for writing a new module and so include your IDL code within the CAOS PSE (and submit it to us for inclusion in future distributions). 01-Refer to http://lagrange.oca.eu/caos for further information on the CAOS Problem-Solving Environment and its packages (or for submission of bug fixes, new modules, etc.). 01A-Refer to http://www.airyproject.eu for further information on the Software Package AIRY (or for submission of bug fixes concerning the Software Package AIRY, new modules for the Soft.Pack.AIRY, etc.). 02-Please never redistribute any CAOS or AIRY part by yourself, rather refer to http://lagrange.oca.eu/caos -- or at least recommend step 00 of the installation instructions ! 03-A first paper about the Software Package AIRY was Correia, S., Carbillet, M., Boccacci, P., Bertero, M., & Fini, L. 2002, Astron Astrophys, 387, 733 The last paper, presenting the last version of AIRY (7.1) together with the vadvances of the whole CAOS PSE, has been presented at the AO4ELT#5 conference held in Tenerife, Spain) in June 2017 (“The CAOS Problem- Solving Environment: tools for AO numerical modelling and post-AO deconvolution”, M. Carbillet & A. La Camera). 04-UNIX/LINUX/MACOSX cases: If you wish to use different Software Packages but would like to have the simulation projects made with different installed packages in different locations (not all the simulation projects in the same "work_caos/Projects" directory), there is a solution which still permits to use modules from the various Software Packages together anyway: A-Make one working directory per Software Package (e.g. work_caos and work_airy). B-Add one alias for each installed Software Package in your .cshrc or .bashrc (and .profile) file, for example for the Soft.Pack.AIRY: alias airy='source YOUR_PATH/work_airy/caos_env.sh ; idl' C-Then simply type "airy" to launch IDL+the CAOS PSE+move in the chosen working directory, all together. 05-New projects start within the worksheet with "File"->"New Project". Modules are put within the worksheet through button "Modules", and can be cloned or deleted using "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. In order to link two modules, click on the output of the first one and then click on the input of the second one. 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 at any moment. 06-For a detailed tutorial refer to: http://www.airyproject.eu/Tutorials/AIRY/index.html 07-In order to run a project, for example "Strehl Constrained IBD Example": > .rn ./Projects/StrehlConstrained_IBD_Example/project.pro or alternatively use button "Run" of the CAOS Application Builder. --------------------------------------------------------------------- CONTRIBUTORS TO THIS DISTRIBUTION OF THE SOFTWARE PACKAGE AIRY (7.2): --------------------------------------------------------------------- - Andrea La Camera (DIBRIS, Univ. di Genova) [andrea.lamera@unige.it], - Marcel Carbillet (Lagrange, UCA, OCA, CNRS) [marcel.carbillet@unice.fr]. --------------------------------------------------------------- Last revision: 2017/11/24 - Andrea La Camera & Marcel Carbillet