#include <REMORA_NCInterface.H>

Collaboration diagram for ncutils::NCFile:

[legend]

Public Member Functions
	~NCFile ()

void	close ()
	Close file object.

int	num_dimensions () const
	Number of dimensions.

int	num_variables () const
	Number of variables.

int	num_attributes () const
	Number of attributes.

bool	has_dim (const std::string &) const
	Check if a dimension exists by name.

bool	has_var (const std::string &) const
	Check if a variable exists by name.

bool	has_attr (const std::string &) const
	Check if an attribute exists.

NCDim	dim (const std::string &) const
	Get the dimension instance by name.

NCVar	var (const std::string &) const
	Get the variable instance by name.

NCDim	def_dim (const std::string &, const size_t len) const
	Define new dimension.

NCVar	def_scalar (const std::string &name, const nc_type dtype) const
	Define a scalar variable, i.e., 0-dimensional array.

NCVar	def_array (const std::string &name, const nc_type dtype, const std::vector< std::string > &) const
	Define an array.

NCVar	def_array_fill (const std::string &name, const nc_type dtype, const std::vector< std::string > &dnames, const void *fill_val) const
	Define an array with a fill value.

NCVar	def_var (const std::string &name, const nc_type dtype, const std::vector< std::string > &dnames) const
	Define a variable (wrapper for def_array)

NCVar	def_var_fill (const std::string &name, const nc_type dtype, const std::vector< std::string > &dnames, const void *fill_val) const
	Define a variable (wrapper for def_array)

void	put_attr (const std::string &name, const std::string &value) const
	Set file attribute to value.

void	put_attr (const std::string &name, const std::vector< double > &value) const
	Set file attribute to value.

void	put_attr (const std::string &name, const std::vector< float > &value) const
	Set file attribute to value.

void	put_attr (const std::string &name, const std::vector< int > &value) const
	Set file attribute to value.

std::string	get_attr (const std::string &name) const
	Read file attribute from file.

void	get_attr (const std::string &name, std::vector< double > &value) const
	Read file attribute from file.

void	get_attr (const std::string &name, std::vector< float > &value) const
	Read file attribute from file.

void	get_attr (const std::string &name, std::vector< int > &value) const
	Read file attribute from file.

void	wait_all (int num_requests, int *requests)
	wait for non-blocking calls to finish

std::vector< NCDim >	all_dims () const
	Return a list of all dimensions defined in this group.

std::vector< NCVar >	all_vars () const
	Return a list of all variables defined in this group.

void	enter_def_mode () const
	Enter definition mode (not needed for NetCDF4 format)

void	exit_def_mode () const
	Exit definition mode.

	NCFile (const int id)

Static Public Member Functions
static NCFile	create (const std::string &name, const int cmode=NC_CLOBBER\|NC_64BIT_DATA, MPI_Comm comm=MPI_COMM_WORLD, MPI_Info info=MPI_INFO_NULL)
	Create a file. Defaults to CDF-5; classic CDF-1 has a 2GB limit.

static NCFile	open (const std::string &name, const int cmode=NC_NOWRITE, MPI_Comm comm=MPI_COMM_WORLD, MPI_Info info=MPI_INFO_NULL)
	Open an existing file.

Public Attributes
const int	ncid {-1}

bool	is_open {false}

Detailed Description

Representation of a NetCDF file

Provide wrappers to create and open file

Definition at line 284 of file REMORA_NCInterface.H.

Constructor & Destructor Documentation

◆ ~NCFile()

ncutils::NCFile::~NCFile ( )

Definition at line 507 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ NCFile()

ncutils::NCFile::NCFile ( const int id )

inline

Definition at line 402 of file REMORA_NCInterface.H.

Member Function Documentation

◆ all_dims()

std::vector< NCDim > ncutils::NCFile::all_dims ( ) const

Return a list of all dimensions defined in this group.

Definition at line 450 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ all_vars()

std::vector< NCVar > ncutils::NCFile::all_vars ( ) const

Return a list of all variables defined in this group.

Definition at line 460 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ close()

