25 kBodyLiftingHeightMin(parameter_record.body_lifting_height_min),
26 kBodyLiftingHeightMax(parameter_record.body_lifting_height_max),
27 kMovableCoxaAngleMin(math_util::ConvertDegToRad(parameter_record.movable_coxa_angle_min_deg)),
28 kMovableCoxaAngleMax(math_util::ConvertDegToRad(parameter_record.movable_coxa_angle_max_deg)),
29 kMinLegR(parameter_record.min_leg_range),
30 kMaxLegR(parameter_record.max_leg_range),
31 kFreeLegHeight(parameter_record.free_leg_height),
32 kStableMargin(parameter_record.stable_margin),
33 free_leg_pos_leg_coordinate_({ {
41 leg_base_pos_robot_coordinate_({ {
49 kMaxLegRArray(InitMaxLegR()),
50 kMinLegPosXY(InitMinLegPosXY()),
51 kMaxLegPosXY(InitMaxLegPosXY()),
57 const int leg_index,
const Vector3& leg_pos)
const noexcept
60 assert(0 <= leg_index);
66 const int kJointNum = 4;
67 const int kJointAngleNum = kJointNum - 1;
84 float coxa_joint_angle = std::atan2f(leg_pos.y, leg_pos.x);
86 if (leg_pos.y == 0 && leg_pos.x == 0)
95 leg_index, coxa_joint_angle + std::numbers::pi_v<float>))
97 coxa_joint_angle += std::numbers::pi_v<float>;
100 leg_index, coxa_joint_angle - std::numbers::pi_v<float>))
102 coxa_joint_angle -= std::numbers::pi_v<float>;
125 const float angle_ft = std::atan2(
126 leg_pos.z - femur_joint_pos.
z,
127 (leg_pos.ProjectedXY() - femur_joint_pos.
ProjectedXY()).GetLength());
130 float angle_ft_phase = angle_ft + std::numbers::pi_v<float>;
131 angle_ft_phase = (angle_ft_phase > std::numbers::pi_v<float>) ?
132 angle_ft_phase - std::numbers::pi_v<float> : angle_ft_phase;
145 const Vector3 candidate_leg_pos_phase = femur_joint_pos +
Vector3{
158 const float distance = (leg_pos - candidate_leg_pos).GetLength();
159 const float distance_phase = (leg_pos - candidate_leg_pos_phase).GetLength();
161 float angle_f = 0, angle_t = 0;
163 if (distance < distance_phase)
170 angle_f = angle_ft_phase;
171 angle_t = -std::numbers::pi_v<float>;
211 const float femur_to_leg_x =
213 ((leg_pos.ProjectedXY().GetSquaredLength() >
216 const float femur_to_leg_z = femur_to_leg.
z;
219 const float arc_cos_upper =
227 const float arc_cos_arg = arc_cos_upper / arc_cos_lower;
230 const float femur_joint_angle =
231 std::acos(arc_cos_arg) +
232 std::atan2(femur_to_leg_z, femur_to_leg_x);
257 const float tibia_angle = std::atan2(
274 assert(joint_state.joint_pos_leg_coordinate.size() == 4);
275 assert(joint_state.joint_angle.size() == 3);
315 if (joint_state.joint_pos_leg_coordinate[3] != leg_pos) {
return false; }
322 const Vector3& converted_position,
324 const Vector3& center_of_mass_global,
326 const bool consider_rot)
const
329 assert(0 <= leg_index);
334 return RotateVector3(converted_position - center_of_mass_global,
340 return converted_position -
341 center_of_mass_global -
347 const Vector3& converted_position,
349 const Vector3& center_of_mass_global,
351 const bool consider_rot)
const
354 assert(0 <= leg_index);
360 robot_quat) + center_of_mass_global;
364 return converted_position +
370 const Vector3& converted_position,
371 const Vector3& center_of_mass_global,
373 const bool consider_rot)
const
377 return RotateVector3(converted_position, robot_quat) + center_of_mass_global;
381 return converted_position + center_of_mass_global;
386 const int leg_index)
const
392 const int leg_index)
const
401 assert(0 <= leg_index);
404 return free_leg_pos_leg_coordinate_[leg_index];
410 assert(0 <= leg_index);
413 return leg_base_pos_robot_coordinate_[leg_index];
420 assert(0 <= leg_index);
431 if (kMinLegPosXY[leg_index].Cross(leg_pos_xy) < 0.0f)
435 if (kMaxLegPosXY[leg_index].Cross(leg_pos_xy) > 0.0f)
442 if (
static_cast<int>(leg_pos.
z) < -kMaxLegRSize || 0 <
static_cast<int>(leg_pos.
z))
467 const std::array<Vector3, HexapodConst::kLegNum>& leg_pos)
const
504 return kBodyLiftingHeightMin;
509 return kBodyLiftingHeightMax;
514 const std::array<Vector3, HexapodConst::kLegNum>& leg_pos)
const
520 std::array<Vector2, HexapodConst::kLegNum> ground_leg_pos;
523 int ground_leg_pos_num = 0;
531 ground_leg_pos[ground_leg_pos_num] = leg_pos[i].ProjectedXY() +
534 ground_leg_pos_num++;
539 float min_margin = 0;
540 bool is_first =
true;
542 for (
int i = 0; i < ground_leg_pos_num; i++)
544 Vector2 i_to_i_plus_1 = ground_leg_pos[(i + 1) % ground_leg_pos_num] -
558 min_margin = (std::min)(min_margin, margin);
566 const std::array<Vector3, HexapodConst::kLegNum>& leg_pos)
const
577 const float top_z = (std::max)(
599 if (devide_map.
IsInMap(coxa_pos_global_coord))
601 const float coxa_top_z = (std::max)(
617 if (devide_map.
IsInMap(leg_pos_global_coord))
619 const float leg_top_z = (std::max)(
635std::array<float, PhantomXMkII::kMaxLegRSize> PhantomXMkII::InitMaxLegR()
const
640 std::array <float, kMaxLegRSize> res;
648 const float PERMISSION = 0.5f;
652 const float mins[3] = { -1.428f, -1.780f, -1.194f };
655 const float maxes[3] = { 1.402f, 1.744f, 1.769f };
660 for (
int iz = 0; iz < 200; iz++)
662 for (
int ix = 53; ix < 248; ix++)
665 const Vector3 line_end(
static_cast<float>(ix), 0.0f,
static_cast<float>(iz));
686 const float _q1 = -atan2(line_end.z, _IK_trueX);
689 const float _q2 = acos(
694 const float _femur_angle = _q1 + _q2;
695 const float _tibia_angle = acos(
700 std::numbers::pi_v<float> / 2.0f;
705 cos(_femur_angle + _tibia_angle - std::numbers::pi_v<float> / 2.0f);
709 _kinematics.y = 0.0f;
713 sin(_femur_angle + _tibia_angle - std::numbers::pi_v<float> / 2.0f));
715 const float _Permission = (_kinematics - line_end).GetSquaredLength();
717 if (PERMISSION > _Permission)
719 constexpr float kLegRom_RMargin = 2.f;
722 res[iz] =
static_cast<float>(ix) - kLegRom_RMargin;
729 res[iz] = MAX_LEG_RADIUS;
739std::array<Vector2, HexapodConst::kLegNum> PhantomXMkII::InitMinLegPosXY()
const
741 std::array<Vector2, HexapodConst::kLegNum> res;
746 res[i] = Vector2(cos(angle), sin(angle)).GetNormalized();
752std::array<Vector2, HexapodConst::kLegNum> PhantomXMkII::InitMaxLegPosXY()
const
754 std::array<Vector2, HexapodConst::kLegNum> res;
759 res[i] = Vector2(cos(angle), sin(angle)).GetNormalized();
constexpr int GetDividedMapIndexX(const float pos_x) const noexcept
指定した座標を DividedMap のインデックスに変換する. 範囲外の値を指定した場合でも,値を丸めずに返す. そのため,IsInMap で範囲内に存在するかどうかを確認する必要がある.
constexpr bool IsInMap(const float x, const float y) const
指定した座標がマップの範囲内に存在するかどうかを返す.
constexpr int GetDividedMapIndexY(const float pos_y) const noexcept
指定した座標を DividedMap のインデックスに変換する. 範囲外の値を指定した場合でも,値を丸めずに返す. そのため,IsInMap で範囲内に存在するかどうかを確認する必要がある.
float GetTopZ(int x_index, int y_index) const
格子状に切り分けられたマップから,最も高いZ座標を返す.
float GetMapMinZ() const noexcept
static constexpr int kLegNum
static constexpr float kFemurLength
第2関節部の長さ[mm].
static constexpr bool IsValidCoxaAngle(const int leg_index, const float angle)
第1関節の角度が有効な範囲内かどうかを判定する.
static constexpr float kCoxaBaseOffsetY
coxa linkの付け根(中央)までの長さ[mm].
static constexpr float kCenterCoxaBaseOffsetY
coxa linkの付け根(前方・後方)までの長さ[mm].
static constexpr float kCoxaLength
第1関節部の長さ[mm].
static constexpr float kTibiaLength
第3関節部の長さ[mm].
static constexpr std::array< float, kPhantomXLegNum > kCoxaDefaultAngle
第1関節の初期角度[rad]
static constexpr bool IsValidFemurAngle(const float angle)
第2関節の角度が有効な範囲内かどうかを判定する.
static constexpr bool IsValidTibiaAngle(const float angle)
第3関節の角度が有効な範囲内かどうかを判定する.
static constexpr float kCoxaBaseOffsetX
coxa linkの付け根までの長さ(上方向)[mm].
static constexpr float kCoxaBaseOffsetZ
胴体の高さ[mm].
Vector3 ConvertLegToGlobalCoordinate(const Vector3 &converted_position, int leg_index, const Vector3 ¢er_of_mass_global, const Quaternion &robot_quat, const bool consider_rot) const override
脚座標系で表現されている座標を,グローバル座標系に変換する.
Vector3 ConvertGlobalToLegCoordinate(const Vector3 &converted_position, int leg_index, const Vector3 ¢er_of_mass_global, const Quaternion &robot_quat, const bool consider_rot) const override
グローバル座標系で表現されている座標を,脚座標系に変換する.
Vector3 ConvertRobotToLegCoordinate(const Vector3 &converted_position, int leg_index) const
ロボット座標系で表現されている座標を,脚座標系に変換する.
PhantomXMkII(const PhantomXMkIIParameterRecord ¶meter_record)
Vector3 ConvertLegToRobotCoordinate(const Vector3 &converted_position, int leg_index) const
脚座標系で表現されている座標を,ロボット座標系に変換する.
bool IsBodyInterferingWithGround(const RobotStateNode &node, const DividedMapState &devide_map) const override
胴体が地面と干渉しているかどうかを判定する.
float GetGroundHeightMarginMax() const noexcept override
地面の最大高さと重心位置を最大どれだけ離すかを返す.
float GetGroundHeightMarginMin() const noexcept override
地面の最大高さと重心位置を最小どれだけ離すかを返す.
float CalculateStabilityMargin(const leg_func::LegStateBit &leg_state, const std::array< Vector3, HexapodConst::kLegNum > &leg_pos) const override
安定余裕(Stability Margin)を計算する. 詳しくは「不整地における歩行機械の静的安定性評価基準」 という論文を読んで欲しい. 接地脚を繋いで作られる多角形の辺と重心の距離の最小値を計...
bool IsLegInRange(int leg_index, const Vector3 &leg_pos) const override
脚が可動範囲内にあるかどうかを判定する.
HexapodJointState CalculateJointState(const int leg_index, const Vector3 &leg_pos) const noexcept override
指定した脚の関節のグローバル座標と,角度を計算する. 重たいのでグラフ探索や,描画処理中にループで使用することは推奨しない. 間接の可動範囲外まで動いてしまう場合でも,答えを返す. 目標座標...
Vector3 GetFreeLegPosLegCoordinate(int leg_index) const noexcept override
遊脚する位置を返す,脚座標系.
bool IsValidJointState(const int leg_index, const Vector3 &leg_pos, const HexapodJointState &joint_state) const noexcept override
指定した脚のHexapodJointStateが正しく計算できているかを調べる. 目標座標に届かない場合や,間接の可動範囲外まで動いてしまう場合, 戻り値は false になる.
Vector3 ConvertRobotToGlobalCoordinate(const Vector3 &converted_position, const Vector3 ¢er_of_mass_global, const Quaternion &robot_quat, const bool consider_rot) const override
ロボット座標系で表現されている座標を,グローバル座標系に変換する.
bool IsStable(const leg_func::LegStateBit &leg_state, const std::array< Vector3, HexapodConst::kLegNum > &leg_pos) const override
安定余裕を用いて,静的に安定しているかどうかを判定する.
bool IsLegInterfering(const std::array< Vector3, HexapodConst::kLegNum > &leg_pos) const override
脚が他の脚と干渉しているかどうかを判定する.
Vector3 GetLegBasePosRobotCoordinate(int leg_index) const noexcept override
脚の付け根の座標(leg base position )を取得する.ロボット座標系.
bool IsGrounded(const LegStateBit &leg_state, const int leg_index)
脚番号 leg_index 0 ~ 5 に応じて,その脚が接地しているかを調べる. 脚は右前脚を0番として,時計回りに0,1,2,3,4,5となる.左前足が5番.
std::bitset< kLegStateBitNum > LegStateBit
脚状態を保存する型.28bitのビット型.
constexpr bool CanMakeTriangle(const T a, const T b, const T c) noexcept
3辺で三角形が作れるか調べる関数.
constexpr bool IsEqual(const T num1, const T num2) noexcept
C++において,小数同士の計算は誤差が出てしまう. 誤差込みで値が等しいか調べる.
constexpr T Squared(const T num) noexcept
2乗した値を返す関数.
Vector3 RotateVector3(const Vector3 &vec, const EulerXYZ &rot)
回転させたベクトルを返す.三角関数の処理が多く重たいので注意.
std::vector< Vector3 > joint_pos_leg_coordinate
bool is_in_range
目標座標に脚が届かないならば false になる.
std::vector< float > joint_angle
bool HasIntersection(const LineSegment2 &other) const
他の線分と交点が存在しているかどうか調べる関数.
float 型と double 型の定数を提供するクラス.
constexpr Quaternion GetConjugate() const noexcept
クォータニオンの共役を返す. 共役なクォータニオンとは,ベクトル成分の符号を反転させたもの q = w + xi + yj + zk とすると, qの共役は w - xi - yj - zk となる...
グラフ構造のためのノード(頂点).旧名 LNODE
std::array< Vector3, HexapodConst::kLegNum > leg_pos
[4 * 3 * 6 = 72 byte] 脚先の座標.(coxa(脚の付け根)を原点とする)
leg_func::LegStateBit leg_state
[4 byte] 脚状態,重心パターンを bitで表す.旧名 leg_con.
Vector3 center_of_mass_global_coord
[4 * 3 = 12byte] グローバル座標系における重心の位置.旧名 GCOM
Quaternion posture
[4 * 4 = 16byte] 姿勢を表すクォータニオン.
Vector2 GetNormalized() const
このベクトルを正規化したベクトルを返す.
constexpr float GetSquaredLength() const noexcept
このベクトルの長さの2乗を返す.
constexpr float Cross(const Vector2 &other) const noexcept
自分×引数 の外積の結果を返す.
float GetLength() const
このベクトルの長さを返す.
constexpr float GetSquaredLength() const noexcept
ベクトルの長さの2乗を返す.
float GetLength() const noexcept
ベクトルの長さを返す.
constexpr Vector2 ProjectedXY() const noexcept
XY平面に射影したベクトルを返す.