Parse S-58 Log File (Maritime)

Available with ArcGIS Maritime license.

Summary

Parses log files produced by the Validate S-57 File tool and third-party validation software against S-58 (recommended ENC validation checks). Critical errors and warnings are imported as records in a Data Reviewer table.

Usage

  • Validation log files generated by Esri .S58 files and 7Cs version 3.4 and later (.ANL and .VLD files) are parsed.

  • The coordinate system of the Data Reviewer workspace feature dataset should match the coordinate system of the production database.

  • The Data Reviewer workspace must contain the reviewer schema. This can be created using the Enable Data Reviewer tool or the Reviewer Session Manager.

  • This geoprocessing tool uses one S-57 product per Data Reviewer workspace.

  • The Data Reviewer Session parameter must point to an existing session in the Data Reviewer workspace. If a new session is necessary, create it first in the Data Reviewer workspace.

  • Existing results in the target session that are marked as exceptions will not be written again to the same session.

Parameters

LabelExplanationData Type
Input S-58 Log File

The S-58 log file that contains validation errors. It can be an *.S58, *.ANL, or *.VLD file.

File
Input S-57 File

The base cell file (*.000) from which the validation result was produced. The name of the ENC cell referenced in this parameter must match the name of the ENC cell referenced in the validation log file.

File
Production Database

The workspace to validate and correct. This workspace contains the data used to generate the S-57 format file.

Workspace
Data Reviewer Workspace

The path to the Data Reviewer workspace where the features or table records will be written. A Data Reviewer workspace must be created for each ENC product.

Workspace
Data Reviewer Session

An existing Data Reviewer session. The options are populated based on the sessions in the Data Reviewer workspace.

String
Update Cells
(Optional)

The cell files (*.001 - *.999) that will be updated.

File

Derived Output

LabelExplanationData Type
Log Parse Count

The total number of error and warning messages written to the Data Reviewer Session.

Long

arcpy.maritime.ParseS58LogFile(in_s58_log_file, in_s57_file, in_production_database_workspace, in_reviewer_workspace, reviewer_session, {in_update_cells})
NameExplanationData Type
in_s58_log_file

The S-58 log file that contains validation errors. It can be an *.S58, *.ANL, or *.VLD file.

File
in_s57_file

The base cell file (*.000) from which the validation result was produced. The name of the ENC cell referenced in this parameter must match the name of the ENC cell referenced in the validation log file.

File
in_production_database_workspace

The workspace to validate and correct. This workspace contains the data used to generate the S-57 format file.

Workspace
in_reviewer_workspace

The path to the Data Reviewer workspace where the features or table records will be written. A Data Reviewer workspace must be created for each ENC product.

Workspace
reviewer_session

An existing Data Reviewer session.

String
in_update_cells
[in_update_cells,...]
(Optional)

The cell files (*.001 - *.999) that will be updated.

File

Derived Output

NameExplanationData Type
parse_count

The total number of error and warning messages written to the Data Reviewer Session.

Long

Code sample

ParseS58LogFile example (Python window)

The following Python window script demonstrates how to use the ParseS58LogFile function.

# Import arcpy module
import arcpy
#Variables
s58_file = r"C:\Data\checks\US4CN22M.S58"
base_cell = r"C:\Data\checks\US4CN22M.000"
nis = r"C:\Data\checks\NIS_test.gdb"
reviewer_gdb = r"C:\Data\checks\Reviewer.gdb"
reviewer_session = "Session 1 : Session 1"
update_cells = ""

# Process: Parse S-58 Log File
arcpy.maritime.ParseS58LogFile(s58_file, base_cell, nis, reviewer_gdb, reviewer_session, update_cells)

Environments

Licensing information

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

Related topics