Create a File

Create a new netCDF file with PIO in C. More...

Functions
int	PIOc_createfile (int iosysid, int *ncidp, int *iotype, const char *filename, int mode)
	Create a new file using pio. More...
int	PIOc_create (int iosysid, const char *path, int cmode, int *ncidp)
	Open a new file using pio. More...

Detailed Description

Create a new netCDF file with PIO in C.

Function Documentation

PIOc_create()

int PIOc_create	(	int	iosysid,
		const char *	path,
		int	cmode,
		int *	ncidp
	)

Open a new file using pio.

The default fill mode will be used (FILL for netCDF and netCDF-4 formats, NOFILL for pnetcdf.) Input parameters are read on comp task 0 and ignored elsewhere.

Parameters

iosysid	: A defined pio system descriptor (input)
path	: The filename to create.
cmode	: The netcdf mode for the create operation.
ncidp	: A pio file descriptor (output)

Returns

0 for success, error code otherwise.

Author

Ed Hartnett

PIOc_createfile()

int PIOc_createfile	(	int	iosysid,
		int *	ncidp,
		int *	iotype,
		const char *	filename,
		int	mode
	)

Create a new file using pio.

Input parameters are read on comp task 0 and ignored elsewhere. NOFILL mode will be turned on in all cases.

Parameters

iosysid	A defined pio system ID, obtained from PIOc_InitIntercomm() or PIOc_InitAsync().
ncidp	A pointer that gets the ncid of the newly created file.
iotype	A pointer to a pio output format. Must be one of PIO_IOTYPE_PNETCDF, PIO_IOTYPE_NETCDF, PIO_IOTYPE_NETCDF4C, or PIO_IOTYPE_NETCDF4P.
filename	The filename to create.
mode	The netcdf mode for the create operation.

Returns

0 for success, error code otherwise.

Author

Jim Edwards, Ed Hartnett