mArchiveExec
- Description:
- Given a table of archive images (generated by mArchiveList), calls mArchiveGet on each one in sequence to retrieve all the files into the current directory.
- Syntax:
- mArchiveExec [-d level] region.tbl
Switches:
- -d level
- Prints out additional debugging information; in this version, the only supported level is 1.
Arguments:
- region.tbl
- Table of archive images, generated by mArchiveList.
- Results:
- [struct stat="OK", count=num-images, failed=num-failed]
- num-images from region.tbl are retrieved into the current directory. num-failed is a count of failed attempts to retrieve images; turn on debugging to see the errors generated by mArchiveGet.
Examples:
First, run mArchiveList to generate a table of image metadata, including URLs:
- $ mArchiveList 2mass j m31 0.5 0.5 2mass_m31_j.tbl
- [struct stat="OK", count=18]
Next, call mArchiveExec on the metadata table to populate the current directory with the files found by mArchiveList:
- $ mArchiveExec 2mass_m31_j.tbl
- [struct stat="OK", count=18, failed=0]
- $ ls
- 2mass-atlas-001016n-j1030232.fits
2mass-atlas-001016n-j1030244.fits
2mass-atlas-001025n-j0740021.fits
2mass-atlas-001025n-j0740033.fits
2mass-atlas-001025n-j0740044.fits
2mass-atlas-971024n-j0080021.fits
2mass-atlas-971024n-j0080033.fits
2mass-atlas-971024n-j0080044.fits
2mass-atlas-971024n-j0090232.fits
2mass-atlas-971024n-j0090244.fits
2mass-atlas-981123n-j0720021.fits
2mass-atlas-981123n-j0720033.fits
2mass-atlas-981123n-j0720044.fits
2mass-atlas-981204n-j0420021.fits
2mass-atlas-981204n-j0420033.fits
2mass-atlas-981204n-j0420044.fits
2mass-atlas-981204n-j0430232.fits
2mass-atlas-981204n-j0430244.fits
2mass_m31_j.tbl
Return Codes:
- [struct stat="OK", count=num-files, failed=num-failed]
- [struct stat="ERROR", msg="Usage: mArchiveExec [-d level] region.tbl]
- [struct stat="ERROR", msg="Table region.tbl needs column 'URL' and can optionally have columns 'fname'/'file' and pixel ranges 'imin'...'jmax'"]