measure op• 데이터 종류: signal → table
• 호출: import fullseye as fs; fs.ledger.profile_params(p, dx=1.0, n_sampling=5)(구현을 직접 호출하려면 import roughness; roughness.profile_params(p, dx=1.0, n_sampling=5), 원장에서 가져오려면 opsroughness.get("profile_params"))
단면 거칠기 파라미터 Ra/Rq/Rz/Rt/Rp/Rv/Rsk/Rku(ISO 4287).
인수
p 대역 처리된 단면(1차원).
dx 샘플 간격. 파라미터 자체에는 영향이 없지만 sampling_length
보고에 필요하다(단위가 없으면 Rz의 조건을 쓸 수 없다).
n_sampling 기준 길이의 분할 수. ISO 4287의 기본값은 5.
★ Rz와 Rt를 둘 다 반환한다 —— 정의 차이를 여기서 없앤다 ISO 4287의 Rz는 "평가 길이를 n_sampling 등분하고, 각 구간의최대 산 높이 + 최대 골 깊이를 평균한 것". 한편 Rt는 평가 길이 전체의최대 고저차. 같은 단면이라도 값이 다르고, 게다가 문헌이나 장치에 따라 "Rz"가 어느 쪽을 가리키는지 흔들린다. 둘 다 반환하면 혼동할 수가 없다.
실측(512점, λc=80 µm로 자른 단면. 깊은 흠집을 1개 포함하는 행을 골랐다):
Rz(5구간의 평균) 1.5076
Rz_max(구간의 최대) 5.4706
Rt(평가 길이 전체) 5.4706
Rt / Rz 3.63
흠집이 1구간에만 있으므로, 5구간의 평균이 흠집의 기여를 1/5로 희석한다. 같은 단면에서 3.6배 다른 숫자가, 둘 다 "Rz"라고 불리고 있다. 같은 행에서 흠집만 빼면 Rt/Rz = 1.21까지 내려간다 —— 차이가 벌어지는 것은 고립된 특징이 있을 때뿐이므로, "우리 장치에서는 일치하니까 같다"는 반례에 부딪히지 않았을 뿐이다.
★ 함정 —— 단면 1개의 Rz는 면의 Sz를 대표하지 않는다가공 자국이 행 방향으로 달리는 면(512x512, 깊은 흠집 4개, λc=80 µm)에서, 단면을 171개씩 취한 실측:
• 결에 직교하는 열 방향의 Rq는 평행한 행 방향의 2.67배 (0.1853 대 0.0694). 같은 표면, 같은 장치에서 방향만 다를 뿐.
• 행 방향의 Rt는 최소 0.2765 / 최대 5.4706으로 19.8배 흩어진다.
• 면의 Sz(5.9694)의 80 %에 도달하는 단면은 171개 중 6개(3.5 %).
Rq는 몇 개로 충분하지만 Rz는 부족하다 —— 같은 1차원 단면이라도, 파라미터마다 필요한 개수가 다르다. Rz를 보고한다면 개수와 방향을반드시 덧붙일 것.
정의의 세부(규격으로부터의 일탈을 여기에 명시한다)
• 기준선은 평가 길이 전체의 평균선(최소제곱 직선이 아니다). 기울기는 surface_form_remove 또는 surface_filter로 먼저 제거해 둘 것.
• Rp / Rv / Rsk / Rku는 평가 길이 전체로 계산한다(구간 평균이 아니다).
• 평가 길이가 n_sampling으로 나누어떨어지지 않을 때는 나머지를 버린다. 버린점 수는 dropped_samples로 반환한다.
fail-closed(실패 시 거부)
• 1차원이 아님 / 8점 미만 / NaN 또는 Inf를 포함.
• n_sampling이 1 미만, 또는 구간당 4점 미만이 된다.
• 단면이 완전히 평탄(Rq=0).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• poc_food_cutting_measure — py -3.11 examples/poc_food_cutting_measure.py
• poc_surface_roughness — py -3.11 examples/poc_surface_roughness.py
table 를 입력으로 받는 것)—
measure)*Provenance: roughness.py — ROUGHNESS 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.