Assign Feature Scamin Values

The AssignFeatureScaminValues process calculates minimum display scale attribute values for S-57 or S-101 non-sounding features using specified parameters.

The scale minimum is represented by SCAMIN attributes in S-57 data sets and by scaleMinimum attributes in S-101 data sets.

The scale minimum value of a feature determines the display scale below which the feature is no longer visible on an Electronic Chart Display and Information System (ECDIS). The purpose for using scale minimum values is to reduce the amount of clutter displayed to the ECDIS user.

This process uses a mapping rule file to calculate scale minimum values as described in Scale Minimum in the HPD User Guide.

Features in a supported format. HOB, H2O and 000 (S-57 or S-101 specification) formats are supported.

carisbatch --run AssignFeatureScaminValues --feature-catalogue <value> --mapping-rule-file <value> [options] <input> <output>

Long	Short	Description	Can Repeat	Notes
--feature-catalogue	-F	Catalogue that defines features and attributes in an output HOB file. Catalogue information is read from the Catalogue Control File. See Catalogues for a list of available catalogues. The catalogue will be ignored if the output is not a HOB file.	FALSE	Required
--map-scale	-M	Value for input map scale. This option is required for all file formats except S-57 files.	FALSE	Required
--mapping-rule-file	-m	The path to the mapping rule file for the calculation of scale minimum values. See Scale Minimum In the HPD User Guide for details.	FALSE	Required

Long

Short

Description

Can Repeat

Notes

--feature-catalogue

-F

Catalogue that defines features and attributes in an output HOB file. Catalogue information is read from the Catalogue Control File.

See Catalogues for a list of available catalogues.

The catalogue will be ignored if the output is not a HOB file.

FALSE

Required

--map-scale

-M

Value for input map scale. This option is required for all file formats except S-57 files.

FALSE

Required

--mapping-rule-file

-m

The path to the mapping rule file for the calculation of scale minimum values.

See Scale Minimum In the HPD User Guide for details.

FALSE

Required

S-57
Objective	Assign scale minimum values to features in `D:\outputs\gb4x0000.hob`. Features are read from `D:\inputs\gb4x0000.000`. The S-57 ENC 3.1 feature catalogue is applied to `D:\outputs\gb4x0000.hob`. The mapping rule file is `assignIHOscamin.xml`.
Description		Command Line Syntax
Feature catalogue for output file.		--feature-catalogue "S-57 ENC 3.1"
Mapping rule file		--mapping-rule-file assignIHOscamin.xml
Path and name of input file.		D:\inputs\gb4x0000.000
Path and name of output file.		D:\outputs\gb4x0000.hob
Command Line	carisbatch --run AssignFeatureScaminValues --feature-catalogue "S-57 ENC 3.1" --mapping-rule-file assignIHOscamin.xml D:\inputs\gb4x0000.000 D:\outputs\gb4x0000.hob
Result	Scale minimum values are assigned to `gb4x0000.hob` according to the `assignIHOscamin.xml` file

S-101
Objective	Assign scale minimum values to non-sounding features in `s100_output.h2o`. Features are read from `S100_input.000`. The S-101 feature catalogue is applied to `s100_output.h2o`. The mapping rule file is `assignIHOS101scamin.xml` and map scale for `S100_input.000` is 1:20000
Description		Command Line Syntax
Feature catalogue for output file.		--feature-catalogue "S-101 1.0"
Mapping rule file		--mapping-rule-file assignIHOS101scamin.xml
Scale of input map		--map-scale 20000
Path and name of input file.		D:\inputs\S100_input.000
Path and name of output file.		D:\outputs\s100_output.h2o
Command Line	carisbatch --run AssignFeatureScaminValues --feature-catalogue "S-101 1.0" --map-scale 20000 --mapping-rule-file assignIHOS101scamin.xml D:\inputs\S100_input.000 D:\outputs\s100_output.h2o
Result	Scale minimum values are assigned to `s100_output.h2o` according to `assignIHOS101scamin.xml`