gdncvaropen.f90 File Reference

Open a netCDF variable. More...

Go to the source code of this file.

Functions/Subroutines
recursive subroutine	gdncvaropen (var, url, writable, err)

Detailed Description

Open a netCDF variable.

Author

Yasuhiro MORIKAWA, Eizi TOYODA

Copyright

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

These subroutines and functions are provided through gtdata_netcdf_generic.

Definition in file gdncvaropen.f90.

Function/Subroutine Documentation

gdncvaropen()

recursive subroutine gdncvaropen	(	type(gd_nc_variable), intent(out)	var,
		character(len = *), intent(in)	url,
		logical, intent(in), optional	writable,
		logical, intent(out), optional	err )

Open a variable from URL

Opens a netCDF variable specified by URL. If the variable name is empty in the URL, the first non-dimension variable is opened.

Parameters

[out]	var	Opened variable handle
[in]	url	Variable URL
[in]	writable	Open for writing (optional)
[out]	err	Error flag (optional)

Definition at line 40 of file gdncvaropen.f90.

  use dc_types, only: string
  use gtdata_netcdf_types, only: gd_nc_variable, gd_nc_variable_search
  use gtdata_netcdf_internal, only: vtable_add
  use gtdata_netcdf_file_generic, only: gdncfileopen
  use dc_url, only: urlsplit
  use dc_error, only: storeerror
  use dc_trace, only: beginsub, endsub
  use netcdf, only: nf90_noerr, nf90_max_name, nf90_enotvar, nf90_ebaddim, &
    & nf90_inq_varid, nf90_inq_dimid, nf90_inquire_variable, nf90_inquire
  implicit none
  type(GD_NC_VARIABLE), intent(out):: var
  character(len = *), intent(in):: url
  logical, intent(in), optional:: writable
  logical, intent(out), optional:: err
  character(len = STRING):: filename, varname
  character(len = NF90_MAX_NAME):: dimname
  integer:: stat, nvars, i
  type(GD_NC_VARIABLE_SEARCH):: e
  character(len = *), parameter:: subname = 'GDNcVarOpen'
continue
  call beginsub(subname)
  call urlsplit(url, file=filename, var=varname)
  if (filename == "") filename = "gtool.nc"
  call gdncfileopen(e%fileid, trim(filename), stat=stat, writable=writable, err=err )
  if (stat /= 0) goto 999
  !
  ! 名前から変数を探し出す
  !
  if (varname /= '') then
    e%varid = 0
    stat = nf90_inq_varid(e%fileid, trim(varname), e%varid)
    if (stat == nf90_enotvar) then
      e%varid = 0
      stat = nf90_noerr
    endif
  else
    ! 名前が空ならできれば次元変数でない最初の変数をとりだす
    stat = nf90_inquire(e%fileid, nvariables = nvars)
    if (stat /= 0) goto 999
    e%varid = 1
    do, i = 1, nvars
      stat = nf90_inquire_variable(e%fileid, i, name = dimname)
      if (stat /= nf90_noerr) goto 999
      stat = nf90_inq_dimid(e%fileid, dimname, e%dimid)
      if (stat == nf90_noerr) cycle
      if (stat /= nf90_ebaddim) goto 999
      e%varid = i
      stat = nf90_noerr
      exit
    enddo
  endif
  if (stat /= nf90_noerr) goto 999
  !
  ! 次元id を調べる
  !
  stat = nf90_inq_dimid(e%fileid, trim(varname), e%dimid)
  if (stat /= nf90_noerr) then
    if (e%varid <= 0) goto 999
    e%dimid = 0
  endif
  !
  stat = vtable_add(var, e)
  if (stat /= nf90_noerr) goto 999
  call endsub(subname, 'an=%d file=%d var=%d', i=(/var%id, e%fileid, e%varid/))
  call storeerror(stat, subname, err)
  return
  !
  ! エラー処理 (正常完了時も呼ぶ)
  !
999 continue
  var = gd_nc_variable(-1)
  call endsub(subname, 'an=%d err', i=(/var%id/))
  call storeerror(stat, subname, err, cause_c=url)

References dc_trace::beginsub(), dc_trace::endsub(), dc_error::storeerror(), dc_types::string, and gtdata_netcdf_internal::vtable_add().

Here is the call graph for this function: