# Job options

The job body accepts an options dictionary, which exposes a set of additional settings for your job.

# Mesh fine-tuning

When requesting mesh output files, you can fine-tune the mesh generation process.

The options are available for all CBCT structures

• mandibular bone (options.mandible)
• maxillary bone (options.skull and options.maxillary-complex)
• mandibular canals (options.nerve)
• airway (options.airway)
• teeth (options.dentition)
• soft tissue (options.soft-tissue)
• sinuses (options.maxillary-sinus)

Additionally, they are available for the fused teeth through options.fusedMeshOptions.

# Smoothing smoothingIterations smoothingFactor

The smoothingIterations field allows you to specify an additional number of smoothing iterations to apply to the generated mesh. More iterations lead to smoother, sometimes better-looking meshes, but too high values can lead to loss of detail. The default value of 0 for small structures (teeth, nerves, etc.) and 1 for big structures (skull, mandible, etc.) should give good and accurate results in most cases, but if more smoothness is desired, higher values can be used; we encourage you to explore what works best for you.

If you want to ensure that your meshes are manifold, then you should use a value of 0.

# Decimation decimateMaxError decimationFactor

Decimation allows you to reduce the number of triangles in the mesh, leading to smaller file sizes.

The decimateMaxError option determines the maximum allowed error (in millimeters) when decimating the mesh. The default value of 0.03 for small structures (teeth, nerves, etc.) and 0.1 for big structures (skull, mandible, etc.) should result in a decent mesh size reduction with very minimal accuracy loss, but larger and smaller values can be used if desired. Setting this to zero will disable decimation completely (maximizing accuracy, but potentially increasing the mesh size significantly).

# Manifold makeManifold

If makeManifold is enabled, the output mesh will be made water-tight, cleaning up holes and missing faces. This will increase the processing time.

# Crown options align_crown_meshes_to_cbct

When requesting mesh output files for the IOS crowns, you can choose whether the crowns should be returned in the original IOS position or aligned to the CBCT (default). This is controlled through the options.align_crown_meshes_to_cbct option. Only applicable when there is a CBCT scan present in the job, otherwise the crowns are always returned in the original IOS position.

# Gingiva options gingivaOptions

When requesting mesh output files for the gingiva, you fine-tune the result through options.gingivaOptions. The following settings are available:

• addBase: automatically adds a base to the gingiva mesh.
• closeProfile: automatically closes the holes where the teeth come out of the gingiva, leading to a closed teeth surface.

# Fused mesh options fusedMeshOptions

When requesting mesh output files for the fused teeth, you can fine-tune the result through options.fusedMeshOptions.

The following settings are available:

• smoothingIterations: the number of smoothing iterations to apply to the generated mesh. The higher the value, the smoother the mesh.
• decimateMaxError: The maximum error allowed when simplifying the mesh, based on the voxel size of the scan.
• fallbackToCbctTooth: if the fusion fails, return the CBCT root (⚠️ this option is only available on the latest Engine)
• fallbackToIosCrown: if the fusion fails, return the IOS crown (⚠️ this option is only available on the latest Engine)

# Falling back to the "best" tooth fallbackToCbctTooth fallbackToIosCrown

Sometimes, the Engine may not successfully fuse CBCT roots with IOS crowns. This can happen for various reasons, such as the absence of a tooth in one of the scans due to extraction, misalignment between the two scans, or other factors.

In such cases, the Engine will attempt to fall back to the "best" available tooth, either the CBCT root or the IOS crown, with priority given to the CBCT root.

If you prefer not to have the Engine return a mesh containing a non-fused tooth, you can disable the fallback to the "best" tooth by setting the fallbackToCbctTooth and fallbackToIosCrown parameters to false. In that case, the requested fused structures will be marked as not present if their fusion failed.

If both fallback options are set to true and fusion cannot occur, even when the tooth is present in both scans, the Engine will return the CBCT root.