weldx.welding.groove.iso_9692_1.get_groove#

weldx.welding.groove.iso_9692_1.get_groove(groove_type, workpiece_thickness=None, workpiece_thickness2=None, root_gap=None, root_face=None, root_face2=None, root_face3=None, bevel_radius=None, bevel_radius2=None, bevel_angle=None, bevel_angle2=None, groove_angle=None, groove_angle2=None, special_depth=None, code_number=None)#

Create a Groove from weldx.tags.core.groove.

Parameters:
  • groove_type (str) –

    String specifying the Groove type:

    • VGroove

    • UGroove

    • IGroove

    • UVGroove

    • VVGroove

    • HVGroove

    • HUGroove

    • DVGroove

    • DUGroove

    • DHVGroove

    • DHUGroove

    • FFGroove

  • workpiece_thickness (Union[Quantity, str, None]) – workpiece thickness (Default value = None)

  • workpiece_thickness2 (Union[Quantity, str, None]) – workpiece thickness if type needs 2 thicknesses (Default value = None)

  • root_gap (Union[Quantity, str, None]) – root gap, gap between work pieces (Default value = None)

  • root_face (Union[Quantity, str, None]) – root face, upper part when 2 root faces are needed, middle part when 3 are needed (Default value = None)

  • root_face2 (Union[Quantity, str, None]) – root face, the lower part when 2 root faces are needed. upper part when 3 are needed - used when min. 2 parts are needed (Default value = None)

  • root_face3 (Union[Quantity, str, None]) – root face, usually the lower part - used when 3 parts are needed (Default value = None)

  • bevel_radius (Union[Quantity, str, None]) – bevel radius (Default value = None)

  • bevel_radius2 (Union[Quantity, str, None]) – bevel radius - lower radius for DU-Groove (Default value = None)

  • bevel_angle (Union[Quantity, str, None]) – bevel angle, usually the upper angle (Default value = None)

  • bevel_angle2 (Union[Quantity, str, None]) – bevel angle, usually the lower angle (Default value = None)

  • groove_angle (Union[Quantity, str, None]) – groove angle, usually the upper angle (Default value = None)

  • groove_angle2 (Union[Quantity, str, None]) – groove angle, usually the lower angle (Default value = None)

  • special_depth (Union[Quantity, str, None]) – special depth used for 4.1.2 Frontal-Face-Groove (Default value = None)

  • code_number – String, used to define the Frontal Face Groove (Default value = None)

Returns:

an Groove from weldx.tags.core.groove

Return type:

type

Examples

Create a V-Groove:

get_groove(groove_type="VGroove",
           workpiece_thickness=Q_(9, "mm"),
           groove_angle=Q_(50, "deg"),
           root_face=Q_(4, "mm"),
           root_gap=Q_(2, "mm"))

Create a U-Groove:

get_groove(groove_type="UGroove",
           workpiece_thickness=Q_(15, "mm"),
           bevel_angle=Q_(9, "deg"),
           bevel_radius=Q_(6, "mm"),
           root_face=Q_(3, "mm"),
           root_gap=Q_(1, "mm"))
Raises:

ValueError – When passing negative parameter values.

Notes

Each groove type has a different set of attributes which are required. Only required attributes are considered. All the required attributes for Grooves are in Quantity values from pint and related units are accepted. Required Groove attributes:

IGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

VGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

alpha: groove_angle

The groove angle is the whole angle of the V-Groove. It is a pint Quantity in degree or radian.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the length of the Y-Groove which is not part of the V. It can be 0.

UGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

beta: bevel_angle

The bevel angle is the angle that emerges from the circle segment. Where 0 degree would be a parallel to the root face and 90 degree would be a parallel to the workpiece.

R: bevel_radius

The bevel radius defines the length of the radius of the U-segment. It is usually 6 millimeters.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part below the U-segment.

UVGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

alpha: groove_angle

The groove angle is the whole angle of the V-Groove part. It is a pint Quantity in degree or radian.

beta: bevel_angle

The bevel angle is the angle that emerges from the circle segment. Where 0 degree would be a parallel to the root face and 90 degree would be a parallel to the workpiece.

R: bevel_radius

The bevel radius defines the length of the radius of the U-segment. It is usually 6 millimeters.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

h: root_face

The root face is the height of the V-segment.

VVGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

alpha: groove_angle

The groove angle is the whole angle of the lower V-Groove part. It is a pint Quantity in degree or radian.

beta: bevel_angle

The bevel angle is the angle of the upper V-Groove part. It is a pint Quantity in degree or radian.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part below the lower V-segment. It can be 0 or None.

h: root_face2

This root face is the height of the part of the lower V-segment and the root face c.

HVGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

beta: bevel_angle

The bevel angle is the angle of the V-Groove part. It is a pint Quantity in degree or radian.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part below the V-segment.

HUGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

beta: bevel_angle

The bevel angle is the angle that emerges from the circle segment. Where 0 degree would be a parallel to the root face and 90 degree would be a parallel to the workpiece.

R: bevel_radius

The bevel radius defines the length of the radius of the U-segment. It is usually 6 millimeters.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part below the U-segment.

DVGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

alpha: groove_angle

The groove angle is the whole angle of the upper V-Groove part. It is a pint Quantity in degree or radian.

alpha2: groove_angle

The groove angle is the whole angle of the lower V-Groove part. It is a pint Quantity in degree or radian.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part between the V-segments.

h1: root_face2

The root face is the height of the upper V-segment. Only c is needed.

h2: root_face3

The root face is the height of the lower V-segment. Only c is needed.

DUGroove:
t: workpiece_thickness

The workpiece thickness is a length Quantity, e.g.: “mm”. It is assumed that both workpieces have the same thickness.

beta: bevel_angle

The bevel angle is the angle that emerges from the circle segment. Where 0 degree would be a parallel to the root face and 90 degree would be a parallel to the workpiece. The upper U-segment.

beta2: bevel_angle2

The bevel angle is the angle that emerges from the circle segment. Where 0 degree would be a parallel to the root face and 90 degree would be a parallel to the workpiece. The lower U-segment.

R: bevel_radius

The bevel radius defines the length of the radius of the upper U-segment. It is usually 6 millimeters.

R2: bevel_radius2

The bevel radius defines the length of the radius of the lower U-segment. It is usually 6 millimeters.

b: root_gap

The root gap is the distance of the 2 workpieces. It can be 0 or None.

c: root_face

The root face is the height of the part between the U-segments.

h1: root_face2

The root face is the height of the upper U-segment. Only c is needed.

h2: root_face3

The root face is the height of the lower U-segment. Only c is needed.

DHVGroove:

This is a special case of the DVGroove. The values of the angles are interpreted here as bevel angel. So you have only half of the size. Accordingly the inputs beta1 (bevel angle) and beta2 (bevel angle 2) are used.

DHUGroove:

This is a special case of the DUGroove. The parameters remain the same.

FFGroove:

These grooves are identified by their code number. These correspond to the key figure numbers from the standard. For more information, see the documentation.