gdncvarsearch.f90 File Reference

Search for variables in a netCDF file. More...

Go to the source code of this file.

Functions/Subroutines
subroutine	gdncvarsearchinit (iter, urlbase)
subroutine	gdncvarsearchnext (iter, url, end)

Detailed Description

Search for variables in a netCDF file.

Author

GFD Dennou Club

Copyright

Copyright (C) GFD Dennou Club, 2000-2026. All rights reserved.
License is BSD-2-Clause. See COPYRIGHT in detail

To enumerate all variables in a file:

1. Call var_search(iter, urlbase) to initialize the iterator
2. Call attr_next(iter, url, end) in a loop
3. url gives each variable URL; end becomes true when all variables are enumerated

Definition in file gdncvarsearch.f90.

Function/Subroutine Documentation

gdncvarsearchinit()

subroutine gdncvarsearchinit	(	type(gd_nc_variable_search), intent(out)	iter,
		character(len = *), intent(in)	urlbase )

Initialize variable search iterator

Parameters

[out]	iter	Search iterator
[in]	urlBase	Base URL for the file

Definition at line 38 of file gdncvarsearch.f90.

  use dc_types, only: string
  use gtdata_netcdf_types, only: gd_nc_variable_search
  use dc_url, only: urlsplit
  use gtdata_netcdf_file_generic, only: gdncfileopen
  use dc_trace, only: beginsub, endsub, dbgmessage
  implicit none
  type(GD_NC_VARIABLE_SEARCH), intent(out):: iter
  character(len = *), intent(in):: urlBase
  character(len = string):: file
  logical:: err
  character(len = *), parameter:: subname = 'GDNcVarSearchInit'
 
  call beginsub(subname, 'urlbase=<%c>', c1=trim(urlbase))
  call urlsplit(trim(urlbase), file=file)
  call gdncfileopen(iter%fileid, filename=file, writable=.false., err=err)
  if (err) iter%fileid = -1
  iter%varid = 0
  iter%dimid = 0
  call endsub(subname, 'file=%d', i=(/iter%fileid/))

References dc_trace::beginsub(), dc_trace::dbgmessage(), dc_trace::endsub(), and dc_types::string.

Here is the call graph for this function:

gdncvarsearchnext()

subroutine gdncvarsearchnext	(	type(gd_nc_variable_search), intent(inout)	iter,
		character(len = *), intent(out)	url,
		logical, intent(out)	end )

Get next variable in search

Returns the URL of the next variable. Dimension-only variables (without corresponding coordinate variable) are also included.

Parameters

[in,out]	iter	Search iterator
[out]	url	Variable URL
[out]	end	True when all variables enumerated

Definition at line 80 of file gdncvarsearch.f90.

  use gtdata_netcdf_types, only: gd_nc_variable_search
  use dc_types, only: string
  use netcdf, only: nf90_max_name, nf90_noerr, &
    & nf90_inquire_variable, nf90_inquire_dimension, nf90_inq_varid
  use dc_url, only: urlmerge
  use gtdata_netcdf_file_generic, only: gdncfileinquire, gdncfileclose
  use dc_trace, only: beginsub, endsub, dbgmessage
  implicit none
  type(GD_NC_VARIABLE_SEARCH), intent(inout):: iter
  character(len = *), intent(out):: url
  logical, intent(out):: end
  character(len = string):: filename
  character(len = NF90_MAX_NAME):: varname
  integer:: stat, varid_tmp
  character(len = *), parameter:: subname = 'GDNcVarSearchNext'
continue
  call beginsub(subname)
  if (iter%fileid <= 0) then
    end = .TRUE.
    url = ''
    call endsub(subname, "bad file %d", i=(/iter%fileid/))
    return
  endif
  if (iter%varid >= 0) then
    iter%varid = iter%varid + 1
    stat = nf90_inquire_variable(iter%fileid, iter%varid, name = varname)
    if (stat == nf90_noerr) goto 900
    iter%varid = -1
  endif
  do while (iter%dimid >= 0)
    iter%dimid = iter%dimid + 1
    ! --- 指定番号の次元がなければエラー ---
    stat = nf90_inquire_dimension(iter%fileid, iter%dimid, name = varname)
    if (stat /= nf90_noerr) exit
    ! --- 指定番号の次元と同名の変数があれば却下、次番号へ ---
    stat = nf90_inq_varid(iter%fileid, varname, varid_tmp)
    if (stat /= nf90_noerr) goto 900
  enddo
  end = .TRUE.
  url = ""
  call gdncfileclose(iter%fileid)
  iter%dimid = -1
  call endsub(subname, "end file %d", i=(/iter%fileid/))
  return
 
900 continue
  call gdncfileinquire(iter%fileid, name=filename)
  url = urlmerge(file=trim(filename), var=trim(varname))
  end = .FALSE.
  call endsub(subname, "file=%d url=<%c>", &
    & i=(/iter%fileid/), c1=trim(url))
  return

References dc_trace::beginsub(), dc_trace::dbgmessage(), dc_trace::endsub(), gdncfileclose(), and dc_types::string.

Here is the call graph for this function: