#
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
andoptions.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.
On older releases (version v2
and older) The smoothingFactor
option can also be used to make meshes smoother, but we don't recommend to use this option anymore, as it is removed as of version 24.06
. Indeed, smoothingIterations
provides better results, for a much lower processing time.
#
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).
On older releases (version v2
and older) The decimationFactor
option can also be used to decimate the mesh, but we don't recommend to use this option anymore, as it is removed as of version 24.06
. Indeed, decimateMaxError
provides better results, for a much lower processing time.
#
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.
This option is removed as of version 24.06
. From now on, almost all meshes will be manifold by default, but if you want to be 100% sure, then you should set the smoothingIterations to 0.
#
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.
These options are only available as of version 24.06
.