UF_MODL_ask_mass_props_3d
Defined in: uf_modl.h
int UF_MODL_ask_mass_props_3d(tag_t * objects, int num_objs, int type, int units, double density, int accuracy, double acc_value [ 11 ] , double mass_props [ 47 ] , double statistics [ 13 ] )
overview 概述
Returns the mass properties of the specified collection of solid or sheet bodies.
Specify units and a density value, and either an accuracy value (set accuracy = 1) or relative tolerances (set accuracy = 2) for the mass property computations.
For simple analytic solid or sheet bodies (e.g., planes, cylinders), an accuracy value of 0.9 is sufficient. For more complicated solids or B-Surface sheet body faces, accuracy values closer to 1.0 may be necessary.
If Relative Tolerances are specified, the system iterates on accuracy values until successive mass property values are within the specified relative tolerances.
The relative tolerance values are defined by the test value (or estimated relative tolerance) is where MP(n) is the mass property value for the n-th iteration on the accuracy value.
If a relative tolerance of 0.0 is specified, no testing is done for the corresponding mass property value, although all the mass property values are computed using the same accuracy values.
返回指定实体或工作表主体集合的质量属性。为质量属性计算指定单位和密度值，以及精度值(集合精度 = 1)或相对公差(集合精度 = 2)。对于简单的解析实体或片状体(例如平面、圆柱体) ，0.9的精度值就足够了。对于更复杂的固体或 B 表面板体表面，精度值接近1.0可能是必要的。如果指定了相对公差，则系统对精度值进行迭代，直到连续的质量属性值在指定的相对公差范围内。相对公差值由测试值(或估计的相对公差)定义，其中 MP (n)是精度值上第 n 次迭代的质量性质值。如果规定相对公差为0.0，则不对相应的质量特性值进行测试，尽管所有的质量特性值都使用相同的精度值计算。
UFUN例子
获取源码例子请搜索 里海NX二次开发3000例专栏
parameters 参数
| tag_t * | objects | Input | num_objs Array of solid or sheet body identifiers, Solid bodies for analysis type 1, Sheet bodies for analysis types 2 and 3 实体或片体标识符阵列，用于分析类型1的实体，用于分析类型2和3的片体 |
| int | num_objs | Input | Number of objects 物体数量 |
| int | type | Input | Type of 3D Analysis 1 = Solid Bodies 2 = Thin Shell - Sheet Bodies 3 = Bounded by Sheet Bodies 三维分析类型1 = 实体2 = 薄壳-薄板体3 = 以薄板体为界 |
| int | units | Input | Units of mass and length 1 = Pounds and inches 2 = Pounds and feet 3 = Grams and centimeters 4 = Kilograms and meters 质量和长度单位1 = 磅和英寸2 = 磅和英尺3 = 克和厘米4 = 公斤和米 |
| double | density | Input | Density - Mass per unit volume (Mass per unit area for thin shell). Not used for solid body analysis; for solid bodies the densities of the solid bodies are used in the analysis and the density of the combined set of bodies is output in the mass properties array (mass_props[46]). 密度-单位体积质量(薄壳单位面积质量)。不用于固体分析; 对于固体，在分析中使用固体的密度，组合的物体集的密度在质量特性阵列中输出(mass _ props [46])。 |
| int | accuracy | Input | 1 = Use Accuracy 2 = Use Relative Tolerances 1 = 使用精度2 = 使用相对公差 |
| double | acc_value [ 11 ] | Input | [0] = Accuracy value between 0.0 and 1.0 if accuracy = 1 [1-10] not used if accuracy = 1 [0] = Relative Tolerance for Area if accuracy = 2 [1] = Relative Tolerance for Volume [2-4] = Relative Tolerances for First Moments (centroidal) [5-7] = Relative Tolerances for Moments of Inertia (centroidal) [8-10]= Relative Tolerances for Products of Inertia (centroidal) [0] = 0.0和1.0之间的准确度值，如果准确度 = 1[1-10]没有使用，如果准确度 = 1[0] = 面积的相对公差，如果准确度 = 2[1] = 体积的相对公差[2-4] = 第一矩的相对公差(质心)[5-7] = 惯性矩的相对公差(质心)[8-10] = 惯性产品的相对公差(质心) |
| double | mass_props [ 47 ] | Output | Mass properties [0] = Surface Area [1] = Volume (0.0 For Thin Shell) [2] = Mass [3-5] = Center Of Mass (COFM), WCS [6-8] = First Moments (centroidal) [9-11] = Moments Of Inertia, WCS [12-14] = Moments Of Inertia (centroidal) [15] = Spherical Moment Of Inertia [16-18] = Inertia Products, WCS [19-21] = Inertia Products (centroidal) [22-30] = Principal Axes, WCS [31-33] = Principal Moments (centroidal) [34-36] = Radii Of Gyration, WCS [37-39] = Radii Of Gyration (centroidal) [40] = Spherical Radius Of Gyration [41-45] = Unused [46] = Density 质量性质[0] = 表面积[1] = 体积(薄壳的0.0)[2] = 质量[3-5] = 质心(COFM) ,wCS [6-8] = 第一矩(质心)[9-11] = 惯性矩，WCS [12-14] = 惯性矩(质心)[15] = 球面转动惯量[16-18] = 惯性积,wCS [19-21] = 惯性积(质心)[22-30] = 主轴，WCS [31-33] = 主矩(质心)[34-36] = 回转半径,wCS [37-39] = 回转半径(质心)[40] = 球形回转半径[41-45] = 未使用[46] = 密度 |
| double | statistics [ 13 ] | Output | Errors are Estimates of the Relative Tolerances achieved if accuracy = 2; otherwise +/- range errors are given [0] = Error For Surface Area [1] = Error For Volume [2] = Error For Mass [3] = Radius Of Error Sphere [4] = Error For Moment XC [5] = Error For Moment YC [6] = Error For Moment ZC [7] = Error For Moment Of Inertia XC [8] = Error For Moment Of Inertia YC [9] = Error For Moment Of Inertia ZC [10] = Error For Product Of Inertia XCYC [11] = Error For Product Of Inertia YCZC [12] = Error For Product Of Inertia XCZC 误差是精度 = 2时所获得的相对公差的估计值; 否则给出 +/-范围误差[0] = 表面积误差[1] = 体积误差[2] = 质量误差[3] = 误差球半径误差[4] = 矩误差[5] = 矩误差[6] = 矩误差[7] = 转动惯量误差[8] = 转动惯量误差[9] = 转动惯量误差[10] = 惯性乘积误差[11] = 惯性乘积误差[12] = 惯性乘积误差 |
