Skip to content

W24Roughness

W24Roughness

Roughness object

Attributes: roughness_id: Unique UUID4 identifier

label: RoughnessLabel

Properties

  • position: Refer to #/definitions/W24BaseFeaturePosition.

  • roughness_id (string)

  • label: Refer to #/definitions/W24RoughnessLabel.

Definitions

  • W24BaseFeatureCoordinate (object): Coordinate point
    Attributes: x: x position normalized by the thumbnail's width
    y: y position normalized by the thumbnail's height.

  • x (number)

  • y (number)

  • W24BaseFeaturePosition (object): Position of the Feature on the individual thumbnails normalized by the width and height of each thumbnail.
    Each features position is indicated as a list of coordinates. If the list only has two elements, you are dealing with a line. If it has four or more, you are looking at a polygon
    Attributes: page: Position of the Feature on the Page thumbnail
    sheet: Position of the Feature on the Sheet thumbnail
    sectional: Position of the Feature on the Sectional thumbnail.

  • sheet (array)

    • Items: Refer to #/definitions/W24BaseFeatureCoordinate.

  • canvas (array)

    • Items: Refer to #/definitions/W24BaseFeatureCoordinate.

  • sectional (array)

    • Items: Refer to #/definitions/W24BaseFeatureCoordinate.

  • W24RoughnessStandard (string): Most standards that define the surface roughness use very similar symbols. However, the position of the fields varies.
    The standards listed here are understood and supported by the API.
    NOTE: the ISO 1302 standard exists in four different versions, these releases substantially modified the position and structure of the roughness symbols.
    NOTE: this list is not exhaustive, many countries have specified their own standards over the years. Do not hesitate to reach out if you wish us to implement another standard. Must be one of: ['ISO 1302:1978', 'ISO 1302:1992', 'ISO 1302:2002', 'ISO 21920-1:2021', 'ASME Y14.36-1978', 'ASME Y14.36M-1996', 'ASME Y14.36-2018'].

  • W24RoughnessMaterialRemovalType (string): Most standard allow the designer to specify whether material removal is required or prohibited.
    By default both options are allowed. Must be one of: ['UNSPECIFIED', 'PROHIBITED', 'REQUIRED'].

  • W24RoughnessDirectionOfLay (string): The lay of the roughness limits the manufacturing process and is sometimes required for the application. Must be one of: ['=', '⟂', 'X', 'M', 'C', 'R', 'P'].

  • W24ManufacturingMethod (object): Manufacturing method specified on the drawing. Currently only the blurb is available.
    Attributes: blurb: Manufacturing method as specified on the drawing.

  • blurb (string)

  • W24RoughnessConditionType (string): Roughnesses can specify, the upper limit, the lower limit and the average. Must be one of: ['U', 'L', 'A'].

  • W24RoughnessFilterType (string): When measuring the roughness, different filter types will result in different results. To reduce this source of ambiguity, the designer can specify the filter to be used.
    NOTE: this list is not exhaustive. If you need us to support another filter method, please reach out. Must be one of: ['G', 'RG', 'S', '"2RC"'].

  • W24RoughnessParameter (string): Roughness Parameter that is specified.
    NOTE: this list is not exhaustive, but covers the most frequently used parameters. Must be one of: ['AA', 'CLA', 'PVA', 'RMS', 'Pa', 'PC', 'Pku', 'Pp', 'Pq', 'Psk', 'Pt', 'Pv', 'Py', 'Pz', 'Ra(DIN)', 'Ra(ISO)', 'Rc', 'Rku', 'Rp', 'Rq', 'Rsk', 'Rt', 'Rv', 'Ry', 'Rz', 'Wa', 'Wc', 'Wku', 'Wp', 'Wq', 'Wsk', 'Wt', 'Wv', 'Wy', 'Wz', 'N'].

  • W24RoughnessEvaluationLengthType (string): An enumeration. Must be one of: ['LENGTH', 'LAMBDA_C_MULTIPLE'].

  • W24UnitLength (string): Enum of the supported length units . Must be one of: ['METER', 'DECIMETER', 'CENTIMETER', 'MILLIMETER', 'FOOT', 'INCH', 'MICRO_INCH'].

  • W24RoughnessEvaluationLength (object): For sophisticated application, the sample needs to be taken over a longer distances. This is specified the either the sampling length in millimeter (ISO 3012:1974, ISO 3012:1978, ISO 3012:1992) or as multiple of the main lambda (ISO 3012:2002 and ISO 3012:2021).

    Attributes: evaluation_length_type: Sampling length type that is specified by the applicable standard
    length: evaluation length in the specified units.
    length_unit: Millimeter for both the ISO and ASME standards
    lambda_c_multiple: multiple of the main cutoff lambda_c.

  • evaluation_length_type: Refer to #/definitions/W24RoughnessEvaluationLengthType.

  • length (number)

  • length_unit: Refer to #/definitions/W24UnitLength.

  • lambda_c_multiple (number)

  • W24RoughnessAcceptanceCriterion (string): The designer can specify whether to apply the 16%-rule, the maximum- or medium- rule when deciding whether a surface complies with the specifications. Must be one of: ['16%', 'max', 'mean'].

  • W24RoughnessGrade (object): ISO Roughness Grade
    Attributes: blurb: String representation for human consumption
    grade: Roughness Grade in the range N01 to N12. Valid values are N01, N0, N1, N2, N3, N4, N5, N6, N7, N8, N9, N10, N11, N12, N13, N14.

  • blurb (string)

  • grade (string)

  • W24RoughnessCondition (object): Roughness Label
    Attributes: blurb: String representation of the Roughness for human consumption.
    condition_type: Roughness Side that is specified (upper or lower). We automatically determine this value depending on the standard and the position of the parameter
    filter_type: Filter Type to use when measuring the surface. When not specified on the drawing, we set the default value according to the applicable standard.
    lambda_s: Filter bandwidth microroughness cutoff lambda_s. When not specified, we determine the default value based on the standard and the value_limit.
    lambda_c: Filter bandwidth main cutoff lambda_c. When not specified, we determine the default value based on the standard and the value_limit.
    parameter: Parameter to be measured

    characteristic: Method of converting the 2D-measurement into a single number
    evaluation_length: For sophisticated application, the roughness needs to be evaluated over a longer distances. This is specified the either the sampling length in millimeter (ISO 3012:1974, ISO 3012:1978, ISO 3012:1992) or as multiple of the main lambda (ISO 3012:2002 and ISO 3012:2021).
    acceptance_criterion: Designers can specify what rule to apply when deciding whether a measured tolerance complies with the requirements
    value_limit: Specification limit
    roughness_grade: ISO roughness grade that the roughness specifications correspond to. IMPORTANT: this allows you to deal with all the standards in a simple way.

  • blurb (string)

  • condition_type: Refer to #/definitions/W24RoughnessConditionType.

  • filter_type: Refer to #/definitions/W24RoughnessFilterType.

  • lambda_s (number)

  • lambda_c (number)

  • parameter: Refer to #/definitions/W24RoughnessParameter.

  • evaluation_length: Refer to #/definitions/W24RoughnessEvaluationLength.

  • acceptance_criterion: Refer to #/definitions/W24RoughnessAcceptanceCriterion.

  • value (number)

  • roughness_grade: Refer to #/definitions/W24RoughnessGrade.

  • W24UnitSystem (string): Unit System that is used for a certain feature . Must be one of: ['METRIC', 'IMPERIAL'].

  • W24RoughnessWaviness (object): Roughness Waviness as defined in the ASME-Y14-36
    Attributes: waviness_height: Waviness height in inch waviness_width: Waviness width in inch.

  • waviness_height (number)

  • waviness_width (number)

  • W24RoughnessLabel (object): Roughness Label
    Attributes: blurb: String for human consumption
    blurb_html: HTML for human consumption. The complex structure of the symbol makes this necessary.
    standard : Standard in which the Roughness Symbol is written NOTE: there are multiple standards that are in use
    machining_allowance: Machining Allowance in millimeter of micro-inch. See the unit attribute.
    material_removal_type: The MaterialRemovalType specifies whether material must / must not be removed.
    applies_all_around: Boolean value that specifies whether the roughness applies to all surfaces around
    direction_of_lay: The lay of the roughness limits the manufacturing process and is sometimes required for the application.
    manufacturing_method: Method by which to achieve the roughness
    conditions: Roughness conditions
    unit_system: Unit system that is used for the roughness. We are not using the explicit units as the different attributes have different units (e.g, micro and nano meters)
    waviness: Waviness defined in ASME standards.

  • blurb (string)

  • blurb_html (string)

  • standard: Refer to #/definitions/W24RoughnessStandard.

  • machining_allowance (number)

  • material_removal_type: Refer to #/definitions/W24RoughnessMaterialRemovalType.

  • applies_all_around (boolean)

  • direction_of_lay: Refer to #/definitions/W24RoughnessDirectionOfLay.

  • manufacturing_method: Refer to #/definitions/W24ManufacturingMethod.

  • conditions (array)

    • Items: Refer to #/definitions/W24RoughnessCondition.

  • unit_system: Refer to #/definitions/W24UnitSystem.

  • waviness: Refer to #/definitions/W24RoughnessWaviness.