IMGLIST

Lists images in a dataset.


Format

IMGLIST dataset epos [keywords]


Parameters

dataset

ADDE dataset name and position; specify one of the following formats:

 

 

group/descriptor.position

 

 

alias.position

 

a position greater than zero represents an absolute position in the dataset; a position less than or equal to zero represents a relative position in the dataset based on image time, for example, 0 is the most recent and -1 is the next most recent; the position ALL represents all positions in the dataset; to use the default position, do not specify .position (no default for group/descriptor or alias; default=0 for position)

epos

ending position number of the data on the server; must be greater than 0; valid only if the position specified in dataset is greater than 0


Keywords

BANd=

bband eband

lists information only for the specified range of bands; uses BAND as the FORM keyword default

 

ALL

lists all bands (default)

DAY=

bday eday

lists only images within the specified range of dates (no default for bday; eday default=bday)

FORm=

image information to list (default=standard one-line image summary)

 

AUDIT

lists the one-line image summary plus the audit trail

 

BAND

lists the one-line image summary plus the band information

 

ALL

lists the expanded image directory plus the band information

 

MEMO

list OPS output plus memo field and creation information

 

OPS

list image directory information in LA command format

ID=

station

lists only images with the specified NEXRAD station ID, e.g., MKX

 

LIST

lists the most recent image for all NEXRAD stations

SS=

lists only images with the specified sensor source number

TIMe=

btime etime

lists only images within the specified range of times (no default for btime; etime default=btime)

WL=

bwl ewl

lists all bands with image wavelengths in the range bwl to ewl; uses FORM=BAND as the default output format; valid only with high spectral resolution data, e.g., Aqua AIRS

WN=

bwn ewn

lists all bands with image wave numbers in the range bwn to ewn; uses FORM=BAND as the default output format; valid only with high spectral resolution data, e.g., Aqua AIRS


Remarks

If a negative position is specified in dataset, all images from that position to the most recent are listed. For example, if you specify position -5, the six most recent images (positions 0, -1, -2, -3, -4, -5) are listed.

When using FORM=BAND or FORM=ALL, the latitude and longitude resolution values listed with each band are for the image's center point. The line and element resolution factors (where "1" equals the base resolution factor of the instrument) are listed in the last line of the FORM=ALL output. If there are multiple bands with different resolutions, the resolution factors in the last line are for the band(s) with the lowest resolution.


Examples

IMGLIST STORM/GOES-IR

This entry lists the most recent image in the dataset STORM/GOES-IR.

IMGLIST STORM/GOES-IR.1

This entry lists the image in position 1 in the dataset STORM/GOES-IR.

IMGLIST STORM/GOES-IR.-3

This entry lists the four most recent images (positions 0, -1, -2, -3) in the dataset STORM/GOES-IR.

IMGLIST STORM/GOES-IR.-4 BAND=3

This entry lists the five most recent images in the dataset STORM/GOES-IR that contain band 3.

IMGLIST STORM/GOES-IR.1 20 BAND=3

This entry lists the images in positions 1 through 20 in the dataset STORM/GOES-IR that contain band 3.

IMGLIST STORM/GOES-IR.5 10 FORM=BAND

This entry lists the images in positions 5 through 10 in the dataset STORM/GOES-IR. It also lists information about the bands in each image.

IMGLIST STORM/GOES-IR.ALL DAY=95100 95110

This entry lists all the images with dates 95100 through 95110 in the dataset STORM/GOES-IR.

IMGLIST STORM/GOES-IR.ALL DAY=95100 95110 TIME=0 12

This entry lists all the images in the dataset STORM/GOES-IR with times 0 through 12 UTC on each day 95100 through 95110.