rawlog-edit(1)

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

NAME

6       rawlog-edit - Command-line robotic datasets (rawlogs) manipulation tool
7

SYNOPSIS

9        rawlog-edit  [--cut] [--export-gps-txt] [--export-gps-kml]
10           [--keep-label <label[,label...]>]
11           [--remove-label <label[,label...]>]
12           [--info] [--externalize] [-q] [-w] [--to-time <T1>]
13           [--from-time <T0>] [--to-index <N1>] [--from-index <N0>]
14           [--image-format <jpg,png,pgm,...>] [-o
15           <dataset_out.rawlog>] -i <dataset.rawlog> [--] [--version]
16           [-h]
17

USAGE EXAMPLES

19       Quick overview of a dataset file:
20
21       rawlog-edit --info -i in.rawlog
22
23       Cut the entries [1000,2000] into another rawlog file:
24
25       rawlog-edit --cut --from-index 1000 --to-index 2000 \
26                    -i in.rawlog -o out.rawlog
27
28       Cut the entries from the beginning up to timestamp 1281619819:
29
30       rawlog-edit --cut --to-time 1281619819 \
31                    -i in.rawlog -o out.rawlog
32
33       Generate a Google Earth KML file with the GPS data in a dataset:
34
35       rawlog-edit --export-gps-kml -i in.rawlog
36
37       Remove all observations named "REAR_LASER":
38
39       rawlog-edit --remove-label REAR_LASER -i in.rawlog -o out.rawlog
40
41       Remove all observations not named "REAR_LASER":
42
43       rawlog-edit --keep-label REAR_LASER -i in.rawlog -o out.rawlog
44
45       Convert all images to external storage mode:
46
47       rawlog-edit --externalize -i in.rawlog -o out.rawlog
48
49       rawlog-edit --externalize --image-format jpg -i in.rawlog \
50                    -o out.rawlog
51

DESCRIPTION

53       rawlog-edit is a command-line application to inspect and manipulate
54       robotic dataset files in the "rawlog" standardized format.
55
56       These are the supported arguments and operations:
57
58          --cut
59            Op: Cut a part of the input rawlog.
60
61            Requires: -o (or --output)
62
63            Requires: At least one of --from-index, --from-time, --to-index,
64            --to-time. Use only one of the --from-* and --to-* at once.
65
66            If only a --from-* is given, the rawlog will be saved up to its end.
67            If only a --to-* is given, the rawlog will be saved from its
68            beginning.
69
70
71          --export-gps-txt
72            Op: Export GPS readings to TXT files.
73
74            Generates one .txt file for each different sensor label of GPS
75            observations in the dataset. The generated .txt files will be saved in
76            the same path than the input rawlog, with the same filename + each
77            sensorLabel.
78
79          --export-gps-kml
80            Op: Export GPS paths to Google Earth KML files.
81
82            Generates one .kml file with different sections for each different
83            sensor label of GPS observations in the dataset. The generated .kml
84            files will be saved in the same path than the input rawlog, with the
85            same filename + each sensorLabel.
86
87          --keep-label <label[,label...]>
88            Op: Remove all observations not matching the given sensor
89            label(s).Several labels can be provided separated by commas.
90
91            Requires: -o (or --output)
92
93          --remove-label <label[,label...]>
94            Op: Remove all observation matching the given sensor label(s).Several
95            labels can be provided separated by commas.
96
97            Requires: -o (or --output)
98
99          --info
100            Op: parse input file and dump information and statistics.
101
102          --externalize
103            Op: convert to external storage.
104
105            Requires: -o (or --output)
106
107            Optional: --image-format
108
109          -q,  --quiet
110            Terse output
111
112          -w,  --overwrite
113            Force overwrite target file without prompting.
114
115          --to-time <T1>
116            End time for --cut, as UNIX timestamp, optionally with fractions of
117            seconds.
118
119          --from-time <T0>
120            Starting time for --cut, as UNIX timestamp, optionally with fractions
121            of seconds.
122
123          --to-index <N1>
124            End index for --cut
125
126          --from-index <N0>
127            Starting index for --cut
128
129          --image-format <jpg,png,pgm,...>
130            External image format
131
132          -o <dataset_out.rawlog>,  --output <dataset_out.rawlog>
133            Output dataset (*.rawlog)
134
135          -i <dataset.rawlog>,  --input <dataset.rawlog>
136            (required)  Input dataset (required) (*.rawlog)
137
138          --,  --ignore_rest
139            Ignores the rest of the labeled arguments following this flag.
140
141          --version
142            Displays version information and exits.
143
144          -h,  --help
145            Displays usage information and exits.
146

BUGS

148       Please report bugs at http://www.mrpt.org/project/issues/MRPT
149

AUTHORS

155       rawlog-edit is part of the Mobile Robot Programming Toolkit (MRPT), and
156       was originally written by the MAPIR laboratory (University of Malaga).
157
158       This manual page was written by Jose Luis Blanco
159       <joseluisblancoc@gmail.com>.
160

COPYRIGHT

162       This program is free software; you can redistribute it and/or modify it
163       under the terms of the GNU General Public License as published by the
164       Free Software Foundation; either version 3, or (at your option) any
165       later version.
166
167       On Debian GNU/Linux systems, the complete text of the GNU General
168       Public License can be found in `/usr/share/common-licenses/GPL'.
169
170
171
172perl v5.12.2                      2010-08-12                    RAWLOG-EDIT(1)