Troubleshooting

Error while processing a project - PIX4Dcloud

A project may fail to be processed on PIX4Dcloud for different reasons. When this happens, an email is sent to the project owner. Several leads are recommended to be explored.

If the problem is related to the output display (the outputs are generated but something in the display doesn't work or no email is sent as error notification), other specific checks should be performed. Please visit: Output is not displayed / feature is missing in the cloud.

1. Inspect the quality report

When there is a processing error, the PDF quality report is normally sent via email to the project owner. If this is not the case, go to the section Inspect the log file.

  1. Download the PDF report from the email. Alternatively, open the project in the Error status, then click Quality report to download it.
  2. Analyze the file with the Quality Report Help.
  3. If no evident error is found, go to Inspect the log file.

2. Inspect the log file

When there is a processing error, normally an error is logged in the log file that is generated while processing. If there is no log file (and no quality report) generated instead, it is highly probable that The project crashed on PIX4Dcloud servers.

To download and inspect the log file:

  1. Open the project in the Error status, then click Processing logs to download the file.
  2. Open the file with a text editor, e.g. Notepad++.
  3. In the processing logs document, look for (CTRL+F) the following string: [Error].
  4. Go to the Pix4D Documentation or to your preferred search engine and search for the error code/description.
Example: If the error logged is [Error]: Error e0046: Processing failed. No calibrated cameras, look for Error e0046 in the search engine.

3. Inspect the input files

Perform some basic checks on the input files:

Warning: PIX4Dcloud allows users to process projects with minimum 6 images. When uploading the images from PIX4Dmapper, there is no warning message which is why the project fails if it does not comply with this minimum requirement.

The project crashed on PIX4Dcloud servers

The project can crash on PIX4Dcloud servers due to lack of resources. This can happen if the project is too large or the processing effort exceeds PIX4Dcloud servers' capabilities. More information at: How many images can PIX4Dcloud process?.

If the project was processed directly on PIX4Dcloud:

  • Create a new project with a reduced number of images.

If the project was uploaded from PIX4Dmapper, reopen the project in PIX4Dmapper, then try choosing at least one of the following options:

  • Reducing the quality of Step 2 outputs in the Processing Options (defining Menu Process > Processing Options... > 2. Point Cloud and Mesh > Point Cloud > Point Density > High (Slow) and Menu Process > Processing Options... > 2. Point Cloud and Mesh > 3D Textured Mesh > High Resolution can potentially lead to a server crash for large projects due to high RAM usage).
  • Reducing the number of images.
  • Ensuring the strictly necessary outputs are marked for their generation.
  • Defining a processing area.

Then upload the project to PIX4Dcloud for processing again.