Program: SKYTOOL Purpose: Interactive coordinate transformation utility. Category: COORDINATES, UTILITY File: skytool.c Author: J.P. Terlouw Keywords: **EPOCH1= Epoch of the first equatorial and ecliptic coordinates. [1950.0] **EPOCH2= Epoch of the second equatorial and ecliptic coordinates. [1983.5] Though there are many other keywords, only the above keywords should be set directly from the command line. All others are set by typing into input fields, pressing buttons or selecting menu entries in the X-window, or are set internally by the program itself. #begin section description Description: SKYTOOL is an interactive coordinate transformation utility based on the GIPSY graphical interface routines (Ggi). It is intended to be self-explanatory. When it is started, an X-window appears with input/output fields for the following values: - Epoch 1 - RA and Dec for the first epoch. - Ecliptic l and b for the first epoch. - Epoch 2 - RA and Dec for the second epoch. - Ecliptic l and b for the second epoch. - Galactic l and b. - Supergalactic l and b. These fields represent only one and the same position. If any of the fields is changed, the other fields are changed accordingly. For every coordinate field there are two versions: one in degrees and one in hms,dms or dms,dms When the "LOG" button is activated, all transactions are written to the GIPSY log file. When an output file is specified (via the "FILE" menu), the resulting coordinates in degrees are written to this file. The output sky system can be specified with the "Output Sky System" menu. Where applicable, Epoch 2 is used for output coordinates. Writing to the file can be stopped by either pressing "CANCEL" in the file specification window, or by specifying an other filename. In the latter case writing will then continue to the newly specified file. When an input file is specified, the "GO" button will become available. Pressing this button causes the input file to be processed by the task SKYTRANS. The input sky system for this option can be specified with the "Input Sky System" menu. Where applicable, Epoch 1 is used for input coordinates. When an output file is specified, this file will be _overwritten_ by the results from SKYTRANS. Please note that SKYTOOL will be unresponsive until SKYTRANS is finished. Any communication due to errors in the input file will be done via Hermes. #end section description Updates: Jul 25, 1997: JPT, Document created. Aug 1, 1997: JPT, Changed layout. Aug 8, 1997: JPT, "Show Document" button added. Jan 5, 1998: JPT, Upgraded to latest Ggi version Apr 21, 1998: JPT, Version 1.0 Feb 11, 2000: JPT, Increased precision of seconds output. Mar 8, 2000: JPT, Still more precision of declination seconds. Jun 28, 2000: JPT, Redesigned GUI.