R: Create a netCDF File

nc_create {ncdf4} | R Documentation

## Create a netCDF File

### Description

Creates a new netCDF file on disk, given the variables the new file is to contain.

### Usage

     nc_create( filename, vars, force_v4=FALSE, verbose=FALSE )

### Arguments

`filename` | Name of the netCDF file to be created.
`vars` | Either an object of class `ncvar4` describing the variable to be created, or a vector (or list) of such objects to be created.
`force_v4` | If TRUE, then the created output file will always be in netcdf-4 format (which supports more features, but cannot be read by version 3 of the netcdf library). If FALSE, then the file is created in netcdf version 3 format UNLESS the user has requested features that require version 4. Deafult is FALSE.
`verbose` | If TRUE, then information is printed while the file is being created.

### Details

This routine creates a new netCDF file on disk. The routine must be called with the variables that will be created in the file. Keep in mind that the new file may not actually be written to disk until `nc_close` is called. Always call `nc_close` when you are done with your file, or before exiting R!

### Value

An object of class `ncdf4`, which has the fields described in `nc_open`.

### Author(s)

David W. Pierce dpierce@ucsd.edu

### References

http://dwpierce.com/software

### See Also

`ncdim_def`, `ncvar_def`.

### Examples

    # Define an integer dimension
    dimState <- ncdim_def( "StateNo", "count", 1:50 )

    # Make an integer variable.  Note that an integer variable can have
    # a double precision dimension, or vice versa; there is no fixed
    # relationship between the precision of the dimension and that of the
    # associated variable.  We just make an integer variable here for
    # illustration purposes.
    varPop <- ncvar_def("Pop", "count", dimState, -1,
    		longname="Population", prec="integer")

    # Create a netCDF file with this variable
    ncnew <- nc_create( "states_population.nc", varPop )

    # Write some values to this variable on disk.
    popAlabama <- 4447100
    ncvar_put( ncnew, varPop, popAlabama, start=1, count=1 )

    nc_close(ncnew)

    # Clean up example
    file.remove( "states_population.nc" )

[Package ncdf4 version 1.17 Index]