SADT: Download and Installation
The latest version of the Survey Area Definition Tool (SADT) is available for Scientific Linux running Java 1.6 or higher. It is known to work also under other Linux flavours, but not all have been tested. As a Java application it should also run under Unix, Mac OS X, or MS Windows operating systems running Java 1.6 or higher, but no support is guaranteed onother systems. Please note that running P2PP version 3 (P2PP3) also requires Java 1.6.
Before downloading SADT, please make sure of the following:
- The java executable needs to be found automatically by SADT for it to run correctly. You must thus make sure that the path to Java is included in your $PATH environment variable. A simple check can be made using the command "which java" from a terminal window. Also make sure that you are running the correct version of Java. As mentioned at the top of this page, this should be Java 1.6 and it is the same version as the one required by P2PP3 (see next point). The version of java can be verified with the command "java -version".
- Install P2PP3 before installing SADT! The tool can be obtained from the dedicated download page, see also the instructions for installation. Once P2PP3 is installed, run it and login to your account if you have an approved programme, or alternatively to the P2PP3 tutorial account (login: 52052 / password: tutorial). This will ensure that the VIRCAM or OmegaCAM instrument package is downloaded to your computer — it is also needed by SADT.
Download one of the following tarballs, depending on the instrument you are using:
- SADT version 5.04 for VIRCAM on the VISTA telescope [3.8Mbytes]
- SADT version 5.06 for OmegaCAM on the VST telescope [3.8Mbytes]
In order to simplify the installation we recommend that you save this file in the same directory in which you have installed P2PP3.
Go to the directory where you saved the file. At this point you should have a gzipped tar file in your current directory. Unpack it by executing:This will create a directory called sadt-5.04 (or sadt-5.06). You may now remove the gzipped tar file:
gunzip -c sadt-<version>.tar.gz | tar xvf -
Go into the directory and execute the provided installation script:
Follow the instructions on the screen. You will be asked to give the location where you have installed P2PP3. If you unpacked SADT in the same location then the installation script should find it automatically, provided that you have followed the instructions at the top of this page.
Assuming that you have successfully installed SADT, you can now run the tool using the command
if you are using VIRCAM or, in the case of OmegaCAM observations:
<install-dir>/sadt-5.06/bin/sadt -c vst
For more information about how to use the tool to prepare your observations, check out our cookbooks:
Important notice: the instrument package used by SADT has to be the same one as in P2PP3. This is the reason why P2PP3 has to be installed first. By installing first P2PP3 and logging in with your account (or tutorial account) the instrument package information is automatically downloaded to the P2PP3 cache directory. If the instrument package version changes, then to get the new version, you can download it through the P2PP3 main GUI window: in the "File" menu, select the command "Download/Refresh Obs. runs". This action will add a new directory with the latest IP version to the instruments/ subdirectory of the P2PP3 installation.
You now have to ensure that SADT also points to this directory. One way to do it is to remove SADT from your machine, download the updated tarball and re-run the installation of the tool as decribed above. Alternatively, you can edit the following configuration file:
<install-dir>/sadt-<version>/cfg/vista/sadt.cfg.In this file please edit the following line (examples):
EPOCH_TOBE_OBSERVED = 2014.0 to point to the correct path to the latest version of the instrument package and to correct the epoch.