几何对象的主属性计算器更多...

类 AnyCAD.Foundation.PrincipalProps 继承关系图:

Public 成员函数
	PrincipalProps (global::System.IntPtr cPtr, bool cMemoryOwn)
	仅供内部使用

void	Dispose ()

	PrincipalProps ()
	默认构造函数

bool	HasSymmetryAxis ()
	检查几何系统是否具有对称轴

bool	HasSymmetryAxisByTol (double aTol)
	检查几何系统是否具有对称轴（指定公差）

bool	HasSymmetryPoint ()
	检查几何系统是否具有对称中心

bool	HasSymmetryPointByTol (double aTol)
	检查几何系统是否具有对称中心（指定公差）

GXYZ	Moments ()
	获取主惯性矩

GVec	FirstAxisOfInertia ()
	获取第一主惯性轴方向

GVec	SecondAxisOfInertia ()
	获取第二主惯性轴方向

GVec	ThirdAxisOfInertia ()
	获取第三主惯性轴方向

GXYZ	RadiusOfGyration ()
	获取主回转半径

详细描述

几何对象的主属性计算器

PrincipalProps类用于计算和获取几何对象（如实体、面等）的主属性，包括惯性矩、对称轴、对称点、主惯性轴和回转半径等物理特性。这些属性在工程分析、质量属性计算和结构优化中非常重要。

构造及析构函数说明

◆ PrincipalProps()

AnyCAD.Foundation.PrincipalProps.PrincipalProps ( )

默认构造函数

创建一个未初始化的PrincipalProps对象，需要后续设置几何形状。

成员函数说明

◆ FirstAxisOfInertia()

GVec AnyCAD.Foundation.PrincipalProps.FirstAxisOfInertia ( )

获取第一主惯性轴方向

返回: 第一主惯性轴的方向向量

返回对应于最小惯性矩的主惯性轴方向。该轴通过系统的质心。注意：如果系统具有对称中心，则存在无限多个解，此时返回的向量仅表示其中一个可能的主惯性轴方向。

◆ HasSymmetryAxis()

bool AnyCAD.Foundation.PrincipalProps.HasSymmetryAxis ( )

检查几何系统是否具有对称轴

返回: 如果几何系统具有对称轴则返回true，否则返回false

使用默认的相对公差1.e-10来比较惯性矩。此精度对于由解析几何面限制的大多数工程对象已经足够。对称轴意味着存在一个轴，绕该轴旋转一定角度后几何体保持不变。

◆ HasSymmetryAxisByTol()

bool AnyCAD.Foundation.PrincipalProps.HasSymmetryAxisByTol ( double aTol )

检查几何系统是否具有对称轴（指定公差）

参数

aTol	用于检查惯性矩相等性的相对公差

返回: 如果几何系统具有对称轴则返回true，否则返回false

允许自定义公差值以适应不同的精度需求。如果aTol == 0，则使用机器精度约1.e-16 (Epsilon)。较小的公差值提供更严格的对称性检测。

◆ HasSymmetryPoint()

bool AnyCAD.Foundation.PrincipalProps.HasSymmetryPoint ( )

检查几何系统是否具有对称中心

返回: 如果几何系统具有对称中心则返回true，否则返回false

使用默认的相对公差1.e-10来比较惯性矩。对称中心意味着存在一个点，几何体关于该点中心对称（即点对称）。

◆ HasSymmetryPointByTol()

bool AnyCAD.Foundation.PrincipalProps.HasSymmetryPointByTol ( double aTol )

检查几何系统是否具有对称中心（指定公差）

参数

aTol	用于检查惯性矩相等性的相对公差

返回: 如果几何系统具有对称中心则返回true，否则返回false

允许自定义公差值。如果aTol == 0，则使用机器精度约1.e-16。

◆ Moments()

GXYZ AnyCAD.Foundation.PrincipalProps.Moments ( )

获取主惯性矩

返回: 包含三个主惯性矩(Ixx, Iyy, Izz)的向量

返回当前系统相对于主惯性轴的三个主惯性矩。这些值是惯性矩阵的特征值。特殊情况说明：

如果系统具有对称轴，则三个值中有两个相等，表示存在无限多个主惯性轴
如果系统具有对称中心，则Ixx、Iyy和Izz全部相等，任何通过质心的轴都是主惯性轴可以使用HasSymmetryAxis()和HasSymmetryPoint()函数检查这些特殊情况。

◆ RadiusOfGyration()

GXYZ AnyCAD.Foundation.PrincipalProps.RadiusOfGyration ( )

获取主回转半径

返回: 包含三个主回转半径(Rxx, Ryy, Rzz)的向量

回转半径是惯性矩的另一种表达方式，定义为 R = sqrt(I/m)，其中I是惯性矩， m是质量。Rxx、Ryy和Rzz分别是绕三个主惯性轴的回转半径。特殊情况：

如果系统具有对称轴，则三个值中有两个相等
如果系统具有对称中心，则Rxx、Ryy和Rzz全部相等

◆ SecondAxisOfInertia()

GVec AnyCAD.Foundation.PrincipalProps.SecondAxisOfInertia ( )

获取第二主惯性轴方向

返回: 第二主惯性轴的方向向量

返回对应于中间惯性矩的主惯性轴方向。该轴通过系统的质心，且与第一主惯性轴垂直。注意：如果系统具有对称中心或对称轴，则第二和第三主惯性轴不是唯一定义的。

◆ ThirdAxisOfInertia()

GVec AnyCAD.Foundation.PrincipalProps.ThirdAxisOfInertia ( )

获取第三主惯性轴方向

返回: gp_Vec 第三主惯性轴的方向向量

返回对应于最大惯性矩的主惯性轴方向。该轴通过系统的质心，且与第一、第二主惯性轴垂直，构成右手坐标系。重要说明：

这三个函数返回惯性矩阵的三个特征向量，分别对应三个主惯性轴
主惯性轴都通过系统的质心，并分别与这三个特征向量平行
如果系统具有对称轴，则任何通过质心并平行于两个相等特征值对应的特征向量的线性组合的轴都是主惯性轴
如果系统具有对称中心，则任何通过质心的轴都是主惯性轴
使用HasSymmetryAxis()和HasSymmetryPoint()检查这些特殊情况
使用Moments()函数了解哪两个特征值相等注意：如果系统具有对称中心或对称轴，则第二和第三主惯性轴不是唯一定义的。

Public 成员函数