NAME

ms2vmap -- convert vector maps between different formats

SYNOPSIS

ms2vmap (-h|--help|--pod)

ms2vmap <file> ... -o <out file> [<options>]

Read vector map objects from a number of files (having no input files is also allowed), optionally apply some modifications and save to the output file. Normally output file is just overwritten, except for fig format where existing geo reference is used, all non-map objects are preserved (accroding with --min_depth/--max_depth options). Also some options (--keep_labels, --update_tag, --fix_rounding) read old data from the output file and merge them with new data.

Options:

-h, --help

Show help message.

-o, --out <arg>

Output file.

--pod

Show help message as POD template.

-t, --types <arg>

File with type information. Default: /usr/share/mapsoft2/types.cfg

-D, --define <arg>

Define variables for type information file.

-q, --quite <arg>

Be quiet, do not print types of skipped objects. Default: 0. This works when reading/writing MP, VMAP, writing FIG.

--skip_unknown <arg>

Skip objects which are not defined in typeinfo file. Default: 0. This works when reading/writing MP, VMAP.

--trk_type <arg>

select type for GPX waypoint import/export

--wpt_type <arg>

select type for GPX track import/export

--wpt_pref <arg>

prefix for waypoint names (names w/o prefix are skipped). Default: "="

--crop_nom <arg>

Crop map to nomenclature region.

--crop_rect <arg>

Crop map to a rectangle.

--crop_labels <arg>

By default crop_* commands are not applied to labels. This option can change it. Values: 0 or 1, default: 0.

--update_labels <arg>

Update labels (0|1): find labels for each object, add missing labels, remove labels without objects, update label type, name, and reference. Values: 0 or 1, default: 0.

--label_names <arg>

When updating labels, get names from labels, not from objects. Useful for updating map from a source (e.g. gpx) where names are missing.Values: 0 or 1, default: 0.

--keep_labels <arg>

Keep old labels. Values: 0 or 1, default: 0.

--replace_tag <arg>

Replace objects with a given tag.

--replace_type <arg>

Replace objects with a given type.

--replace_types <arg>

Replace objects with all types which exist in input files. Values: 0 or 1, default: 0.

--fix_rounding <arg>

Fix rounding errors using information from the output file. This should be used when editing map in fig format and then returning changes to other format. Then untached points are detected and rounding errors fixed.

--rounding_acc <arg>

accuracy for fixing rounding errors (m). Fig accuracy is 1/450 cm, 2.2 m for 1:100'000 maps. Default: 5

--join_lines

join similar line objects (same type, name, comment, tags)

--join_lines_d <arg>

Max distance for joining lines in meters. Default 5.

--join_lines_a <arg>

Max angle for joining lines in degrees. Default 45.

--filter_pts

Reduce number of points in lines and polygons.

--filter_pts_d <arg>

Accuracy for point filtering in meters. Default: 10

Options for MP format:

--mp_id <arg>

override MP ID

--mp_name <arg>

override MP Name

--mp_levels <arg>

set mp data levels (comma-separated integers), default: "24,22,20,18,17,15".

--mp_in_enc <arg>

Override input encoding for MP-files (does not change CodePage setting)

--mp_out_enc <arg>

Override output encoding for MP-files (does not change CodePage setting)

Options for FIG format:

--min_depth <arg>

minimum depth of map object (default 40)

--max_depth <arg>

minimum depth of map object (default 200)

--fig_enc <arg>

Encoding for reading/writing fig files (default: KOI8-R). When reading utf8 files with a special comment (made by xfig>3.2.9) this option is ignored.

Options for VMAP format:

--def_label_type <arg>

When reading VMAP file, set type number for labels which are not defined in typeinfo file. Use -1 to skip unknown labels (default). If skip_unknown is set then labels are skipped with unknown objects.

Options for OSM XML format:

--osm_conf <arg>

Configuration file for OSM XML -> VMAP2 conversion

--osm_ids

Put OSM IDs in object comments

--osm_tags

Put OSM tags in object comments

AUTHOR

Vladislav Zavjalov <slazav@altlinux.org>

SEE ALSO