Import Mosaic Dataset Geometry (Data Management)

Summary

Modifies the geometry for the footprints, boundary, or seamlines in a mosaic dataset to match those in a feature class.

Illustration

Usage

• This tool matches the feature in the mosaic dataset with the feature in the feature class based on a common attribute field.

• The footprint is not always used to clip the image in the mosaic dataset. You can change the Always Clip The Image To Its Footprint property in the Mosaic Dataset Properties dialog box on the Defaults tab.

• If the Input Feature Class has more than 1,000 records, you should add an index on the Input Join Field by running the Add Attribute Index tool. If your mosaic dataset is very large and the join field is not indexed, the tool will take much longer to complete.

Parameters

Dialog

Label	Explanation	Data Type
Mosaic Dataset	The mosaic dataset whose geometries you want to edit.	Mosaic Layer
Target Feature Class	The geometry that you want to change. FOOTPRINT—The footprint polygons in the mosaic dataset SEAMLINE—The seamline polygons in the mosaic dataset BOUNDARY—The boundary polygon in the mosaic dataset	String
Target Join Field	The field in the mosaic dataset to use as a basis for the join.	Field
Input Join Field	The field in the Input Feature Class to use as a basis for the join. If the Input Feature Class has more than 1,000 records, add an index on this field by running the Add_Attribute_Index tool. If your mosaic dataset is very large and the join field is not indexed, the tool will take much longer to complete.	Field

Derived Output

Label	Explanation	Data Type
Updated Mosaic Dataset	The updated mosaic dataset.	Mosaic Layer

Python

arcpy.management.ImportMosaicDatasetGeometry(in_mosaic_dataset, target_featureclass_type, target_join_field, input_join_field)

Name	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset whose geometries you want to edit.	Mosaic Layer
target_featureclass_type	The geometry that you want to change. FOOTPRINT—The footprint polygons in the mosaic dataset SEAMLINE—The seamline polygons in the mosaic dataset BOUNDARY—The boundary polygon in the mosaic dataset	String
target_join_field	The field in the mosaic dataset to use as a basis for the join.	Field
input_join_field	The field in the input_featureclass to use as a basis for the join. If the input_featureclass has more than 1,000 records, add an index on this field by running the Add_Attribute_Index tool. If your mosaic dataset is very large and the join field is not indexed, the tool will take much longer to complete.	Field

Derived Output

Name	Explanation	Data Type
out_mosaic_dataset	The updated mosaic dataset.	Mosaic Layer

Code sample

ImportMosaicDatasetGeometry example 1 (Python window)

This is a Python sample for the ImportMosaicDatasetGeometry tool.

import arcpy
arcpy.ImportMosaicDatasetGeometry_management("c:/workspace/fgdb.gdb/md",
                                                   "FOOTPRINT", "OBJECTID",
                                                   "infootprint.shp", "FTID")

ImportMosaicDatasetGeometry example 2 (stand-alone script)

This is a Python script sample for the ImportMosaicDatasetGeometry tool.

##===========================
##Import Mosaic Dataset Geometry
##Usage: ImportMosaicDatasetGeometry_management in_mosaic_dataset FOOTPRINT | SEAMLINE
##                                       | BOUNDARY target_join_field 
##                                       input_featureclass input_join_field 

import arcpy
arcpy.env.workspace = "c:/PrjWorkspace/RasGP"

# Import shape file geometry as Mosaic Dataset Footprints
# Note: Feature class FID starts with 0
arcpy.ImportMosaicDatasetGeometry_management("Geometry.gdb/md",
                                            "FOOTPRINT", "OBJECTID",
                                            "infootprint.shp", "FTID")                                      

# Import GDB feature class as Mosaic Dataset Boundary
arcpy.ImportMosaicDatasetGeometry_management("Geometry.gdb/md", "BOUNDARY",
                                      "OBJECTID", "Geometry.gdb/inboundary",
                                      "OBJECTID")

Environments

This tool does not use any geoprocessing environments.