import copy
from copy import deepcopy
import numpy as np
import xml.etree.ElementTree as ET

import robosuite.utils.macros as macros
from robosuite.models.base import MujocoXML, MujocoModel
from robosuite.utils.mjcf_utils import string_to_array, array_to_string, CustomMaterial, OBJECT_COLLISION_COLOR,\
                                       sort_elements, new_joint, add_prefix, add_material, find_elements


# Dict mapping geom type string keywords to group number
GEOMTYPE2GROUP = {
    "collision": {0},                 # If we want to use a geom for physics, but NOT visualize
    "visual": {1},                    # If we want to use a geom for visualization, but NOT physics
    "all": {0, 1},                    # If we want to use a geom for BOTH physics + visualization
}

GEOM_GROUPS = GEOMTYPE2GROUP.keys()


class MujocoObject(MujocoModel):
    """
    Base class for all objects.

    We use Mujoco Objects to implement all objects that:

        1) may appear for multiple times in a task
        2) can be swapped between different tasks

    Typical methods return copy so the caller can all joints/attributes as wanted

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy

    """

    def __init__(self, obj_type="all", duplicate_collision_geoms=True):
        super().__init__()
        self.asset = ET.Element("asset")
        assert obj_type in GEOM_GROUPS, "object type must be one in {}, got: {} instead.".format(GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms

        # Attributes that should be filled in within the subclass
        self._name = None
        self._obj = None

        # Attributes that are auto-filled by _get_object_properties call
        self._root_body = None
        self._bodies = None
        self._joints = None
        self._actuators = None
        self._sites = None
        self._contact_geoms = None
        self._visual_geoms = None

        # Attributes for composite objects
        self._count = None
        self._composite_type = None
        self._spacing = None
        self._composite_shape = None

    def merge_assets(self, other):
        """
        Merges @other's assets in a custom logic.

        Args:
            other (MujocoXML or MujocoObject): other xml file whose assets will be merged into this one
        """
        for asset in other.asset:
            if find_elements(root=self.asset, tags=asset.tag,
                             attribs={"name": asset.get("name")}, return_first=True) is None:
                self.asset.append(asset)

    def get_obj(self):
        """
        Returns the generated / extracted object, in XML ElementTree form.

        Returns:
            ET.Element: Object in XML form.
        """
        assert self._obj is not None, "Object XML tree has not been generated yet!"
        return self._obj

    def exclude_from_prefixing(self, inp):
        """
        A function that should take in either an ET.Element or its attribute (str) and return either True or False,
        determining whether the corresponding name / str to @inp should have naming_prefix added to it.
        Must be defined by subclass.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        raise NotImplementedError

    def _get_object_subtree(self):

        """
        Returns a ET.Element
        It is a <body/> subtree that defines all collision and / or visualization related fields
        of this object.
        Return should be a copy.
        Must be defined by subclass.

        Returns:
            ET.Element: body
        """
        raise NotImplementedError

    def _get_object_properties(self):
        """
        Helper function to extract relevant object properties (bodies, joints, contact/visual geoms, etc...) from this
        object's XML tree. Assumes the self._obj attribute has already been filled.
        """
        # Parse element tree to get all relevant bodies, joints, actuators, and geom groups
        _elements = sort_elements(root=self.get_obj())
        # print(ET.tostring(self.get_obj(), encoding='unicode', method='xml'))
        assert len(_elements["root_body"]) == 1, "Invalid number of root bodies found for robot model. Expected 1," \
                                                 "got {}".format(len(_elements["root_body"]))
        _elements["root_body"] = _elements["root_body"][0]
        _elements["bodies"] = [_elements["root_body"]] + _elements["bodies"] if "bodies" in _elements else \
                              [_elements["root_body"]]
        self._root_body = _elements["root_body"].get("name")
        self._bodies = [e.get("name") for e in _elements.get("bodies", [])]
        self._joints = [e.get("name") for e in _elements.get("joints", [])]
        self._actuators = [e.get("name") for e in _elements.get("actuators", [])]
        self._sites = [e.get("name") for e in _elements.get("sites", [])]
        self._sensors = [e.get("name") for e in _elements.get("sensors", [])]
        composite_obj = _elements["root_body"].find("./body/composite")
        if  composite_obj is not None:
            self._count = np.fromstring(composite_obj.get("count"), dtype=int, sep=' ')
            self._composite_type = composite_obj.get("type")
            self._spacing = float(composite_obj.get("spacing"))
            assert len(self._count) == 3, "the length of count must be 3, got: {} instead.".format(len(self._count))
            dim = 3 - np.sum(self._count==1)
            self._composite_shape = [self._spacing * (self._count[i] - 1) for i in range(dim)]
            if dim == 1:
                self._contact_geoms = [f'G{i}' for i in range(self._count[0])] 
            elif dim == 2:                   
                self._contact_geoms = [f'G{i}_{j}' for j in range(self._count[1])
                                                   for i in range(self._count[0])]
            elif dim == 3:
                self._contact_geoms = [f'G{i}_{j}_{k}' for k in range(self._count[2])
                                                       for j in range(self._count[1])
                                                       for i in range(self._count[0])]
        else:
            self._contact_geoms = [e.get("name") for e in _elements.get("contact_geoms", [])]
        self._visual_geoms = [e.get("name") for e in _elements.get("visual_geoms", [])]

        # Add default materials if we're using domain randomization
        if macros.USING_INSTANCE_RANDOMIZATION:
            tex_element, mat_element, _, used = add_material(root=self.get_obj(), naming_prefix=self.naming_prefix)
            # Only add the material / texture if they were actually used
            if used:
                self.asset.append(tex_element)
                self.asset.append(mat_element)

        # Add prefix to all elements
        add_prefix(root=self.get_obj(), prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    @property
    def name(self):
        return self._name

    @property
    def naming_prefix(self):
        return "{}_".format(self.name)

    @property
    def root_body(self):
        return self.correct_naming(self._root_body)

    @property
    def bodies(self):
        return self.correct_naming(self._bodies)

    @property
    def joints(self):
        return self.correct_naming(self._joints)

    @property
    def actuators(self):
        return self.correct_naming(self._actuators)

    @property
    def sites(self):
        return self.correct_naming(self._sites)

    @property
    def sensors(self):
        return self.correct_naming(self._sensors)

    @property
    def contact_geoms(self):
        return self.correct_naming(self._contact_geoms)

    @property
    def visual_geoms(self):
        return self.correct_naming(self._visual_geoms)

    @property
    def important_geoms(self):
        """
        Returns:
             dict: (Default is no important geoms; i.e.: empty dict)
        """
        return {}

    @property
    def important_sites(self):
        """
        Returns:
            dict:

                :`obj`: Object default site
        """
        return {"obj": self.naming_prefix + "default_site"}

    @property
    def important_sensors(self):
        """
        Returns:
            dict: (Default is no sensors; i.e.: empty dict)
        """
        return {}

    @property
    def bottom_offset(self):
        """
        Returns vector from model root body to model bottom.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def top_offset(self):
        """
        Returns vector from model root body to model top.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def horizontal_radius(self):
        """
        Returns maximum distance from model root body to any radial point of the model.

        Helps us put models programmatically without them flying away due to a huge initial contact force.
        Must be defined by subclass.

        Returns:
            float: radius
        """
        raise NotImplementedError

    @staticmethod
    def get_site_attrib_template():
        """
        Returns attribs of spherical site used to mark body origin

        Returns:
            dict: Dictionary of default site attributes
        """
        return {
            "pos": "0 0 0",
            "size": "0.002 0.002 0.002",
            "rgba": "1 0 0 1",
            "type": "sphere",
            "group": "0",
        }

    @staticmethod
    def get_joint_attrib_template():
        """
        Returns attribs of free joint

        Returns:
            dict: Dictionary of default joint attributes
        """
        return {
            "type": "free",
        }


class MujocoXMLObject(MujocoObject, MujocoXML):
    """
    MujocoObjects that are loaded from xml files (by default, inherit all properties (e.g.: name)
    from MujocoObject class first!)

    Args:
        fname (str): XML File path

        name (str): Name of this MujocoXMLObject

        joints (None or str or list of dict): each dictionary corresponds to a joint that will be created for this
            object. The dictionary should specify the joint attributes (type, pos, etc.) according to the MuJoCo xml
            specification. If "default", a single free-joint will be automatically generated. If None, no joints will
            be created.

        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, fname, name, joints="default", obj_type="all", duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        # Set obj type and duplicate args
        assert obj_type in GEOM_GROUPS, "object type must be one in {}, got: {} instead.".format(GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms

        # Set name
        self._name = name

        # joints for this object
        if joints == "default":
            self.joint_specs = [self.get_joint_attrib_template()]  # default free joint
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints

        # Make sure all joints have names!
        for i, joint_spec in enumerate(self.joint_specs):
            if "name" not in joint_spec:
                joint_spec["name"] = "joint{}".format(i)

        # Lastly, parse XML tree appropriately
        self._obj = self._get_object_subtree()

        # Extract the appropriate private attributes for this
        self._get_object_properties()
        # print(ET.tostring(self.root, encoding='unicode', method='xml'))

    def _get_object_subtree(self):
        # Parse object
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        # exit(0)
        # Rename this top level object body (will have self.naming_prefix added later)
        obj.attrib["name"] = "main"
        # Get all geom_pairs in this tree
        geom_pairs = self._get_geoms(obj)

        # Define a temp function so we don't duplicate so much code
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get("group")) in GEOMTYPE2GROUP[obj_type]

        # Loop through each of these pairs and modify them according to @elements arg
        for i, (parent, element) in enumerate(geom_pairs):
            # Delete non-relevant geoms and rename remaining ones
            if not _should_keep(element):
                parent.remove(element)
            else:
                if parent.tag == 'composite': #composite objects' geoms do not have name attribute
                    pass
                else:
                    g_name = element.get("name")
                    g_name = g_name if g_name is not None else f"g{i}"
                    element.set("name", g_name)
                    # Also optionally duplicate collision geoms if requested (and this is a collision geom)
                    if self.duplicate_collision_geoms and element.get("group") in {None, "0"}:
                        parent.append(self._duplicate_visual_from_collision(element))
                        # Also manually set the visual appearances to the original collision model
                        element.set("rgba", array_to_string(OBJECT_COLLISION_COLOR))
                        if element.get("material") is not None:
                            del element.attrib["material"]
        # add joint(s)
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        # Lastly, add a site for this object
        template = self.get_site_attrib_template()
        template["rgba"] = "1 0 0 0"
        template["name"] = "default_site"
        obj.append(ET.Element("site", attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        # if isinstance(inp, ET.Element) and inp.find("./composite") is not None:
        #     #if this body is next to "composite", its name should not be changed 
        #     if inp.find("./composite").get("type") in ['cloth','rope']:
        #         return True
        return False

    def _get_object_properties(self):
        """
        Extends the base class method to also add prefixes to all bodies in this object
        """
        super()._get_object_properties()
        add_prefix(root=self.root, prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        # Copy element
        vis_element = deepcopy(element)
        # Modify for visual-specific attributes (group=1, conaffinity/contype=0, no mass, update name)
        vis_element.set("group", "1")
        vis_element.set("conaffinity", "0")
        vis_element.set("contype", "0")
        vis_element.set("mass", "1e-8")
        vis_element.set("name", vis_element.get("name") + "_visual")
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        # Initialize return array
        geom_pairs = []
        # If the parent exists and this is a geom element, we add this current (parent, element) combo to the output
        if _parent is not None and root.tag == "geom":
            geom_pairs.append((_parent, root))
        # Loop through all children elements recursively and add to pairs
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        # Return all found pairs
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']".format(self.naming_prefix))
        return string_to_array(bottom_site.get("pos"))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".format(self.naming_prefix))
        return string_to_array(top_site.get("pos"))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.naming_prefix)
        )
        return string_to_array(horizontal_radius_site.get("pos"))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type="all", duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=duplicate_collision_geoms)

        # Store common material names so we don't add prefixes to them
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {"group": "0", "rgba": array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {"conaffinity": "0", "contype": "0", "mass": "1e-8", "group": "1"}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        # First check if asset attribute exists; if not, define the asset attribute
        if not hasattr(self, "asset"):
            self.asset = ET.Element("asset")
        # If the material name is not in shared materials, add this to our assets
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element("texture", attrib=material.tex_attrib))
            self.asset.append(ET.Element("material", attrib=material.mat_attrib))
        # Add this material name to shared materials if it should be shared
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib["name"])
        # Update prefix for assets
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        # Automatically return False if this is not of type "str"
        if type(inp) is not str:
            return False
        # Only return True if the string matches the name of a common material
        return True if inp in self.shared_materials or inp in self.shared_textures else False

    # Methods that still need to be defined by subclass
    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError

