Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.atnf.csiro.au/computing/software/gipsy/tsk/header.dc1 Дата изменения: Tue Aug 1 09:41:55 2000 Дата индексирования: Fri Jan 16 01:12:19 2009 Кодировка: Поисковые слова: mdi

Program: HEADER

Purpose: Display header information

Category: HEADER, UTILITY

File: header.c

Author: M. Vogelaar

Keywords:

INSET= Give set (, subsets) to work on:
Maximum number of subsets is 2048.

** MODE= Output mode (Formatted/List/Axes/General/Hist/Res) [F]


** FILENAME= Name of file for header output:
Write HEADER output only to a file and do not ask for a
printer destination.


** PRINTER= Select destination of output. If user selects nothing,
all data is written to the terminal. Else if a number
is given and a corresponding printer exist, the data
is directed to the selected printer. If the number does
not correspond to a printer, a menu with available
printers and their characteristics is presented.
To be sure to get this menu, type PRINTER=0 at the
start of the program.
If for some reason no printers can be found, an error
message is given.

** HISTORY= Print history and comments? [Y]/N
Disable/enable printing history and comments found
in the header of the set. This keyword overrules the
history setting in the MODE= keyword.


Description: This program is used to check the contents of the header
of your data. The header determines how your data is
organized, and what information it contains.
In a GDS-data structure, a header item may refer to the
structure as a whole, or to a specific substructure.
At the INSET= key, you may thus give a structure name only,
or a structure name and a substructure specification.
If you specify the structure name only, you will get the
items defined at the top level, that is: for the structure
as a whole. If you specify one or more substructures, you
will get, for each substructure, the items as they are
defined at the level of that substructure or at a higher
level. Searching at a higher level can be prevented by
specifying MODE=R.

Using the keyword MODE=, you can determine how the header
is displayed.

#begin section mode
OUTPUT MODES
============
It is possible to combine more modes at the same time by
specifying more characters, for example: MODE=AFG


MODE=A

The name, range, grid spacing and projection type of
each axis is shown.


MODE=F

If you choose MODE=F (default) you will be given a
standard, formatted header. For each substructure,
you will be supplied with:

- A general formatted header in any case, except for
an IRDS set (raw IRAS data).
(proj. centre, coordinate axes, maximum value etc).
- If possible, a special radio or IRAS header.
- For an IRDS set a special header is given. If the SNIP
axis is given as the subset axis, additional information
on these subsets is given.


MODE=G

All available header items are sorted and displayed
in FITS style i.e. with keyword, contents and comment.
If no comment was part of the header information,
comment is searched in a list with general descriptor
items.


MODE=H

Print the HISTORY and COMMENT fields at set/subset level.


MODE=R

Restrict the information for substructures to the
given level by ignoring information found at higher
levels. The headers then will contain only substructure
information. This output mode is used in combination
with the modes F, A or G.


MODE=L

Generate a list with general, or common, descriptor items.

#end section mode



Notes: If possible, physical coordinates are converted to
natural units (example: Mhz in header is converted to
natural units Hz).

Example:

Updates: ??? ??, 1990: VOG, Document created.
Jun 24, 1991, FL, formatted header for raw IRDS data added,
Jun 10, 1993, VOG, Radio telescope names added.
Oct 24, 1994, VOG, HISTORY= keyword implemented
Sep 25, 1999, VOG, Display entire CTYPE name for
parameter type axes.
Jul 07, 2000, VOG, Added FILENAME= functionality.
Jul 27, 2000, VOG, Replaced deg2hms_dms routine by
hms, dms routines because of sign problems
for declinations < 0 and > -1.