ArcMap

Import Mosaic Dataset Geometry

Summary

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

Illustration

Image clipped to footprint

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.

  • This tool will not recalculate the extent of the mosaic dataset. To recalculate the extent, browse to the Mosaic Dataset Properties dialog's Feature Extent tab and click the Recalculate button.

  • 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.

Syntax

arcpy.management.ImportMosaicDatasetGeometry(in_mosaic_dataset, target_featureclass_type, target_join_field, input_featureclass, input_join_field)
ParameterExplanationData 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_featureclass

The feature class with the new geometry.

Feature Layer; Raster Catalog Layer
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

NameExplanationData 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.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

Related topics