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.