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

Dialog

Label	Explanation	Data 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

Label	Explanation	Data Type
Log Parse Count	The total number of error and warning messages written to the Data Reviewer Session.	Long

Python

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

Name	Explanation	Data 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

Name	Explanation	Data 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

Current Workspace

Licensing information

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