INSTALLATION INSTRUCTIONS FOR THE DSS BATCH TOOL.

*** Note: a version installed before July 9, 2018, can no longer work.     ***
*** Linux x86 64bit and Mac (10.11, 10.12, 10.13) are currently supported. ***

Version 2.56 (Mar 20, 2003) Patched (Feb, 2013) Patched (July 10, 2018)

Please refer to the README.html file for information about the package, and its usage.

Below are the short installation instructions for the ESO/ST-ECF
version of "dss", a software originally produced by STScI for
extracting data from the Digital Sky Survey.

"dss" can be invoked with an input list of target areas to be downloaded to disk.
Please refer to the README.html file to know more.

This distribution includes the both Linux x86 64 bit, and macos versions.
This tool will no longer work on any other platforms.

This installation requires about 53MB of disk space.

The changes made in this patch reflect some ESO infrastructural changes.
No new functionality is provided to users. The previous (not patched) version
can no longer be used.


INSTALLATION INSTRUCTIONS

1.- cd to a directory where you want to install it,
    e.g. cd ~/ ; the tool will then be installed in the directory called ~/dss/

2.- get the software using wget or equivalent, e.g.:
    wget -O dss.tar.gz 'http://archive.eso.org/cms/tools-documentation/dss/dss.tar.gz'

3.- untar the file:
    gunzip -c dss.tar.gz | tar xf - 

4.- Edit the two files: dss/scripts/dss1 and dss/scripts/dss2
    to reflect your software location.
    That is, change /your/path string in the line
         setenv DSS_ROOT  /your/path
    with your valid path, e.g.:
        setenv DSS_ROOT /usr/local/dss
    which points to the directory that contains the headers/ folder.
    Please do it in both dss1 and dss2 scripts.

5.- Copy the two scripts (dss1 and dss2) to a directory in your PATH, e.g.:
       cp dss/scripts/dss1      /usr/local/bin/dss1
       cp dss/scripts/dss2      /usr/local/bin/dss2
    or where ever your put your local executables
    (You might need root priviledges)

You can now use "dss1" to access the 1st epoch 25 micron sky survey, or
"dss2" to access the second epoch survey at 15 micron resolution.

Again please read the README.html file for information about how to
best use these applications. 

If you have any problem, please contact usd-help@eso.org,
using as subject: DSS batch tool.

Last Update: 04-Jan-2023 (Cured some typos, and fixed a wrong EQUINOX (was 2E+30) in xe203.hhh)