Define a Dimension

Define a new dimension in the file in C. More...

Functions
int	PIOc_def_dim (int ncid, const char *name, PIO_Offset len, int *idp)
	The PIO-C interface for the NetCDF function nc_def_dim. More...

Detailed Description

Define a new dimension in the file in C.

Function Documentation

PIOc_def_dim()

int PIOc_def_dim	(	int	ncid,
		const char *	name,
		PIO_Offset	len,
		int *	idp
	)

The PIO-C interface for the NetCDF function nc_def_dim.

This routine is called collectively by all tasks in the communicator ios.union_comm. For more information on the underlying NetCDF commmand please read about this function in the NetCDF documentation at: http://www.unidata.ucar.edu/software/netcdf/docs/group__dimensions.html

Parameters

ncid	the ncid of the open file, obtained from PIOc_openfile() or PIOc_createfile().
name	name of the dimension.
len	length of the dimension.
idp	a pointer that will get the id of the variable or attribute.

Returns

PIO_NOERR for success, error code otherwise.

Author

Jim Edwards, Ed Hartnett