STScI Logo




grlist -- List individual file names and group numbers.


grlist inimage members


Print a list of individual file names making up a group format image. Task input consists of a root image name and a range of group members. The group members list (the members parameter) is given in ranges format. The output consists of the root image name with a group member (sometimes referred to simply as the "group" or sometimes the "cluster") specifier enclosed in square brackets.


image [file name]
Image file root name.
members [string]
A list of group members given in ranges format. Single numbers may be separated by commas to indicate individual members, a range of members may be specified by the first and last member separated by a dash, or all members may be selected by a dash or null string.
(inclusive = no) [boolean]
Include files not in group format?

If "yes", then include those files in the output list that are not in group format with no group member indicated. Otherwese, list only members of files from group-format images.


1. List the first three images of a group-format file:

  st> grlist myimage "1-3"

  st> grlist myimage "1,2,3"

2. List all images:

  st> grlist myimage "-"

3. List the first three and the sixth images:

  st> grlist myimage "1-3,6"



ranges, grplot, grspec, specplot, graph, sgraph

Source Code · Package Help · Search Form · STSDAS