sections images
images
Image template or list of images. There is no check that the names are
images and any name may be used. The thing which distinguishes an image
template from a file template is that the special characters '[' and
']' are interpreted as image sections rather than a character class
wildcard unless preceded by the escape character '!'. To explictly
limit a wildcard template to images one should use an appropriate
extension such as ".imh".
option = fullname
The options are:
nolist
Do not print list.
fullname
Print the full image name for each image in the template.
root
Print the root name for each image in the template.
section
Print the section for each image in the template.
nimages
The number of images in the image template.
The image template list images is expanded and the images are printed one per line on the standard output unless the "nolist" option is given. Other options allow selection of a portion of the image name. The number of images in the list is determined and stored in the parameter nimages.
This task is used for several purposes:
(1)
To verify that an image template is expanded as the user desires.
(2)
To create a file of image names which include image sections.
(3)
To create a file of new image names using the concatention feature of the
image templates.
(4)
To determine the number of images specified by the user in a command language
script.
There is no check that the names are images and any name may be used.
The thing which distinguishes an image template from a file
template is that the special characters '[' and ']' are interpreted
as image sections rather than a character class wildcard unless
preceded by the escape character '!'. To explictly limit a wildcard
template to images one should use an appropriate extension such as ".imh".
1. Calculate and print the number of images in a template:
2. Expand an image template:
Note the use of the character class escape, image section appending,
and explicit use of the .imh extension.
3. Create a new list of image names by adding the suffix "new":
Note the use of the append syntax. Also there is no guarantee that the
files are actually images.
4. Subtract two sets of images:
Note the use of the substitution syntax.
The image list is not sorted.
EXAMPLES
cl> sections fits*.imh opti=no
cl> = sections.nimages
cl> 7
cl> sections fits*![3-9].imh[1:10,*]
fits003.imh[1:10,*]
fits004.imh[1:10,*]
cl> sections jan18???//new
jan18001new
jan18002new
cl> sections objs*.imh[100:200,300:400] > objslist
cl> sections skys*.imh[100:200,300:400] > skyslist
cl> sections %objs%bck%* > bcklist
cl> imarith @objslist - @skyslist @bcklist
TIME REQUIREMENTS
BUGS
SEE ALSO
This page automatically generated from the iraf .hlp file. If you
would like your local iraf package .hlp files converted into HTML
please contact Dave Mills at NOAO.dmills@noao.edu