Rainer's Binary/Speckle Package (Software for Adaptive Optics)
Synopsis: Software to reduce Speckle or AO data from the raw data to deconvolved images (in Fourier space), to determine the parameters of a binary or triple, and to find limits for undetected companion stars.
Operating System: Unix, tested on Linux (Redhat and SuSE) and Solaris
Language: C and Tcl/Tk
History: Developed by R. Köhler, see for example Köhler et al., Astronomy and Astrophysics, v.356, p.541-558 (2000)
20. February 2002: I encountered more problems caused by the copyright restrictions of the Numerical Recipes, so I decided to write my own implementation of the amoeba-algorithm. This should make installation much easier.
22. January 2002: Another new version on this website. Again, the changes are mostly bugfixes, this time related to warnings when compiling on non-Intel/non-Alpha machines and the interpretation of new SHARP I-files. There are a few functions which are undocumented, untested or simply do not work in the distributed version. Everything described in the documentation should work, however.
19. June 2001:
A new version is avaiable on this webpage. The changes are mostly
bugfixes related to the byte-order on Intel- and Alpha-machines.
To download it, go to the Installation section.
Publications describing the method are of course my PhD thesis (which is unfortunately in German), Köhler & Leinert, Astronomy and Astrophysics 331, 997 (1998), and Köhler et al., Astronomy and Astrophysics 356, 541 (2000). The latter paper contains an especially comprehensive explanation and some examples, so I include it in the tar-file of the package (here is the PDF-file).
|Version:||8.x (tested with 8.0 and 8.3)|
|Version:||1.9.8 or 2.0 (DS9), 2.0.3 (XPA)|
setenv XPA_METHOD localIn the bash shell, use
|Version:||probably not important|
Here is a gzipped tar-file of the sources
Here is an example data set (raw and reduced data) 28 MBytes!
make make installThis should compile everything and put the executable programs into the toplevel directory.
The principle is (hopefully) pretty simple: There is a master program called "mcspeckle" ("mouse controlled speckle", since its predecessor didn't have a graphical user interface). The user tells mcspeckle which data files to use, what is in the files (objects, sky etc.), and what should be done. Mcspeckle than (usually) creates a Makefile, i.e. an input file for the make program that contains all the dependancies between the different data files and the commands needed to do the data reduction. Make then decides what has to be done to create the final results. In the good (?) old days, when one data reduction ran the whole night and quite often ended with a "disk full error", this was very useful. One could simply fix the problem and run make again. Make then checked which files were up to date und ran only the commands for the files that had not yet been reduced. The user shouldn't have to fiddle with the contents of the makefiles.
Of course, someone has to do the work of reading the data, doing something with it, and writing the results to another file. This is the task of most of the other programs in the package (despeckle, findcenter, fits2pnm, fitsmean, maskedit, prespeckle, quickvis, saa, and tkfmovie). Some of them have their own graphical interface to let the user adjust something, but most of them are simply called by make or from the shell, and accept only command line options. The most important option is "-h", which will show all the other options.
Furthermore, there are binplot, amf, and bff, which fit a binary or triple model to the data. Finally, maxbright calculates limits for undetected companions.
Here are tutorials for the three basic tasks:
Reducing the raw data and deconvolution
Finding out if a star is not a binary
Finding the parameters of a binary
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
If you find the program useful, please acknowledge it in any publications that result from its use.