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)
	ALL	lists the expanded image directory plus the band information
	AUDIT	lists the one-line image summary plus the audit trail
	AUX	lists the one-line image summary plus the auxiliary cards
	BAND	lists the one-line image summary 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 center latitude and longitude location and the resolution values listed with each band are the approximate values at the image center point. The central wavelengths and descriptions of primary uses are from the SATBAND file, which gets its information from official satellite launch and operations websites. For example, the GOES-R Series (GOES-16 and later) central wavelengths listed in the FORM=BAND and FORM=ALL output are nominal values from the GOES-R Website's ABI Bands Quick Information Guides page. See its Fact Sheets for details about each band's characteristics and uses.

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 and with each band in the LR and ER columns of the FORM=OPS output. If there are multiple bands with different resolutions, the resolution factors in the last line of the FORM=ALL output are for the band(s) with the lowest resolution.

When listing GOES-R Series (GOES-16 and later) ABI images, the FORM=AUX keyword lists eight Temperature Data Quality Flag (TDQF) values from the raw data. The values are listed in a single line beginning with "DQF for band" for each of the sixteen bands. An "ND" in the output indicates that no value was reported for that flag. The values, in order, are for these eight TDQF flags:

percent_focal_plane_temperature_threshold_exceeded_qf
maximum_focal_plane_temperature
focal_plane_temperature_threshold_increasing
focal_plane_temperature_threshold_decreasing
percent_good_pixel_qf
percent_conditionally_usable_pixel_qf
percent_out_of_range_pixel_qf
percent_no_value_pixel_qf

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.