mo_ncread::get_ncvar Interface Reference

Read array from NC file. More...

Public Member Functions
subroutine	get_ncvar_0d_sp (filename, varname, dat, fid)
subroutine	get_ncvar_0d_dp (filename, varname, dat, fid)
subroutine	get_ncvar_1d_sp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_1d_dp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_2d_sp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_2d_dp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_3d_sp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_3d_dp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_4d_sp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_4d_dp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_5d_sp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_5d_dp (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_0d_i4 (filename, varname, dat, fid)
subroutine	get_ncvar_1d_i4 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_2d_i4 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_3d_i4 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_4d_i4 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_5d_i4 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_0d_i1 (filename, varname, dat, fid)
subroutine	get_ncvar_1d_i1 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_2d_i1 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_3d_i1 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_4d_i1 (filename, varname, dat, start, a_count, fid)
subroutine	get_ncvar_5d_i1 (filename, varname, dat, start, a_count, fid)

Detailed Description

Read array from NC file.

Reads a 2 - 5 dimensional array from a nc file given the variable name EXACTLY as specified in the file. If the array is not allocated when calling, Get_NcVar will allocate it internally. If the dimension of the actual data is less than the ones of the array, then the dimension lengths of the array will be filled with ones.

Example

See test program in directory test_mo_NcRead.

Literature

1. http://www.unidata.ucar.edu/software/netcdf/docs/netcdf-f90.html

Parameters

[in]	character(len=*) :: Filename	Name of the nc file.
[in]	character(len=*) :: VarName	Name of the Variable in the nc file.
[in]	real(sp/dp), dimension(:,:[,:[,:[,:]]]), allocatable :: array	Array where data will be read.
[in]	integer(i4), dimension(:) :: jdate	Starting indeces of first value to read. len is the number of dimensions of array, default is 1, see example
[in]	integer(i4), dimension(:) :: a_count	Same size as jdate, specifies how many values in each dimension is going to be read
[in]	integer(i4) :: fid	File handle of opened netcdf file

Note

Output array is a floating point of 2-5 dimensions.
NOT yet tested for different compilers than intel11.1.075 CANNOT read packed data.
i1 indicates, that 1 byte integer is read [type is integer(1)].

Author

Stephan Thober

Date

Nov 2011

• added comments

Mar 2012

• corrected dynamical read of data

May 2012

• fid

Nov 2012

• write out Varname, when vartype is incorrect

Feb 2013

• added 1 byte integer version

Mar 2014

• added subroutines for allocatable arrays

Author

Matthias Cuntz

Date

Jan 2012

• unified routines for different dimensions and data types

Definition at line 85 of file mo_ncread.f90.

Member Function/Subroutine Documentation

get_ncvar_0d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_0d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), intent(inout)	dat,
		integer(i4), intent(in), optional	fid
	)

Definition at line 380 of file mo_ncread.f90.

get_ncvar_0d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_0d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), intent(inout)	dat,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1621 of file mo_ncread.f90.

get_ncvar_0d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_0d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), intent(inout)	dat,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1202 of file mo_ncread.f90.

get_ncvar_0d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_0d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), intent(inout)	dat,
		integer(i4), intent(in), optional	fid
	)

Definition at line 341 of file mo_ncread.f90.

get_ncvar_1d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_1d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), dimension(:), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 497 of file mo_ncread.f90.

get_ncvar_1d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_1d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), dimension(:), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1661 of file mo_ncread.f90.

get_ncvar_1d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_1d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), dimension(:), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1242 of file mo_ncread.f90.

get_ncvar_1d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_1d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), dimension(:), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 419 of file mo_ncread.f90.

get_ncvar_2d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_2d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), dimension(:, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 654 of file mo_ncread.f90.

get_ncvar_2d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_2d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), dimension(:, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1737 of file mo_ncread.f90.

get_ncvar_2d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_2d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), dimension(:, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1318 of file mo_ncread.f90.

get_ncvar_2d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_2d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), dimension(:, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 575 of file mo_ncread.f90.

get_ncvar_3d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_3d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), dimension(:, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 812 of file mo_ncread.f90.

get_ncvar_3d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_3d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), dimension(:, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1813 of file mo_ncread.f90.

get_ncvar_3d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_3d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), dimension(:, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1394 of file mo_ncread.f90.

get_ncvar_3d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_3d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), dimension(:, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 732 of file mo_ncread.f90.

get_ncvar_4d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_4d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), dimension(:, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 968 of file mo_ncread.f90.

get_ncvar_4d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_4d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), dimension(:, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1889 of file mo_ncread.f90.

get_ncvar_4d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_4d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), dimension(:, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1470 of file mo_ncread.f90.

get_ncvar_4d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_4d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), dimension(:, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 890 of file mo_ncread.f90.

get_ncvar_5d_dp()

subroutine mo_ncread::get_ncvar::get_ncvar_5d_dp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(dp), dimension(:, :, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1124 of file mo_ncread.f90.

get_ncvar_5d_i1()

subroutine mo_ncread::get_ncvar::get_ncvar_5d_i1	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(1), dimension(:, :, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1965 of file mo_ncread.f90.

get_ncvar_5d_i4()

subroutine mo_ncread::get_ncvar::get_ncvar_5d_i4	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		integer(i4), dimension(:, :, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1546 of file mo_ncread.f90.

get_ncvar_5d_sp()

subroutine mo_ncread::get_ncvar::get_ncvar_5d_sp	(	character(len = *), intent(in)	filename,
		character(len = *), intent(in)	varname,
		real(sp), dimension(:, :, :, :, :), intent(inout), allocatable	dat,
		integer(i4), dimension(:), intent(in), optional	start,
		integer(i4), dimension(:), intent(in), optional	a_count,
		integer(i4), intent(in), optional	fid
	)

Definition at line 1046 of file mo_ncread.f90.

---

The documentation for this interface was generated from the following file:

• src/mo_ncread.f90