[ Basic Info | References | User Guide ]
Basic Information on itemize
Task: itemize
Purpose: List information about MIRIAD dataset(s)
Categories: utility
ITEMIZE is a MIRIAD task which dumps a dataset or an item within a
dataset. If the input name is an item, then the contents of the
item (element for element) are written to the screen. If the input
name represents a dataset, then a summary of the items within the
dataset are given. If multiple input files are given, it acts as
a file scanner, and some minimal information is given about the
the kind of dataset.
Large datasets with more than 2147483648 are reported with the wrong
count (MIR4 to be fixed in version 4.1)
Here is a recipe to create a miriad dataset from scratch. You can then
use puthd to add items:
mkdir data ; touch data/header
Key: in
The name of either a dataset, or an item within a data set or a
wildcard. For example:
% itemize in=dataset
or
% itemize in=dataset/item
or
% itemize in='*'
For example, to show the history information of file ``cm'', use
% itemize in=cm/history
When a dataset name is given, itemize summarizes the contents
of the entire dataset. When an item name is also given, then
itemize dumps the entire contents of the item (in accordance
to the index and format keywords).
When a wildcard expands in more than one file, itemize only
checks to see if the specified file is a miriad dataset, and
attempts to say a few intelligent things about it.
Key: log
The name of the output listing file. The default is the users
terminal.
Key: index
When dumping an entire item, "index" specifies the range of elements
to dump. The default is the entire item. For example, to print out
lines 10 through 20 of the history item, use:
% itemize in=cm/history index=10,20
Key: format
When dumping an entire item, this gives the FORTRAN format specifier
to be used. For example, when dumping a real item, you may set:
format=8e15.7
The default varies according to the data type.
Key: scan
Scan mode if multiple input files are specified. If "scan=miriad"
itemize only reports on what it thinks are Miriad data files.
If "scan=image" itemize makes an index of image parameters for
each Miriad image in the input files. The default scans all
input files.