{"id":350,"date":"2019-07-12T17:10:38","date_gmt":"2019-07-12T17:10:38","guid":{"rendered":"https:\/\/ccsb.scripps.edu\/mgltools\/?page_id=350"},"modified":"2019-07-12T17:51:32","modified_gmt":"2019-07-12T17:51:32","slug":"doc-156-selection-strings","status":"publish","type":"page","link":"https:\/\/ccsb.scripps.edu\/mgltools\/doc-156-selection-strings\/","title":{"rendered":"doc 156 selection strings"},"content":{"rendered":"

Selection Strings<\/h2>\n

Among the various ways molecular fragments can be selected in Pmv, selection strings are one of the most powerful selection mechanisms.<\/p>\n

Pmv stores molecules in a hierarchical data structure with 4 levels: Molecules contains Chains, made of Residues, containing Atoms. A Pmv selection string is a \u201c:\u201d separated set of 1 to 4 expressions where the first expression will select one of more molecules, the second expression if present will select chains among these molecules, the 3rd<\/sup> expression will select residues in these chains, and finally the 4th<\/sup> expression if present will select atoms in the previously selected residues. The result of such a selection will be a set of Molecules, Chains, Residues, or Atoms depending on the number of expressions.<\/p>\n

Mol selector [: [Chain selector] [: [Residue selector] [: [Atom selector]]]]<\/p>\n

Multiple selection strings can be used when separated by a \u2018;\u2019.<\/p>\n

Expressions syntax<\/h3>\n

Expressions can be strings, sometime numbers or ranges of numbers, or lambda expressions (i.e. a Python function with no name).<\/p>\n

An empty string selects everything<\/strong>. For example:<\/p>\n

\u201c:::\u201d will select all Atoms in all Residues in all Chains in all Molecules in Pmv<\/p>\n

\u201cMol1::\u201d will select all Residues in all Chains in molecule Mol1<\/p>\n

\u201cMol2:B::\u201d will select all atoms in Chain B in molecule Mol2<\/p>\n

A comma-separated list<\/strong> of items can be used in an expression. For instance:<\/p>\n

\u201cMol1, Mol2:::C,N,CA,O\u201d selects backbone heavy atoms in molecules Mol1 and Mol2<\/p>\n

A Range<\/strong> can be specified using the \u2018-\u2018 character.<\/p>\n

\u201c::ALA35-THR45\u201d selects a range of residues<\/p>\n

\u201c1CRN-2PLV\u201d selects all molecules in the list of molecules loaded in Pmv starting at and including 1CRN and ending and including 2PLV. This will only work if 1CRN was loaded before 2PLV. Else an empty is returned.<\/p>\n

Expressions can contain common regular expressions<\/strong> such as \u2018.\u2019 to match any single character, \u2018*\u2019 to match any number of any character, and [1235] to match the numbers 1 through five in a single position.<\/p>\n

\u201c::..N*\u201d selects all Residues with the third letter in its name being an N followed by any string<\/p>\n

\u201c::\u2026[23].\u201d Selects all Residues with names made of exactly 5 characters and where the 4th<\/sup> character is either 2 or 3<\/p>\n

 <\/p>\n

Relative positions<\/strong> in a list can be indicated by using the \u201c#\u201d symbol in front of a number.<\/p>\n

\u201c#2,#5\u201d selects the 2rd<\/sup> and 5th<\/sup> molecule<\/p>\n

\u201cMol1:C:#1-#5\u201d selects the first 5 Residues in Chain C or molecule Mol1<\/p>\n

Names of predefined sets<\/strong> can also be used in expressions. Names will be matched at the level of the elements they contain. A list of standard predefined set names is available here<\/a>. Sets defined by the user will be matched as well.<\/p>\n

Molecule selectors:<\/h3>\n

Molecular selectors match the expression against the molecule names. They support regular expressions, relative indices, lists and ranges.<\/p>\n

Chain selectors:<\/h3>\n

Chain selectors match the expression against the chain\u2019s id. They support regular expressions, relative indices, lists and ranges.<\/p>\n

Residue selectors:<\/h3>\n

Residue selectors usually match the expression against the Residue name, which is a concatenation of the 3-letter Residue type (e.g. ALA, TYR, etc) and the Residue number from the PDB file (e.g. 3, 4A, etc.). One letter amino acid code can also be used (available here<\/a>). Regular expressions, relative indices, lists, and ranges are supported.<\/p>\n

Atom selectors:<\/h3>\n

Atom selectors match the expression against the atom name. Regular expressions, relative indices, lists, and ranges are supported.<\/p>\n

Where to use selection strings:<\/h3>\n

Selection strings can be used in the select from String command, which is accessible through the select menu.<\/p>\n

\"Screen<\/p>\n

\"Macintosh<\/p>\n

or through the dashboard<\/a> using the Sel. Entry field:<\/p>\n

\"Macintosh<\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Selection Strings Among the various ways molecular fragments can be […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-350","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/pages\/350","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/comments?post=350"}],"version-history":[{"count":4,"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/pages\/350\/revisions"}],"predecessor-version":[{"id":432,"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/pages\/350\/revisions\/432"}],"wp:attachment":[{"href":"https:\/\/ccsb.scripps.edu\/mgltools\/wp-json\/wp\/v2\/media?parent=350"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}