pad_tactile_read — DRIVE pegtactile op

• 데이터 종류: table × table → table

• 호출: import fullseye as fs; fs.ledger.pad_tactile_read(frame: 'dict', pad: 'dict', ctx=None, track=None, pixelwise: 'bool' = True, torsion_model: 'str' = 'partial_slip') -> 'dict'(구현을 직접 호출하려면 import pegtactile; pegtactile.pad_tactile_read(frame: 'dict', pad: 'dict', ctx=None, track=None, pixelwise: 'bool' = True, torsion_model: 'str' = 'partial_slip') -> 'dict', 원장에서 가져오려면 opsdrive.get("pad_tactile_read"))

사용법

> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.

パッド 1 枚の像 → (P̂, q̂, ねじり)。

P̂ = 陰影 → photometric の法線(:func:tacsim.membrane_recover)→ 接触半径(中心は既知 = パッド中央;`pixelwise` なら

:func:tacsim.contact_radius_fit_pixelwise、偽ならビン版 :func:tacsim.contact_radius_fit = 罠の対照)→ :func:tacsim.hertz_force。

q̂ = マーカー追跡(:func:tacslip.marker_track、`track` で渡せば省く)→ 法線荷重の ūr(P̂ から閉形式)を引く → 2 成分の Mindlin

当てはめ(:func:tacslip.mindlin_fit_vector)。ねじり = 当てはめたせん断場を引いた残りに、固着核(r < 0.6 â)で剛体回転

(:func:tactorque.rigid_rotation_fit)→ 無滑りの関係 M = (16Gâ³/3)ω(Reissner–Sagoci)が `torsion_no_slip`。

★`torsion_model="partial_slip"(既定、2026-10-06 から)では、それを部分滑りの数値解(:func:cuttouch.torsion_partial_slip` の

`from_no_slip_read)で直した値を torsion` に返す —— Hertz 接触のねじりは縁から必ず滑るので、無滑りの関係のままだと M を過大に

読む(全滑りまでの比 0.5 で +33 %、0.8 で +85 %)。`"no_slip" は 0.4.0 までの値(torsion = torsion_no_slip`)。

`torsion_c_over_a(固着円の半径 / a)と torsion_readable`(固着円が当てはめの核 r < 0.6a を含み全滑りでない —— 偽なら数は返すが

当てにならない)も返す。第 2 実装 `Q_stick = 固着核の一様変位 δ̂ を Mindlin の δx 式で逆に解いた値(μ は較正値)。返り P・a`・

`q(2,)・Q・phi・torsion・torsion_no_slip・torsion_model・torsion_c_over_a・torsion_readable・c_over_a`・

`Q_stick・matched・rms_px(当てはめの残差)・track。**Raises** ValueError: frame に rgb・shading` が無い、

追跡できたマーカーが 3 未満、torsion_model の綴り違い。

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_knife_tactile_toughness — py -3.11 examples/poc_knife_tactile_toughness.py

• poc_peg_insertion_tactile — py -3.11 examples/poc_peg_insertion_tactile.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

같은 카테고리(pegtactile)

pad_params · pad_context · peg_wrench_to_pad_loads · pad_loads_to_peg_wrench · pad_shear_asymmetry · pad_marker_displacement · pad_tactile_frame · contact_candidates


*Provenance: pegtactile.py — DRIVE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.