ecc7549b8eae0c415f441ea375f7acc95f8844fb
<mask token>


class MujocoXMLObject(MujocoObject, MujocoXML):
    <mask token>

    def __init__(self, fname, name, joints='default', obj_type='all',
        duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        assert obj_type in GEOM_GROUPS, 'object type must be one in {}, got: {} instead.'.format(
            GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms
        self._name = name
        if joints == 'default':
            self.joint_specs = [self.get_joint_attrib_template()]
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints
        for i, joint_spec in enumerate(self.joint_specs):
            if 'name' not in joint_spec:
                joint_spec['name'] = 'joint{}'.format(i)
        self._obj = self._get_object_subtree()
        self._get_object_properties()

    def _get_object_subtree(self):
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        obj.attrib['name'] = 'main'
        geom_pairs = self._get_geoms(obj)
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get('group')) in GEOMTYPE2GROUP[obj_type]
        for i, (parent, element) in enumerate(geom_pairs):
            if not _should_keep(element):
                parent.remove(element)
            elif parent.tag == 'composite':
                pass
            else:
                g_name = element.get('name')
                g_name = g_name if g_name is not None else f'g{i}'
                element.set('name', g_name)
                if self.duplicate_collision_geoms and element.get('group') in {
                    None, '0'}:
                    parent.append(self._duplicate_visual_from_collision(
                        element))
                    element.set('rgba', array_to_string(OBJECT_COLLISION_COLOR)
                        )
                    if element.get('material') is not None:
                        del element.attrib['material']
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        template = self.get_site_attrib_template()
        template['rgba'] = '1 0 0 0'
        template['name'] = 'default_site'
        obj.append(ET.Element('site', attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        return False
    <mask token>

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        vis_element = deepcopy(element)
        vis_element.set('group', '1')
        vis_element.set('conaffinity', '0')
        vis_element.set('contype', '0')
        vis_element.set('mass', '1e-8')
        vis_element.set('name', vis_element.get('name') + '_visual')
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        geom_pairs = []
        if _parent is not None and root.tag == 'geom':
            geom_pairs.append((_parent, root))
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']"
            .format(self.naming_prefix))
        return string_to_array(bottom_site.get('pos'))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".
            format(self.naming_prefix))
        return string_to_array(top_site.get('pos'))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.
            naming_prefix))
        return string_to_array(horizontal_radius_site.get('pos'))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type='all', duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=
            duplicate_collision_geoms)
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {'group': '0', 'rgba': array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {'conaffinity': '0', 'contype': '0', 'mass': '1e-8', 'group':
            '1'}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        if not hasattr(self, 'asset'):
            self.asset = ET.Element('asset')
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element('texture', attrib=material.tex_attrib)
                )
            self.asset.append(ET.Element('material', attrib=material.
                mat_attrib))
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib['name'])
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self
            .exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        if type(inp) is not str:
            return False
        return (True if inp in self.shared_materials or inp in self.
            shared_textures else False)

    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError

