NCL Website header
NCL Home > Documentation > Functions > Group query, File I/O


Returns an array of file group names in the specified supported file.

Available in version 6.1.1 and later.


	function getfilegrpnames (
		the_file [1] : file   

	return_val [*] :  string



A reference to a file, created using addfile or addfiles. Thus, it must be a supported file format.

Return value

This function returns an array of strings with each element containing the name of a group. The length of this array is equal to the number of groups in the file.


This function is useful when accessing file groups by string name. (See Files.)

See Also



The following example gets all the group names from a netCDF file but it will also work for any file referenced by addfile. The dollar sign syntax used in this example is described at "NCL Variables".

    f = addfile ("" , "r")   ; could also have ccm, grb or hdf suffux
    gNames = getfilegrpnames (f) ; get names of all groups on file
    nNames = dimsizes (gNames)   ; number of groups on the file
    print (nNames)               ; print all group names on file
    do n=0,nNames-1              ; loop thru each group
       g = f=>$gNames(n)$        ; read the group to memory
       delete (g)
   end do