>  Docs Center  >  Libraries  >  ASTROLIB  >  READ_IPAC_VAR

READ_IPAC_VAR

READ_IPAC_VAR

Name


  READ_IPAC_VAR

Purpose


  Read an IPAC ascii table from a variable into an IDL structure.
  Used by query_irsa_cat.pro.

Explanation


  Reads an IPAC ascii table from a variable into an IDL structure. The
  definition of an IPAC-format table is currently here:
      http://irsa.ipac.caltech.edu/applications/DDGEN/Doc/ipac_tbl.html

Calling Sequence


      info = read_ipac_var(textvar, [change_null=change_null, /debug])

Inputs


      TEXTVAR -- a text variable with the table returned from the query

Optional Input


      CHANGE_NULL -- an integer value to be used when the IPAC table
                    has a non-numeric string for null values in an
                    integer column. The default is -9999. For
                    floating-point columns, this is 'NaN'.
      DEBUG -- enables some debugging statements

Outputs


      info - Anonymous IDL structure containing information on the catalog. The structure
          tag names are taken from the column names. The structure will put header
          information in tags starting with "HEADER", e.g.
          HEADER_TABLE_HEADER, HEADER_DATA_UNITS, and HEADER_NULL_VALUES.
          Since the table column names may be altered if they are
          not valid IDL variable names, the original column names
          are saved as HEADER_COL_NAMES_ORIG. The original data
          type names are also saved as HEADER_COL_TYPES_ORIG.
          If the table is not valid, or contains no data, the function returns a value of -1

Procedures Used


  GET_DATE, VALID_NUM

Notes


  Uses some unnecessary looping, but it's kept this way to stay
  similar to read_ipac_table.pro.

Modification History


      Adapted from read_ipac_table - C. Gonzalez, U. Alicante March 2011
      Allow long integer, convert blanks in numeric fields to null
      value - T. Brooke, IPAC May 2011
      Allow 64bit long; use valid_num to check - TB June 2013



© 2019 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us