ArcMap

Make Image Server Layer

Summary

Creates a temporary raster layer from an image service. The layer that is created will not persist after the session ends unless the document is saved.

The input can also be a SOAP URL to an image server.

Usage

  • Use this tool to create an image layer from an image service, or a URL that references an image service.

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

  • Use this tool to add an image service to a Python script or model, or when creating a geoprocessing service.

  • 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 upon the extent of that layer.

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

  • The mosaicking options are only available when the image service it contains is generated from a mosaic definition or image service definition.

Syntax

MakeImageServerLayer_management (in_image_service, out_imageserver_layer, {template}, {band_index}, {mosaic_method}, {order_field}, {order_base_value}, {lock_rasterid}, {cell_size}, {where_clause}, {processing_template})
ParameterExplanationData Type
in_image_service

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

An example of a URL is: http://AGSServer:8399/arcgis/services/ISName/ImageServer

Image Service; String
out_imageserver_layer

The name of the output image layer.

Raster Layer
template
(Optional)

The output extent of the image layer.

The output extent can be specified by defining the area to be clipped (X-Minimum, Y-Minimum, X-Maximum, and Y-Maximum) or by using the extent of an existing layer.

Extent
band_index
[ID,...]
(Optional)

Choose which bands to export for the layer. If no bands are specified, then all the bands will be used in the output.

Value Table
mosaic_method
(Optional)

The mosaic method defines how the mosaic is created from different rasters.

  • SEAMLINE —Smooth transitions between images using seamlines.
  • NORTH_WEST —Display imagery that is closest to the northwest corner of the mosaic dataset boundary.
  • CLOSEST_TO_CENTER —Display imagery that is closest to the center of the screen.
  • LOCK_RASTER —Select specific raster datasets to display.
  • BY_ATTRIBUTE —Display and prioritize imagery based on a field in from the attribute table.
  • CLOSEST_TO_NADIR —Display the rasters with viewing angles closest to zero.
  • CLOSEST_TO_VIEWPOINT —Display imagery that is closest to a selected viewing angle.
  • NONE —Order rasters based on the ObjectID in the mosaic dataset attribute table.
String
order_field
(Optional)

The default field to use to order the rasters when the mosaic method is By_Attribute. The list of fields is defined as those in the service table that are of type metadata and are integer (for example, the values can represent dates or cloud cover percentage).

String
order_base_value
(Optional)

The images are sorted based on the difference between this input value and the attribute value in the specified field.

String
lock_rasterid
(Optional)

Raster ID or raster name to which the service should be locked, such that only the specified rasters are displayed. If left blank (undefined), it will be similar to the system default. Multiple IDs can be defined as a semicolon-delimited list.

String
cell_size
(Optional)

The cell size for the output image service layer.

Double
where_clause
(Optional)

A query used to select a subset of items within an image service.

SQL Expression
processing_template
(Optional)

Raster function processing template that can be applied on the output image service layer.

String

Code sample

MakeImageServerLayer example 1 (Python window)

This is a Python sample for the MakeImageServerLayer tool.

arcpy.MakeImageServerLayer_management(
        input2, "mdlayer", "feature.shp", "1;2;3",
        "LockRaster", "#", "#", "4", "#", processing_template="Hillshade")
MakeImageServerLayer example 2 (Python window)

This is a Python script sample for the MakeImageServerLayer tool.

arcpy.MakeImageServerLayer_management(
        input2, "mdlayer", "feature.shp", "1;2;3",
        "LockRaster", "#", "#", "4", "#", processing_template="Custom_func")

Environments

Licensing information

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

Related topics