.fpl logfile tool

Overview

Tool to process .fpl logfiles (recordings). This demonstrates the use of the .fpl logfile utilities

See Fixposition SDK: Build and installation on how to build and run the apps, or Fixposition SDK: Running pre-built apps on how to run the apps.

Command line help

fpltool (release, 0.0.0-heads/main-0-g5c7edb5)
Copyright (c) Fixposition AG (www.fixposition.com) and contributors
License: see the LICENSE files included in the source distribution
 
Tool for .fpl logfiles
 
Usage:
 
    parsertool [flags] <input> [<input> ...]
 
Usage:
 
    fpltool [<flags>] <command> [...]
 
Where (availability of flags depends on <command>, see below):
 
    -h       -- Print program help screen, and exit
    -V       -- Print program, version and license information, and exit
    -v / -q  -- Increase / decrease logging verbosity, multiple flags accumulate
    -p / -P  -- Show / don't show progress (default: automatic)
    -f       -- Force overwrite output (default: refuse to overwrite existing output files)
    -c       -- Compress output (e.g. ROS bags), -c -c to compress more
    -x       -- Add extra output, multiple -x can be given
    -o <out> -- Output to <out>
    -S <sec> -- Skip <sec> seconds from start of log (approximate!) (default: 0, i.e. no skip)
    -D <sec> -- Process <sec> seconds of log (approximate!) (default: everything)
    
Print information about the data in a .fpl logfile, along with status and meta data
 
    fpltool [-vqpPx] dump <fpl-file>
 
Print the meta data from a .fpl logfile (as YAML)
 
    fpltool [-vqpP] meta <fpl-file>
 
Generate a ROS bag from a .fpl logfile
 
    fpltool [-vqpPfoSD] robag <fpl-file>
 
Trim start and/or end of .fpl logfile, i.e. extract a portion of the file. Note that this process is
inaccurate and the effective start time and duration of the resulting file may be off by 30 to 60 seconds.
Therefore, both the start time (-S) and the duration (-D) must be at least 60 seconds.
 
    fpltool [-vqpPfo] -S <sec> -D <sec> <fpl-file>
 
Extract (som) non-ROS data from the .fpl logfile
 
    fpltool [-vqpP] extract <fpl-file>
 
Examples:
 
    Create a some.bag from a some.fpl logfile:
 
        fpltool rosbag some.fpl
 
    Create a compressed another.bag with 2 minutes of data starting 60 seconds into some.fpl logfile:
 
        fpltool rosbag some.fpl -c -c -o another.bag -S 60 -D 120
 
    Show meta data of some.fpl:
 
        fpltool meta some.fpl
 
    Trim a verylong.fpl into a shorter one:
 
        fpltool trim some.fpl -S 3600 -D 1800
 
    Extract data from some.fpl:
 
        fpltool extract some.fpl
 
        This results in various data files suitable for further processing. For example, the input/output
        messages received/sent by the sensor can be processed by the parsertool:
 
            parsertool some_userio.raw