<mask token>


class MujocoObject(MujocoModel):
    <mask token>
    <mask token>

    def merge_assets(self, other):
        """
        Merges @other's assets in a custom logic.

        Args:
            other (MujocoXML or MujocoObject): other xml file whose assets will be merged into this one
        """
        for asset in other.asset:
            if find_elements(root=self.asset, tags=asset.tag, attribs={
                'name': asset.get('name')}, return_first=True) is None:
                self.asset.append(asset)

    def get_obj(self):
        """
        Returns the generated / extracted object, in XML ElementTree form.

        Returns:
            ET.Element: Object in XML form.
        """
        assert self._obj is not None, 'Object XML tree has not been generated yet!'
        return self._obj

    def exclude_from_prefixing(self, inp):
        """
        A function that should take in either an ET.Element or its attribute (str) and return either True or False,
        determining whether the corresponding name / str to @inp should have naming_prefix added to it.
        Must be defined by subclass.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        raise NotImplementedError

    def _get_object_subtree(self):
        """
        Returns a ET.Element
        It is a <body/> subtree that defines all collision and / or visualization related fields
        of this object.
        Return should be a copy.
        Must be defined by subclass.

        Returns:
            ET.Element: body
        """
        raise NotImplementedError

    def _get_object_properties(self):
        """
        Helper function to extract relevant object properties (bodies, joints, contact/visual geoms, etc...) from this
        object's XML tree. Assumes the self._obj attribute has already been filled.
        """
        _elements = sort_elements(root=self.get_obj())
        assert len(_elements['root_body']
            ) == 1, 'Invalid number of root bodies found for robot model. Expected 1,got {}'.format(
            len(_elements['root_body']))
        _elements['root_body'] = _elements['root_body'][0]
        _elements['bodies'] = [_elements['root_body']] + _elements['bodies'
            ] if 'bodies' in _elements else [_elements['root_body']]
        self._root_body = _elements['root_body'].get('name')
        self._bodies = [e.get('name') for e in _elements.get('bodies', [])]
        self._joints = [e.get('name') for e in _elements.get('joints', [])]
        self._actuators = [e.get('name') for e in _elements.get('actuators',
            [])]
        self._sites = [e.get('name') for e in _elements.get('sites', [])]
        self._sensors = [e.get('name') for e in _elements.get('sensors', [])]
        composite_obj = _elements['root_body'].find('./body/composite')
        if composite_obj is not None:
            self._count = np.fromstring(composite_obj.get('count'), dtype=
                int, sep=' ')
            self._composite_type = composite_obj.get('type')
            self._spacing = float(composite_obj.get('spacing'))
            assert len(self._count
                ) == 3, 'the length of count must be 3, got: {} instead.'.format(
                len(self._count))
            dim = 3 - np.sum(self._count == 1)
            self._composite_shape = [(self._spacing * (self._count[i] - 1)) for
                i in range(dim)]
            if dim == 1:
                self._contact_geoms = [f'G{i}' for i in range(self._count[0])]
            elif dim == 2:
                self._contact_geoms = [f'G{i}_{j}' for j in range(self.
                    _count[1]) for i in range(self._count[0])]
            elif dim == 3:
                self._contact_geoms = [f'G{i}_{j}_{k}' for k in range(self.
                    _count[2]) for j in range(self._count[1]) for i in
                    range(self._count[0])]
        else:
            self._contact_geoms = [e.get('name') for e in _elements.get(
                'contact_geoms', [])]
        self._visual_geoms = [e.get('name') for e in _elements.get(
            'visual_geoms', [])]
        if macros.USING_INSTANCE_RANDOMIZATION:
            tex_element, mat_element, _, used = add_material(root=self.
                get_obj(), naming_prefix=self.naming_prefix)
            if used:
                self.asset.append(tex_element)
                self.asset.append(mat_element)
        add_prefix(root=self.get_obj(), prefix=self.naming_prefix, exclude=
            self.exclude_from_prefixing)

    @property
    def name(self):
        return self._name

    @property
    def naming_prefix(self):
        return '{}_'.format(self.name)

    @property
    def root_body(self):
        return self.correct_naming(self._root_body)

    @property
    def bodies(self):
        return self.correct_naming(self._bodies)
    <mask token>

    @property
    def actuators(self):
        return self.correct_naming(self._actuators)
    <mask token>

    @property
    def sensors(self):
        return self.correct_naming(self._sensors)
    <mask token>

    @property
    def visual_geoms(self):
        return self.correct_naming(self._visual_geoms)

    @property
    def important_geoms(self):
        """
        Returns:
             dict: (Default is no important geoms; i.e.: empty dict)
        """
        return {}
    <mask token>

    @property
    def important_sensors(self):
        """
        Returns:
            dict: (Default is no sensors; i.e.: empty dict)
        """
        return {}

    @property
    def bottom_offset(self):
        """
        Returns vector from model root body to model bottom.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def top_offset(self):
        """
        Returns vector from model root body to model top.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError
    <mask token>

    @staticmethod
    def get_site_attrib_template():
        """
        Returns attribs of spherical site used to mark body origin

        Returns:
            dict: Dictionary of default site attributes
        """
        return {'pos': '0 0 0', 'size': '0.002 0.002 0.002', 'rgba':
            '1 0 0 1', 'type': 'sphere', 'group': '0'}

    @staticmethod
    def get_joint_attrib_template():
        """
        Returns attribs of free joint

        Returns:
            dict: Dictionary of default joint attributes
        """
        return {'type': 'free'}


class MujocoXMLObject(MujocoObject, MujocoXML):
    """
    MujocoObjects that are loaded from xml files (by default, inherit all properties (e.g.: name)
    from MujocoObject class first!)

    Args:
        fname (str): XML File path

        name (str): Name of this MujocoXMLObject

        joints (None or str or list of dict): each dictionary corresponds to a joint that will be created for this
            object. The dictionary should specify the joint attributes (type, pos, etc.) according to the MuJoCo xml
            specification. If "default", a single free-joint will be automatically generated. If None, no joints will
            be created.

        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, fname, name, joints='default', obj_type='all',
        duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        assert obj_type in GEOM_GROUPS, 'object type must be one in {}, got: {} instead.'.format(
            GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms
        self._name = name
        if joints == 'default':
            self.joint_specs = [self.get_joint_attrib_template()]
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints
        for i, joint_spec in enumerate(self.joint_specs):
            if 'name' not in joint_spec:
                joint_spec['name'] = 'joint{}'.format(i)
        self._obj = self._get_object_subtree()
        self._get_object_properties()

    def _get_object_subtree(self):
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        obj.attrib['name'] = 'main'
        geom_pairs = self._get_geoms(obj)
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get('group')) in GEOMTYPE2GROUP[obj_type]
        for i, (parent, element) in enumerate(geom_pairs):
            if not _should_keep(element):
                parent.remove(element)
            elif parent.tag == 'composite':
                pass
            else:
                g_name = element.get('name')
                g_name = g_name if g_name is not None else f'g{i}'
                element.set('name', g_name)
                if self.duplicate_collision_geoms and element.get('group') in {
                    None, '0'}:
                    parent.append(self._duplicate_visual_from_collision(
                        element))
                    element.set('rgba', array_to_string(OBJECT_COLLISION_COLOR)
                        )
                    if element.get('material') is not None:
                        del element.attrib['material']
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        template = self.get_site_attrib_template()
        template['rgba'] = '1 0 0 0'
        template['name'] = 'default_site'
        obj.append(ET.Element('site', attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        return False

    def _get_object_properties(self):
        """
        Extends the base class method to also add prefixes to all bodies in this object
        """
        super()._get_object_properties()
        add_prefix(root=self.root, prefix=self.naming_prefix, exclude=self.
            exclude_from_prefixing)

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        vis_element = deepcopy(element)
        vis_element.set('group', '1')
        vis_element.set('conaffinity', '0')
        vis_element.set('contype', '0')
        vis_element.set('mass', '1e-8')
        vis_element.set('name', vis_element.get('name') + '_visual')
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        geom_pairs = []
        if _parent is not None and root.tag == 'geom':
            geom_pairs.append((_parent, root))
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']"
            .format(self.naming_prefix))
        return string_to_array(bottom_site.get('pos'))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".
            format(self.naming_prefix))
        return string_to_array(top_site.get('pos'))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.
            naming_prefix))
        return string_to_array(horizontal_radius_site.get('pos'))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type='all', duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=
            duplicate_collision_geoms)
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {'group': '0', 'rgba': array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {'conaffinity': '0', 'contype': '0', 'mass': '1e-8', 'group':
            '1'}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        if not hasattr(self, 'asset'):
            self.asset = ET.Element('asset')
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element('texture', attrib=material.tex_attrib)
                )
            self.asset.append(ET.Element('material', attrib=material.
                mat_attrib))
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib['name'])
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self
            .exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        if type(inp) is not str:
            return False
        return (True if inp in self.shared_materials or inp in self.
            shared_textures else False)

    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError

