from typing import Union, List
import xml.etree.ElementTree as ET
from os import path
ASSETS_PATH = path.join(path.dirname(path.dirname(__file__)), 'assets')
MODELS_PATH = path.join(ASSETS_PATH, 'models')
MOUNTS_DIR_PATH = path.join(MODELS_PATH, 'mounts')
GRIPPERS_DIR_PATH = path.join(MODELS_PATH, 'grippers')
MANIPULATORS_DIR_PATH = path.join(MODELS_PATH, 'manipulators')
SCENES_DIR_PATH = path.join(ASSETS_PATH, 'scenes')
[文档]
class XMLSplicer:
def __init__(self,
name: str = 'robot',
scene: str = 'default',
mount: Union[str, List[str]] = None,
manipulator: Union[str, List[str]] = None,
gripper: Union[str, List[str]] = None,
**kwargs,
):
self.xml_name = name
self.tree = None
self.root = None
self.splice_robot(
scene=scene,
mount=mount,
manipulator=manipulator,
gripper=gripper,
**kwargs,
)
def _init_scene(self, scene):
"""
Initialize the scene xml for the given scene file. We build the tree here
as the global tree. Each other node will append to it.
:param scene: xml file path of scene
"""
self.tree = ET.parse(scene)
self.root = self.tree.getroot()
ELEMENTS = ['asset', 'worldbody', 'actuator', 'default', 'contact', 'sensor', 'equality']
for element in ELEMENTS:
if self.root.find(element) is None:
self.root.append(ET.Element(element))
else:
for node in self.root.findall(element):
self._file_repath(scene, node)
[文档]
def add_component_from_xml(self, xml: str, goal_body: tuple) -> None:
"""
For each input xml file, we extract the component we need, and append it into global tree.
:param xml: xml file path
:param goal_body: goal body, a tuple consist of id and name
"""
if not isinstance(xml, str):
raise ValueError("Please checkout your xml path.")
tree = ET.parse(xml)
root_node = tree.getroot()
# preprocess
self.tag_rename(goal_body[0], root_node)
# add assets
if root_node.find('asset') is not None:
self._file_repath(xml, root_node.find('asset'))
for asset in root_node.find('asset'):
self.root.find('asset').append(asset)
# add world-body
if root_node.find('worldbody') is not None:
for body in root_node.find('worldbody'):
node = self.root.find(f'.//body[@name=\'{goal_body[1]}\']')
if node is None:
node = self.root.find('worldbody')
node.append(body)
# add actuator
if root_node.find('actuator') is not None:
for actuator in root_node.find('actuator'):
self.root.find('actuator').append(actuator)
# add default
if root_node.find('default') is not None:
for default in root_node.find('default'):
self.root.find('default').append(default)
# add contact
if root_node.find('contact') is not None:
for contact in root_node.find('contact'):
self.root.find('contact').append(contact)
# add sensor
if root_node.find('sensor') is not None:
for sensor in root_node.find('sensor'):
self.root.find('sensor').append(sensor)
# add equality
if root_node.find('equality') is not None:
for equality in root_node.find('equality'):
self.root.find('equality').append(equality)
def _file_repath(self, xml_path, asset_node: ET.Element):
""" Reset file path of the assets to abstract path.
Note all the texture files should put into the texture dict.
:param xml_path: path of specified xml file
:param asset_node: node
"""
for child in asset_node:
if child.tag == 'mesh' and child.attrib['file'] is not None:
child.attrib['file'] = path.join(path.dirname(xml_path), child.attrib['file'])
elif child.tag == 'texture' and 'file' in child.attrib:
TEXTURE_DIR_PATH = path.dirname(__file__) + '/../assets/textures'
child.attrib['file'] = path.join(TEXTURE_DIR_PATH,
child.attrib['file'])
[文档]
def tag_rename(self, id, node: ET.Element):
for mesh in node.findall('.//mesh[@name]'):
for element in node.findall('.//geom[@mesh=\'{}\']'.format(mesh.attrib['name'])):
element.attrib['mesh'] = '{}_{}'.format(id, element.attrib['mesh'])
mesh.attrib['name'] = '{}_{}'.format(id, mesh.attrib['name'])
for body in node.findall('.//body[@name]'):
for element in node.findall('.//'):
for key, value in element.attrib.items():
if value == body.attrib['name'] and key != 'mesh':
element.attrib[key] = '{}_{}'.format(id, element.attrib[key])
for geom in node.findall('.//geom[@name]'):
geom.attrib['name'] = '{}_{}'.format(id, geom.attrib['name'])
# for default in node.findall('.//default'):
# if 'class' in default.attrib:
# for geom in node.findall('.//geom'):
# if 'class' in geom.attrib and geom.get('class') == default.attrib['class']:
# geom.set('class', '{}_{}'.format(id, geom.attrib['class']))
# for body in node.findall('.//body'):
# if 'childclass' in body.attrib and body.get('childclass') == default.attrib['class']:
# body.set('childclass', '{}_{}'.format(id, body.attrib['childclass']))
# default.set('class', '{}_{}'.format(id, default.attrib['class']))
for joint in node.findall('.//joint[@name]'):
target = joint.attrib['name']
for element in node.findall('.//'):
for key, value in element.attrib.items():
if value == target:
element.attrib[key] = '{}_{}'.format(id, element.attrib[key])
for connect in node.findall('.//connect[@name]'):
for element in node.findall('.//'):
for key, value in element.attrib.items():
if value == connect.attrib['name']:
element.attrib[key] = '{}_{}'.format(id, element.attrib[key])
for site in node.findall('.//site[@name]'):
for element in node.findall('.//'):
for key, value in element.attrib.items():
if value == site.attrib['name'] and element.tag != 'site':
element.attrib[key] = '{}_{}'.format(id, element.attrib[key])
site.set('name', '{}_{}'.format(id, site.attrib['name']))
for camera in node.findall('.//camera[@name]'):
camera.set('name', '{}_{}'.format(id, camera.attrib['name']))
for sensor in node.findall('.//sensor/*[@name]'):
sensor.set('name', '{}_{}'.format(id, sensor.attrib['name']))
for actuator in node.findall('.//actuator/*[@name]'):
actuator.set('name', '{}_{}'.format(id, actuator.attrib['name']))
[文档]
def add_node_from_xml(self, xml_path: str = None):
""" Add node from xml file. The attached node is the parent node of the new node.
:param node: the parent node of the new node
:param xml_path: the path of the xml file
"""
if xml_path is None:
raise ValueError("Please checkout your xml path.")
new_tree = ET.parse(xml_path)
for node_type in ['worldbody', 'asset', 'actuator']:
new_node = new_tree.getroot().find(node_type)
if new_node is not None:
parent_element = self.root.find(node_type)
new_node = new_node.findall('*')
if isinstance(new_node, list):
for node in new_node:
parent_element.append(node)
else:
parent_element.append(new_node)
[文档]
def set_node_attrib(self, node: str, name: str, attrib: dict):
""" Set node attribute.
e.g.
>>> self.set_node_attrib('body', 'green_block', {'pos': '0.5 0.0 0.46'})
:param node: node name
:param attrib: attribute dict
"""
node_element = self.root.find(f'.//{node}[@name=\'{name}\']')
for key in attrib:
node_element.set(key, attrib[key])
[文档]
def add_node_from_str(self, father_node: str, xml_text: str):
parent_element = self.root.find(father_node)
new_element = ET.fromstring(xml_text)
parent_element.append(new_element)
[文档]
def add_texture(self, name: str, type: str, file: str):
parent_element = self.root.find("asset")
texture_element = ET.Element('texture')
texture_element.set('name', name)
texture_element.set('type', type)
texture_element.set('file', file)
parent_element.append(texture_element)
[文档]
def add_material(self, name: str, texture: str, texrepeat: str, texuniform: str):
parent_element = self.root.find("asset")
material_element = ET.Element('material')
material_element.set('name', name)
material_element.set('texture', texture)
material_element.set('texrepeat', texrepeat)
material_element.set('texuniform', texuniform)
parent_element.append(material_element)
[文档]
def add_mesh(self, name: str, file: str, **kwargs):
parent_element = self.root.find("asset")
mesh_element = ET.Element('mesh')
mesh_element.set('name', name)
mesh_element.set('file', file)
for key in kwargs:
mesh_element.set(key, kwargs[key])
parent_element.append(mesh_element)
[文档]
def add_geom(self, node: str, **kwargs):
if node == 'worldbody':
geom_element = self.root.find('worldbody')
else:
geom_element = self.root.find(f'.//body[@name=\'{node}\']')
geom = ET.Element('geom')
for key in kwargs:
geom.set(key, kwargs[key])
geom_element.append(geom)
[文档]
def add_body(self, node: str, **kwargs):
if node == 'worldbody':
body_element = self.root.find('worldbody')
else:
body_element = self.root.find(f'.//body[@name=\'{node}\']')
body = ET.Element('body')
for key in kwargs:
body.set(key, kwargs[key])
body_element.append(body)
[文档]
def add_joint(self, node: str, **kwargs):
if node == 'worldbody':
joint_element = self.root.find('worldbody')
else:
joint_element = self.root.find(f'.//body[@name=\'{node}\']')
joint = ET.Element('joint')
for key in kwargs:
joint.set(key, kwargs[key])
joint_element.append(joint)
[文档]
def save_xml(self, output_path='../assets'):
""" Save xml file with identity path"""
self.tree.write(path.join(output_path, f"{self.xml_name}.xml"))
[文档]
def save_and_load_xml(self, output_path=path.join(path.dirname(__file__), '../assets')):
""" Save xml file and get its path"""
self.save_xml(output_path)
return path.abspath(path.join(output_path, f"{self.xml_name}.xml"))
[文档]
def splice_robot(self, scene=None, mount=None, manipulator=None, gripper=None, **kwargs):
""" Splice the robot with the given scene, mount, manipulator and gripper.
:param scene: scene name
:param mount: mount name
:param manipulator: manipulator name
:param gripper: gripper name
:param kwargs:
"""
# Check the scene.
if isinstance(scene, str):
if scene.endswith('.xml'):
scene_path = scene
else:
scene_path = path.join(SCENES_DIR_PATH, '{}.xml'.format(scene))
self._init_scene(scene_path)
else:
raise ValueError("Must have scene.xml to generate the world.")
if isinstance(mount, str):
mount = [mount]
if isinstance(mount, list):
for ch_id, ch_name in enumerate(mount):
if ch_name.endswith('.xml'):
mount_path = ch_name
else:
mount_path = path.join(MOUNTS_DIR_PATH, ch_name, '{}.xml'.format(ch_name))
self.add_component_from_xml(mount_path, goal_body=(ch_id, 'worldbody'))
if isinstance(manipulator, str):
manipulator = [manipulator]
if isinstance(manipulator, list):
for mani_id, mani_name in enumerate(manipulator):
if mani_name.endswith('.xml'):
manipulator_path = mani_name
else:
manipulator_path = path.join(MANIPULATORS_DIR_PATH, mani_name, '{}.xml'.format(mani_name))
self.add_component_from_xml(manipulator_path,
goal_body=(mani_id, f'{mani_id}_mount_base_link') if mount is not None else (mani_id, 'worldbody'))
if gripper is not None:
assert kwargs['attached_body'] is not None, "Please specify the attached_body for the gripper."
attached_body = kwargs['attached_body'] if isinstance(kwargs['attached_body'], list) else [kwargs['attached_body']]
if isinstance(gripper, str):
gripper = [gripper]
if isinstance(gripper, list):
for goal_body, g in zip(enumerate(attached_body), gripper):
gripper_path = path.join(GRIPPERS_DIR_PATH, g, '{}.xml'.format(g))
self.add_component_from_xml(gripper_path, goal_body=goal_body)
