-------------------------------------------- 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.1 archive file" and download the file AIRY_Software_Package_7.1.tar.gz (with, e.g., "tar xvfz"). A directory called "AIRY_Software_Package_7.1" 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 two other libraries: - the IDL Astronomy User's Library, commonly called "astrolib". This library is available from http://idlastro.gsfc.nasa.gov. - And the "Coyote" routines (the version distributed on the same web-page as "astrolib"). 04-Change directory to .../work_caos/, then click on the link "Example projects using the Soft.Pack.AIRY 7.1" 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. 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 (7.0), has been presented at the SPIE "Astronomical Telescopes & Instrumentation" conference held in Edinburgh, june-july 2016 (paper n. 9909-297). 04-UNIX/LINUX/MACOSX cases: If you will 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 Software Package CAOS: 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 CAOS 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.1): --------------------------------------------------------------------- - Andrea La Camera (DIBRIS, Univ. di Genova) [andrea.lamera@unige.it], - Marcel Carbillet (Lagrange, UNS/CNRS/OCA) [marcel.carbillet@oca.eu]. ------------------------------------------------------------- Completed December 2016 - Andrea La Camera & Marcel Carbillet