<mask token>


class MujocoObject(MujocoModel):
    <mask token>
    <mask token>

    def merge_assets(self, other):
        """
        Merges @other's assets in a custom logic.

        Args:
            other (MujocoXML or MujocoObject): other xml file whose assets will be merged into this one
        """
        for asset in other.asset:
            if find_elements(root=self.asset, tags=asset.tag, attribs={
                'name': asset.get('name')}, return_first=True) is None:
                self.asset.append(asset)

    def get_obj(self):
        """
        Returns the generated / extracted object, in XML ElementTree form.

        Returns:
            ET.Element: Object in XML form.
        """
        assert self._obj is not None, 'Object XML tree has not been generated yet!'
        return self._obj

    def exclude_from_prefixing(self, inp):
        """
        A function that should take in either an ET.Element or its attribute (str) and return either True or False,
        determining whether the corresponding name / str to @inp should have naming_prefix added to it.
        Must be defined by subclass.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        raise NotImplementedError

    def _get_object_subtree(self):
        """
        Returns a ET.Element
        It is a <body/> subtree that defines all collision and / or visualization related fields
        of this object.
        Return should be a copy.
        Must be defined by subclass.

        Returns:
            ET.Element: body
        """
        raise NotImplementedError

    def _get_object_properties(self):
        """
        Helper function to extract relevant object properties (bodies, joints, contact/visual geoms, etc...) from this
        object's XML tree. Assumes the self._obj attribute has already been filled.
        """
        _elements = sort_elements(root=self.get_obj())
        assert len(_elements['root_body']
            ) == 1, 'Invalid number of root bodies found for robot model. Expected 1,got {}'.format(
            len(_elements['root_body']))
        _elements['root_body'] = _elements['root_body'][0]
        _elements['bodies'] = [_elements['root_body']] + _elements['bodies'
            ] if 'bodies' in _elements else [_elements['root_body']]
        self._root_body = _elements['root_body'].get('name')
        self._bodies = [e.get('name') for e in _elements.get('bodies', [])]
        self._joints = [e.get('name') for e in _elements.get('joints', [])]
        self._actuators = [e.get('name') for e in _elements.get('actuators',
            [])]
        self._sites = [e.get('name') for e in _elements.get('sites', [])]
        self._sensors = [e.get('name') for e in _elements.get('sensors', [])]
        composite_obj = _elements['root_body'].find('./body/composite')
        if composite_obj is not None:
            self._count = np.fromstring(composite_obj.get('count'), dtype=
                int, sep=' ')
            self._composite_type = composite_obj.get('type')
            self._spacing = float(composite_obj.get('spacing'))
            assert len(self._count
                ) == 3, 'the length of count must be 3, got: {} instead.'.format(
                len(self._count))
            dim = 3 - np.sum(self._count == 1)
            self._composite_shape = [(self._spacing * (self._count[i] - 1)) for
                i in range(dim)]
            if dim == 1:
                self._contact_geoms = [f'G{i}' for i in range(self._count[0])]
            elif dim == 2:
                self._contact_geoms = [f'G{i}_{j}' for j in range(self.
                    _count[1]) for i in range(self._count[0])]
            elif dim == 3:
                self._contact_geoms = [f'G{i}_{j}_{k}' for k in range(self.
                    _count[2]) for j in range(self._count[1]) for i in
                    range(self._count[0])]
        else:
            self._contact_geoms = [e.get('name') for e in _elements.get(
                'contact_geoms', [])]
        self._visual_geoms = [e.get('name') for e in _elements.get(
            'visual_geoms', [])]
        if macros.USING_INSTANCE_RANDOMIZATION:
            tex_element, mat_element, _, used = add_material(root=self.
                get_obj(), naming_prefix=self.naming_prefix)
            if used:
                self.asset.append(tex_element)
                self.asset.append(mat_element)
        add_prefix(root=self.get_obj(), prefix=self.naming_prefix, exclude=
            self.exclude_from_prefixing)

    @property
    def name(self):
        return self._name

    @property
    def naming_prefix(self):
        return '{}_'.format(self.name)

    @property
    def root_body(self):
        return self.correct_naming(self._root_body)

    @property
    def bodies(self):
        return self.correct_naming(self._bodies)
    <mask token>

    @property
    def actuators(self):
        return self.correct_naming(self._actuators)
    <mask token>

    @property
    def sensors(self):
        return self.correct_naming(self._sensors)

    @property
    def contact_geoms(self):
        return self.correct_naming(self._contact_geoms)

    @property
    def visual_geoms(self):
        return self.correct_naming(self._visual_geoms)

    @property
    def important_geoms(self):
        """
        Returns:
             dict: (Default is no important geoms; i.e.: empty dict)
        """
        return {}
    <mask token>

    @property
    def important_sensors(self):
        """
        Returns:
            dict: (Default is no sensors; i.e.: empty dict)
        """
        return {}

    @property
    def bottom_offset(self):
        """
        Returns vector from model root body to model bottom.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def top_offset(self):
        """
        Returns vector from model root body to model top.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError
    <mask token>

    @staticmethod
    def get_site_attrib_template():
        """
        Returns attribs of spherical site used to mark body origin

        Returns:
            dict: Dictionary of default site attributes
        """
        return {'pos': '0 0 0', 'size': '0.002 0.002 0.002', 'rgba':
            '1 0 0 1', 'type': 'sphere', 'group': '0'}

    @staticmethod
    def get_joint_attrib_template():
        """
        Returns attribs of free joint

        Returns:
            dict: Dictionary of default joint attributes
        """
        return {'type': 'free'}


class MujocoXMLObject(MujocoObject, MujocoXML):
    """
    MujocoObjects that are loaded from xml files (by default, inherit all properties (e.g.: name)
    from MujocoObject class first!)

    Args:
        fname (str): XML File path

        name (str): Name of this MujocoXMLObject

        joints (None or str or list of dict): each dictionary corresponds to a joint that will be created for this
            object. The dictionary should specify the joint attributes (type, pos, etc.) according to the MuJoCo xml
            specification. If "default", a single free-joint will be automatically generated. If None, no joints will
            be created.

        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, fname, name, joints='default', obj_type='all',
        duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        assert obj_type in GEOM_GROUPS, 'object type must be one in {}, got: {} instead.'.format(
            GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms
        self._name = name
        if joints == 'default':
            self.joint_specs = [self.get_joint_attrib_template()]
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints
        for i, joint_spec in enumerate(self.joint_specs):
            if 'name' not in joint_spec:
                joint_spec['name'] = 'joint{}'.format(i)
        self._obj = self._get_object_subtree()
        self._get_object_properties()

    def _get_object_subtree(self):
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        obj.attrib['name'] = 'main'
        geom_pairs = self._get_geoms(obj)
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get('group')) in GEOMTYPE2GROUP[obj_type]
        for i, (parent, element) in enumerate(geom_pairs):
            if not _should_keep(element):
                parent.remove(element)
            elif parent.tag == 'composite':
                pass
            else:
                g_name = element.get('name')
                g_name = g_name if g_name is not None else f'g{i}'
                element.set('name', g_name)
                if self.duplicate_collision_geoms and element.get('group') in {
                    None, '0'}:
                    parent.append(self._duplicate_visual_from_collision(
                        element))
                    element.set('rgba', array_to_string(OBJECT_COLLISION_COLOR)
                        )
                    if element.get('material') is not None:
                        del element.attrib['material']
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        template = self.get_site_attrib_template()
        template['rgba'] = '1 0 0 0'
        template['name'] = 'default_site'
        obj.append(ET.Element('site', attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        return False

    def _get_object_properties(self):
        """
        Extends the base class method to also add prefixes to all bodies in this object
        """
        super()._get_object_properties()
        add_prefix(root=self.root, prefix=self.naming_prefix, exclude=self.
            exclude_from_prefixing)

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        vis_element = deepcopy(element)
        vis_element.set('group', '1')
        vis_element.set('conaffinity', '0')
        vis_element.set('contype', '0')
        vis_element.set('mass', '1e-8')
        vis_element.set('name', vis_element.get('name') + '_visual')
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        geom_pairs = []
        if _parent is not None and root.tag == 'geom':
            geom_pairs.append((_parent, root))
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']"
            .format(self.naming_prefix))
        return string_to_array(bottom_site.get('pos'))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".
            format(self.naming_prefix))
        return string_to_array(top_site.get('pos'))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.
            naming_prefix))
        return string_to_array(horizontal_radius_site.get('pos'))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type='all', duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=
            duplicate_collision_geoms)
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {'group': '0', 'rgba': array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {'conaffinity': '0', 'contype': '0', 'mass': '1e-8', 'group':
            '1'}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        if not hasattr(self, 'asset'):
            self.asset = ET.Element('asset')
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element('texture', attrib=material.tex_attrib)
                )
            self.asset.append(ET.Element('material', attrib=material.
                mat_attrib))
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib['name'])
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self
            .exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        if type(inp) is not str:
            return False
        return (True if inp in self.shared_materials or inp in self.
            shared_textures else False)

    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError

