このページの一部は機械翻訳であり、まだ人による確認が行われていません。

変更履歴

4.0.0

2026年10月5日

API

  • パス失敗診断を追加しました。Motion::Planner::path の呼び出しが失敗したときに追加の診断情報を取得するには、Motion::PathRequest::diagnoseFailures を有効にしてください。

  • Motion::ReplaceableTool と Motion::ToolGeometry を追加しました。Motion::Planner::setReplaceableTool は、ツールのメッシュを直接受け取る従来のオーバーロードに代わり、Motion::ReplaceableTool を受け取るようになりました。

  • Goals を、新しい Motion::ConfigurationGoal を保持する Motion::ConfigurationGoals に置き換えました。これは、fromConfigurations に代わり、コンフィグレーションまたはゴールのリストから暗黙的に構築されるようになりました。ゴールは、jointConfigurations に代わり、Motion::ConfigurationGoals::goals で読み取れるようになりました。

  • Motion::Planner::computeInverseKinematics は、ポーズのリストの代わりに、新しい Motion::PoseGoal を保持する Motion::PoseGoals を受け取るようになりました。ポーズのリストは引き続き暗黙的に変換されますが、C++ では、波括弧で囲んだポーズのリストにはもう 1 組の波括弧が必要になりました。

  • Motion::Mesh は作成後に変更できなくなりました。transformInPlace と bottomCenterTransformInPlace を削除しましたので、代わりにコピーを返す Motion::Mesh::transform と Motion::Mesh::bottomCenterTransform を使用してください。setColor は、コピーを返す Motion::Mesh::withColor に置き換えました。

C++

  • Motion::Mesh はコピーできるようになりました。

Python

  • zivid_pythonmotion ホイールは Python 3.12 にも対応するようになりました。

  • Python 3.10 は 2026 年 10 月にサポートが終了します。本リリースでは Python 3.10 のサポートは非推奨となり、将来のリリースで削除される可能性があります。

UserConfiguration.yml

  • フィールドは Generation セクションと Runtime セクションにグループ化されるようになりました。

  • 各関心領域の退避方向を Runtime/RegionsOfInterest に移動し、Id によって Generation/Workspace/RegionsOfInterest と対応付けました。

  • Runtime 配下のフィールドを変更しても、セルデータを再生成する必要がなくなりました。

  • 移動中のロボットツールの向きを設定する Generation/ConstrainedMovement セクションを追加しました。

  • Generation/Attachments および Generation/AdaptivePart 配下の SelfCollisionCheckLinks は、リンクの番号付けが 1 から始まるようになりました。既存のファイルでは、各リンクに 1 を加算してください。

  • SelfCollisionCheckLinks に同じリンクが 2 回記載されている場合、またはロボットに存在しないリンクが記載されている場合、セルの読み込みが失敗します。

  • StaticEnvironmentSafetyDistance と DynamicEnvironmentSafetyDistance を、Runtime/PreferredMinClearance/StaticEnvironment と Runtime/PreferredMinClearance/DynamicEnvironment に名称変更しました。プランナーは可能な限りこのクリアランスを維持しますが、保証はされません。

全般

  • Zivid Motion は、CUDA 12.0 に対応した NVIDIA ドライバー、つまりドライバーバージョン 525.60.13 以降を必要とするようになりました。

  • プランナーの呼び出し、プランナーの起動、セルデータの生成が高速化し、メモリ使用量が削減されました。

  • いくつかのバグを修正しました。

3.2.0

2026年9月1日

API

  • Visualizer が表示するロボットコンフィグレーションを設定する Motion::Visualizer::setRobotConfiguration を追加しました。

  • Motion::packageApiLog は、作成するアーカイブに API ログ自体を含めるようになったため、記録したセッションを再現するために Zivid が必要とするものはそのアーカイブだけで済みます。アーカイブはログの隣に <name>.zip として作成されるようになり、ログを含めていなかった従来の <name>-resources.zip を置き換えます。

UserConfiguration.yml

  • ロボットのメーカーを表す RobotBrand を追加しました。

全般

  • 各種パフォーマンスの改善。

バグ修正

  • Motion::Planner::path は、ゴールには到達できるがそこに至るパスがない場合、ゴールがブロックされているのではなく、パスがブロックされていると報告するようになりました。

  • エクスポートされた API ログは、記録された障害物とともに再生されるようになりました。

  • いくつかの軽微なバグを修正しました。

