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'"]