ble_server
読み取り中…
検索中…
一致する文字列を見つけられません
ble_server.converter 名前空間

BLEペイロードを検証し、ROS 2メッセージへ変換する。 [詳解]

クラス

class  ConvertResult
 コンバーター1回の変換結果。 [詳解]
class  IPayloadConverter
 BLE受信バイト列を ひとつの メッセージ型へ変換する契約。 [詳解]
class  DispatcherConverter
 type フィールドで適切な :class:IPayloadConverter へ振り分ける。 [詳解]
class  JsonPolygonConverter
 cleaning_zone JSONを検証し、PolygonStampedへ変換する。 [詳解]
class  JsonInitialPoseConverter
 initial_pose JSONを検証し、PoseWithCovarianceStampedへ変換する。 [詳解]

関数

DispatcherConverter build_default_dispatcher (str default_frame_id="map", float max_coord_abs_val=1000.0, str cleaning_zone_topic="/cleaning_zone", str initial_pose_topic="/initialpose")
 デフォルト設定の :class:DispatcherConverter を組み立てて返す。
float _signed_area (list points)
 平面ポリゴンの符号付き面積を頂点座標から求める [m^2]。
bool _has_duplicate_points (list points)
 座標が完全一致する重複頂点があるか判定する。
float _cross (tuple o, tuple a, tuple b)
 点oからa、bへのベクトルの2次元外積を返す。
bool _segments_cross (tuple a, tuple b, tuple c, tuple d)
 線分abとcdが真に交差するか判定する。端点接触は交差に含めない。
bool _has_self_intersection (list points)
 閉じたポリゴンの隣接しない辺に真性交差があるか判定する。

変数

 logger = logging.getLogger(__name__)

詳解

BLEペイロードを検証し、ROS 2メッセージへ変換する。

設計方針

  • IPayloadConverter はtype文字列ひとつを担当する単一責任コンバーター。 handled_type プロパティで担当を宣言し、convert で変換を行う。
  • DispatcherConverter が受信JSONの type を見て適切なコンバーターへ ディスパッチする。新しいメッセージ型は DispatcherConverter に登録する だけでよく、既存コンバーターは無変更で追加できる(開放/閉鎖原則)。
  • BleReceiverNode は DispatcherConverter だけを知り、配信先トピック の選択はコンバーター側が返す ConvertResult を介して行う。

関数詳解

◆ _cross()

float _cross ( tuple o,
tuple a,
tuple b )
protected

点oからa、bへのベクトルの2次元外積を返す。

converter.py の 398 行目に定義があります。

◆ _has_duplicate_points()

bool _has_duplicate_points ( list points)
protected

座標が完全一致する重複頂点があるか判定する。

converter.py の 388 行目に定義があります。

◆ _has_self_intersection()

bool _has_self_intersection ( list points)
protected

閉じたポリゴンの隣接しない辺に真性交差があるか判定する。

converter.py の 414 行目に定義があります。

◆ _segments_cross()

bool _segments_cross ( tuple a,
tuple b,
tuple c,
tuple d )
protected

線分abとcdが真に交差するか判定する。端点接触は交差に含めない。

converter.py の 403 行目に定義があります。

◆ _signed_area()

float _signed_area ( list points)
protected

平面ポリゴンの符号付き面積を頂点座標から求める [m^2]。

converter.py の 377 行目に定義があります。

◆ build_default_dispatcher()

DispatcherConverter build_default_dispatcher ( str default_frame_id = "map",
float max_coord_abs_val = 1000.0,
str cleaning_zone_topic = "/cleaning_zone",
str initial_pose_topic = "/initialpose" )

デフォルト設定の :class:DispatcherConverter を組み立てて返す。

Args: default_frame_id: JSONに frame_id がない場合の座標フレーム。 max_coord_abs_val: 座標の絶対値上限 [m]。 cleaning_zone_topic: cleaning_zone メッセージの配信先トピック名。 initial_pose_topic: initial_pose メッセージの配信先トピック名。 AMCLが購読する /initialpose に合わせるのが通常の運用。

将来新しいメッセージ型を追加する際はここに register を追記する。

converter.py の 342 行目に定義があります。

変数詳解

◆ logger

ble_server.converter.logger = logging.getLogger(__name__)

converter.py の 27 行目に定義があります。