Convert#

Convert datasets#

This command allows to convert a dataset from one format to another. The command is a usability alias for create, add and export and just provides a simpler way to obtain the same results in simple cases. A list of supported formats can be found in the --help output of this command.

Usage:

datum convert [-h] [-i SOURCE] [-if INPUT_FORMAT] -f OUTPUT_FORMAT
              [-o DST_DIR] [--overwrite] [-e FILTER] [--filter-mode FILTER_MODE]
              [-- EXTRA_EXPORT_ARGS]

Parameters:

-i, --input-path (string) - Input dataset path. (default: current directory)
-if, --input-format (string) - Input dataset format. Will try to detect, if not specified.
-f, --output-format (string) - Output format
-o, --output-dir (string) - Directory to save output. (default: a subdir in the current one)
--overwrite - Allows overwriting existing files in the output directory, when it is not empty.
-e, --filter (string) - XML XPath filter expression for dataset items
--filter-mode (string) - Filter mode, one of items, annotations, items+annotations (default: items)
-h, --help - Print the help message and exit.
-- <extra export args> - Additional arguments for the format writer (use -- -h for help). Must be specified after the main command arguments.

Examples:

Convert a VOC-like dataset to a COCO-like one

datum convert --input-format voc --input-path <path/to/voc-like/dataset/> \
              --output-format coco \
              -- --save-media