Measures

Measures are functions that compute a result from data captured from the geometry area. Measures are application-related objects and they will not be displayed in the dictionary if you do not have the right product installed (Part Design or Generative Shape Design for instance).

Sample: KwrMeasuresWiz.CATPart

  • distance (Body, Body): Length
    Returns the distance between two bodies of a part.
  • distancedir (Body, Body, Direction): Length
    Measures the distance between two bodies of a part in both directions and returns the minimum distance between them. (volume bodies are not taken into account).
  • minimumCurvatureRadius (Curve): Length
    Enables the user to measure the minimum radius of curvature for any type of curve.
  • nbDomains (Body): Integer
     For all types of items, enables the user to compute the number of domains.
  • length (Curve): Length
    Returns the total length of a curve.
  • length (Curve, Point, Boolean): Length
    Returns the length of a curve segment located between Point1 and one end of the curve.
    Modifying the boolean value allows you to retrieve the length from the specified point to the other end.
  • length (Curve, Point, Point): Length
    Returns the length of a curve segment delimited by two points. 
  • area (Surface): Area
    Returns the area of a surface generated by the Generative Shape Design product (an extruded surface for example).
  • area (Curve): Area
    Returns the area delimited by a curve.
  • perimeter (Surface,...):Length
    Returns the perimeter of a surface. It can take several surface features in input. The perimeter function sums up the perimeter of each surface. The returned value is a length.
  • Point   >  coord (rank: Integer): Length
    Returns the coordinates of a point. Returns X if 1 is specified, Y if 2 is specified, Z if 3 is specified.
  • volume (closed_surface: Surface, ...): Volume
    Returns the volume of a closed surface.
  • volume (Volume geometry,...): Volume
    Returns the volume of a volume.
  • angle (center: Point, pt1: Point, pt2: Point): Angle
    Returns the angle between the lines "C-Point1" and "C-Point2".

    ReturnValue

    Let line1 be the line of start point center and end point pt1.

    Let line2 be the line of start point center and end point pt2.

    Then angle(center, pt1, pt2) is defined as: angle(line1, line2).

    Example

    angle(PartBody\Intersect.1 ,PartBody\Point.9 ,PartBody\Point.10 )
    angle(PartBody\Intersect.1 ,PartBody\Point.10 ,PartBody\Point.9 )
  • angle (Direction, Direction): Angle
    Returns the angle between two directions.
     
    ReturnValue

    The input directions define together two geometrical (i.e. non-oriented) angles whose sum equals 360°: one is between 0° and 180° and the other one is between 180° and 360°.

    The angle() constructor returns the geometrical angle between the input directions which is between 0° and 180°.

    We have:

    angle(direction1, direction2) = angle(direction2, direction1), and

    angle(direction1, -direction2) = 180° - angle(direction1, direction2).

    Example

    angle(direction(`PartBody\Line.1`) ,direction(`PartBody\Line.2`) )
    angle(direction(`PartBody\Line.1`) ,direction(PartBody\Plane.1) )
    angle(direction(PartBody\Plane.1) ,direction(`PartBody\Line.1`) )
    angle(direction(`xy plane`) ,direction(PartBody\Plane.1) )
  • angle (Line, Line): Angle
    Returns the angle between two lines.
     
    ReturnValue

    The input lines have got a direction. Those two directions define together two geometrical (i.e. non-oriented) angles whose sum equals 360°: one is between 0° and 180° and the other one is between 180° and 360°.

    The angle() constructor returns the geometrical angle between the input lines’ directions which is between 0° and 180°.

    Let line3 be an Invert Feature whose element to invert is line2. We have:

    angle(line1, line2) = angle(line2, line1), and

    angle(line1, line3) = 180° - angle(line1, line2).

    Example

    angle(`PartBody\Line.1` ,`PartBody\Line.2` )
    angle(`PartBody\Line.1` ,`PartBody\Inverse.1 (Line.2 inversed)` )
    angle(`PartBody\Line.2` ,`PartBody\Line.1` )
    angle(`PartBody\Line.1` ,`PartBody\Line.3 (included in xy plane)` )
    angle(`PartBody\Line.1` ,`PartBody\Line.4 (included in zx plane)` )
    angle(`PartBody\Line.1` ,`PartBody\Inverse.2 (Line.3 inversed)` )
  • angle (Plane, Plane): Angle
    Returns the angle between two planes.
     
    ReturnValue

    The input planes have got a normal. Those two normals define together two geometrical (i.e. non-oriented) angles whose sum equals 360°: one is between 0° and 180° and the other one is between 180° and 360°.

    The angle() constructor returns the geometrical angle between the input planes’ normals which is between 0° and 180°.

    Let plane3 be an Invert Feature whose element to invert is plane2. We have:

    angle(plane1, plane2) = angle(plane2, plane1), and

    angle(plane1, plane3) = 180° - angle(plane1, plane2).

    Example

    angle(`xy plane` ,PartBody\Plane.1 )
    angle(PartBody\Plane.1 ,`xy plane` )
    angle(`xy plane` ,`PartBody\Plane.1 (inversed)` )
    angle(`PartBody\Plane.1 (inversed)` ,`xy plane` )
    angle(`PartBody\xy plane (inversed)` ,PartBody\Plane.1 )
    angle(PartBody\Plane.1 ,`PartBody\xy plane (inversed)` )
    angle(`PartBody\xy plane (inversed)` ,`PartBody\Plane.1 (inversed)` )
    angle(`PartBody\Plane.1 (inversed)` ,`PartBody\xy plane (inversed)`
  • angleoriented (Direction, Direction, Direction): Angle
    Returns the angle between two directions and oriented by a third direction.
  • angleoriented (Line, Line, Direction): Angle
    Returns an angle between two lines and oriented by the direction.
  • angleoriented (Plane, Plane, Direction): Angle
    Returns an angle between two planes and oriented by the direction.
  • curvature (crv: Curve, pt: Point): Real
    Returns the curvature of a curve in a given point.