NAME

ms2vmapdb -- working with vector map database

SYNOPSIS

ms2vmapdb (-h|--help|--pod)

ms2vmapdb <action> (-h|--help)

ms2vmapdb <action> [<action arguments and options>]

GENERAL OPTIONS:

-h, --help

Show help message.

--pod

Show help message as POD template.

ACTIONS:

ms2vmapdb create -- create vmap2 database

ms2vmapdb delete -- delete vmap2 database

ms2vmapdb rebuild_gh -- rebuild geohashes for vmap2 database

ms2vmapdb dump_gh -- dump geohashes for vmap2 database

ms2vmapdb add_obj -- add new object to vmap2 database, print id

ms2vmapdb types -- print all object types in vmap2 database

ms2vmapdb bbox -- print bounding box of the map (using geohash data)

ms2vmapdb update_labels -- update labels

ms2vmapdb crop_nom -- crop to nomenclature map page

ms2vmapdb crop_rect -- crop to rectangular range

ms2vmapdb import -- import objects to vmap2 database

ms2vmapdb export -- export vector map to a different format

ms2vmapdb fig_lib -- make fig library using typeinfo file

CREATE -- CREATE VMAP2 DATABASE

SYNOPSIS

ms2vmap create <dbname>

Create vmap2 database. <dbname> is a database name with or without .vmap2db extension.

DELETE -- DELETE VMAP2 DATABASE

SYNOPSIS

ms2vmap delete <dbname>

Delete vmap2 database. <dbname> is a database name with or without .vmap2db extension.

REBUILD_GH -- REBUILD GEOHASHES FOR VMAP2 DATABASE

SYNOPSIS

ms2vmap rebuild_gh <dbname>

DUMP_GH -- DUMP GEOHASHES FOR VMAP2 DATABASE

SYNOPSIS

ms2vmap dump_gh <dbname>

ADD_OBJ -- ADD NEW OBJECT TO VMAP2 DATABASE, PRINT ID

SYNOPSIS

ms2vmap add_obj <dbname> <object_type> <coordinates>

Options

-n, --name <arg>

Specify object name.

-c, --comm <arg>

Specify object comment.

-a, --angle <arg>

Specify object angle.

-s, --scale <arg>

Specify object scale.

-A, --align <arg>

Specify object alignment (NW,N,NE,E,SE,S,SW,C).

--ref_type <arg>

Specify ref_type.

--ref_pt <arg>

Specify ref_pt.

TYPES -- PRINT ALL OBJECT TYPES IN VMAP2 DATABASE

SYNOPSIS

ms2vmap types <dbname>

BBOX -- PRINT BOUNDING BOX OF THE MAP (USING GEOHASH DATA)

SYNOPSIS

ms2vmap bbox <dbname>

UPDATE_LABELS -- UPDATE LABELS

SYNOPSIS

ms2vmap update_labels <dbname> -t <typeinfo file>

Options:

-t, --types <arg>

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

-D, --define <arg>

Define variables for type information file.

CROP_NOM -- CROP TO NOMENCLATURE MAP PAGE

SYNOPSIS

ms2vmap crop_nom <dbname> <nom name>
-n, --crop_labels <arg>

Crop labels. Values: 0 or 1, default 0.

CROP_RECT -- CROP TO RECTANGULAR RANGE

SYNOPSIS

ms2vmap crop_rect <dbname> <rectangle>
-n, --crop_labels <arg>

Crop labels. Values: 0 or 1, default 0.

IMPORT -- IMPORT OBJECTS TO VMAP2 DATABASE

SYNOPSIS

ms2vmap import <file1> <file2> ... -o <dbname> -t <type info file>

Read map objects in different formats and add to a database.

Options:

-o, --out <arg>

Output file.

-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: "="

Options for reading 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 reading MP format:

--mp_enc <arg>

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

Options for reading 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 reading 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

EXPORT -- EXPORT VECTOR MAP TO A DIFFERENT FORMAT

SYNOPSIS

ms2vmap export <dbname> -o <out file> [<options>]

Supported formats: vmap2, vmap2db, vmap, mp, fig

Options:

-o, --out <arg>

Output file.

-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 writing 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_enc <arg>

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

Options for writing 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.

FIG_LIB -- MAKE FIG LIBRARY USING TYPEINFO FILE

SYNOPSIS

ms2vmap fig_lib [<options>]

Options:

-o, --out <arg>

Output file.

-t, --types <arg>

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

-D, --define <arg>

Define variables for type information file.

AUTHOR

Vladislav Zavjalov <slazav@altlinux.org>

SEE ALSO