Installing and Using Scripts

• Installation
  • Uninstalling Old Scripts
• Running a Script
  • Command-Line Scripts
  • S-Lang Scripts

Installation

All of the contributed scripts are contained in the CIAO_4.0_scripts.tar package. The scripts page describes the scripts available for download. All of the script have a help file ("ahelp <scriptname>"); some scripts also have a parameter file. The installation process is described step-by-step in the README_CIAO_scripts file.

As explained in the README, the scripts are intended to be installed in the $ASCDS_INSTALL/contrib directory of the CIAO directory structure. If you do not maintain your own CIAO installation, you will have to ask your system administrator to install the package.

Installing the scripts in this way provides seamless integration with CIAO: Command-line scripts will be in the user's path, S-Lang scripts and functions will be within S-Lang's search path, and ahelp and the parameter interface will function as they do with the CIAO tools.

Uninstalling Old Scripts

Before installing the a new script package, you should remove the files from previous script installations. The uninstall script is called uninstall_4.0_scripts. Please see the text of the script for usage instructions and some warnings about the uninstallation process.

unix% cd $ASCDS_CONTRIB
unix% ./uninstall_4.0_scripts 
Removing file bin/acis_bkgrnd_lookup
Removing file bin/acis_fef_lookup
...
Removing empty directory bin
Removing empty directory param
Removing empty directory share/slsh/local-packages
Removing empty directory share/slsh
Removing empty directory share
Done!

Running a Script

There are two general types of scripts: command-line scripts (written for the slsh, sh, ksh, and Perl interpreters) and S-Lang scripts, which are run from within a S-Lang-enabled application, such as slsh.

Command-Line Scripts

When CIAO is started, the contributed script directory is added to the user's path (in this example, $ASCDS_INSTALL is set to /soft/ciao-4.0/):

unix% echo $PATH
...:/soft/ciao-4.0/bin:/soft/ciao-4.0/contrib/bin:...

This makes it possible to call the script from the command line just like a CIAO tool, without needing to specify the path:

unix% merge_all
Input event file(s) (): 
...

Note that the scripts are executable by default when they are installed, so there should not be any need to change permissions (e.g. "chmod +x merge_all") before use.

S-Lang Scripts

S-Lang scripts must be called from within an interpreter, such as slsh. This example is taken from the Filtering Lightcurves thread:

slsh> () = evalfile("analyze_ltcrv.sl");
slsh> analyze_ltcrv("lc_c7.fits")

CIAO defines the $SLANG_SCRIPT_PATH environment variable, which includes the path to the scripts directory ($ASCDS_INSTALL/contrib/share/slsh/local-packages):

unix% echo $SLANG_SCRIPT_PATH
/soft/ciao-4.0/share/slsh/local-packages:/soft/ciao-4.0/contrib/share/slsh/local-packages

Therefore, it isn't necessary to specify the path in the evalfile command.