General
swift assumes that the models in your set are properly installed and working for your simulator. If not, it can happen that swift uses a model (as result of the matching procedure) which then fails to render.
::: {.important} ::: {.title} Important :::
The normal situation should be that there are no validation errors. Fix your model set if models are removed or changed. So it is your responsibility to keep your model set up to date. However there are some tools helping you. :::
It can happen that models fail even though there is no validation error,
see disabledmodels
{.interpreted-text role=“ref”}
Reasons for validation errors
All that requires updating the own models and the model set. Check the
model file path of the models in your model set, then you can see where
swift expects the models. If you want to fix the path, you can
re-create the model set, see createms
{.interpreted-text role=“ref”} .
How to enable validation?
From the settings (use SHIFT + settings button to get to the first page), click matching, scroll down a bit
Pilot client validations
In the matching settings you can setup how swift handles validation.
This is how the result dialog looks like. There you can temp. disable such models.
After you have disabled models you wold see them "in red" in the model view (might be you have to press "load set" to refresh the view).
Btw, you can also temp. disable a model from the context menu.
Trigger validation in pilot client
From the model page in the client, click the [validate]{.title-ref} button,
In the validation popup you either see messages already (if there are results already), or press [trigger validation]{.title-ref} to start the validation (which takes a while before there are results)
Validation in mapping tool
::: {.important} ::: {.title} Important :::
This does a live check (unlike the background check of the pilot client above). In case the files are not accessible on a remote drive it can cause the mapping tool to hang before a timeout is reported. :::
In the mapping tool just select the models to be checked and run the validation.
If there was a previous validation in the swift pilot client yielding some invalid models, those can be also highlighted in the mapping tool.
A real world example
see modelsetvalidationexample
{.interpreted-text role=“ref”}
::: {.toctree caption=“Content in this chapter”} modelsetvalidationexample disabledmodels whyvalidationerrors :::