Siemens-NXUG二次开发-创建块（长方体）特征、圆柱特征、圆锥或圆台特征、球体特征、管道特征[Python UF][20240504]

1.python uf函数

1.1 NXOpen.UF.ModlFeatures.CreateBlock1

# 内部和外部模式可用
"""
官方文档翻译：创建块。角点指示要创建的块的原点，X、Y和Z长度控制边长度的大小，sign参数控制执行的布尔运算，此函数的输出是与块相关联的对象标识符,原点是相对于绝对CSYS的，但是，边长度的方向是相对于WCS的。
返回值：一个tag，元素类型为python的int类型，块特征的feature tag标识。
"""             
def NXOpen.UF.ModlFeatures.CreateBlock1	(self, sign, corner_pt, medge_len)
	'''
	sign(NXOpen.UF.Modl.FeatureSigns) 指示创建的同时执行某种布尔运算， UF_NULLSIGN：创建新的目标体、UF_POSITIVE：合并、target solid UF_NEGATIVE：减去、UF_UNSIGNED：相交
	corner_pt：float list-块的角点位置（角点是值距离原点最近的点）
	edge_len：str list-分别在XYZ三个轴上的尺寸长度
	'''

1.2 NXOpen.UF.ModlFeatures.CreateCyl1

# 内部和外部模式可用
官方文档翻译：创建圆柱体，原点指示圆柱体底面的中心所在的位置，方向矢量控制在其上创建圆柱体的轴，直径和高度控制圆柱体的大小，sign参数控制执行的布尔运算，此函数的输出是与圆柱体相关联的对象标识符。
返回值：一个tag，元素类型为python的int类型，圆柱特征的feature tag标识。
"""             
def NXOpen.UF.ModlFeatures.CreateCyl1(self, sign, origin, height, diam, direction)
	'''
	sign(NXOpen.UF.Modl.FeatureSigns) 指示创建的同时执行某种布尔运算， UF_NULLSIGN：创建新的目标体、UF_POSITIVE：合并、target solid UF_NEGATIVE：减去、UF_UNSIGNED：相交
	origin：float list-底面圆心位置
	height：str-圆柱高度
	diam：str-圆柱直径
	direction：float list-圆柱建模方向（朝向：从底面朝着某个方向建立高度为height的圆柱特征）
	'''

1.3 NXOpen.UF.ModlFeatures.CreateCone1

# 内部和外部模式可用
官方文档翻译：创建圆锥体或圆台体，原点指示圆锥体底面的中心所在的位置，方向矢量控制在哪个轴上创建圆锥体，底部和顶部直径（直径）以及高度控制圆锥体的大小，sign参数控制执行的布尔运算，此函数的输出是与该圆锥体相关联的对象标识符。
返回值：一个tag，元素类型为python的int类型，圆锥或圆台特征的feature tag标识。
"""             
def NXOpen.UF.ModlFeatures.CreateCyl1(self, sign, origin, height, diam, direction)
	'''
	sign(NXOpen.UF.Modl.FeatureSigns) 指示创建的同时执行某种布尔运算， UF_NULLSIGN：创建新的目标体、UF_POSITIVE：合并、target solid UF_NEGATIVE：减去、UF_UNSIGNED：相交
	origin：float list-底面圆心位置
	height：str-圆锥或圆台高度
	diam：str list-[0]圆锥底面直径（大直径）、[1]圆台上表面直径（小直径），其中小直径为'0.0'时绘制出来的是圆锥否则是圆台
	direction：float list-圆柱建模方向（朝向：从底面朝着某个方向建立高度为height的圆锥或圆台特征）
	'''

1.4 NXOpen.UF.ModlFeatures.CreateSphere1

