Assembly CreateJointFixed: Difference between revisions

From FreeCAD Documentation
m (Typos, docnav according to GuiCommand model)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

{{VeryImportantMessage|Some joints are experimental features. To enable them see [[Fine-tuning#Assembly_Workbench|Fine-tuning]].}}


</translate>
</translate>
Line 8: Line 6:
<translate>
<translate>


<!--T:2-->
{{Docnav
{{Docnav
|[[Assembly_ToggleGrounded|ToggleGrounded]]
|[[Assembly_ToggleGrounded|ToggleGrounded]]
Line 17: Line 16:
}}
}}


<!--T:3-->
{{GuiCommand
{{GuiCommand
|Name=Assembly CreateJointFixed
|Name=Assembly CreateJointFixed
Line 26: Line 26:
}}
}}


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


<!--T:5-->
The [[Image:Assembly_CreateJointFixed.svg|24px]] [[Assembly_CreateJointFixed|Assembly CreateJointFixed]] tool creates a joint locking two assembly parts together, preventing any movement or rotation.
The [[Image:Assembly_CreateJointFixed.svg|24px]] [[Assembly_CreateJointFixed|Assembly CreateJointFixed]] tool creates a joint locking two assembly parts together, preventing any movement or rotation.


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


<!--T:7-->
# Optionally select two geometric entities of two different parts. Other selections will be rejected.
# Optionally select two geometric entities of two different parts. Other selections will be rejected.
# There are several ways to invoke the tool:
# There are several ways to invoke the tool:
Line 39: Line 41:
# Pre-selected parts are moved to meet at their selected entities.
# Pre-selected parts are moved to meet at their selected entities.
# The '''Create Joint''' dialog opens in the [[Task_panel|Task panel]] listing the pre-selected entities.
# The '''Create Joint''' dialog opens in the [[Task_panel|Task panel]] listing the pre-selected entities.
# Optionally change the type of the joint from the dropdown list:
# Optionally change the joint type in the dropdown list:
#* Select '''Fixed'''.
#* Select '''Fixed'''.
#*# If the selection list is empty: select two geometric entities.
#*# If the selection list is empty: select two geometric entities.
Line 52: Line 54:
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally check the '''Limits''' option.
#*# Optionally check the '''Limits''' option.
#*#* Optionally enter an ''Angle'' min value.
#*#* Optionally enter an ''Angle min'' value.
#*#* Optionally enter an ''Angle'' min value.
#*#* Optionally enter an ''Angle max'' value.
#* Select '''Cylindrical'''.
#* Select '''Cylindrical'''.
#*# If the selection list is empty: select two geometric entities.
#*# If the selection list is empty: select two geometric entities.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally check the '''Limits''' option.
#*# Optionally check the '''Limits''' option.
#*#* Optionally enter an ''Length min'' value.
#*#* Optionally enter a ''Length min'' value.
#*#* Optionally enter an ''Length max'' value.
#*#* Optionally enter a ''Length max'' value.
#*#* Optionally enter an ''Angle min'' value.
#*#* Optionally enter an ''Angle min'' value.
#*#* Optionally enter an ''Angle min'' value.
#*#* Optionally enter an ''Angle max'' value.
#* Select '''Slider'''.
#* Select '''Slider'''.
#*# If the selection list is empty: select two geometric entities.
#*# If the selection list is empty: select two geometric entities.
Line 67: Line 69:
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally check the '''Limits''' option.
#*# Optionally check the '''Limits''' option.
#*#* Optionally enter an ''Length min'' value.
#*#* Optionally enter a ''Length min'' value.
#*#* Optionally enter an ''Length max'' value.
#*#* Optionally enter a ''Length max'' value.
#* Select '''Ball'''.
#* Select '''Ball'''.
#*# If the selection list is empty: select two geometric entities.
#*# If the selection list is empty: select two geometric entities.
Line 75: Line 77:
#*# Optionally enter a ''Distance'' value.
#*# Optionally enter a ''Distance'' value.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#*# Optionally press {{Button|[[Image:Button_sort.svg|16px]]}} to change the direction of the joint.
#* Select '''RackPinion'''. [[Fine-tuning#Assembly_Workbench|{{Emphasis|Experimental feature}}]].
#* Select '''RackPinion'''.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be perpendicular)
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be perpendicular)
#*# Optionally enter a ''Pitch radius'' value.
#*# Optionally enter a ''Pitch radius'' value.
#* Select '''Screw'''. [[Fine-tuning#Assembly_Workbench|{{Emphasis|Experimental feature}}]].
#* Select '''Screw'''.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be parallel)
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be parallel)
#*# Optionally enter a ''Pitch radius'' value.
#*# Optionally enter a ''Pitch radius'' value.
#* Select '''Gears'''. [[Fine-tuning#Assembly_Workbench|{{Emphasis|Experimental feature}}]].
#* Select '''Gears'''.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
#*# Optionally enter a ''Radius 1'' value.
#*# Optionally enter a ''Radius 1'' value.
#*# Optionally enter a ''Radius 2'' value.
#*# Optionally enter a ''Radius 2'' value.
#*# Optionally check/uncheck the '''Reverse rotation''' option. (unchecking selects the '''Belt''' option)
#*# Optionally check/uncheck the '''Reverse rotation''' option. (unchecking selects the '''Belt''' option)
#* Select '''Belt'''. [[Fine-tuning#Assembly_Workbench|{{Emphasis|Experimental feature}}]].
#* Select '''Belt'''.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
#*# If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
#*# Optionally enter a ''Radius 1'' value.
#*# Optionally enter a ''Radius 1'' value.
Line 95: Line 97:
# Press {{Button|OK}} to finish the tool.
# Press {{Button|OK}} to finish the tool.


==Notes==
==Notes== <!--T:8-->


<!--T:9-->
* Never select the items in the selection list and hit the {{KEY|Del}} key! This also removes the connected features from the Tree! (weekly build 0.22.0-36807)
* This joint can be used as an actuator to control the motion of a kinematic simulation. Mouse wheel action in the Task dialog immediately rearranges the connected parts.
* A fixed joint can be used as an actuator to control the motion of a kinematic simulation. Mouse wheel action in the Task panel immediately rearranges the connected parts.
** Offset translates along its local Z axis, negative offsets are accepted.
** Offset translates along its local Z axis, negative offsets are accepted.
** Rotation revolves around its local Z axis, angles > 360° and even negative angles are accepted.
** Rotation revolves around its local Z axis, angles > 360° and even negative angles are accepted.


==Properties==
==Properties== <!--T:10-->


<!--T:11-->
See also: [[Property_editor|Property editor]].
See also: [[Property_editor|Property editor]].


<!--T:12-->
A '''Fixed''' object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. It also has the following additional properties:
A '''Fixed''' object is derived from an [[App_FeaturePython|App FeaturePython]] object and inherits all its properties. It also has the following additional properties:


===Data===
===Data=== <!--T:13-->


<!--T:14-->
{{TitleProperty|Joint}}
{{TitleProperty|Joint}}


<!--T:15-->
* {{PropertyData|Activated|Bool}}: This indicates if the joint is active.
* {{PropertyData|Activated|Bool}}: This indicates if the joint is active.
* {{PropertyData|Distance|Float}}: This is the distance of the joint. It is used only by the distance joint and the RackPinion (pitch radius), Screw, Gear, and Belt (radius1).
* {{PropertyData|Distance|Float}}: This is the distance of the joint. It is used only by the distance joint and the RackPinion (pitch radius), Screw, Gear, and Belt (radius1).
Line 119: Line 125:
* {{PropertyData|Rotation|Float}}: This is the rotation of the joint.
* {{PropertyData|Rotation|Float}}: This is the rotation of the joint.


<!--T:16-->
{{TitleProperty|Joint Connector 1}}
{{TitleProperty|Joint Connector 1}}


<!--T:17-->
* {{PropertyData|Detach1|Bool}}: This prevents placement1 from recomputing, enabling custom positioning of the placement.
* {{PropertyData|Detach1|Bool}}: This prevents placement1 from recomputing, enabling custom positioning of the placement.
* {{PropertyData|Element1|String}}: The selected element of the first object.
* {{PropertyData|Element1|String}}: The selected element of the first object.
Line 128: Line 136:
* {{PropertyData|Vertex1|String}}: The selected Vertex of the first object.
* {{PropertyData|Vertex1|String}}: The selected Vertex of the first object.


<!--T:18-->
{{TitleProperty|Joint Connector 2}}
{{TitleProperty|Joint Connector 2}}


<!--T:19-->
* {{PropertyData|Detach2|Bool}}: This prevents placement2 from recomputing, enabling custom positioning of the placement.
* {{PropertyData|Detach2|Bool}}: This prevents placement2 from recomputing, enabling custom positioning of the placement.
* {{PropertyData|Element2|String}}: The selected element of the second object.
* {{PropertyData|Element2|String}}: The selected element of the second object.
Line 137: Line 147:
* {{PropertyData|Vertex2|String}}: The selected Vertex of the second object.
* {{PropertyData|Vertex2|String}}: The selected Vertex of the second object.


<!--T:20-->
{{TitleProperty|Limits}}
{{TitleProperty|Limits}}


<!--T:21-->
* {{PropertyData|Angle Max|Float}}: This is the maximum limit for the angle between both coordinate systems (between their X axes).
* {{PropertyData|Angle Max|Float}}: This is the maximum limit for the angle between both coordinate systems (between their X axes).
* {{PropertyData|Angle Min|Float}}: This is the minimum limit for the angle between both coordinate systems (between their X axes).
* {{PropertyData|Angle Min|Float}}: This is the minimum limit for the angle between both coordinate systems (between their X axes).
* {{PropertyData|Enable Limits|Bool}}: Is this joint using limits?
* {{PropertyData|Enable Limits|Bool}}: Is this joint using limits?
* {{PropertyData|Length Max|Float}}: This is the maximum limit for the angle between both coordinate systems (along their Z axis).
* {{PropertyData|Length Max|Float}}: This is the maximum limit for the distance between both coordinate systems (along their Z axis).
* {{PropertyData|Length Min|Float}}: This is the minimum limit for the angle between both coordinate systems (along their Z axis).
* {{PropertyData|Length Min|Float}}: This is the minimum limit for the distance between both coordinate systems (along their Z axis).




<!--T:22-->
{{Docnav
{{Docnav
|[[Assembly_ToggleGrounded|ToggleGrounded]]
|[[Assembly_ToggleGrounded|ToggleGrounded]]

Latest revision as of 16:15, 4 June 2024

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Assembly CreateJointFixed

Menu location
Assembly → Create a Fixed Joint
Workbenches
Assembly
Default shortcut
F
Introduced in version
1.0
See also
None

Description

The Assembly CreateJointFixed tool creates a joint locking two assembly parts together, preventing any movement or rotation.

Usage

  1. Optionally select two geometric entities of two different parts. Other selections will be rejected.
  2. There are several ways to invoke the tool:
    • Press the Create a Fixed Joint button.
    • Select the Assembly → Create a Fixed Joint option from the menu.
    • Use the keyboard shortcut: F.
  3. Pre-selected parts are moved to meet at their selected entities.
  4. The Create Joint dialog opens in the Task panel listing the pre-selected entities.
  5. Optionally change the joint type in the dropdown list:
    • Select Fixed.
      1. If the selection list is empty: select two geometric entities.
      2. The parts are moved to meet at their selected entities.
      3. Optionally enter an Offset value.
      4. Optionally enter a Rotation value.
      5. Optionally press to change the direction of the joint.
    • Select Revolute.
      1. If the selection list is empty: select two geometric entities.
      2. The parts are moved to meet at their selected entities.
      3. Optionally enter an Offset value.
      4. Optionally press to change the direction of the joint.
      5. Optionally check the Limits option.
        • Optionally enter an Angle min value.
        • Optionally enter an Angle max value.
    • Select Cylindrical.
      1. If the selection list is empty: select two geometric entities.
      2. Optionally press to change the direction of the joint.
      3. Optionally check the Limits option.
        • Optionally enter a Length min value.
        • Optionally enter a Length max value.
        • Optionally enter an Angle min value.
        • Optionally enter an Angle max value.
    • Select Slider.
      1. If the selection list is empty: select two geometric entities.
      2. Optionally enter a Rotation value.
      3. Optionally press to change the direction of the joint.
      4. Optionally check the Limits option.
        • Optionally enter a Length min value.
        • Optionally enter a Length max value.
    • Select Ball.
      1. If the selection list is empty: select two geometric entities.
    • Select Distance.
      1. If the selection list is empty: select two geometric entities.
      2. Optionally enter a Distance value.
      3. Optionally press to change the direction of the joint.
    • Select RackPinion.
      1. If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be perpendicular)
      2. Optionally enter a Pitch radius value.
    • Select Screw.
      1. If the selection list is empty: select two geometric entities of two different parts that have previously been used to define a Slider joint and a Revolute joint. (Slider direction and rotation axis must be parallel)
      2. Optionally enter a Pitch radius value.
    • Select Gears.
      1. If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
      2. Optionally enter a Radius 1 value.
      3. Optionally enter a Radius 2 value.
      4. Optionally check/uncheck the Reverse rotation option. (unchecking selects the Belt option)
    • Select Belt.
      1. If the selection list is empty: select two geometric entities of two different parts that have previously been used to define two different Revolute joints.
      2. Optionally enter a Radius 1 value.
      3. Optionally enter a Radius 2 value.
      4. Optionally check/uncheck the Reverse rotation option. (checking selects the Gears option)
      5. Optionally enter a Rotation value.
  6. The Parts are moved to meet at their selected entities.
  7. Press OK to finish the tool.

Notes

  • A fixed joint can be used as an actuator to control the motion of a kinematic simulation. Mouse wheel action in the Task panel immediately rearranges the connected parts.
    • Offset translates along its local Z axis, negative offsets are accepted.
    • Rotation revolves around its local Z axis, angles > 360° and even negative angles are accepted.

Properties

See also: Property editor.

A Fixed object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:

Data

Joint

  • DataActivated (Bool): This indicates if the joint is active.
  • DataDistance (Float): This is the distance of the joint. It is used only by the distance joint and the RackPinion (pitch radius), Screw, Gear, and Belt (radius1).
  • DataDistance2 (Float): This is the second distance of the joint. It is used only by the gear joint to store the second radius.
  • DataJoint Type (Ennumeration): The type of the joint. (Fixed, Revolute, Cylindrical, Slider, Ball, Distance, RackPinion, Screw, Gears, Belt)
  • DataOffset (Vector): This is the offset vector of the joint.
  • DataRotation (Float): This is the rotation of the joint.

Joint Connector 1

  • DataDetach1 (Bool): This prevents placement1 from recomputing, enabling custom positioning of the placement.
  • DataElement1 (String): The selected element of the first object.
  • DataObject1 (String): The first object of the joint.
  • DataPart1 (Link): The first Part of the joint.
  • DataPlacement1 (Placement): This is the local coordinate system within object1 that will be used for the joint.
  • DataVertex1 (String): The selected Vertex of the first object.

Joint Connector 2

  • DataDetach2 (Bool): This prevents placement2 from recomputing, enabling custom positioning of the placement.
  • DataElement2 (String): The selected element of the second object.
  • DataObject2 (String): The second object of the joint.
  • DataPart2 (Link): The second Part of the joint.
  • DataPlacement2 (Placement): This is the local coordinate system within object2 that will be used for the joint.
  • DataVertex2 (String): The selected Vertex of the second object.

Limits

  • DataAngle Max (Float): This is the maximum limit for the angle between both coordinate systems (between their X axes).
  • DataAngle Min (Float): This is the minimum limit for the angle between both coordinate systems (between their X axes).
  • DataEnable Limits (Bool): Is this joint using limits?
  • DataLength Max (Float): This is the maximum limit for the distance between both coordinate systems (along their Z axis).
  • DataLength Min (Float): This is the minimum limit for the distance between both coordinate systems (along their Z axis).