mArchiveList1
Retrieve a list of archive images from the irsa server
Usage
mArchiveList {survey
band
object | location
width
height
outfile}
Overview
Given a location on the sky, archive name, and size in degrees, contact the IRSA server to retrieve a list of archive images. The list contains enough information to support mArchiveGet downloads.
Arguments
- survey
-
Can be one of:
2MASS DSS SDSS DPOSS
- band
-
Case insensitive - can be one of:
(2MASS) j, h, k (SDSS) u, g, r, i, z (DPOSS) f, j, n (DSS) DSS1, DSS1R, DSS1B, DSS2, DSS2B, DSS2R, DSS2IR
- object|location
-
Object name or coordinate string to be resolved by NED (if string includes spaces, must be surrounded by double quotes)
- width
-
Width of area of interest, in degrees
- height
-
Height of area of interest, in degrees
- outfile
-
Path to output table
Result
[struct stat="OK", count=num-images]
outfile is an ASCII table of image metadata for the region and survey of interest. The last column in the table is a URL that mArchiveGet can use to retrieve the image.
Messages
OK
|
[struct stat="OK", count=num-files] |
|---|---|
ERROR
|
Can't open output file outfile |
ERROR
|
Error message from IRSA's ImgList service |
ERROR
|
Couldn't find host hostname |
ERROR
|
Couldn't create socket() |
ERROR
|
hostname: connect failed |
Examples
To retrieve metadata and file handles for 2MASS J-band images, covering a half-degree by half-degree area around m31:
- mArchiveList 2mass j m31 0.5 0.5 2mass_m31_j.tbl
-
[struct stat="OK", count=18]
Output file: 2mass_m31_j.tbl.
To retrieve GPFS file handles for SDSS u-band images:
- mArchiveList -s gpfs sdss u m101 0.2 0.2 sdss_m101_u.tbl
-
[struct stat="OK", count=16]
Output file: sdss_m101_u.tbl.
Releases
5 releases since Debian 9 (Stretch); the text changed 1 time.