CARIS Process Designer : CARIS Batch : S-57 Composer Processes : Reassign S-57 FOIDs
 

Reassign S-57 FOIDs

The ReassignS57FOIDs process assigns new feature object IDs to all features in an S-57 file.

Input

Name and path of an S-57 file (.000) or update (.001, .002, and so on).

Output

Name and path of the output file. The extension must match the input file. Note, this can also be the input file.

Syntax

carisbatch --run ReassignS57FOIDs --iho-agency-code <value> --iho-agency-code-file <value> --unique-foid-file <value> --foid-lookup-table-file <value> [options] <input> <output>

Options

Long

Short

Description

Can Repeat

Notes

--iho-agency-code

-a

The producing agency for the S-57 file. This should match one of the agency codes in the file specified by the --iho-agency-code-file option.

FALSE

Required

--iho-agency-code-file

-A

The path and file name of the IHO agency code file.

The agency code file may be used to get a list of agency codes or to validate the agency code given by the --iho-agency-code option.

FALSE

Required

--unique-foiid-file

-u

The feature object ID file that defines

• the current feature identifier number

• the current feature identifier subdivision

• the greatest possible feature identifier subdivision

If this file is not specified then the file that was created when the application was installed is used.

FALSE

Required

--foid-lookup-table-file

-f

The name and location of the feature object ID (FOID) lookup table. This file lists the feature object IDs before and after running the ReassignS57FOIDS process. The table is created when the process is run on a new edition or base cell. The same lookup table is reapplied, and possibly extended, when the process is run on an update.

FALSE

Required

Example

Example

Objective

Feature object identifiers from the input.001 file are reassigned in the new output.001 file.

Description

Command Line Syntax

The two-character agency code is 1C

--agency-code 1C

The agency code is derived from the agencies.txt file in the ReassignS57FOIDS folder.

--agency-code-file C:\ReassignS57FOIDS\agencies.txt

The file that defines feature identifiers for output.001 is uniqueid.txt that is located in the ReassignS57FOIDS folder.

--unique-id-file C:\ReassignS57FOIDS\uniqueid.txt

The file that lists the old and new feature identifiers after the process is run is named FOID_lookup.txt.

--foid-lookup-table-file C:\ReassignS57FOIDS\FOID_lookup.txt

The file with current feature identifiers is stored in the ReassignS57FOIDS folder.

C:\ReassignS57FOIDS\input.001

The file with new feature identifiers (output.001) will be saved in the ReassignS57FOIDS folder.

C:\ReassignS57FOIDS\output.001

Command Line

carisbatch -r ReassignS57FOIDs --agency-code 1C --agency-code-file C:\ReassignS57FOIDS\agencies.txt --unique-id-file C:\ReassignS57FOIDS\uniqueid.txt --foid-lookup-table-file C:\ReassignS57FOIDS\FOID_lookup.txt  C:\ReassignS57FOIDS\input.001 C:\ReassignS57FOIDS\output.001