NAME

mapsoft_convert -- convert geodata to various formats

SYNTAX

        mapsoft_convert <options> <input files> -o <output file>

INPUT FILE FORMATS

format is determined by file extension:

*.xml -- mapsoft native XML-like format

*.fig -- mapsoft geofig format

*.wpt, *.plt, *.map -- OziExplorer format

*.gpx -- GPX format (partial support)

*.gu -- old garmin-utils format

*.zip -- zipped files

gps: -- read data from Garmin GPS via autodetected serial device

<character device> -- read data from Garmin GPS via serial device

OUTPUT FILE FORMATS

Format is determined by file extension:

*.xml -- mapsoft native XML-like format

*.wpt, *.plt, *.map, *.oe -- OziExplorer format (Each track, waypoint set or map reference will be written in a separate .plt, .wpt or .map file)

*.zip -- zipped OziExplorer files

*.gpx -- GPX format /partial support, tracks and waypoints/

*.kml -- Google KML format /partial support, tracks and waypoints/

*.kmz -- zipped kml

*.gu -- old garmin-utils format (tracks and waypoints only)

*.tif, .tiff, .jpg, .jpeg -- raster image (see below)

gps: -- send data to Garmin GPS via autodetected serial device

<character device> -- send data to Garmin GPS via serial device

OPTIONS

-o, --out <arg> -- output file name

-h, --help -- show this message

--pod -- show this message as POD template

-v, --verbose -- be verbose

OPTIONS FOR GEODATA FILTERING

--shift_maps <X,Y> -- shift map references

--rescale_maps <k> -- rescale map references

--map_nom_brd -- set map borders according to map name

-s, --skip <wmtao> -- skip data, "wmtao" (w - waypoints, m - maps, t - tracks, a - active log, o - save tracks)

--gen_n <n> -- reduce track points to n

--gen_e <e> -- reduce track points up to accuracy e [meters] (when gen_n and gen_e both used it means: "remove points while number of points > n OR accuracy < e"

OPTIONS FOR RENDERING IMAGES

--htm <file> -- write html map into file

-f, --fig <file> -- write fig-file

-m, --map <file> -- write map-file

--map_show_brd -- draw map borders

--trk_draw_mode <mode> -- draw mode: normal, speed, height.

--trk_draw_dots -- draw dots on tracks

--trk_draw_arrows -- draw arrows on tracks.

--trk_draw_v1 <v1> -- low value for speed draw mode

--trk_draw_v2 <v2> -- high value for speed draw mode

--trk_draw_h1 <h1> -- low value for height draw mode

--trk_draw_h2 <h2> -- high value for height draw mode

--max_image <W,H> -- don't write images larger then this,. default 1000,1000

--data_marg <arg> -- margins around data (works only if no. geometry set), pixels

--jpeg_quality <arg> -- set jpeg quality

OPTIONS FOR RENDERING IMAGES, GEOMETRY SETTINGS

--geom <WxH+X+Y>, --datum <arg>, --proj <arg>, --lon0 <arg> -- set rectangular geometry in a given datum/proj

--wgs_geom <WxH+X+Y>, --proj <arg> -- set rectalgular geometry in WGS lon-lat coordinates and convert it to the given projection

--wgs_brd <X1,Y1,X2,Y2...> -- set border of area in WGS lon-lat coordinates and convert it to the given projection

--nom <arg>

--google <X,Y,Z> -- set area as google tile

geom, wgs_geom, wgs_brd, nom and google options are incompatible with each other.

--rscale <arg> -- reversed scale (10000 for 1:10000 map)

-d, --dpi <arg> -- resolution, dots per inch

--mag <arg> -- additional magnification

--swap_y -- swap vertical axis

By default the scale of resulting map is the same as one of the first. input map. If there is no maps on input scale=1e-5,dpi=200. You may change default value using mag --option or rewrite it by dpi and scale (or rscale) parameters

Note: using rscale=100000, dpi=300 and rscale=50000, dpi=150 gave same images but different geofig files.

OPTIONS FOR RENDERING IMAGES, SRTM INPUT:

--srtm_mode <mode> -- srtm mode: normal, slopes

--srtm_cnt_step -- contour step, m

--srtm_hmin -- min height (blue color) for normal mode

--srtm_hmax -- max height (magenta color) for normal mode

--srtm_smin -- min slope for slopes mode (30)

--srtm_smax -- max slope for slopes mode (55)

EXAMPLES

Convert Ozi map files to a single xml:

        mapsoft_convert /maps/*.map -o maps.xml

Download waypoints and active log from GPS device and write them down in Ozi format files data.plt and data.wpt:

        mapsoft_convert /dev/ttyUSB0 -s o -o data.plt

Convert waypoints and track to packed kml format:

        mapsoft_convert data.plt data.wpt -o data.kmz

Create jpeg image with map from maps.xml and data from data.plt. Create also a map-file for this image

        mapsoft_convert maps.xml data.plt -o mymap.jpg --map=mymap.map

AUTHORS

Vladislav Zavjalov <slazav@altlinux.org>, Max Ushakov, Tim Alexeevsky

SEE ALSO

Homepage (rus) <http://slazav.mccme.ru/prog/mapsoft.htm>

Source code <http://github.com/ushakov/mapsoft>

Bugtracker <http://mapsoft.lighthouseapp.com/projects/24601-mapsoft/tickets>

LJ community <http://community.livejournal.com/mapsoft/>