It is possible to use the command line to create and process projects. Not all options can be changed. In many cases, it is possible to create a .p4d file to change the options that cannot be changed through the command line: .p4d minimum format.
To use the command line access the folder where Pix4Dmapper is installed and run the command:
pix4dmapper.exe -h
This displays the help which lists the options and commands that can be used.
The syntax of the command line is:
pix4dmapper [options] [project file]
The following command line options are available:
Name | Description |
-h [ --help ] | Print command line help and exit. |
-v [ --version ] | Print version and exit. |
-c [ --cmdline ] | Command line mode (does not open the user interface). If nothing is specified will use --run. Can also be used with --initial, --dense, --ortho or --new. |
--close-gui | Close GUI after processing. Can only be used together with --run. It is ignored when used in command line mode. |
--cam-param-project | Use camera parameters from the project file even if the database has different parameters. |
--cam-param-db | Use camera parameters from the database even if the project file has different parameters. |
--disable-user-cam-db | Disable user camera database. Only the build-in database is used. |
--email arg | Login with your Pix4D account email. Can only be used together with --password. |
--password arg | Log in with your Pix4D account password. Can only be used together with --email. |
--logout | Logout from the software. |
Name | Description |
-n [ --new ] | Create new project. |
--image-dir arg | Image directory. Can only be used with --new and --cmdline. |
--geolocation-format arg | Geolocation file format. The following <arg> can be selected:
|
--geolocation-file arg | Geolocation file. <arg> is the path to the geolocation file. Can only be used with --new and --cmdline. |
--ignore-non-geotagged | Does not add images to the project that have no image geolocation in the EXIF data. |
--cam-bands arg | Use specified camera bands. <arg> is a comma-separated list of camera bands. If the band names contain spaces, the list has be surrounded by quotation marks. Example: "Red edge, Green, Blue". |
--split-image-dir arg | Save split multi-page images to <arg>. Can only be used together with --new. |
--disable-cs-guess | Don't try to guess the project output coordinate system. The user will be prompted to enter it when opening the project in GUI mode. |
Name | Description |
-r [ --run ] | Run project. If no other option is specified, runs all steps defined in the processing options of the project. |
-i [ --initial ] | Run step 1. Initial Processing. |
-d [ --dense ] | Run step 2. Point Cloud and Mesh. Can only be used if step 1. Initial Processing is completed or if it used together with --initial. |
-o [ --ortho ] | Run step 3. DSM, Orthomosaic and Index. Can only be used if step 1. Initial Processing is completed or if it is used together with --initial. Can also be used in combination with --dense or after step 2. Point Cloud and Mesh has been completed. |
--template arg | Initialize processing options using a processing options template. Can be used with --new, --run, --initial, --dense, --ortho. <arg> can be: <template_name>: Use --template-list to display the list of pre-defined templates. <template_file>: Path to a custom template .tmpl file. The custom template file can be generated either using the user interface or by creating the file manually: How to create a Processing Options Template .tmpl File. |
--template-list | Display the list of pre-defined templates. |
Name | Description |
--max-cpus arg | Maximum number of CPU threads to use for processing. <arg> is an integer between 1 and the maximum number of CPU threads available on the current device. Can only be used with --run, --initial, --dense, --ortho. |
--use-cuda arg |
Enable/disable all CUDA capable GPUs. <arg> can be:
|
Pix4Dmapper outputs to two different streams: Stdout (containing the messages labelled as Info, UI and Processing) and Stderr (containing the messages labelled as Error and Warning). For more information about these labels: Menu View > Log Output.
The Stderr messages are always outputted. The outputting of the stdout messages depends on whether Pix4Dmapper is running in command line mode (using the -c option) or not. The options --stdout and --no-stdout allow you to modify this behavior.
Command line argument | Stdout | Stderr |
pix4dmapper.exe | Silent | Verbose |
pix4dmapper.exe --stdout | Verbose | Verbose |
pix4dmapper.exe -c | Verbose | Verbose |
pix4dmapper -c --no-stdout | Silent | Verbose |
Article feedback (for troubleshooting, post here instead)
0 comments