Summary
Records the coordinate system information for the specified input datasets including any associated projection parameters, datum, or spheroid. It creates or modifies the dataset's projection parameters.
Usage
This command can be used if the input datasets do not have a projection defined. If either of the input datasets has a projection defined, a warning will be raised but the tool will execute successfully.
The input datasets can include feature classes, raster datasets, and layers.
The coordinate system information of the input is created or modified by this tool. No separate output feature class will be created.
If the input datasets do not have a projection defined, the coordinate system will be listed as Unknown on the dialog box.
If either of the input datasets has a coordinate system defined, use the Project tool to modify it.
Use the Spatial Reference Properties dialog box to select a coordinate system definition from an existing definition list or dataset, or create a new coordinate system definition.
Use the template parameter to select an existing definition from another dataset to create a new coordinate system definition.
Either a coordinate system or a template dataset must be specified for the tool to execute.
When using this tool in ModelBuilder, the outputs will be two Boolean parameters. One parameter is named Completed and the other is named Error. These parameters are provided to allow chaining in ModelBuilder. Preconditions can be established with other processes. This will allow branching in models. If the tool fails, the model can stop or run another series of processes. If it completes successfully, the model can continue running.
Syntax
arcpy.samples.BatchDefine(input_datasets, {Coordinate_System}, {Template_Dataset})
Parameter | Explanation | Data Type |
input_datasets [input_datasets,...] | Datasets whose projection is to be defined. The datasets can be feature classes, raster datasets, and layers. | Geodataset |
Coordinate_System (Optional) | Name of the coordinate system to be applied to the input datasets. | Coordinate System |
Template_Dataset (Optional) | Dataset that will be used to select an existing projection definition to be applied to the input datasets. | Geodataset |
Code sample
BatchDefine Example (Standalone Script)
import arcgisscripting
gp = arcgisscripting.create(9.3)
gp.workspace = "c:/Workspace/canada.mdb"
gp.BatchDefine("rivers;roads", "Coordinate Systems/Geographic Coordinate Systems/North America/North American Datum 1983.prj")
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes