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 on other systems.

Preliminary requirements

Before downloading SADT, please make sure of the following:

  1. 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 or higher. The version of java can be verified with the command "java -version".
  2. 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 and/or OmegaCAM instrument packages are downloaded to your computer — they are also needed by SADT.

Installing SADT

  1. Download the following tarball:

    In order to simplify the installation we recommend that you save this file in the same directory in which you have installed P2PP3.

  2. 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: gunzip -c sadt-5.1.0.tar.gz | tar xvf -

    This will create a directory called sadt-5.1.0. You may now remove the gzipped tar file:rm sadt-5.1.0.tar.gz
  3. Go into the directory and execute the provided installation script:cd sadt-5.1.0

    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.

Running SADT

Assuming that you have successfully installed SADT, you can now run the tool using the command <install-dir>/sadt-5.1.0/bin/sadt -c <vst|vista>

Choose the command-line option according to the instrument for which you are preparing observations ('-c vst' for OmegaCAM, '-c vista' for VIRCAM).

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 described above. Alternatively, you can edit the following configuration files: <install-dir>/sadt-5.1.0/cfg/vista/sadt.cfg. <install-dir>/sadt-5.1.0/cfg/vst/sadt.cfg. In each of these files please edit the following line (examples): INSTRUMENT_PACKAGE_PATH=/home/User/tools/p2pp-3.4.2/instruments/VIRCAM-xx.yy/ INSTRUMENT_PACKAGE_PATH=/home/User/tools/p2pp-3.4.2/instruments/OMEGACAM-xx.zz/ where xx.yy (or xx.zz) is the version number to be retrieved from the latest instrument package for the instrument downloaded into the /p2pp-3.4.2/instruments/ directory e.g. VIRCAM- 100.03 for period P100. EPOCH_TOBE_OBSERVED = 2018.0 to point to the correct path to the latest version of the instrument package and to correct the epoch.

Instrument selector

This page is specific to Public Surveys on the VST and VISTA telescopes.