Summary
Makes a raster layer from a netCDF file.
Usage
To create a netCDF raster layer from a netCDF variable, the spacing between x-coordinates must be equal and the spacing between y-coordinates must be equal. If the coordinates are unequally spaced, create a netCDF feature layer, then interpolate to raster.
The output raster layer type is either float or integer based on the netCDF variable type.
The first variable in the netCDF file suitable for creating a raster is selected as the default variable.
Auxiliary coordinate variables are listed in the X Dimension and Y Dimension drop-down lists and used during execution if specified. They are not listed in the Dimension Values parameter drop-down list and cannot be set as the value of this parameter in a script.
Specify a Band Dimension to create a multiband raster.
The first value of a nonspatial dimension is used to create a default view of a multidimensional variable.
To save the output layer, right-click the layer in the ArcMap table of contents and click Save As Layer File, or use the Save To Layer File tool.
The calendar attribute values noleap and 365_day, assigned to the time coordinate variable of the netCDF file, are not honored in ArcGIS.
Use the Cell registration parameter (cell_registration in Python) to determine how the extent of the netCDF raster layer is computed from the X Dimension and Y Dimension values. The cell size, number of rows, number of columns, and the width and height of the output raster remain the same, irrespective of the option used.
Syntax
MakeNetCDFRasterLayer(in_netCDF_file, variable, x_dimension, y_dimension, out_raster_layer, {band_dimension}, {dimension_values}, {value_selection_method}, {cell_registration})
Parameter | Explanation | Data Type |
in_netCDF_file | The input netCDF file. | File |
variable | The variable of the netCDF file used to assign cell values to the output raster. This is the variable that will be displayed, such as temperature or rainfall. | String |
x_dimension | A netCDF dimension used to define the x, or longitude, coordinates of the output layer. | String |
y_dimension | A netCDF dimension used to define the y, or latitude, coordinates of the output layer. | String |
out_raster_layer | The name of the output raster layer. | Raster Layer |
band_dimension (Optional) | A netCDF dimension used to create bands in the output raster. Set this dimension if a multiband raster layer is required. For instance, altitude might be set as the band dimension to create a multiband raster where each band represents temperature at that altitude. | String |
dimension_values [[dimension, {value}],...] (Optional) | The value (such as 01/30/05) of the dimension (such as Time) or dimensions to use when displaying the variable in the output layer. By default, the first value of the dimension or dimensions will be used. This default value can also be altered on the netCDF tab of the Layer Properties dialog box.
| Value Table |
value_selection_method (Optional) | Specifies the dimension value selection method.
| String |
cell_registration (Optional) | Determines the location of the cell registration.
| String |
Code sample
MakeNetCDFRasterLayer example 1 (Python window)
Creates a raster layer from a netCDF file.
import arcpy
arcpy.MakeNetCDFRasterLayer_md("C:/data/netcdf/rainfall.nc","pptx",
"lon","lat","rainfall")
MakeNetCDFRasterLayer example 2 (stand-alone script)
Creates a raster layer from a netCDF file.
# Name: MakeNetCDFRasterLayer_Ex_02.py
# Description: Create a raster layer from a netCDF file.
# Requirements: None
# Import system modules
import arcpy
# Set local variables
inNetCDFFile = "C:/data/netcdf/rainfall.nc"
variable = "pptx"
XDimension = "lon"
YDimension = "lat"
outRasterLayer = "rainfall"
bandDimmension = ""
dimensionValues = ""
valueSelectionMethod = ""
cellRegistration = ""
# Execute MakeNetCDFRasterLayer
arcpy.MakeNetCDFRasterLayer_md(inNetCDFFile, variable, XDimension, YDimension,
outRasterLayer, bandDimmension, dimensionValues,
valueSelectionMethod, cellRegistration)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes