>  Docs Center  >  Libraries  >  Motley  >  MGH_NCDF_RESTORE

MGH_NCDF_RESTORE

MGH_NCDF_RESTORE

Name


  MGH_NCDF_RESTORE

Purpose


  This function retrieves data from a netCDF file (or sequence thereof)
  in the form of an IDL structure.

Category


  NetCDF

Calling Sequence


  result = MGH_NCDF_RESTORE(file, variables)

Positional Parameters


  file (input, string, scalar or vector)
    A list of netCDF file names. This list is passed to the Init
    routine for the netCDF file object.
  variables (input, string, scalar or vector, optional)
    A list of variable names. Default is all variables in the file(s).

Keyword Parameters


  AUTOSCALE (input, switch)
    Passed to the netCDF object's Retrieve method to determine whether
    data are automatically scaled.
  COUNT (output, integer)
    This keyword returns the number of variables for which data have
    been returned.
  HASH (input, switch)
    Passed to the netCDF object's Retrieve method to specify that
    the result should be a hash.
  NETCDF_CLASS (input, string, scalar)
    The class of the netCDF file object to be created. Permissible
    values are 'MGHncFile', 'MGHncReadFile' and
    'MGHncSequence'. The default is 'MGHncSequence'.
  POINTER (input, switch)
    Passed to the netCDF object's Retrieve method to specify that
    the result should be a structure with the data values contained
    as pointer variables
  Other keywords are passed to the netCDF object's Init method via
  inheritance.

Return Value


  The function returns an anonymous structure, with one tag per
  variable.

Procedure


  An netCDF file object is created, its Retrieve method called and
  the object then destroyed.
###########################################################################
  Copyright (c) 1994-2013 NIWA:
  http://www.niwa.co.nz/
  Licensed under the MIT open source license:
  http://www.opensource.org/licenses/mit-license.php
###########################################################################

Modification History


  Mark Hadfield, 14 Mar 1994:
    Written as NCDF_RESTORE.
  Mark Hadfield, Apr 1997:
    Rewritten to use the MGHncFile class.
  Mark Hadfield, May 1998:
    Extra keywords now passed to MGHncFile.
  Mark Hadfield, Nov 2000:
    Renamed MGH_NCDF_RESTORE, updated, moved to public directory,
    added NETCDF_CLASS keyword & associated functionality.
  Mark Hadfield, 2001-07:
    Updated for IDL 5.5.
  Mark Hadfield, 2005-09:
    Added POINTER keyword.
  Mark Hadfield, 2011-11:
    Added HASH keyword.
  Mark Hadfield, 2013-10:
    Added check for undefined file name.



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