<mask token>


class MujocoObject(MujocoModel):
    <mask token>
    <mask token>

    def merge_assets(self, other):
        """
        Merges @other's assets in a custom logic.

        Args:
            other (MujocoXML or MujocoObject): other xml file whose assets will be merged into this one
        """
        for asset in other.asset:
            if find_elements(root=self.asset, tags=asset.tag, attribs={
                'name': asset.get('name')}, return_first=True) is None:
                self.asset.append(asset)

    def get_obj(self):
        """
        Returns the generated / extracted object, in XML ElementTree form.

        Returns:
            ET.Element: Object in XML form.
        """
        assert self._obj is not None, 'Object XML tree has not been generated yet!'
        return self._obj

    def exclude_from_prefixing(self, inp):
        """
        A function that should take in either an ET.Element or its attribute (str) and return either True or False,
        determining whether the corresponding name / str to @inp should have naming_prefix added to it.
        Must be defined by subclass.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        raise NotImplementedError

    def _get_object_subtree(self):
        """
        Returns a ET.Element
        It is a <body/> subtree that defines all collision and / or visualization related fields
        of this object.
        Return should be a copy.
        Must be defined by subclass.

        Returns:
            ET.Element: body
        """
        raise NotImplementedError

    def _get_object_properties(self):
        """
        Helper function to extract relevant object properties (bodies, joints, contact/visual geoms, etc...) from this
        object's XML tree. Assumes the self._obj attribute has already been filled.
        """
        _elements = sort_elements(root=self.get_obj())
        assert len(_elements['root_body']
            ) == 1, 'Invalid number of root bodies found for robot model. Expected 1,got {}'.format(
            len(_elements['root_body']))
        _elements['root_body'] = _elements['root_body'][0]
        _elements['bodies'] = [_elements['root_body']] + _elements['bodies'
            ] if 'bodies' in _elements else [_elements['root_body']]
        self._root_body = _elements['root_body'].get('name')
        self._bodies = [e.get('name') for e in _elements.get('bodies', [])]
        self._joints = [e.get('name') for e in _elements.get('joints', [])]
        self._actuators = [e.get('name') for e in _elements.get('actuators',
            [])]
        self._sites = [e.get('name') for e in _elements.get('sites', [])]
        self._sensors = [e.get('name') for e in _elements.get('sensors', [])]
        composite_obj = _elements['root_body'].find('./body/composite')
        if composite_obj is not None:
            self._count = np.fromstring(composite_obj.get('count'), dtype=
                int, sep=' ')
            self._composite_type = composite_obj.get('type')
            self._spacing = float(composite_obj.get('spacing'))
            assert len(self._count
                ) == 3, 'the length of count must be 3, got: {} instead.'.format(
                len(self._count))
            dim = 3 - np.sum(self._count == 1)
            self._composite_shape = [(self._spacing * (self._count[i] - 1)) for
                i in range(dim)]
            if dim == 1:
                self._contact_geoms = [f'G{i}' for i in range(self._count[0])]
            elif dim == 2:
                self._contact_geoms = [f'G{i}_{j}' for j in range(self.
                    _count[1]) for i in range(self._count[0])]
            elif dim == 3:
                self._contact_geoms = [f'G{i}_{j}_{k}' for k in range(self.
                    _count[2]) for j in range(self._count[1]) for i in
                    range(self._count[0])]
        else:
            self._contact_geoms = [e.get('name') for e in _elements.get(
                'contact_geoms', [])]
        self._visual_geoms = [e.get('name') for e in _elements.get(
            'visual_geoms', [])]
        if macros.USING_INSTANCE_RANDOMIZATION:
            tex_element, mat_element, _, used = add_material(root=self.
                get_obj(), naming_prefix=self.naming_prefix)
            if used:
                self.asset.append(tex_element)
                self.asset.append(mat_element)
        add_prefix(root=self.get_obj(), prefix=self.naming_prefix, exclude=
            self.exclude_from_prefixing)

    @property
    def name(self):
        return self._name

    @property
    def naming_prefix(self):
        return '{}_'.format(self.name)

    @property
    def root_body(self):
        return self.correct_naming(self._root_body)

    @property
    def bodies(self):
        return self.correct_naming(self._bodies)

    @property
    def joints(self):
        return self.correct_naming(self._joints)

    @property
    def actuators(self):
        return self.correct_naming(self._actuators)
    <mask token>

    @property
    def sensors(self):
        return self.correct_naming(self._sensors)

    @property
    def contact_geoms(self):
        return self.correct_naming(self._contact_geoms)

    @property
    def visual_geoms(self):
        return self.correct_naming(self._visual_geoms)

    @property
    def important_geoms(self):
        """
        Returns:
             dict: (Default is no important geoms; i.e.: empty dict)
        """
        return {}
    <mask token>

    @property
    def important_sensors(self):
        """
        Returns:
            dict: (Default is no sensors; i.e.: empty dict)
        """
        return {}

    @property
    def bottom_offset(self):
        """
        Returns vector from model root body to model bottom.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def top_offset(self):
        """
        Returns vector from model root body to model top.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError
    <mask token>

    @staticmethod
    def get_site_attrib_template():
        """
        Returns attribs of spherical site used to mark body origin

        Returns:
            dict: Dictionary of default site attributes
        """
        return {'pos': '0 0 0', 'size': '0.002 0.002 0.002', 'rgba':
            '1 0 0 1', 'type': 'sphere', 'group': '0'}

    @staticmethod
    def get_joint_attrib_template():
        """
        Returns attribs of free joint

        Returns:
            dict: Dictionary of default joint attributes
        """
        return {'type': 'free'}


class MujocoXMLObject(MujocoObject, MujocoXML):
    """
    MujocoObjects that are loaded from xml files (by default, inherit all properties (e.g.: name)
    from MujocoObject class first!)

    Args:
        fname (str): XML File path

        name (str): Name of this MujocoXMLObject

        joints (None or str or list of dict): each dictionary corresponds to a joint that will be created for this
            object. The dictionary should specify the joint attributes (type, pos, etc.) according to the MuJoCo xml
            specification. If "default", a single free-joint will be automatically generated. If None, no joints will
            be created.

        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, fname, name, joints='default', obj_type='all',
        duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        assert obj_type in GEOM_GROUPS, 'object type must be one in {}, got: {} instead.'.format(
            GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms
        self._name = name
        if joints == 'default':
            self.joint_specs = [self.get_joint_attrib_template()]
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints
        for i, joint_spec in enumerate(self.joint_specs):
            if 'name' not in joint_spec:
                joint_spec['name'] = 'joint{}'.format(i)
        self._obj = self._get_object_subtree()
        self._get_object_properties()

    def _get_object_subtree(self):
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        obj.attrib['name'] = 'main'
        geom_pairs = self._get_geoms(obj)
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get('group')) in GEOMTYPE2GROUP[obj_type]
        for i, (parent, element) in enumerate(geom_pairs):
            if not _should_keep(element):
                parent.remove(element)
            elif parent.tag == 'composite':
                pass
            else:
                g_name = element.get('name')
                g_name = g_name if g_name is not None else f'g{i}'
                element.set('name', g_name)
                if self.duplicate_collision_geoms and element.get('group') in {
                    None, '0'}:
                    parent.append(self._duplicate_visual_from_collision(
                        element))
                    element.set('rgba', array_to_string(OBJECT_COLLISION_COLOR)
                        )
                    if element.get('material') is not None:
                        del element.attrib['material']
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        template = self.get_site_attrib_template()
        template['rgba'] = '1 0 0 0'
        template['name'] = 'default_site'
        obj.append(ET.Element('site', attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        return False

    def _get_object_properties(self):
        """
        Extends the base class method to also add prefixes to all bodies in this object
        """
        super()._get_object_properties()
        add_prefix(root=self.root, prefix=self.naming_prefix, exclude=self.
            exclude_from_prefixing)

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        vis_element = deepcopy(element)
        vis_element.set('group', '1')
        vis_element.set('conaffinity', '0')
        vis_element.set('contype', '0')
        vis_element.set('mass', '1e-8')
        vis_element.set('name', vis_element.get('name') + '_visual')
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        geom_pairs = []
        if _parent is not None and root.tag == 'geom':
            geom_pairs.append((_parent, root))
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']"
            .format(self.naming_prefix))
        return string_to_array(bottom_site.get('pos'))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".
            format(self.naming_prefix))
        return string_to_array(top_site.get('pos'))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.
            naming_prefix))
        return string_to_array(horizontal_radius_site.get('pos'))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type='all', duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=
            duplicate_collision_geoms)
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {'group': '0', 'rgba': array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {'conaffinity': '0', 'contype': '0', 'mass': '1e-8', 'group':
            '1'}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        if not hasattr(self, 'asset'):
            self.asset = ET.Element('asset')
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element('texture', attrib=material.tex_attrib)
                )
            self.asset.append(ET.Element('material', attrib=material.
                mat_attrib))
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib['name'])
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self
            .exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        if type(inp) is not str:
            return False
        return (True if inp in self.shared_materials or inp in self.
            shared_textures else False)

    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError

