Make WCS Layer (Data Management)

Summary

Creates a temporary raster layer from a WCS service.

Usage

  • This is one of the few tools that can accept a WCS service as an input; therefore, this tool can be used to convert a WCS service to a raster layer, which can then be used by a geoprocessing tool. The layer created by the tool is temporary and will not persist after the session ends unless the document is saved.

  • The input can also be a URL to a WCS server. The WCS server URL should also include the coverage and version information. If only URL is entered, the tool will automatically take the first coverage and use the default version (1.0.0) to create the WCS layer.

  • The output can be the entire image service or a portion of it.

  • You can clip out a portion of the image service by choosing an output extent layer or by specifying the rectangle extent. If you choose an output extent layer, the clip extent will be based on the extent of that layer.

  • The output can be created with only a subset of the bands. This will save time and disk space.

Parameters

LabelExplanationData Type
Input WCS Coverage

Browse to the input WCS service. This tool can also accept a URL that references the WCS service.

If a WCS server URL is used, the URL should include the coverage name and version information. If only the URL is entered, the tool will automatically take the first coverage and use the default version (1.0.0) to create the WCS layer.

An example of a URL that includes the coverage name and version is http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer?coverage=rasterDRGs&version=1.1.1.

In this example, http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer? is the URL. The coverage specified is coverage=rasterDRGs, and the version is &version=1.1.1.

To get the coverage names on a WCS server, use the WCS GetCapabilities request. An example of WCS request is http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer?request=getcapabilities&service=wcs.

WCS Coverage; String
Output WCS Layer

The name of the output WCS layer.

Raster Layer
Template Extent
(Optional)

The output extent of the WCS layer.

  • Current Display Extent Map View—The extent will be based on the active map or scene.
  • Draw Extent Square and Finish—The extent will be based on a rectangle drawn on the map or scene.
  • Extent of a Layer Layer—The extent will be based on an active map layer. Choose an available layer or use the Extent of data in all layers option. Each map layer has the following options:

    • All Features Select All—The extent of all features.
    • Selected Features Area from Selected Features—The extent of the selected features.
    • Visible Features Extent Indicator—The extent of visible features.

  • Browse Browse—The extent will be based on a dataset.
  • Clipboard Paste—The extent can be copied to and from the clipboard.
    • Copy Extent Copy—Copies the extent and coordinate system to the clipboard.
    • Paste Extent Paste—Pastes the extent and coordinate system from the clipboard. If the clipboard does not include a coordinate system, the extent will use the map’s coordinate system.
  • Reset Extent Reset—The extent will be reset to the default value.

When coordinates are manually provided, the coordinates must be numeric values and in the active map's coordinate system. The map may use different display units than the provided coordinates. Use a negative value sign for south and west coordinates.

Extent
Bands
(Optional)

The bands that will be exported for the layer. If no bands are specified, all the bands will be used in the output.

Value Table

arcpy.management.MakeWCSLayer(in_wcs_coverage, out_wcs_layer, {template}, {band_index})
NameExplanationData Type
in_wcs_coverage

The name of the input WCS service, or the URL that references the WCS service.

If a WCS server URL is used, the URL should include the coverage name and version information. If only the URL is entered, the tool will automatically take the first coverage and use the default version (1.0.0) to create the WCS layer.

An example of a URL that includes the coverage name and version is http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer?coverage=rasterDRGs&version=1.1.1.

In this example, http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer? is the URL. The coverage specified is coverage=rasterDRGs, and the version is &version=1.1.1.

To get the coverage names on a WCS server, use the WCS GetCapabilities request. An example of WCS request is http://ServerName/arcgis/services/serviceName/ImageServer/WCSServer?request=getcapabilities&service=wcs.

WCS Coverage; String
out_wcs_layer

The name of the output WCS layer.

Raster Layer
template
(Optional)

The output extent of the WCS layer.

  • MAXOF—The maximum extent of all inputs will be used.
  • MINOF—The minimum area common to all inputs will be used.
  • DISPLAY—The extent is equal to the visible display.
  • Layer name—The extent of the specified layer will be used.
  • Extent object—The extent of the specified object will be used.
  • Space delimited string of coordinates—The extent of the specified string will be used. Coordinates are expressed in the order of x-min, y-min, x-max, y-max.
Extent
band_index
[band_index,...]
(Optional)

The bands that will be exported for the layer. If no bands are specified, all the bands will be used in the output.

Value Table

Code sample

MakeWCSLayer example 1 (Python window)

This is a Python sample for the MakeWCSLayer function.

import arcpy
from arcpy import env
env.workspace = "C:/Workspace"
input1 = "GIS Servers/File_TIFF_Amberg on server3/090160_1"
arcpy.MakeWCSLayer_management(input1, "wcslayer1", "11.844983 49.445367 11.858321 49.453887",
                              "1;2;3")
MakeWCSLayer example 2 (stand-alone script)

This is a Python script sample for the MakeWCSLayer function.

##====================================
##Make WCS Layer
##Usage: MakeWCSLayer_management in_wcs_coverage out_wcs_layer {template} {ID;ID...}
    
import arcpy

arcpy.env.workspace = r"C:/Workspace"
input1 = r"GIS Servers\File_TIFF_Amberg on server3\090160_1"
input2 = "http://server3/arcgis/services/File_TIFF_Amberg/ImageServer/WCSServer"

##Create WCS layer from WCS connection file
arcpy.MakeWCSLayer_management(input1, "wcslayer1", "11.844983 49.445367 11.858321 49.453887",
                              "1;2;3")

##Create WCS layer from URL with clipping feature
arcpy.MakeWCSLayer_management(input2, "wcslayer2", "clip.shp", "1;2;3")

Related topics