-------------------------------------------- INSTALLATION PROCESS (& BRIEF INTRODUCTION): -------------------------------------------- 00-subscribe to the PAOLAC mailing-list ! ... either by pointing your browser to http://fizeau.unice.fr/mailman/listinfo/paolac and following the instructions therein. [Subscribing to this mailing-list will insure you to receive new versions, patches, and updates related to the Software Package PAOLAC, the CAOS Library, and the CAOS Application Builder.] 01-first install the last version of the whole "CAOS system" (or better called the "CAOS Problem Solving Environment") including the last versions of the CAOS Application Builder (now 7.0) and the CAOS Library (now 5.2). 02-change directory to .../caos/packages/ 03-unpack there PAOLAC_Software_Package_1.0.tgz, containing the directory named "PAOLAC_Software_Package_1.0" where the modules of the Software Package PAOLAC 1.0 are located. 04-please note that this Soft.Pack. ABSOLUTELY NEEDS the regular PAOLA library to be installed - contact Laurent Jolissaint (jolissaint@strw.leidenuniv.nl) for it if necessary. 05-change directory to .../work_caos/ 06-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]. 07-launch IDL [See the "trick" (point 05 of the "Final Remarks") given at the end of this file to avoid this step and step 06 here above.] 08-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) [Alternatively and to definitely avoid this point simply add the line "caos_init" in your file "caos_startup.pro".] 09-type "worksheet" at the CAOS prompt in order to use the CAOS Application Builder NB: steps 0,1,3,4 are necessary just once: during installation. ------------------- SOME FINAL REMARKS: ------------------- 00-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. 01-refer to http://fizeau.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.). 02-please never redistribute any CAOS part by yourself, rather refer to previous step -- or at least recomend step 0! 03-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. 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. for a detailed example refer to the tutorial given on the CAOS web-page. 04-in order to run a project, for example let's say "PAOLAC-simu": > .rn ./Projects/PAOLAC-simu/project.pro or alternatively use button "Run". 05-if you are playing with 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, work_airy, work_paolac, etc.) B-add one alias for each installed Software Package in your .cshrc or .bashrc, for example for the Software Package PAOLAC: alias paolac='cd YOUR_PATH/work_paolac ; source caos_env.sh ; idl' C-simply type "paolac" to launch IDL+the CAOS system+move in the PAOLAC working directory, all together. 06-a paper about the Software Package PAOLAC will be published by EDP Sciences (proceedings of the conference "AO for ELTs" held in Paris in june 2009). (un)complete reference is: Marcel Carbillet, Laurent Jolissaint, Anne-Lise Maire, The Software Package PAOLAC: an embedment of the analytical code PAOLA within the CAOS problem-solving environment, in "Adaptive Optics for Extremely Large Telescopes", Th. Fusco & Y. ClŽnet Eds., EAS Publication Series, 2009. ------------------------------------------------------------------ CONTRIBUTORS TO THIS FIRST VERSION OF THE SOFTWARE PACKAGE PAOLAC: ------------------------------------------------------------------ - Marcel Carbillet (Fizeau) [marcel.carbillet@unice.fr] - Laurent Jolissaint (Leiden Obs.) [jolissaint@strw.leidenuniv.nl] ------------------------------------ written july 2009 - Marcel Carbillet