# 内部和外部模式可用
官方文档翻译：创建球体，“原点”表示球体的中心，Diameter控制大小，sign参数控制执行的布尔运算，此函数的输出是与球体关联的特征标记。
返回值：一个tag，元素类型为python的int类型，球体特征的feature tag标识。
"""             
def NXOpen.UF.ModlFeatures.CreateSphere1(self, sign, center, diam)
	'''
	sign(NXOpen.UF.Modl.FeatureSigns) 指示创建的同时执行某种布尔运算， UF_NULLSIGN：创建新的目标体、UF_POSITIVE：合并、target solid UF_NEGATIVE：减去、UF_UNSIGNED：相交
	center：float list-球心位置
	diam：str-球直径
	'''

1.5 NXOpen.UF.Modl.CreateTube

# 内部和外部模式可用
官方文档翻译：根据指定的内径和外径创建卡套管或电缆,如果内径设置为零，则会产生电缆(实心体无空心部分),此函数的输出是一个特征对象标识符列表,限制变量的类型为字符，以允许表达式使用。
返回值：一个tag，元素类型为python的int类型，管道特征的feature tag标识。
def NXOpen.UF.Modl.CreateTube(self, path_list, limit, sign)
	'''
	path_list-int list:构成管道中心线的边或曲线类型tag列表
	limit：str lis-[0]管道外直、 [1]管道内直径，其中当[1]为‘0.0’时创建的就是实心圆柱体管道
	sign(NXOpen.UF.Modl.FeatureSigns) 指示创建的同时执行某种布尔运算， UF_NULLSIGN：创建新的目标体、UF_POSITIVE：合并、target solid UF_NEGATIVE：减去、UF_UNSIGNED：相交
	'''

2.示例代码

2.1 pyuf_block_cylinder_cone_sphere_tube.py

import NXOpen
import NXOpen.UF as UF


def get_uf_session():
    # 获取当前python UF会话
    return UF.UFSession.GetUFSession()

def get_py_session():
    # 获取当前python会话
    return NXOpen.Session.GetSession()

def pyuf_new_prt(the_pyuf_session, new_prt_file_name, units = 1):
    """
    功能：创建一个指定文件路径和文件名的.prt文件，默认单位制是米（m）
    """

    # 由于要对Part进行操作，因此需要获取Part实例对象
    pyuf_part_instance = the_pyuf_session.Part

    # New方法位于Part类对象中
    new_prt_file_tag = pyuf_part_instance.New(new_prt_file_name, units)
    return new_prt_file_tag

def pyuf_save_prt(the_pyuf_session):
    """
    功能：保存当前工作part
    """
    # 由于要对Part进行操作，因此需要获取Part实例对象
    pyuf_part_instance = the_pyuf_session.Part

    # Save方法位于Part类对象中
    return pyuf_part_instance.Save()

def pyuf_close_prt(the_pyuf_session, part_tag, scope, mode):
    """
    功能：关闭当前工作part
    """
    # 由于要对Part进行操作，因此需要获取Part实例对象
    pyuf_part_instance = the_pyuf_session.Part

    # Close方法位于Part类对象中
    return pyuf_part_instance.Close(part_tag, scope, mode)


def get_solid_body_face_tags(the_pyuf_session, solid_body_tag):
    """
    功能：获取一个solidbody实体中的所有面的tag标识
    """
    uf_modling_instance = the_pyuf_session.Modeling

    face_tag_list = uf_modling_instance.AskBodyFaces(solid_body_tag)
    return face_tag_list

def get_solid_body_face_edge_tags(the_pyuf_session, solid_body_face_tag):
    """
    功能：获取一个实体面中的所有实体边的tag标识
    """
    uf_modling_instance = the_pyuf_session.Modeling

    edge_tag_list = uf_modling_instance.AskFaceEdges(solid_body_face_tag)
    return edge_tag_list


def createBlock(the_pyuf_session, corner_point, size, signs = 0):
	"""
	python uf创建块（长方体）

	corner_point-float list[x,y,z]：长方体角点坐标，size-str list[x_size, y_size,z_size]:块长宽高尺寸

	返回值是一个整数：块的feature tag标识
	
	signs意义：
	UF_NULLSIGN = 0
	create new target solid

	UF_POSITIVE = 1
	add to target solid

	UF_NEGATIVE = 2
	subtract from target solid

	UF_UNSIGNED = 3
	intersect with target solid

	UF_NO_BOOLEAN = 4
	feature has not been booleaned

	UF_TOP_TARGET = 5
	feature is the "top target" feature, it has no
	"parent" features but does have tool features

	UF_UNITE = 6
	feature has been united to target solid

	UF_SUBTRACT = 7
	feature has been subtracted from target solid

	UF_INTERSECT = 8
	feature has been intersected with target solid

	UF_DEFORM_POSITIVE = 9
	feature used to deform the positive side
	of the target sheet

	UF_DEFORM_NEGATIVE = 10
	feature used to deform the negative side
	of the target sheet
	"""

	uf_modlFeatures_instance = the_pyuf_session.ModlFeatures
	modl_feature_signs = UF.Modl.FeatureSigns.ValueOf(signs)
	return uf_modlFeatures_instance.CreateBlock1(modl_feature_signs, corner_point, size)

def createCylinder(the_pyuf_session, origin, height, diam, direction, signs = 0):
	"""
	python uf创建圆柱

	origin-float list[x,y,z]：圆柱底端面中心点坐标，height-str:圆柱高度，diam-str:圆柱直径，
	direction-float list[x,y,z]:圆柱建模方向向量（从中心点开始朝某个方向建模）

	返回值一个整数：圆柱的feature tag标识
	"""

	uf_modlFeatures_instance = the_pyuf_session.ModlFeatures
	modl_feature_signs = UF.Modl.FeatureSigns.ValueOf(signs)
	return uf_modlFeatures_instance.CreateCyl1(modl_feature_signs, origin, height, diam, direction)


def createCone(the_pyuf_session, origin, height, diam, direction, signs = 0):
	"""
	[python uf创建圆锥或圆锥台

	origin-float list[x,y,z]：圆锥底端面中心点坐标，height-str:圆锥高度，
	diam-str list[大直径，小直径（圆锥-0.0，圆锥台-大于0.0）]:圆锥直径，direction-float list[x,y,z]:圆锥建模方向向量（从中心点开始朝某个方向建模）

	返回值一个整数：圆锥或圆锥台的feature tag标识
	"""
	uf_modlFeatures_instance = the_pyuf_session.ModlFeatures
	modl_feature_signs = UF.Modl.FeatureSigns.ValueOf(signs)
	return uf_modlFeatures_instance.CreateCone1(modl_feature_signs, origin, height, diam, direction)

def createSphere(the_pyuf_session, origin, diam, signs = 0):
	"""
	python uf创建球

	origin-float list[x,y,z]：球中心点坐标，diam-str：球直径

	返回值一个整数：球的feature tag标识
	"""
	uf_modlFeatures_instance = the_pyuf_session.ModlFeatures
	modl_feature_signs = UF.Modl.FeatureSigns.ValueOf(signs)
	return uf_modlFeatures_instance.CreateSphere1(modl_feature_signs, origin, diam)

def createTube(the_pyuf_session, path_list, diam, signs = 0):
	"""
	创建管体
	center  (list of float) Center of sphere to be created.
	diam    (str) Diameter of sphere to be created.
	"""
	uf_modl_instance = the_pyuf_session.Modl
	modl_feature_signs = UF.Modl.FeatureSigns.ValueOf(signs)
	return uf_modl_instance.CreateTube(path_list, diam, modl_feature_signs)

def getFeatureBody(the_pyuf_session, feature_tag):
	"""
	查询特征所属body的tag
	"""
	uf_modeling_instance = the_pyuf_session.Modeling
	return uf_modeling_instance.AskFeatBody(feature_tag)


if __name__ == '__main__':
    # 获取uf session
    the_pyuf_session = get_uf_session()

    # 获取python session
    the_py_session = get_py_session()

    # 打开prt文件路径与名称
    new_prt_file_name = 'D:\\pyuf_block_cylinder_cone_sphere_tube.prt'
    
    new_prt_file_tag = pyuf_new_prt(the_pyuf_session, new_prt_file_name)

    # 外部模式运行，会在命令行中打印，但内部模式运行则无反应，因在UF.UI类中操作，才可在NX/UG界面显示数据
    # 由于与NX/UG界面UI操作的方法都在UI类中，因此先获取UF.UI示例对象
    pyuf_ui_instance = the_pyuf_session.Ui

    # 判断信息窗口是否打开
    if pyuf_ui_instance.IsListingWindowOpen() == False:
        # 信息窗口未打开，先要将其打开
        # 打开信息窗口
        pyuf_ui_instance.OpenListingWindow()
        
    # 创建长方体
    block_feature_tag = createBlock(the_pyuf_session, [100.0, 100.0, 100.0], ['200.0', '400.0', '50.0'])
    
    # 创建圆柱体(朝X轴正向建模)
    createCylinder(the_pyuf_session, [50.0, 50.0, 50.0], '55.0', '100.0', [1.0, 0.0, 0.0])
    
    # 创建圆锥(朝Z轴负向建模)(带布尔减去，会自动将与之接触的实体中减去该圆锥体)
    createCone(the_pyuf_session, [50.0, 50.0, 50.0], '120.0', ['100.0', '0.0'], [0.0, 0.0, -1.0], 2)
    
    # 创建圆台(朝Z轴正向建模)
    createCone(the_pyuf_session, [150.0, 50.0, 50.0], '120.0', ['100.0', '55.0'], [0.0, 0.0, 1.0])
    
    # 创建球体
    createSphere(the_pyuf_session, [200.0, 300.0, 125.0], '100.0')
    
    # 从某个特征上查询该特征所属的实体
    block_body_tag = getFeatureBody(the_pyuf_session, block_feature_tag)
    block_body_face_tag_list = get_solid_body_face_tags(the_pyuf_session, block_body_tag)
    temp_face_edge_tag_list = get_solid_body_face_edge_tags(the_pyuf_session, block_body_face_tag_list[0])
    
    # 创建管道（控制外壁直径和内孔壁直径）
    createTube(the_pyuf_session, [temp_face_edge_tag_list[0]], ['10.0', '5.0'])
    
    # 创建管道（控制外壁直径和内孔壁直径）
    createTube(the_pyuf_session, [temp_face_edge_tag_list[1]], ['20.0', '0.0'])
    
    # 向信息窗口写入内容
    pyuf_ui_instance.WriteListingWindow('\nnew_prt_file_tag is:' + str(new_prt_file_tag))
    # 将信息窗口的内容保存到指定文件中
    pyuf_ui_instance.SaveListingWindow('D:\\pyuf_listingwindow_content_test.txt')

    # 关闭信息窗口
    #pyuf_ui_instance.ExitListingWindow()
    
    pyuf_save_prt(the_pyuf_session)
    
    pyuf_close_prt(the_pyuf_session, new_prt_file_tag, 0, 1)

3.运行结果

3.1 内部模式

选中要运行的.py文件后，点击“管道通路”即可。

运行结果：

3.2 外部模式

cmd命令：“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_block_cylinder_cone_sphere_tube.py。
cmd命令：“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_block_cylinder_cone_sphere_tube.py。

powershell命令：&“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_block_cylinder_cone_sphere_tube.py。
powershell命令：&“D:\Siemens\NX 12.0\NXBIN\run_journal.exe” pyuf_block_cylinder_cone_sphere_tube.py。

运行结果：

同上