import copy
from copy import deepcopy
import numpy as np
import xml.etree.ElementTree as ET

import robosuite.utils.macros as macros
from robosuite.models.base import MujocoXML, MujocoModel
from robosuite.utils.mjcf_utils import string_to_array, array_to_string, CustomMaterial, OBJECT_COLLISION_COLOR,\
                                       sort_elements, new_joint, add_prefix, add_material, find_elements


# Dict mapping geom type string keywords to group number
GEOMTYPE2GROUP = {
    "collision": {0},                 # If we want to use a geom for physics, but NOT visualize
    "visual": {1},                    # If we want to use a geom for visualization, but NOT physics
    "all": {0, 1},                    # If we want to use a geom for BOTH physics + visualization
}

GEOM_GROUPS = GEOMTYPE2GROUP.keys()


class MujocoObject(MujocoModel):
    """
    Base class for all objects.

    We use Mujoco Objects to implement all objects that:

        1) may appear for multiple times in a task
        2) can be swapped between different tasks

    Typical methods return copy so the caller can all joints/attributes as wanted

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy

    """

    def __init__(self, obj_type="all", duplicate_collision_geoms=True):
        super().__init__()
        self.asset = ET.Element("asset")
        assert obj_type in GEOM_GROUPS, "object type must be one in {}, got: {} instead.".format(GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms

        # Attributes that should be filled in within the subclass
        self._name = None
        self._obj = None

        # Attributes that are auto-filled by _get_object_properties call
        self._root_body = None
        self._bodies = None
        self._joints = None
        self._actuators = None
        self._sites = None
        self._contact_geoms = None
        self._visual_geoms = None

        # Attributes for composite objects
        self._count = None
        self._composite_type = None
        self._spacing = None
        self._composite_shape = None

    def merge_assets(self, other):
        """
        Merges @other's assets in a custom logic.

        Args:
            other (MujocoXML or MujocoObject): other xml file whose assets will be merged into this one
        """
        for asset in other.asset:
            if find_elements(root=self.asset, tags=asset.tag,
                             attribs={"name": asset.get("name")}, return_first=True) is None:
                self.asset.append(asset)

    def get_obj(self):
        """
        Returns the generated / extracted object, in XML ElementTree form.

        Returns:
            ET.Element: Object in XML form.
        """
        assert self._obj is not None, "Object XML tree has not been generated yet!"
        return self._obj

    def exclude_from_prefixing(self, inp):
        """
        A function that should take in either an ET.Element or its attribute (str) and return either True or False,
        determining whether the corresponding name / str to @inp should have naming_prefix added to it.
        Must be defined by subclass.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        raise NotImplementedError

    def _get_object_subtree(self):

        """
        Returns a ET.Element
        It is a <body/> subtree that defines all collision and / or visualization related fields
        of this object.
        Return should be a copy.
        Must be defined by subclass.

        Returns:
            ET.Element: body
        """
        raise NotImplementedError

    def _get_object_properties(self):
        """
        Helper function to extract relevant object properties (bodies, joints, contact/visual geoms, etc...) from this
        object's XML tree. Assumes the self._obj attribute has already been filled.
        """
        # Parse element tree to get all relevant bodies, joints, actuators, and geom groups
        _elements = sort_elements(root=self.get_obj())
        # print(ET.tostring(self.get_obj(), encoding='unicode', method='xml'))
        assert len(_elements["root_body"]) == 1, "Invalid number of root bodies found for robot model. Expected 1," \
                                                 "got {}".format(len(_elements["root_body"]))
        _elements["root_body"] = _elements["root_body"][0]
        _elements["bodies"] = [_elements["root_body"]] + _elements["bodies"] if "bodies" in _elements else \
                              [_elements["root_body"]]
        self._root_body = _elements["root_body"].get("name")
        self._bodies = [e.get("name") for e in _elements.get("bodies", [])]
        self._joints = [e.get("name") for e in _elements.get("joints", [])]
        self._actuators = [e.get("name") for e in _elements.get("actuators", [])]
        self._sites = [e.get("name") for e in _elements.get("sites", [])]
        self._sensors = [e.get("name") for e in _elements.get("sensors", [])]
        composite_obj = _elements["root_body"].find("./body/composite")
        if  composite_obj is not None:
            self._count = np.fromstring(composite_obj.get("count"), dtype=int, sep=' ')
            self._composite_type = composite_obj.get("type")
            self._spacing = float(composite_obj.get("spacing"))
            assert len(self._count) == 3, "the length of count must be 3, got: {} instead.".format(len(self._count))
            dim = 3 - np.sum(self._count==1)
            self._composite_shape = [self._spacing * (self._count[i] - 1) for i in range(dim)]
            if dim == 1:
                self._contact_geoms = [f'G{i}' for i in range(self._count[0])] 
            elif dim == 2:                   
                self._contact_geoms = [f'G{i}_{j}' for j in range(self._count[1])
                                                   for i in range(self._count[0])]
            elif dim == 3:
                self._contact_geoms = [f'G{i}_{j}_{k}' for k in range(self._count[2])
                                                       for j in range(self._count[1])
                                                       for i in range(self._count[0])]
        else:
            self._contact_geoms = [e.get("name") for e in _elements.get("contact_geoms", [])]
        self._visual_geoms = [e.get("name") for e in _elements.get("visual_geoms", [])]

        # Add default materials if we're using domain randomization
        if macros.USING_INSTANCE_RANDOMIZATION:
            tex_element, mat_element, _, used = add_material(root=self.get_obj(), naming_prefix=self.naming_prefix)
            # Only add the material / texture if they were actually used
            if used:
                self.asset.append(tex_element)
                self.asset.append(mat_element)

        # Add prefix to all elements
        add_prefix(root=self.get_obj(), prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    @property
    def name(self):
        return self._name

    @property
    def naming_prefix(self):
        return "{}_".format(self.name)

    @property
    def root_body(self):
        return self.correct_naming(self._root_body)

    @property
    def bodies(self):
        return self.correct_naming(self._bodies)

    @property
    def joints(self):
        return self.correct_naming(self._joints)

    @property
    def actuators(self):
        return self.correct_naming(self._actuators)

    @property
    def sites(self):
        return self.correct_naming(self._sites)

    @property
    def sensors(self):
        return self.correct_naming(self._sensors)

    @property
    def contact_geoms(self):
        return self.correct_naming(self._contact_geoms)

    @property
    def visual_geoms(self):
        return self.correct_naming(self._visual_geoms)

    @property
    def important_geoms(self):
        """
        Returns:
             dict: (Default is no important geoms; i.e.: empty dict)
        """
        return {}

    @property
    def important_sites(self):
        """
        Returns:
            dict:

                :`obj`: Object default site
        """
        return {"obj": self.naming_prefix + "default_site"}

    @property
    def important_sensors(self):
        """
        Returns:
            dict: (Default is no sensors; i.e.: empty dict)
        """
        return {}

    @property
    def bottom_offset(self):
        """
        Returns vector from model root body to model bottom.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def top_offset(self):
        """
        Returns vector from model root body to model top.
        Useful for, e.g. placing models on a surface.
        Must be defined by subclass.

        Returns:
            np.array: (dx, dy, dz) offset vector
        """
        raise NotImplementedError

    @property
    def horizontal_radius(self):
        """
        Returns maximum distance from model root body to any radial point of the model.

        Helps us put models programmatically without them flying away due to a huge initial contact force.
        Must be defined by subclass.

        Returns:
            float: radius
        """
        raise NotImplementedError

    @staticmethod
    def get_site_attrib_template():
        """
        Returns attribs of spherical site used to mark body origin

        Returns:
            dict: Dictionary of default site attributes
        """
        return {
            "pos": "0 0 0",
            "size": "0.002 0.002 0.002",
            "rgba": "1 0 0 1",
            "type": "sphere",
            "group": "0",
        }

    @staticmethod
    def get_joint_attrib_template():
        """
        Returns attribs of free joint

        Returns:
            dict: Dictionary of default joint attributes
        """
        return {
            "type": "free",
        }


class MujocoXMLObject(MujocoObject, MujocoXML):
    """
    MujocoObjects that are loaded from xml files (by default, inherit all properties (e.g.: name)
    from MujocoObject class first!)

    Args:
        fname (str): XML File path

        name (str): Name of this MujocoXMLObject

        joints (None or str or list of dict): each dictionary corresponds to a joint that will be created for this
            object. The dictionary should specify the joint attributes (type, pos, etc.) according to the MuJoCo xml
            specification. If "default", a single free-joint will be automatically generated. If None, no joints will
            be created.

        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, fname, name, joints="default", obj_type="all", duplicate_collision_geoms=True):
        MujocoXML.__init__(self, fname)
        # Set obj type and duplicate args
        assert obj_type in GEOM_GROUPS, "object type must be one in {}, got: {} instead.".format(GEOM_GROUPS, obj_type)
        self.obj_type = obj_type
        self.duplicate_collision_geoms = duplicate_collision_geoms

        # Set name
        self._name = name

        # joints for this object
        if joints == "default":
            self.joint_specs = [self.get_joint_attrib_template()]  # default free joint
        elif joints is None:
            self.joint_specs = []
        else:
            self.joint_specs = joints

        # Make sure all joints have names!
        for i, joint_spec in enumerate(self.joint_specs):
            if "name" not in joint_spec:
                joint_spec["name"] = "joint{}".format(i)

        # Lastly, parse XML tree appropriately
        self._obj = self._get_object_subtree()

        # Extract the appropriate private attributes for this
        self._get_object_properties()
        # print(ET.tostring(self.root, encoding='unicode', method='xml'))

    def _get_object_subtree(self):
        # Parse object
        obj = copy.deepcopy(self.worldbody.find("./body/body[@name='object']"))
        # exit(0)
        # Rename this top level object body (will have self.naming_prefix added later)
        obj.attrib["name"] = "main"
        # Get all geom_pairs in this tree
        geom_pairs = self._get_geoms(obj)

        # Define a temp function so we don't duplicate so much code
        obj_type = self.obj_type

        def _should_keep(el):
            return int(el.get("group")) in GEOMTYPE2GROUP[obj_type]

        # Loop through each of these pairs and modify them according to @elements arg
        for i, (parent, element) in enumerate(geom_pairs):
            # Delete non-relevant geoms and rename remaining ones
            if not _should_keep(element):
                parent.remove(element)
            else:
                if parent.tag == 'composite': #composite objects' geoms do not have name attribute
                    pass
                else:
                    g_name = element.get("name")
                    g_name = g_name if g_name is not None else f"g{i}"
                    element.set("name", g_name)
                    # Also optionally duplicate collision geoms if requested (and this is a collision geom)
                    if self.duplicate_collision_geoms and element.get("group") in {None, "0"}:
                        parent.append(self._duplicate_visual_from_collision(element))
                        # Also manually set the visual appearances to the original collision model
                        element.set("rgba", array_to_string(OBJECT_COLLISION_COLOR))
                        if element.get("material") is not None:
                            del element.attrib["material"]
        # add joint(s)
        for joint_spec in self.joint_specs:
            obj.append(new_joint(**joint_spec))
        # Lastly, add a site for this object
        template = self.get_site_attrib_template()
        template["rgba"] = "1 0 0 0"
        template["name"] = "default_site"
        obj.append(ET.Element("site", attrib=template))
        return obj

    def exclude_from_prefixing(self, inp):
        """
        By default, don't exclude any from being prefixed
        """
        # if isinstance(inp, ET.Element) and inp.find("./composite") is not None:
        #     #if this body is next to "composite", its name should not be changed 
        #     if inp.find("./composite").get("type") in ['cloth','rope']:
        #         return True
        return False

    def _get_object_properties(self):
        """
        Extends the base class method to also add prefixes to all bodies in this object
        """
        super()._get_object_properties()
        add_prefix(root=self.root, prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    @staticmethod
    def _duplicate_visual_from_collision(element):
        """
        Helper function to duplicate a geom element to be a visual element. Namely, this corresponds to the
        following attribute requirements: group=1, conaffinity/contype=0, no mass, name appended with "_visual"

        Args:
            element (ET.Element): element to duplicate as a visual geom

        Returns:
            element (ET.Element): duplicated element
        """
        # Copy element
        vis_element = deepcopy(element)
        # Modify for visual-specific attributes (group=1, conaffinity/contype=0, no mass, update name)
        vis_element.set("group", "1")
        vis_element.set("conaffinity", "0")
        vis_element.set("contype", "0")
        vis_element.set("mass", "1e-8")
        vis_element.set("name", vis_element.get("name") + "_visual")
        return vis_element

    def _get_geoms(self, root, _parent=None):
        """
        Helper function to recursively search through element tree starting at @root and returns
        a list of (parent, child) tuples where the child is a geom element

        Args:
            root (ET.Element): Root of xml element tree to start recursively searching through
            _parent (ET.Element): Parent of the root element tree. Should not be used externally; only set
                during the recursive call

        Returns:
            list: array of (parent, child) tuples where the child element is a geom type
        """
        # Initialize return array
        geom_pairs = []
        # If the parent exists and this is a geom element, we add this current (parent, element) combo to the output
        if _parent is not None and root.tag == "geom":
            geom_pairs.append((_parent, root))
        # Loop through all children elements recursively and add to pairs
        for child in root:
            geom_pairs += self._get_geoms(child, _parent=root)
        # Return all found pairs
        return geom_pairs

    @property
    def bottom_offset(self):
        bottom_site = self.worldbody.find("./body/site[@name='{}bottom_site']".format(self.naming_prefix))
        return string_to_array(bottom_site.get("pos"))

    @property
    def top_offset(self):
        top_site = self.worldbody.find("./body/site[@name='{}top_site']".format(self.naming_prefix))
        return string_to_array(top_site.get("pos"))

    @property
    def horizontal_radius(self):
        horizontal_radius_site = self.worldbody.find(
            "./body/site[@name='{}horizontal_radius_site']".format(self.naming_prefix)
        )
        return string_to_array(horizontal_radius_site.get("pos"))[0]


class MujocoGeneratedObject(MujocoObject):
    """
    Base class for all procedurally generated objects.

    Args:
        obj_type (str): Geom elements to generate / extract for this object. Must be one of:

            :`'collision'`: Only collision geoms are returned (this corresponds to group 0 geoms)
            :`'visual'`: Only visual geoms are returned (this corresponds to group 1 geoms)
            :`'all'`: All geoms are returned

        duplicate_collision_geoms (bool): If set, will guarantee that each collision geom has a
            visual geom copy
    """

    def __init__(self, obj_type="all", duplicate_collision_geoms=True):
        super().__init__(obj_type=obj_type, duplicate_collision_geoms=duplicate_collision_geoms)

        # Store common material names so we don't add prefixes to them
        self.shared_materials = set()
        self.shared_textures = set()

    def sanity_check(self):
        """
        Checks if data provided makes sense.
        Called in __init__()
        For subclasses to inherit from
        """
        pass

    @staticmethod
    def get_collision_attrib_template():
        """
        Generates template with collision attributes for a given geom

        Returns:
            dict: Initial template with `'pos'` and `'group'` already specified
        """
        return {"group": "0", "rgba": array_to_string(OBJECT_COLLISION_COLOR)}

    @staticmethod
    def get_visual_attrib_template():
        """
        Generates template with visual attributes for a given geom

        Returns:
            dict: Initial template with `'conaffinity'`, `'contype'`, and `'group'` already specified
        """
        return {"conaffinity": "0", "contype": "0", "mass": "1e-8", "group": "1"}

    def append_material(self, material):
        """
        Adds a new texture / material combination to the assets subtree of this XML
        Input is expected to be a CustomMaterial object

        See http://www.mujoco.org/book/XMLreference.html#asset for specific details on attributes expected for
        Mujoco texture / material tags, respectively

        Note that the "file" attribute for the "texture" tag should be specified relative to the textures directory
        located in robosuite/models/assets/textures/

        Args:
            material (CustomMaterial): Material to add to this object
        """
        # First check if asset attribute exists; if not, define the asset attribute
        if not hasattr(self, "asset"):
            self.asset = ET.Element("asset")
        # If the material name is not in shared materials, add this to our assets
        if material.name not in self.shared_materials:
            self.asset.append(ET.Element("texture", attrib=material.tex_attrib))
            self.asset.append(ET.Element("material", attrib=material.mat_attrib))
        # Add this material name to shared materials if it should be shared
        if material.shared:
            self.shared_materials.add(material.name)
            self.shared_textures.add(material.tex_attrib["name"])
        # Update prefix for assets
        add_prefix(root=self.asset, prefix=self.naming_prefix, exclude=self.exclude_from_prefixing)

    def exclude_from_prefixing(self, inp):
        """
        Exclude all shared materials and their associated names from being prefixed.

        Args:
            inp (ET.Element or str): Element or its attribute to check for prefixing.

        Returns:
            bool: True if we should exclude the associated name(s) with @inp from being prefixed with naming_prefix
        """
        # Automatically return False if this is not of type "str"
        if type(inp) is not str:
            return False
        # Only return True if the string matches the name of a common material
        return True if inp in self.shared_materials or inp in self.shared_textures else False

    # Methods that still need to be defined by subclass
    def _get_object_subtree(self):
        raise NotImplementedError

    def bottom_offset(self):
        raise NotImplementedError

    def top_offset(self):
        raise NotImplementedError

    def horizontal_radius(self):
        raise NotImplementedError
