LeRobot documentation

カメラ

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

カメラ

カメラは、ポリシーが参照する画像の観測データを供給します。OpenCV、Intel RealSense、Reachy 2 といったすべてのバックエンドは Camera インターフェースを実装しているため、ハードウェアを切り替えてもフレームを読み取るコードは変更する必要がありません。

カメラの選択と設定についてはCameras guideを、コアセット以外のデバイスについてはThird-Party Cameras & Sensorsを参照してください。

カメラ

class lerobot.cameras.Camera

< >

( config: CameraConfig )

パラメータ

  • fps (float | None) — 設定または測定された秒あたりのフレーム数
  • width (int | None) — フレームの幅(ピクセル単位)
  • height (int | None) — ピクセル単位のフレームの高さ

カメラ実装のベースクラス。

異なるバックエンド間でカメラ操作の標準的なインターフェースを定義します。 サブクラスは、すべての抽象メソッドを実装する必要があります。

基本的なカメラのプロパティ(FPS、解像度)とコア操作を管理します:

  • 接続/切断
  • フレームキャプチャ(同期/非同期/最新)

connect

< >

( warmup: bool = True )

パラメータ

  • warmup — True (デフォルト)の場合、返却前にウォームアップフレームをキャプチャします。キャプチャ設定の調整に時間がかかるカメラに便利です。Falseの場合、ウォームアップフレームをスキップします。

カメラへの接続を確立します。

切断

< >

( )

カメラから切断し、リソースを解放します。

読み取り

< >

( ) → np.ndarray

戻り値

np.ndarray

numpy配列としてキャプチャされたフレーム。

カメラから1フレームを同期的にキャプチャして返します。

これはブロッキング呼び出しであり、ハードウェアとそのSDKを待機します。

async_read

< >

( timeout_ms: float = Ellipsis ) → np.ndarray

パラメータ

  • timeout_ms — 新しいフレームを待機する最大時間(ミリ秒)。 デフォルトは200ms(0.2秒)です。

戻り値

np.ndarray

numpy配列としてキャプチャされたフレーム。

例外

TimeoutError

  • TimeoutError — timeout_ms 以内に新しいフレームが届かない場合。

最新の新しいフレームを返します。

このメソッドは、バックグラウンドスレッドによってキャプチャされた最新のフレームを取得します。 バッファに新しいフレームが既に利用可能である場合(前回の呼び出し以降にキャプチャされた場合)、 即座にそれを返します。

バッファが空の場合、または最新のフレームが以前のasync_read呼び出しによって既に消費済みの場合のみ、最大timeout_msまでブロックします。

本質的に、このメソッドは最新かつ未消費のフレームを返します。必要に応じて、指定されたタイムアウト内に新しいフレームが到着するまで待機します。

使用方法:

  • 処理された各フレームが常に最新であることを保証したい制御ループに最適です。これにより、ループがカメラのFPSに効果的に同期されます。
  • タイムアウトの原因としては、カメラのFPSが非常に低いこと、処理負荷が高いこと、またはカメラが切断されていることが挙げられます。

find_cameras

< >

( ) → List[Dict[str, Any]]

戻り値

List[Dict[str, Any]]

辞書のリストで、各辞書には検出されたカメラに関する情報が含まれます。

システムに接続されている利用可能なカメラを検出します。

CameraConfig

クラス lerobot.cameras.CameraConfig

< >

( fps: int | None = Nonewidth: int | None = Noneheight: int | None = None )

make_cameras_from_configs

lerobot.cameras.make_cameras_from_configs

< >

( camera_configs: dict )

Update on GitHub