R: Rename a NetCDF Attribute

att.rename.nc {RNetCDF} | R Documentation

## Rename a NetCDF Attribute

### Description

Rename a NetCDF attribute.

### Usage

    att.rename.nc(ncfile, variable, attribute, newname)

### Arguments

`ncfile` | Object of class "`NetCDF`" which points to the NetCDF dataset (as returned from `open.nc`).
`variable` | ID or name of the attribute's variable, or `"NC_GLOBAL"` for a global attribute.
`attribute` | The current attribute name or ID.
`newname` | The new name to be assigned to the specified attribute.

### Details

This function changes the name of an existing attribute in a NetCDF dataset open for writing. An attribute cannot be renamed to have the same name as another attribute of the same variable.

### Author(s)

Pavel Michna

### References

http://www.unidata.ucar.edu/software/netcdf/

### Examples

    ##  Create a new NetCDF dataset and define two dimensions
    nc <- create.nc("att.rename.nc")

    dim.def.nc(nc, "station", 5)
    dim.def.nc(nc, "time", unlim=TRUE)

    ##  Create two variables, one as coordinate variable
    var.def.nc(nc, "time", "NC_INT", "time")
    var.def.nc(nc, "temperature", "NC_DOUBLE", c(0,1))

    ##  Put some attributes
    att.put.nc(nc, "temperature", "missing_value", "NC_DOUBLE", -99999.9)
    att.put.nc(nc, "NC_GLOBAL", "title", "NC_CHAR", "Data from Foo")

    ##  Rename these attributes
    att.rename.nc(nc, "temperature", "missing_value", "my_missing_value")
    att.rename.nc(nc, "NC_GLOBAL", "title", "my_title")

    close.nc(nc)

[Package RNetCDF version 1.9-1 Index]