The name command defines a target-name to be used as a synonym for spec in subsequent commands. The target-name will also be listed in:
Defined targets are saved in sessions, and they can also be created with menu: Select... Define Selector. See also: alias, rename
Defining a name is useful to replace a long target specification string with something shorter and easier to type, or to name the current selection for easy access to its contents later. Occurrences of target-name (space- and/or semicolon-delimited) in commands will be translated to the corresponding items. A valid target-name:
A target can be defined as evaluate-now or evaluate-later:
name tm1 /a:34-64
color tm1 medium blue
– is equivalent to –
color /a:34-64 medium blue
Evaluate-later targets can be defined automatically at ChimeraX startup by including name commands in the Startup preferences.
name frozen leus :leu...the name leus will only refer to the leucines in that set of structures, and closing a model (even if it is reopened again) removes it from the set.
To create a named selection, the spec would be sel. For example:
select ligand :<5.5...the target pocket will not be affected by any subsequent changes in what is selected, and will refer solely to what was selected at the time it was defined.
name frozen pocket sel
The command name list reports all user-defined targets in the Log, with brief summaries of their contents; using builtins true also lists the built-in targets.
The command name delete can be used to “forget” a specific user-defined target or all user-defined targets.