성공했을 때 돌아오는 값

들어 있는 값

"ok":true 인 측정 응답에는 아래 값이 전부 들어 있습니다.

이름

예

설명

at

"2026-11-22T03:38:42"

측정이 끝난 시각. PC 의 시계 기준이고 초 단위입니다

source

"upper"

누가 시켰는지. 상위 프로그램이면 늘 "upper" 입니다

recipeId

5

요청한 레시피 번호

ok

true

성공

offset

{"x":…,"y":…,"z":…,"rx":…,"ry":…,"rz":…}

옵셋 6값. 아래 “옵셋 읽는 법”

inlierShare

1.000

겹침 비율(0~1). 겹쳐 본 뒤 레퍼런스에 0.2 mm 안으로 붙은 점의 비율입니다. 1 에 가까울수록 잘 겹친 것입니다

fitness

1.000

짝이 잡힌 점의 비율(0~1)

inlierRmseMm

0.0097

짝 사이 거리의 평균(mm). 참고 값입니다

usedFallback

false

계산이 예비 방법을 썼는지. 참고 값입니다

elapsedMs

354

서버 안에서 걸린 시간(ms)

팁

옵셋을 써도 되는지는 ok 하나만 보고 정하세요. inlierShare 같은 품질 값을 상위 프로그램이 다시 따질 필요는 없습니다. 서버가 이미 기준에 맞는지 보고 ok 를 정했습니다. 품질 값은 기록해 두는 용도입니다.

옵셋 읽는 법

옵셋은 “지금 찍힌 물체가 레퍼런스를 등록할 때의 자리에서 얼마나 어긋났는가”입니다.

값

단위

뜻

x, y, z

mm

얼마나 밀렸는가

rx, ry, rz

도

얼마나 돌았는가

숫자를 쓰기 전에 알아야 할 약속이 넷 있습니다.

  1. 기준은 센서입니다. 로봇이 아닙니다. x, y, z 축은 센서가 보는 방향 기준입니다. 이번 판에는 로봇과 센서의 위치 관계가 연결돼 있지 않습니다. 로봇 보정에 쓰려면 상위 프로그램이나 로봇 쪽에서 좌표를 바꿔야 합니다.

  2. 방향은 “찍힌 물체를 레퍼런스 자리로 되돌리는 양”입니다. 물체가 등록 때보다 x 로 +3 mm 가 있으면 옵셋 x 는 약 -3 입니다(3 mm 옮긴 장면에서 -3.001 이 나왔습니다).

  3. 회전의 중심은 물체의 한가운데입니다. 센서의 원점이 아닙니다.

  4. 회전 세 값은 내인성 XYZ 오일러 각입니다. 회전 행렬로는 R = Rx(rx) · Ry(ry) · Rz(rz) 입니다. 로봇 쪽 각도 규약과 같은지 꼭 맞춰 보세요.

경고

제품에서 쓸 옵셋의 방향과 부호는 아직 정해지지 않았습니다. 부호를 코드 여러 곳에 박아 두지 마세요.

알아 둘 것

참고

원통처럼 제 축 둘레로 굴려도 겉모양이 같은 물체는 “구른 양”을 잴 수 없습니다. 서버는 그런 물체를 “구르지 않았다”고 정하고 그 값을 0 으로 냅니다. 잰 값이 아닙니다. 자세한 것은 program/operation/README.md 의 “약한 방향 보정” 절에 있습니다.

숫자는 소수 넷째 자리까지 적힙니다. -0.0000 처럼 음수 0 이 올 수 있습니다. 숫자로 읽으면 그냥 0 입니다.