Sketcher ValidateSketch: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(38 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:7-->
<!--T:7-->
{{Docnav
{{Docnav
|[[Sketcher_ReorientSketch|Reorient sketch ]]
|[[Sketcher_ReorientSketch|Reorient sketch]]
|[[Sketcher MergeSketches|Merge sketches]]
|[[Sketcher_MergeSketches|Merge sketches]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ReorientSketch.svg
⚫
|IconC=Workbench_Sketcher.svg
|IconR=Sketcher MergeSketch.svg‎
|IconR=Sketcher MergeSketch.svg‎
⚫
|IconC=Workbench_Sketcher.svg
}}
}}


Line 13: Line 15:
{{GuiCommand
{{GuiCommand
|Name=Sketcher ValidateSketch
|Name=Sketcher ValidateSketch
⚫
|MenuLocation=Sketch → Validate sketch...
|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]
⚫
|MenuLocation=Sketch / Part Design → Validate sketch…
|SeeAlso=[[Sketcher_ConstrainCoincident|Sketcher ConstrainCoincident]]
}}
}}


Line 20: Line 23:


<!--T:12-->
<!--T:12-->
The '''Validate sketch''' utility can be used to repair a sketch that is no longer editable, has invalid constraints, or to add missing [[Sketcher ConstrainCoincident|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.
The [[Image:Sketcher_ValidateSketch.svg|24px]] [[Sketcher_ValidateSketch|Sketcher ValidateSketch]] tool can analyze and repair a sketch that is no longer editable or has invalid constraints, or add missing [[Sketcher_ConstrainCoincident|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 an error when trying to apply a PartDesign feature.



⚫
<!--T:11-->
[[File:Sketcher validation tasks.png|left]]
</translate>
</translate>
[[File:Sketcher_ValidateSketch_taskpanel.png|x500px]]
{{clear}}

<translate>
<translate>
==How to use== <!--T:4-->
<!--T:33-->
{{Caption|The Sketcher validation task panel}}

==Usage== <!--T:4-->


<!--T:13-->
<!--T:13-->
# This tool cannot be used while a sketch is in edit mode. To finish edit mode see [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].
# Select the sketch to validate, either from the Model tree, or by clicking on one of its edges in the 3D view. <br>'''Note:''' the sketch must not be in editing mode. If you are in sketch edit mode, you need to use the {{Button|[[File:Sketcher LeaveSketch.svg|16px]] [[Sketcher LeaveSketch|Leave sketch]]}} button, or the {{Button|Close}} button at the top of the Tasks tab.
# Select a sketch.
# Open the validate sketch utility from the Sketch or Part Design menu.
# There are several ways to invoke the tool:
# See [[#Options|Options]] below for operation.
# Press the {{Button|Close}} button when done.
#* Press the {{Button|[[Image:Sketcher_ValidateSketch.svg|16px]] [[Sketcher_ValidateSketch|Validate sketch...]]}} button.
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ValidateSketch.svg|16px]] Validate sketch...}} option from the menu.
# The '''Sketcher validation''' task panel opens. See [[#Options|Options]] for more information.
# Press the {{Button|Close}} button to finish.


==Options== <!--T:14-->
==Options== <!--T:14-->
Line 46: Line 51:
<!--T:17-->
<!--T:17-->
If necessary, define a larger tolerance value in the drop-down field.
If necessary, define a larger tolerance value in the drop-down field.

⚫
<!--T:23-->
Press {{Button|Highlight troublesome vertexes}} to highlight vertexes that are outside this tolerance.

<!--T:24-->
This tolerance is also used by the {{Button|Find}}/{{Button|Fix}} process.


<!--T:18-->
<!--T:18-->
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:34-->


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


===Reversed external geometry=== <!--T:20-->
<!--T:25-->
For example, if there is a Circle-Line-Tangent constraint, but it references two lines, it is considered invalid.


<!--T:26-->
(This sometimes happens due to the [[Topological_naming_problem|Topological naming problem]], i.e. the external geometry changes type).


<!--T:27-->
⚫
===Constraint orientation locking=== <!--T:21-->
It also does other checks, such as for empty links.

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

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

<!--T:28-->
For instance, if a line is forced to shorten to become almost a point.

<!--T:29-->
Other examples: a zero length line or zero radius circle/arc.

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

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

<!--T:30-->
This process might be helpful if sketches with external-geometry fail to solve because of these changes.

⚫
===Constraint orientation locking=== <!--T:37-->

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

<!--T:31-->
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.

<!--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.'''




<!--T:8-->
<!--T:8-->
{{Docnav
{{Docnav
|[[Sketcher_ReorientSketch|Reorient sketch ]]
|[[Sketcher_ReorientSketch|Reorient sketch]]
|[[Sketcher MergeSketches|Merge sketches]]
|[[Sketcher_MergeSketches|Merge sketches]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ReorientSketch.svg
⚫
|IconC=Workbench_Sketcher.svg
|IconR=Sketcher MergeSketch.svg‎
|IconR=Sketcher MergeSketch.svg‎
⚫
|IconC=Workbench_Sketcher.svg
}}
}}


Latest revision as of 11:14, 27 March 2024

Other languages:

Sketcher ValidateSketch

Menu location
Sketch → Validate sketch...
Workbenches
Sketcher, PartDesign
Default shortcut
None
Introduced in version
-
See also
Sketcher ConstrainCoincident

Description

The Sketcher ValidateSketch tool can analyze and repair a sketch that is no longer editable or has invalid constraints, or 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 an error when trying to apply a PartDesign feature.

The Sketcher validation task panel

Usage

  1. This tool cannot be used while a sketch is in edit mode. To finish edit mode see Sketcher LeaveSketch.
  2. Select a sketch.
  3. There are several ways to invoke the tool:
    • Press the Validate sketch... button.
    • Select the Sketch → Validate sketch... option from the menu.
  4. The Sketcher validation task panel opens. See Options for more information.
  5. Press the Close button to finish.

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 troublesome vertexes to highlight vertexes that are outside this tolerance.

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

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.


Sketcher
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Sketcher_ValidateSketch&oldid=1387629"