Sketcher ValidateSketch: Difference between revisions

From FreeCAD Documentation
(Improved the Usage paragraph.)
mNo edit summary
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:7-->
<!--T:7-->
{{Docnav
{{Docnav
Line 25: Line 26:


</translate>
</translate>
[[File:Sketch Validate Tasks 019.png]]
[[File:Sketch_Validate_Tasks_019.png]]
<translate>
<translate>


Line 61: Line 62:
Leave the "Ignore construction geometry" checkbox checked to disregard construction geometry in the analysis.
Leave the "Ignore construction geometry" checkbox checked to disregard construction geometry in the analysis.


===Invalid constraints=== <!--T:19-->
===Invalid constraints===

<!--T:19-->
Checks for malformed constraints.
Checks for malformed constraints.


Line 73: Line 76:
It also does other checks, such as for empty links.
It also does other checks, such as for empty links.


===Degenerated geometry=== <!--T:22-->
===Degenerated geometry===

<!--T:22-->
Degenerated geometry can result from solver actions in a sketch.
Degenerated geometry can result from solver actions in a sketch.


Line 82: Line 87:
Other examples: a zero length line or zero radius circle/arc.
Other examples: a zero length line or zero radius circle/arc.


===Reversed external geometry=== <!--T:20-->
===Reversed external geometry===

<!--T:20-->
Reversed external geometry can happen because the handling of reversed geometry was changed around revision 0.15.
Reversed external geometry can happen because the handling of reversed geometry was changed around revision 0.15.


Line 88: Line 95:
This process might be helpful if sketches with external-geometry fail to solve because of these changes.
This process might be helpful if sketches with external-geometry fail to solve because of these changes.


===Constraint orientation locking=== <!--T:21-->
===Constraint orientation locking===

<!--T:21-->
Tangent and perpendicular constraints are implemented (via-point).
Tangent and perpendicular constraints are implemented (via-point).


Line 95: Line 104:


<!--T:32-->
<!--T:32-->
The locking mechanism typically works well and this tool should not be needed. '''''It should only used after making a backup of the open document.'''''
The locking mechanism typically works well and this tool should not be needed. '''It should only used after making a backup of the open document.'''



<!--T:8-->
<!--T:8-->

Revision as of 11:56, 21 February 2021

Sketcher ValidateSketch

Menu location
Sketch → Validate sketch…
Workbenches
Sketcher, PartDesign
Default shortcut
None
Introduced in version
-
See also
Sketcher_ConstrainCoincident, Topological naming problem

Description

The Validate sketch utility can be used to analyze and repair a sketch that is no longer editable, has invalid constraints, or to add missing coincident constraints to a sketch created from imported geometry such as DXF files. It can also be useful to locate a missing coincidence in a native sketch that generates a "can't validate broken face" error when trying to apply a PartDesign feature.

Usage

  1. This tool cannot be used on a sketch that is in edit mode. If required exit edit mode by doing one of the following:
  2. Select the sketch to be validated from the Tree view or by clicking on one of its edges in the 3D view.
  3. To open the validate sketch utility do one of the following:
    • Select the Sketch → Validate sketch... option from the menu.
    • Press the Validate sketch button.
  4. See Options below for the available operations.
  5. Press the Close button when done.

Options

Missing coincidences

Finds out missing coincidences for overlapping vertices, and adds them. Press the Find button; a pop up dialog will appear to report how many missing coincidences were found; they will be shown in the 3D view as yellow crosses. Press OK to close the dialog, then press the Fix button to add the missing coincidences.

If necessary, define a larger tolerance value in the drop-down field.

Press Highlight open vertexes to highlight vertexes that are outside this tolerance.

This tolerance is also used by the Find/Fix process as well.

Leave the "Ignore construction geometry" checkbox checked to disregard construction geometry in the analysis.

Invalid constraints

Checks for malformed constraints.

For example, if there is a Circle-Line-Tangent constraint, but it references two lines, it is considered invalid.

(This sometimes happens due to the Topological naming problem, i.e. the external geometry changes type).

It also does other checks, such as for empty links.

Degenerated geometry

Degenerated geometry can result from solver actions in a sketch.

For instance, if a line is forced to shorten to become almost a point.

Other examples: a zero length line or zero radius circle/arc.

Reversed external geometry

Reversed external geometry can happen because the handling of reversed geometry was changed around revision 0.15.

This process might be helpful if sketches with external-geometry fail to solve because of these changes.

Constraint orientation locking

Tangent and perpendicular constraints are implemented (via-point).

Internally they work by constraining the angle between tangent vectors. With tangent constraint for example, the angle can be 0 or 180 degrees (co-directed or opposed vectors). The actual angle is remembered in the constraint data ("constraint orientation is locked"), it guards against flipping. But the angle can be erased ("constraint orientation unlock") or updated; these tools do exactly that.

The locking mechanism typically works well and this tool should not be needed. It should only used after making a backup of the open document.