Make OPeNDAP Raster Layer

Summary

Makes a raster layer from data stored on an OPeNDAP server.

Usage

• The performance of this tool depends on the speed of the remote OPeNDAP server and the robustness of the Internet connection between the machine executing the tool and the remote server.

• To create a raster layer, the spacing of the x-coordinates must be equal and the spacing between the y-coordinates of the remote data must be equal. This is often referred to as regularly gridded data.

• Some examples of URLs that reference remote OPeNDAP datasets are the following:

  • http://motherlode.ucar.edu:8080/thredds/dodsC/fmrc/NCEP/GFS/CONUS_80km/files/GFS_CONUS_80km_20121211_1200.grib1
  • http://motherlode.ucar.edu:8080/thredds/dodsC/nexrad/level3/PTA/YUX/20121214/Level3_YUX_PTA_20121214_2227.nids
  • http://motherlode.ucar.edu:8080/thredds/dodsC/station/profiler/RASS/06min/20121214/PROFILER_RASS_06min_20121214_2354.nc

Syntax

MakeOPeNDAPRasterLayer_md (in_opendap_URL, variable, x_dimension, y_dimension, out_raster_layer, {extent}, {dimension_values}, {value_selection_method})

Parameter	Explanation	Data Type
in_opendap_URL	The URL that references the remote OPeNDAP dataset. The URL should resolve to the dataset level (for example, file name), not a directory name.	File; String
variable	The variable from the OPeNDAP dataset that will be used to create the raster layer.	String
x_dimension	The dimension of the OPeNDAP dataset used to define the x, or longitude, coordinates of the output raster layer.	String
y_dimension	The dimension of the OPeNDAP dataset used to define the y, or latitude, coordinates of the output raster layer.	String
out_raster_layer	The name of the output raster layer.	Raster Layer
extent (Optional)	The output extent of the raster layer. Specify the extent coordinates in the units of the OPeNDAP data source (these could be latitude-longitude, projected coordinates, or some arbitrary grid coordinates). The purpose of this parameter is to allow subsetting to an area of interest or to reduce the size of the data that is transferred.	Envelope
dimension_values (Optional)	The starting and ending values of the dimensions or dimensions used to constrain which data will be extracted from the remote OPeNDAP server. By default, the minimum and maximum values of the dimension or dimensions will be used.	Value Table
value_selection_method (Optional)	Specifies the dimension value selection method. BY_VALUE — The input value is matched with the actual dimension value. BY_INDEX — The input value is matched with the position or index of a dimension value. The index is 0 based; that is, the position starts at 0.	String

Code sample

MakeOPeNDAPRasterLayer example 1 (Python window)

Creates an OPeNDAP raster layer.

import arcpy
arcpy.md.MakeOPeNDAPRasterLayer("http://cida.usgs.gov/thredds/dodsC/new_gmo", 
				"pr", "longitude", "latitude", "pr_Layer", 
				"-124.6875 25.1875 -67.0625 52.8125", 
				"time '01/01/1949 12:00:00 AM' '12/31/2010 12:00:00 AM'", "BY_VALUE")

MakeOPeNDAPRasterLayer example 2 (stand-alone script)

Creates an OPeNDAP raster layer.

# Name: MakeOPeNDAPRasterLayer_Ex_02.py
# Description: Create an OPeNDAP raster layer from a netCDF file.
# Requirements: None

# Import system modules
import arcpy


# Set local variables
in_opendap_URL = "http://cida.usgs.gov/thredds/dodsC/new_gmo"
variable = "pr"
XDimension = "longitude"
YDimension = "latitude"
outRasterLayer = "pr_Layer"
extent = "-124.6875 25.1875 -67.0625 52.8125"
dimensionValues = "time '01/01/1949 12:00:00 AM' '12/31/2010 12:00:00 AM'"
valueSelectionMethod = "BY_VALUE"

# Execute MakeNetCDFRasterLayer
arcpy.MakeOPeNDAPRasterLayer_md(in_opendap_URL, variable, XDimension, YDimension,
                               outRasterLayer, extent, dimensionValues, 
                               valueSelectionMethod)

Environments

This tool does not use any geoprocessing environments

Licensing information

• ArcGIS Desktop Basic: Yes
• ArcGIS Desktop Standard: Yes
• ArcGIS Desktop Advanced: Yes