Conditions for the use of OYSTER
The software is provided to you free of charge for academic and/or
non-profit research purposes only. It is provided on an "as is" basis
without any obligations on the author's part to maintain, support, update,
enhance, or modify it. The software comes without warranty of any kind,
and the author is not responsible for any adverse consequences resulting
from its use. No assurance of suitability for any purpose is implied by
its availability for copying.
Three main C code subroutine libraries used by OYSTER and included in
the shared 64-bit library are the intellectual property of others. These
are the Naval Observatory Vector Astrometry Subroutines
(NOVAS),
the Hierarchical Data System by STARLINK
(HDS),
and the Flexible Image Transport System I/O package by the High
Energy Astrophysics Science Archive Research Center
(FITSIO).
The OYSTER IDL code library also contains the
The IDL Astronomy User's Library compiled by Wayne Landsman, and the
OI-DATA IDL Utilities written by J. Monnier.
Starting with Version 8, OYSTER script code can be run under
GDL 0.9.3.
Please run command make -f Makefile.gdl to install.
Downloading OYSTER
The complete OYSTER installation is contained in the
three files below.
The IDL script code is regularly updated and can be downloaded with the
link below in order to upgrade to the most recent version. This will
also update a few miscellaneous other files, most notably the Earth
rotation database. Place the archive file in the OYSTER root directory
and unpack it there using "tar zxvf update.tar.gz ". Then run
make -f Makefile.idl.
First time installation
-
Unpack the OYSTER archive file first (tar zxvf oyster.tar.gz),
this will create the OYSTER root directory named oyster in
your current directory. Then unpack the other two archive files in the
OYSTER root directory. This will create sub-directories atmospheres
and catalogs.
-
Check your system using the uname command. It must be one of
the following: Linux or Darwin. The download contains a
pre-compiled shared library for 64-bit Linux (compiled for Fedora
20). If this library is not compatible with your operating system,
please download src.tar.gz from the link above and unpack in
the OYSTER source sub-directory. Refer to section 2.1 in the
User Manual
for instructions on recompiling the C code library.
-
In the main OYSTER directory, run make. To prepare OYSTER
for use under GDL, run make -f Makefile.gdl. This will
compile the script libraries. It will also create a startup file for
your system, oyster.pro, located in the OYSTER root directory
(oyster_gdl.pro for GDL).
- To start OYSTER, just type
idl oyster.pro or gdl oyster_gdl.pro (including the
full path if necessary).
For further information, please refer to the
User Manual
in the document directory (oyster/docs).
Download data for Michelson Summer School
Save the archive file (below) in the oyster/lab directory (within the
OYSTER root directory) and unpack it there. The data files will be placed
in a folder called data.
Back to main help page