Sketcher ValidateSketch/sv: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
{{Docnav
|[[Sketcher_ReorientSketch|Reorient sketch]]
|[[Sketcher_ReorientSketch|Reorient sketch]]
Line 12: Line 13:
{{GuiCommand/sv
{{GuiCommand/sv
|Name=Sketcher ValidateSketch
|Name=Sketcher ValidateSketch
|Name=Sketcher ValidateSketch
|Name/sv=Sketcher ValidateSketch
|Empty=1
|Empty=1
|Workbenches=[[Sketcher Workbench/sv|Sketcher]], [[PartDesign Workbench/sv|PartDesign]]
|Workbenches=[[Sketcher Workbench/sv|Sketcher]], [[PartDesign Workbench/sv|PartDesign]]
Line 21: Line 22:
==Description==
==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 [[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.


<div class="mw-translate-fuzzy">
[[File:Sketcher validation tasks_sv.png|left]]
</div>
{{clear}}


[[File:Sketcher_ValidateSketch_taskpanel.png|x500px]]
{{Caption|The Sketcher validation task panel}}


==Usage==
==Usage==


# 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 [[Tree_view|Tree view]], or by clicking on one of its edges in the [[3D_view|3D view]].
# Select a sketch.
#: '''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.
# There are several ways to invoke the tool:
# Open the validate sketch utility either:
#* Press the {{Button|[[Image:Sketcher_ValidateSketch.svg|16px]] [[Sketcher_ValidateSketch|Validate sketch...]]}} button.
#* from the {{MenuCommand|Sketch → Validate sketch…}} dropdown
#* pressing the [[Image:Sketcher_ValidateSketch.svg|24px|link=Sketcher_ValidateSketch]] button in the [[Image:Workbench_Sketcher.svg|16px|Sketcher_Workbench]] [[Sketcher_Workbench|Sketcher Workbench]].
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ValidateSketch.svg|16px]] Validate sketch...}} option from the menu.
# See [[#Options|Options]] below for operation.
# The '''Sketcher validation''' task panel opens. See [[#Options|Options]] for more information.
# Press the {{Button|Close}} button when done.
# Press the {{Button|Close}} button to finish.


==Options==
==Options==
Line 48: Line 45:
If necessary, define a larger tolerance value in the drop-down field.
If necessary, define a larger tolerance value in the drop-down field.


Press {{Button|Highlight open vertexes}} to highlight vertexes that are outside this tolerance.
Press {{Button|Highlight troublesome vertexes}} to highlight vertexes that are outside this tolerance.


This tolerance is also used by the {{Button|Find}}/{{Button|Fix}} process as well.
This tolerance is also used by the {{Button|Find}}/{{Button|Fix}} process.


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===
===Invalid constraints===

Checks for malformed constraints.
Checks for malformed constraints.


For example, if there is a Circle-Line-Tangent constraint, but it references two lines, it is considered invalid.
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).
(This sometimes happens due to the [[Topological_naming_problem|Topological naming problem]], i.e. the external geometry changes type).


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


===Degenerated geometry===
===Degenerated geometry===

Degenerated geometry can result from solver actions in a sketch.
Degenerated geometry can result from solver actions in a sketch.


Line 71: Line 70:


===Reversed external geometry===
===Reversed external geometry===

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 76: Line 76:


===Constraint orientation locking===
===Constraint orientation locking===

Tangent and perpendicular constraints are implemented (via-point).
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.
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.'''''
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.'''



{{Docnav
{{Docnav

Latest revision as of 11:15, 27 March 2024

Sketcher ValidateSketch

Menyplacering
Sketch / Part Design → Validate sketch
Arbetsbänkar
Sketcher, PartDesign
Standard genväg
Ingen
Introducerad i version
-
Se även
Ingen

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.