# 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.