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.
Four 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
the Flexible Image Transport System I/O package by the High
Energy Astrophysics Science Archive Research Center
the WD Binary Star Programs LCDC2015 by Robert Wilson
and the Roche code for rotating stars by Deane Peterson
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. Please contact the author to activate the links below.
Use of OYSTER implies scientific collaboration due to maintenance and
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. You must use the tcsh shell to run the scripts.
(version 8.21, January 21, 2016)
First time installation
For further information, please refer to the
in the document directory (oyster/docs).
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 (cd oyster; tar zxvf catalogs.tar.gz).
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 the C source code
(2015) and unpack the file src.tar.gz in the OYSTER source
sub-directory (cd source; tar zxvf src.tar.gz). Refer to section
2.1 in the User Manual for
instructions on recompiling the C code library. You must use the tcsh
shell to run the scripts.
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