def ungroup(name, members="", quiet=1, _self=cmd):
'''
DESCRIPTION
"ungroup" removes an object from a group object, returning it to
the top level.
USAGE
ungroup name
SEE ALSO
group
'''
r = DEFAULT_ERROR
try:
_self.lock(_self)
r = _cmd.group(_self._COb,str(name),str(members),7,int(quiet))
finally:
_self.unlock(r,_self)
if _self._raising(r,_self): raise pymol.CmdException
return r
def ungroup(name, members="", quiet=1, _self=cmd):
'''
DESCRIPTION
"ungroup" removes an object from a group object, returning it to
the top level.
USAGE
ungroup name
SEE ALSO
group
'''
r = DEFAULT_ERROR
try:
_self.lock(_self)
r = _cmd.group(_self._COb, str(name), str(members), 7, int(quiet))
finally:
_self.unlock(r, _self)
if _self._raising(r, _self): raise pymol.CmdException
return r
def group(name, members="", action='auto', quiet=1,_self=cmd):
'''
DESCRIPTION
"group" creates or updates a group object: a container for
organizing objects into a hierarchy.
USAGE
group name [, members [, action ]]
ARGUMENTS
name = string: name of the group
members = string: space-separated list of objects to include in
the group
action = add, remove, open, close, toggle, auto, ungroup, empty,
purge, excise
EXAMPLE
group kinases, 1oky 1pkg 1t46 1uwh 1z5m
group kinases, open
group kinases, close
NOTES
Group objects can typically be used as arguments to commands. In
such cases, the command should be applied to all members of the
group. If the group is used as a selection, then all atoms in all
objects in the group should be included in the selection.
When a group objects is open, objects can be added or removed from
the group by right-clicking and dragging in the control panel.
SEE ALSO
ungroup, order
'''
r = DEFAULT_ERROR
action = group_action_dict[group_action_sc.auto_err(str(action),'group action')]
if name=='all': name='*'
if action==6:
if len(members):
action=1
elif (name in _self.get_names()) or ('*' in name):
action=5
else:
action=1
try:
_self.lock(_self)
r = _cmd.group(_self._COb,str(name),str(members),int(action),int(quiet))
finally:
_self.unlock(r,_self)
if _self._raising(r,_self): raise pymol.CmdException
return r
def group(name, members="", action='auto', quiet=1, _self=cmd):
'''
DESCRIPTION
"group" creates or updates a group object: a container for
organizing objects into a hierarchy.
USAGE
group name [, members [, action ]]
ARGUMENTS
name = string: name of the group
members = string: space-separated list of objects to include in
the group
action = add, remove, open, close, toggle, auto, ungroup, empty,
purge, excise
EXAMPLE
group kinases, 1oky 1pkg 1t46 1uwh 1z5m
group kinases, open
group kinases, close
NOTES
Group objects can typically be used as arguments to commands. In
such cases, the command should be applied to all members of the
group. If the group is used as a selection, then all atoms in all
objects in the group should be included in the selection.
When a group objects is open, objects can be added or removed from
the group by right-clicking and dragging in the control panel.
SEE ALSO
ungroup, order
'''
r = DEFAULT_ERROR
action = group_action_dict[group_action_sc.auto_err(
str(action), 'group action')]
if name == 'all': name = '*'
if action == 6:
if len(members):
action = 1
elif (name in _self.get_names()) or ('*' in name):
action = 5
else:
action = 1
try:
_self.lock(_self)
r = _cmd.group(_self._COb, str(name), str(members), int(action),
int(quiet))
finally:
_self.unlock(r, _self)
if _self._raising(r, _self): raise pymol.CmdException
return r