3.1.0

2026年8月12日

API

  • 並進と roll、pitch、yaw 角からポーズを構築する Motion::Pose::fromXyzRpy を追加しました。

  • 2 つのポーズを合成する Motion::Pose::compose を追加しました。

  • ディスク上のファイルからメッシュを読み込む実験的な Motion::Experimental::loadMesh 関数を追加しました。

C++

  • Motion::Tcp、Motion::Waypoint、Motion::Planner 用のストリーム演算子を追加しました。

Python

  • zivid_pythonmotion ホイールは、以前の Python バージョンごとに 1 つのホイールを配布する方式に代わり、サポートするすべての Python バージョンに対応するようになりました。

  • zivid_pythonmotion ホイールは NumPy への依存関係を宣言するようになりました。

RuntimeConfiguration.yml

  • スレッドプールのサイズを決定する際に Zivid Motion がユーザー用に空けておく CPU スレッド数を上書きする Performance/FreeCpuThreads を追加しました。この数は、これまでは 2 に固定されていました。

全般

  • セルパッケージのインストール時に、Motion のリソースディレクトリが存在しない場合は作成されるようになりました。

  • 生成されたデータなしでパッケージ化する場合でも、セルのパッケージ化に元の URDF ファイルとメッシュファイルが含まれるようになりました。

  • いくつかのバグを修正しました。

3.0.0

2026年7月2日

API

  • Motion::Pose、Motion::Configuration、Motion::Path、Motion::Triangle は、従来の typedef に代わり、具象型になりました。

  • PointXYZ と VectorXYZ の typedef を削除しました。代わりに Motion::Vector3f を使用してください。

  • TransformedBox を Motion::BottomCenteredTransformedBox に名称変更し、そのメンバー bottomCenteredTransform を transform に名称変更しました。

  • Motion::Planner::computeInverseKinematics は、単一のポーズを受け取りオプションのコンフィグレーションを返す方式ではなく、ポーズのリストを受け取り Goals を返すようになりました。

  • PathRequest.goalConfigurations を、新しい Goals 型を使用する Motion::PathRequest::goals に置き換えました。

  • Motion::Profile は小文字になりました(Testing/Production → testing/production)。

  • Motion::Triangles または形状(Motion::Mesh::createBox、Motion::Mesh::createCylinder、Motion::Mesh::createSphere)から構築される、新しい Motion::Mesh クラスを追加しました。

    • Motion::Mesh::transform と Motion::Mesh::transformInPlace を追加しました。

    • Motion::Mesh::bottomCenterTransform と Motion::Mesh::bottomCenterTransformInPlace を追加しました。

    • 複数のメッシュを 1 つに統合する実験的な Motion::Experimental::merge 関数を追加しました。

  • Motion::Planner::setCarriedObject と Motion::Planner::setReplaceableTool は、引数として Motion::Mesh を受け取るようになりました。他のすべてのオーバーロードは削除されました。

  • Motion::Planner::setObstacles は、引数として Motion::Mesh のリストを受け取るようになりました。Motion::Triangles を受け取る従来のオーバーロードは削除されました。

  • プランナーの状態を復元し、以前にエクスポートした API ログを再生する Motion::Planner::replayApiLog を追加しました。

  • Motion::Pose と Motion::Matrix4x4 クラス、およびそれらの間の変換を追加しました。

  • Goals 型と Goals::fromConfigurations を追加しました。

C++

  • Motion::Application は、ヘッダーのバージョンとライブラリのバージョンが一致することを検証するようになりました。

Python

  • Obstacle.PointCloud、Obstacle.Colors、Triangles は numpy 配列から直接構築できるようになり、大規模な点群と三角形メッシュに対してより高性能なインターフェースを提供します。

  • BlendRadius と ColorRGBA がクラスとして公開されるようになりました。

  • zivid_pythonmotion ホイールをインポートすると、そのバージョンがインストール済みの C++ ライブラリと一致しない場合に警告が表示されるようになりました。

バグ修正

  • Motion::Planner::path は、すべてのゴールコンフィグレーションが無効な場合にエラー結果を返すようになりました。

Python

  • PathRequest コンストラクタの引数の順序を修正し、位置引数による構築が機能するようにしました。

2.0.0

2026年3月31日

API

  • Zivid Motion API の初回一般公開リリースです。