rpbuild (Aug2004) | rjtools | rpbuild (Aug2004) |
Since primary headers (extension 0) in multi-extension FITS files have no data unit associated with them and specifying a section following "[0]" would be meaningless, 'pln = 0' is taken to denote 'EXTEND = F' corresponding to output format [xlo:xhi,ylo:yhi].
At present, symbolic image extension specifications like "[SCI]", "[ERR]" or "[DQ]" are not supported.
rj> rpbuild (int(738.4-255.5), int(738.4+255.5), int(541.2-255.5), int(541.2+255.5), pln=0) rj> imcopy ("IC4662V.fits"//rpbuild.imrpstr, "IC4662V_crop.fits") IC4662V.fits[482:993,285:796] -> IC4662V_crop.fits
2. The same for the first extension in a multi-extension FITS file:
rj> rpbuild (int(738.4-255.5), int(738.4+255.5), int(541.2-255.5), int(541.2+255.5), pln=1) rj> imcopy ("IC4662F814W.fits"//rpbuild.imrpstr, "IC4662I_crop.fits") IC4662F814W.fits[1][482:993,285:796] -> IC4662I_crop.fits
3. Undefined values (INDEF) may be used to create region/plane strings with wild-card range specification:
rj> rpbuild 256 512 INDEF INDEF pln=4 rj> = rpbuild.imrpstr [4][256:512,*]
4. If only the lower limit of a range is undefined it defaults to 1, while if only the upper limit is undefined it defaults to the lower limit: since this task is generic and does not test any particular image, it has no access to an image size from which it might obtain a sensible upper limit.
rj> rpbuild INDEF 256 128 INDEF pln=0 rj> = rpbuild.imrpstr [1:256,128:128]rj> unlearn rpbuild; rpbuild INDEF 256 y_start (1:32768) (INDEF): y_end (1:32768) (INDEF): rj> = rpbuild.imrpstr [1:256,*]