Skip to content

Reference Roughnesses

Reference roughness is a simplified roughness symbol that is used to avoid repeating a complicated indication multiple times, or when there is a space constraint on the drawing. The meaning of this simplified symbol is defined on the drawing, mostly near the workpiece in question, near the title block, or in a dedicated space for general notes.

  • Simplified roughness symbol along with its meaning

Reference roughness symbol next to explanatory legend

Models

The data models are defined in the following two models:

Through Title Block

Extracted information can be accessed from the following Model.

title: W24RoughnessReference description: Reference container for surface-roughness notes. Holds an optional position, a human-readable blurb, a reference_label (W24RoughnessLabel placeholder such as “material removal not permitted”), and a reference_value (the full roughness specification applied when the label appears on the workpiece).

W24RoughnessReference

Roughness Reference

Attributes:

blurb: String for human consumption

reference_label: Placeholder for the roughness. We are using a reference label here to allow the full scope of the roughness to be specified. Sometimes we see a pure "material removal not permitted" symbol as placeholder.

reference_value: Meaning of the roughness_label, explaining what surface roughness is applicable when the roughness_label is specified on a workpiece.

Properties

  • position: Default: None.

  • blurb (string)

  • reference_label: Refer to #/$defs/W24RoughnessLabel.

  • reference_value: Refer to #/$defs/W24RoughnessLabel.

Requesting the General Roughnesses

```python

from werk24 import Hook, W24AskTitleBlock from werk24.models.techread import W24TechreadMessage from werk24.utils import w24_read_sync

define a function to read a file and return it as bytes

from . import get_drawing_bytes

def recv_title_block(message: W24TechreadMessage) -> None: """ Print the Weight when we received it """ if message.is_successful: print(message.payload_dict.get('weight')) else: print("Exceptions occurred: {message.exceptions}")

if name == "main":

# get your drawing bytes from a file or buffer
drawing_bytes = get_drawing_bytes()

# define what information you want to receive from the API
# and what shall be done when the info is available.
hooks = [Hook(ask=W24AskTitleBlock(), function=recv_title_block)]

# submit the request to the Werk24 API
w24_read_sync(drawing_bytes, hooks)

```