void ncutils::NCFile::close ( )

Close file object.

Definition at line 512 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ create()

NCFile ncutils::NCFile::create	(	const std::string &	name,
		const int	cmode = `NC_CLOBBER \| NC_64BIT_DATA`,
		MPI_Comm	comm = `MPI_COMM_WORLD`,
		MPI_Info	info = `MPI_INFO_NULL`
	)

static

Create a file. Defaults to CDF-5; classic CDF-1 has a 2GB limit.

Definition at line 485 of file REMORA_NCInterface.cpp.

Referenced by REMORA::WriteNCPlotFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ def_array()

NCVar ncutils::NCFile::def_array	(	const std::string &	name,
		const nc_type	dtype,
		const std::vector< std::string > &	dnames
	)		const

Define an array.

Definition at line 336 of file REMORA_NCInterface.cpp.

Referenced by def_var().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ def_array_fill()

NCVar ncutils::NCFile::def_array_fill	(	const std::string &	name,
		const nc_type	dtype,
		const std::vector< std::string > &	dnames,
		const void *	fill_val
	)		const

Define an array with a fill value.

Definition at line 348 of file REMORA_NCInterface.cpp.

Referenced by def_var_fill().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ def_dim()

NCDim ncutils::NCFile::def_dim	(	const std::string &	name,
		const size_t	len
	)		const

Define new dimension.

Definition at line 324 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ def_scalar()

NCVar ncutils::NCFile::def_scalar	(	const std::string &	name,
		const nc_type	dtype
	)		const

Define a scalar variable, i.e., 0-dimensional array.

Definition at line 330 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ def_var()

NCVar ncutils::NCFile::def_var	(	const std::string &	name,
		const nc_type	dtype,
		const std::vector< std::string > &	dnames
	)		const

inline

Define a variable (wrapper for def_array)

Definition at line 351 of file REMORA_NCInterface.H.

Here is the call graph for this function:

◆ def_var_fill()

NCVar ncutils::NCFile::def_var_fill	(	const std::string &	name,
		const nc_type	dtype,
		const std::vector< std::string > &	dnames,
		const void *	fill_val
	)		const

inline

Define a variable (wrapper for def_array)

Definition at line 360 of file REMORA_NCInterface.H.

Here is the call graph for this function:

◆ dim()

NCDim ncutils::NCFile::dim ( const std::string & name ) const

Get the dimension instance by name.

Definition at line 318 of file REMORA_NCInterface.cpp.

Referenced by def_array(), and def_array_fill().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ enter_def_mode()

void ncutils::NCFile::enter_def_mode ( ) const

Enter definition mode (not needed for NetCDF4 format)

Definition at line 470 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ exit_def_mode()

void ncutils::NCFile::exit_def_mode ( ) const

Exit definition mode.

Definition at line 481 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ get_attr() [1/4]

std::string ncutils::NCFile::get_attr ( const std::string & name ) const

Read file attribute from file.

Definition at line 420 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ get_attr() [2/4]

void ncutils::NCFile::get_attr	(	const std::string &	name,
		std::vector< double > &	value
	)		const

Read file attribute from file.

Definition at line 429 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ get_attr() [3/4]

void ncutils::NCFile::get_attr	(	const std::string &	name,
		std::vector< float > &	value
	)		const

Read file attribute from file.

Definition at line 436 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ get_attr() [4/4]

void ncutils::NCFile::get_attr	(	const std::string &	name,
		std::vector< int > &	value
	)		const

Read file attribute from file.

Definition at line 443 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ has_attr()

bool ncutils::NCFile::has_attr ( const std::string & name ) const

Check if an attribute exists.

Definition at line 397 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ has_dim()

bool ncutils::NCFile::has_dim ( const std::string & name ) const

Check if a dimension exists by name.

Definition at line 386 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ has_var()

bool ncutils::NCFile::has_var ( const std::string & name ) const

Check if a variable exists by name.

Definition at line 391 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ num_attributes()

int ncutils::NCFile::num_attributes ( ) const

Number of attributes.

Definition at line 374 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ num_dimensions()

