Label | Explanation | Data Type |
Input Image Service | The name of the input image service or the SOAP URL that references the image service. Browse to or type the input image service. This tool can also accept a SOAP URL that references the image service. An example of using the image service name called ProjectX is: C:\MyProject\ServerConnection.ags\ProjectX.ImageServer. An example of a URL is http://AGSServer:8399/arcgis/services/ISName/ImageServer. | Image Service; String |
Output Image Server Layer | The name of the output image layer. | Raster Layer |
Template Extent
(Optional) | The output extent of the image layer.
| 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 |
Mosaic Method (Optional) | The mosaic method defines how the mosaic is created from different rasters.
| 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 Raster ID (Optional) | The 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 |
Output Cell Size
(Optional) | The cell size for the output image service layer. | Double |
Expression
(Optional) | Define a query using SQL or use the Query Builder to build a query. | SQL Expression |
Processing Template
(Optional) | The raster function processing template that can be applied on the output image service layer.
| String |
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 on 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 an image service definition.
Parameters
arcpy.management.MakeImageServerLayer(in_image_service, out_imageserver_layer, {template}, {band_index}, {mosaic_method}, {order_field}, {order_base_value}, {lock_rasterid}, {cell_size}, {where_clause}, {processing_template})
Name | Explanation | Data Type |
in_image_service | The name of the input image service or the SOAP URL that references the image service. An example of using the image service name called ProjectX is: C:\MyProject\ServerConnection.ags\ProjectX.ImageServer. 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.
| Extent |
band_index [ID,...] (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 |
mosaic_method (Optional) | The mosaic method defines how the mosaic is created from different rasters.
| 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) | The 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) | Define a query using SQL. | SQL Expression |
processing_template (Optional) | The raster function processing template that can be applied on the output image service layer.
| String |
Code sample
This is a Python sample for the MakeImageServerLayer tool.
arcpy.MakeImageServerLayer_management(
input2, "mdlayer", "feature.shp", "1;2;3",
"LockRaster", "#", "#", "4", "#", processing_template="Hillshade")
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")