next up previous contents
Next: Earth orientation updates Up: Installing OYSTER Previous: Compiling OYSTER   Contents

Programmer's reference

OYSTER uses a library (oyster.so) containing C and FORTRAN objects. This library must be sharable in order for IDL to access it (via the call_external command). Aside from the OYSTER specific code (written in C), this library contains five external libraries. These are:

Please note that WD and SHADOW are currently proprietary libraries and the source code is therefore not included in the standard OYSTER distribution.

After the standard installation procedure described above, manual compilation can be performed by going into the GUI source directory rsi, and editing Makefile. Then run make clean and then make to compile the library, which is named oyster.so. Copy this file into the sub-directory of the OYSTER home directory corresponding to your operating system. If such a directory is not available, copy into the OYSTER home directory. OYSTER will use this file if it cannot find a compatible OS. Send a copy of the Makefile to the author.

This procedure should work for LINUX and SOLARIS. OYSTER will detect your OS, and then know the path to the shared library and the binary JPL ephemeris file (which differs between Sun and PC based work stations), residing in directories linux and solaris under the main OYSTER directory.

To recompile and install the IDL procedures, start up IDL (in the rsi directory) with the command file c.pro, i.e. idl c, which will then compile the IDL code and save it into files oyster.cmb and oyster.cpr. The command file will then end the session. You should use OYSTER first to recompile the crossindex subdirectory of the catalog directory, if the code and catalog data distribution tape was not specifically assembled for your architecture. (This is because the crossindex files are binary files in XDR format.) To recompile the crossindices, type get_crossindex,1. To exit the session, type quit.

Finally, it might be necessary to re-create the binary ephemeris file used by NOVAS. To do this, go into the jpl subdirectory and follow the instructions in README.1st.


next up previous contents
Next: Earth orientation updates Up: Installing OYSTER Previous: Compiling OYSTER   Contents
Christian Hummel 2009-10-20