When extracting ARTIST-.tgz, the content of the archive was extracted into a directory ARTIST. In this README, this directory is referred to as ARTIST/. This README file is located in ARTIST/. Prerequisites: ============== In order to install and use ARTIST, the following programs and libraries have to be present on your system: - gcc, including gcc-c++ - python2 and python-devel - swig - cfitsio and cfitsio-devel - gsl and gsl-devel - ncurses-devel - qhull and qhull-devel The exact names of the required packages which are not part of a basic OS installation for a number of OSs are given in the configuration file templates ARTIST/install/Makefile.defs_xxx. See below for more information concerning these configuration file templates. Installing ARTIST: ================== Installing ARTIST is done in three steps: 1. Configuration: ----------------- All settings that make up the configuration for your system are done in the file ARTIST/install/Makefile.defs that will be included into ARTIST's Makefile ARTIST/Makefile during compilation. Settings include Python version, location of the Python header and library files, the path to the swig binary, and the location of header and library files used by LIME. ARTIST comes with templates for ARTIST/install/Makefile.defs for various systems. You will find these templates in ARTIST/install/. It is recommended to copy the template that fits your system best to ARTIST/install/Makefile.defs, and to adjust the settings in this file. We hope that the comments in the templates are clear enough to make adjustments easy. 2. Compilation: --------------- Once configuration is done, cd into ARTIST/ and command > make or > make all This will perform all necessary compilations of the modellib, LIME, and the Python interface to both. 3. Installation: ---------------- In ARTIST/, the command > make install will copy ARTIST's libraries, Python modules, include files, and definition files for the CASA interface into their final directories. By default, these directories are the directories ARTIST/lib/, ARTIST/include/, and ARTIST/casa. The final directories may be adjusted either by setting the variable DESTDIR in ARTIST/Makefile, or by commanding > make install prefix= ARTIST's libraries and header files will then be installed into the sub-directories lib/, include/, and casa/ of the specified destination directory. Running 'make install' will create ARTIST's startup files ARTIST/artistrc.sh and ARTIST/artistrc.csh. These startup files contain settings to allow smooth execution of ARTIST for sh or bash (artistrc.sh) and csh or tcsh (artistrc.csh). The startup files may be copied and renamed without affecting their function. Removing intermediate products of the installation: =================================================== In ARTIST/, the command > make clean will remove all intermediate products of the installation, such as object files, which were created when performing 'make all'. Uninstalling ARTIST: ==================== To uninstall ARTIST, run > make uninstall in ARTIST/. This will remove ARTIST's libraries, Python modules, include files and all files of the CASA interface from the directories to which they were installed with 'make install'. The directories itself will not be removed, even if they were created during the installtion. If they are to be removed as well, you will have to do so manually. If ARTIST was installed to non-default directories with 'make install prefix= ', use > make uninstall prefix= Running 'make uninstall' will remove ARTIST's startup files ARTIST/artistrc.sh and ARTIST/artistrc.csh. Using ARTIST: ============= In order to use ARTIST from the command line, run the correct startup script by typing > source artistrc.sh (if you are working in bash) or > source artistrc.csh (if you are working in csh) (You may include this line into your .bashrc or .cshrc file to automate this task.) After that, ARTIST's modellib and lime modules may be used from Python. See the file ARTIST/doc/PythonInterface.pdf for further instructions. In order to use ARTIST from CASA, some installation steps must be performed manually. These installation steps could not be automated since they make use of your CASA installation. See the file ARTIST/doc/README_CASA.txt for further instructions, both for installation and usage of the interface.
Back to the main ARTIST page