int ncutils::NCFile::num_dimensions ( ) const

Number of dimensions.

Definition at line 368 of file REMORA_NCInterface.cpp.

Referenced by all_dims().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ num_variables()

int ncutils::NCFile::num_variables ( ) const

Number of variables.

Definition at line 380 of file REMORA_NCInterface.cpp.

Referenced by all_vars().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ open()

NCFile ncutils::NCFile::open	(	const std::string &	name,
		const int	cmode = `NC_NOWRITE`,
		MPI_Comm	comm = `MPI_COMM_WORLD`,
		MPI_Info	info = `MPI_INFO_NULL`
	)

static

Open an existing file.

Definition at line 491 of file REMORA_NCInterface.cpp.

Referenced by check_hires_dims_from_netcdf(), NCTimeSeries::Initialize(), NCTimeSeriesRiver::Initialize(), QueryNetCDFHasVars(), QueryNetCDFVarAttrStr(), ReadNetCDFFile(), ReadNetCDFVarAttrStr(), and REMORA::WriteNCPlotFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ put_attr() [1/4]

void ncutils::NCFile::put_attr	(	const std::string &	name,
		const std::string &	value
	)		const

Set file attribute to value.

Definition at line 404 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ put_attr() [2/4]

void ncutils::NCFile::put_attr	(	const std::string &	name,
		const std::vector< double > &	value
	)		const

Set file attribute to value.

Definition at line 408 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ put_attr() [3/4]

void ncutils::NCFile::put_attr	(	const std::string &	name,
		const std::vector< float > &	value
	)		const

Set file attribute to value.

Definition at line 412 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ put_attr() [4/4]

void ncutils::NCFile::put_attr	(	const std::string &	name,
		const std::vector< int > &	value
	)		const

Set file attribute to value.

Definition at line 416 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ var()

NCVar ncutils::NCFile::var ( const std::string & name ) const

Get the variable instance by name.

Definition at line 362 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

◆ wait_all()

void ncutils::NCFile::wait_all	(	int	num_requests,
		int *	requests
	)

wait for non-blocking calls to finish

Definition at line 497 of file REMORA_NCInterface.cpp.

Here is the call graph for this function:

Member Data Documentation

◆ is_open

bool ncutils::NCFile::is_open {false}

Definition at line 405 of file REMORA_NCInterface.H.

Referenced by close(), and ~NCFile().

◆ ncid

const int ncutils::NCFile::ncid {-1}

Definition at line 404 of file REMORA_NCInterface.H.

Referenced by all_dims(), all_vars(), close(), create(), def_array(), def_array_fill(), def_dim(), def_scalar(), dim(), enter_def_mode(), exit_def_mode(), get_attr(), get_attr(), get_attr(), get_attr(), has_attr(), has_dim(), has_var(), num_attributes(), num_dimensions(), num_variables(), open(), put_attr(), put_attr(), put_attr(), put_attr(), var(), wait_all(), and ~NCFile().

The documentation for this class was generated from the following files:

/home/runner/work/REMORA/REMORA/Source/IO/REMORA_NCInterface.H
/home/runner/work/REMORA/REMORA/Source/IO/REMORA_NCInterface.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~NCFile()

◆ NCFile()

Member Function Documentation

◆ all_dims()

◆ all_vars()

◆ close()

◆ create()

◆ def_array()

◆ def_array_fill()

◆ def_dim()

◆ def_scalar()

◆ def_var()

◆ def_var_fill()

◆ dim()

◆ enter_def_mode()

◆ exit_def_mode()

◆ get_attr() [1/4]

◆ get_attr() [2/4]

◆ get_attr() [3/4]

◆ get_attr() [4/4]

◆ has_attr()

◆ has_dim()

◆ has_var()

◆ num_attributes()

◆ num_dimensions()

◆ num_variables()

◆ open()

◆ put_attr() [1/4]

◆ put_attr() [2/4]

◆ put_attr() [3/4]

◆ put_attr() [4/4]

◆ var()

◆ wait_all()

Member Data Documentation

◆ is_open

◆ ncid