MID_UP_IMAGE

       Get a pixel matrix and some support information from a MIDAS file.

       Allows updating of data, using DATA parameter.

       MID_UP_IMAGE,IMAGE,DATA,NAXIS,NPIX

       IMAGE = Filename or Logical Unit Number.
       * If a filename is given, the file will be opened and closed using a
               local LUN.  The filename is that of the MIDAS image, without
               extension (.BDF will is assumed) or version number (latest
               version is assumed).
       * If a LUN is given, the file associated with that LUN will be used.

       NAXIS = Number of dimensions in MIDAS image. I*4 values.
       NPIX  = Array containing the dimensions of the data to be written into
               the MIDAS image. Must be compatible with (i.e. smaller than or
               equal to the corresponding dimensions of) the latter.
               I*4 values.
       DATA  = Array to be written into the MIDAS image. Dimensions are
               defined by NAXIS and NPIX. R*4 values.

       0) Check inputs and set error handling.
       1) Open file for access using the access method indicated by the type of
               the input parameter IMAGE.
       2) Get the descriptors of the IMAGE.
               a) NAXIS set the output parameter NAXIS to this value.
               b) NPIX  set the output parameter NPIX to this value.
       3) Locate the pixel data start block
       4) Load pixel data into output parameter DATA
       5) Check consistency of dimensions of data array to be written, and
               image dimensions; then write data array into image.
       6) Terminate file access as is proper for the type of parameter IMAGE.

       1) There must be only one FCB and it must be in VBN 1.
       2) The LDBs must begin in VBN 2.
       3) All descriptors must be in the first LDB.
       4) Currently only works for real data, does not check to see if this is
               true or not.
       5) Midas extensions (.bdf, .tbl) assumed lower case.

       FM   - F. Murtagh, ST-ECF
       SAV  - Stephen A. Voels, USM/DAN

       MAY 1989  FM   Initial programming.
       FEB 1991  FM   Conversion to v.2 IDL, Unix.
       Converted to IDL V5.0   W. Landsman   September 1997

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]