Generate Land Areas (Maritime)

Available with Maritime Charting license.

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.

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. If running this tool in the NIS, the scale band tools can be used to isolate the data 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.

Parameters

LabelExplanationData Type
Input Workspace

The workspace containing a 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 not specified, the default GenerateLandAreasSettings.xml configuration file will be used.

File

Derived Output

LabelExplanationData 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})
NameExplanationData Type
in_workspace

The workspace containing a 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 not specified, the default GenerateLandAreasSettings.xml configuration file will be used.

File

Derived Output

NameExplanationData 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

Related topics