1IMAGE2GRIDMAP(1)    Mobile Robot Programming Toolkit - MRPT   IMAGE2GRIDMAP(1)
2
3
4

NAME

6       image2gridmap - Convert any image into an MRPT .gridmap file
7

SYNOPSIS

9       image2gridmap  [-w] [--py <0.0>] [--px <0.0>] [--cy <0.0>] [--cx <0.0>]
10                      -r <0.1> [-o <map.gridmap.gz>] -i <map_image.png> [--]
11                      [--version] [-h]
12

USAGE EXAMPLES

14       Minimal call to convert an image into a gridmap, (0,0) being at image
15       center:
16
17       image2gridmap -i map.png --res 0.10
18
19       Use custom (0,0) location with pixel coords. of (0,0):
20
21       image2gridmap -i map.png --res 0.10 --px 120 --py 100
22
23       Use custom (0,0) location coordinates of image center:
24
25       image2gridmap -i map.png --res 0.10 --cx -25.10 --cy 14.50
26

DESCRIPTION

28       image2gridmap is a command-line application to convert arbitrary
29       grayscale images into MRPT `.gridmap.gz` files. A `.gridmap.gz` file is
30       just a gz-compressed file containing the serialization of an object of
31       type `mrpt::maps::COccupancyGridMap2D`.
32
33       USAGE:
34
35          image2gridmap  [-w] [--py <0.0>] [--px <0.0>] [--cy <0.0>] [--cx <0.0>]
36                         -r <0.1> [-o <map.gridmap.gz>] -i <map_image.png> [--]
37                         [--version] [-h]
38
39       Where:
40
41          -w,  --overwrite
42            Force overwrite target file without prompting.
43
44          --py <0.0>
45            (Use either --cx or --px) Pixel verticl coordinate of the origin of
46            coordinates in the image
47
48          --px <0.0>
49            (Use either --cx or --px) Pixel horizontal coordinate of the origin of
50            coordinates in the image
51
52          --cy <0.0>
53            (Use either --cy or --py) Y coordinate of the image central pixel
54            (Default:0)
55
56          --cx <0.0>
57            (Use either --cx or --px) X coordinate of the image central pixel
58            (Default:0)
59
60          -r <0.1>,  --res <0.1>
61            (required)  Resolution: size (in meters) of one pixel in the image
62            (required)
63
64          -o <map.gridmap.gz>,  --output <map.gridmap.gz>
65            Name of the output file (*.gridmap, *.gridmap.gz)
66
67          -i <map_image.png>,  --input <map_image.png>
68            (required)  Input image file (required) (*.png,*.jpg,...)
69
70          --,  --ignore_rest
71            Ignores the rest of the labeled arguments following this flag.
72
73          --version
74            Displays version information and exits.
75
76          -h,  --help
77            Displays usage information and exits.
78

BUGS

80       Please report bugs at https://github.com/MRPT/mrpt/issues
81

SEE ALSO

83       The application wiki page at http://www.mrpt.org/Applications
84

AUTHORS

86       image2gridmap is part of the Mobile Robot Programming Toolkit (MRPT),
87       and was originally written by Jose Luis Blanco.
88
89       This manual page was written by Jose Luis Blanco
90       <joseluisblancoc@gmail.com>.
91
93       This program is free software; you can redistribute it and/or modify it
94       under the terms of the BSD License.
95
96       On Debian GNU/Linux systems, the complete text of the BSD License can
97       be found in `/usr/share/common-licenses/BSD'.
98
99
100
101perl v5.32.1                      2021-01-31                  IMAGE2GRIDMAP(1)
Impressum