view release on metacpan or  search on metacpan

bin/sourceplot  view on Meta::CPAN

=item B<Delete>

The selected sources will be removed from the Edit Window.

=item B<Undo>

This button will undo the last major command.  Major commands are
considered to be deletions, additions, and source coordinate changes.

=item B<New>

This will allow a source to be created manually, inserting the appropriate
coordinates and a name.  The new source will be added to the list in
the Edit Window and to the plot.  The RA/Dec coordinates can be entered
with spaces or colons separating the parts.  If only the first one or
two parts are inserted, the remaining parts will be filled with 0's.

=item B<Planets>

By pressing this button, a list of the planets will appear.  Selecting one
will add it to the list of sources in the Edit Window and to the plot.

=item B<Done>

This button will close the Edit Window.  It can be re-opened by pressing
the 'Edit' button in the Plot Window.

=back

=head2 Catalog Window

The Catalog Window is provided by L<Tk::AstroCatalog> (part of the
L<Astro::Catalog> package).
Through it, the observer is able to add sources from
a catalog file to be plotted.  The JCMT unified source catalog, which
is included with this program, is initally shown in the Catalog Window.
There are
several features that are not obvious.  To select sources in the Catalog
Window, click the mouse button once over top of it.  The source will turn
red to indicate it has been selected.  Several sources can be selected
in this way, creating a list of selected sources to do actions on.
To deselect a source, click on it a second time.  Double clicking on a
source will add it and all the selected sources to the Edit Window where
the sources will be plotted.

The following are explanations of the features contained within the
buttons on the Catalog Window:

=over 4

=item B<Catalogs>

The 'Catalogs' button will allow the observer to load a default catalog
or to load a catalog from file.  If the file is chosen, a window will
appear in which to find the desired path and file.  The path and file
can be entered manually in the 'Catalog file:' field.  The default
catalog, to be loaded when the 'Default Catalog' menu entry is selected,
can be changed by setting the C<ASTRO_CATALOG_JCMT> environmental
variable
by typing C<setenv ASTRO_CATALOG_JCMT /path/catalog>.  Although Source Plot has
been programmed to accept different variations of catalogs, the Catalog
Window loads catalogs in the JCMT pointing catalog format.

=item B<Rescan>

'Rescan' rescans the currently selected catalog, displaying any entries
that may have been lost in a search.

=item B<Search>

Using 'Search' will display a window in which the user can fill one
or more fields in which to search for a specific source.  If any of
the fields is not filled in, the program will ignore that field and
search based on the other fields.  If only part of a field is known,
the program will display any sources containing the partial information.
For example, if the RA starts with '5' and the Dec begins with '-9 45',
type '5' in the RA field and '-9 45' in the Dec field and the resulting
search will display all the sources that have an RA starting with '5'
and a Dec starting with '-9 45'.  Since the other fields were not used,
the search will not be limited by them.

=item B<Add>

'Add' adds the selected sources to the Edit Window.

=item B<Done>

To close the Catalog Window, press 'Done'.  It can be re-opened by
pressing the 'Catalog' button in the Plot Window.

=back

=head2 Printing the Graph

Once all of your sources are plotted, press the 'Print' button in the
Plotting Window.  A window will appear.  Source Plot will let you print
to a printer or to a file.  Select the method you prefer by pressing the
diamond to the left of that option.  If using the 'To File' method, fill
in the 'Filename' field with the path and filename desired.  If using the
'To Printer' method, the command to print can be changed in the 'Printer
Command' field.  The default command is 'lp'.  Additional arguments
can be added to the line or a totally different command can be used by
replacing this line with the desired command.  For example, to print to
a specific printer, just add '-d printer' after 'lp'.  When everything
is ready, press 'Print'.

=head2 Elevation vs Azimuth Mode

The Elevation vs Azimuth Graph was created to better show the distance
between sources in the sky.  The plot will be shown in this mode if
the selected axes are azimuth and either elevation or air mass.

The elevation is indicated by the circular
lines, with the white outside circle 0 degrees and the middle of the graph
90 degrees.  The azimuth rotates around the circle, 0 degrees at the top
and 180 degrees at the bottom.  Like the other graphs, the large dots
on the lines represent the position of the source at the current time.
The small dots are 15 minute intervals apart.  The times written on the
graph around the 30 degree mark for each source is the time, in HST,
that the source will be passing through that point.