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
the Hierarchical Data System by STARLINK
and the Flexible Image Transport System I/O package by the High
Energy Astrophysics Science Archive Research Center
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
Please run command make -f Makefile.gdl to install.
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.
(version 8.10, August 5, 2014)
First time installation
For further information, please refer to the manual (oyster.ps, for
Version 7) in the document directory (oyster/docs).
Unpack the OYSTER archive file first (tar zxvf oyster.tar.gz),
this will create a directory (OYSTER root directory) named oyster in
your current directory. Then unpack the other two archive files in the
OYSTER root directory. This will create folders atmospheres
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 only for 64-bit Linux (compiled for
Fedora 20), for the other OS (including 32-bit versions) please contact
the author because the C code is no longer included in the release.
If you obtained the C source code from the author, unpack
src.tar.gz in the source folder of the OYSTER root
directory. Then, edit the file Makefile.Linux.in in the
source/c folder (if Linux is your OS, for example) to enter the
path of the IDL main directory (e.g. /usr/local/exelis/idl82)
for the IDL variable and the path to libgfortran.so for the
GF variable. Then change back to the OYSTER root directory and run
make -f Makefile.src.
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).
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