Generate Land Areas (Maritime Tools)

Summary

Creates land area polygon features by identifying existing land topology features, such as coastline and shoreline construction, and eliminating any polygons over water or other exclusionary features. An area of interest is specified to limit the processing area.

Learn more about how Generate Land Areas works

Usage

Only run this tool with a single usage band. In an enterprise environment, it is recommended that you run this tool on a checkout replica in which the data has been filtered to a single usage band.
For the S-57 schema, the tool automatically populates the NIS_Products field to All and the PLTS_COMP_SCALE field to the current compilation scale value.
For the S-101 schema, the tool automatically populates the minimumDisplayScale and maximumDisplayScale fields to the current minimum and maximum values, respectively.

Label	Explanation	Data type
Input Workspace	The workspace containing an ArcGIS Maritime product schema (S-57 or S-101 based) in which existing land topology features, such as coastline and shoreline construction, will be processed to identify the land areas that will be created.	Workspace
Target Workspace	The workspace that will contain the land area polygons that are created. The workspace must be a nautical workspace with S-57 or S-101 schema. For S-57 schema, the workspace should have a NaturalFeaturesA polygon feature class with a LNDARE_LandArea subtype. For S-101 schema, the workspace should have a LandArea_A polygon feature class.	Workspace
Extent Polygon Features	The extent polygon in which the land area polygons will be generated.	Feature Layer
Configuration File (Optional)	The location of an `.xml` configuration file that lists the feature classes that will participate in defining the land topology edges and the feature classes that indicate areas where land should not exist. If no value is provided, the default `GenerateLandAreasSettings.xml` configuration file will be used.	File

Derived output

Label	Explanation	Data type
Updated Land Areas	The updated Land Areas feature class.	Feature Layer

arcpy.maritime.GenerateLandAreas(in_workspace, target_workspace, in_extent_polygon, {in_configuration_file})

Name	Explanation	Data type
in_workspace	The workspace containing an ArcGIS Maritime product schema (S-57 or S-101 based) in which existing land topology features, such as coastline and shoreline construction, will be processed to identify the land areas that will be created.	Workspace
target_workspace	The workspace that will contain the land area polygons that are created. The workspace must be a nautical workspace with S-57 or S-101 schema. For S-57 schema, the workspace should have a NaturalFeaturesA polygon feature class with a LNDARE_LandArea subtype. For S-101 schema, the workspace should have a LandArea_A polygon feature class.	Workspace
in_extent_polygon	The extent polygon in which the land area polygons will be generated.	Feature Layer
in_configuration_file (Optional)	The location of an `.xml` configuration file that lists the feature classes that will participate in defining the land topology edges and the feature classes that indicate areas where land should not exist. If no value is provided, the default `GenerateLandAreasSettings.xml` configuration file will be used.	File

Derived output

Name	Explanation	Data type
updated_land_areas	The updated Land Areas feature class.	Feature Layer

Code sample

GenerateLandAreas example (stand-alone script)

The following stand-alone script demonstrates how to use the GenerateLandAreas function.

# Import arcpy module
import arcpy

in_workspace = r"C:\Data\GLA\enc.gdb"
target_workspace = r"C:\Data\GLA\enc.gdb"
in_extent_polygon = r"C:\Data\GLA\staging.gdb\Extent"
in_configuration_file = r"C:\ArcGISPro\Resources\Maritime\GenerateLandAreasSettings.xml"

arcpy.maritime.GenerateLandAreas(in_workspace, target_workspace, in_extent_polygon, in_configuration_file)

Environments

This tool does not use any geoprocessing environments.

Licensing information

Basic: No
Standard: Requires ArcGIS Maritime
Advanced: Requires ArcGIS Maritime

Generate Land Areas (Maritime Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics