# Convert ## Convert datasets This command allows to convert a dataset from one format to another. The command is a usability alias for [`create`](create), [`add`](../context/sources.md#add-dataset) and [`export`](../context/export.md) 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: ```console 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. - `-- ` - 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 ```console datum convert --input-format voc --input-path \ --output-format coco \ -- --save-images ```