ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/group/trunk/OOPSE-2.0/doc/SelectionExpression.html
Revision: 2061
Committed: Fri Feb 25 16:38:26 2005 UTC (19 years, 4 months ago) by tim
Content type: text/html
File size: 6890 byte(s)
Log Message: 
adding documentation for selection expression

File Contents

# User Rev Content
1 tim 2061 <html>
2     <head>
3     <title>Select Commands in OOPSE</title>
4     </head>
5    
6     <body bgcolor=white>
7     <basefont size=3>
8    
9     <div align=center>
10     <font size="+2"><b>Select Commands in </b></font><b><font size="+2">OOPSE</font></b><br>
11     </div>
12     <a name="syntax" id="syntax">
13     <h2>
14     Syntax of the select command
15     </h2>
16     </a>
17    
18     The most general form of the select command is: <b>select <i>expression</i>
19     </b>
20     <p>The expression represents an arbitrary set of stuntdoubles (atoms or rigid-bodies) in OOPSE. Expressions are composed of either name expressions, index expression, predefined sets, user define expression, comparison operators, within expressions, or logical combinations of the above expression types. Expression can be combined with parentheses and the Boolean operators</p>
21     <p><b><a name="logic"></a> Logical expression. </b> </p>
22     <p>The logical operators allow complex queries to be constructed out of simpler ones using the standard boolean connectives <b>and, or, not</b>. Parentheses can be used to alter the precedence of the operators.
23     <ul>
24     <table width="441" border=1 cellpadding=5 bgcolor="#FFFFFF">
25     <tr bgcolor="#FFCCFF">
26     <td width="174"><div align="left">logical operator </div></td>
27     <td width="241"><div align="left">equivalent operator</div></td>
28     </tr>
29     <tr bgcolor="#FFCCFF">
30     <td><div align="left">and</div></td>
31     <td><div align="left">&quot;&amp;&quot;, &quot;&amp;&amp;&quot; </div></td>
32     </tr>
33     <tr bgcolor="#FFCCFF">
34     <td><div align="left">or</div></td>
35     <td><div align="left">&quot;|&quot;,&quot;||&quot;, &quot;,&quot; </div></td>
36     </tr>
37     <tr bgcolor="#FFCCFF">
38     <td><div align="left">not</div></td>
39     <td><div align="left">&quot;!&quot;</div></td>
40     </tr>
41     </table>
42     <p>&nbsp;</p>
43     </ul>
44     <p><a name="name"><b> Name expression.
45     </b></a> </p>
46     <ul>
47     <table width="886" border="1" bordercolor="#6B7683" bgcolor="#FFFFCC">
48     <tr>
49     <td colspan="2"><div align="center">expression</div></td>
50     <td width="434"><div align="center">description</div></td>
51     </tr>
52     <tr>
53     <td width="183" rowspan="3">expression without &quot;.&quot; </td>
54     <td width="247"><div align="left">select DMPC</div></td>
55     <td>select all stuntdoubles belong to DMPC molecule </td>
56     </tr>
57     <tr>
58     <td><div align="left">select C*</div></td>
59     <td>select all carbon atoms </td>
60     </tr>
61     <tr>
62     <td><div align="left">select DMPC_RB_*</div></td>
63     <td>select all rigid-bodies (only select rigid-bodies, not include the atoms belong to them)</td>
64     </tr>
65     <tr>
66     <td rowspan="3">expression has one &quot;.&quot; </td>
67     <td>select TIP3P.O_TIP3P</td>
68     <td>select stuntdoubles belong to molecule </td>
69     </tr>
70     <tr>
71     <td>select DMPC_RB_0.PO4</td>
72     <td>select atoms belong to rigid-bodies</td>
73     </tr>
74     <tr>
75     <td>select DMPC.20</td>
76     <td>select stuntdoubles by their internal indices inside the molecules </td>
77     </tr>
78     <tr>
79     <td>expression has two &quot;.&quot;</td>
80     <td>select DMPC.DMPC_RB_?.*</td>
81     <td>select all atoms belong to rigid-bodies within DMPC molecule</td>
82     </tr>
83     </table>
84     <p>&nbsp;</p>
85     </ul>
86     <p><a name="index" id="index"><b> Index expression </b></a></p>
87     <p>Index expression is used to select stuntdobules by their global indices. </p>
88     <ul>
89     <table width="894" border=1 cellpadding=5 bgcolor="#FFFFFF"><tr bgcolor="#FFFFCC">
90     <td width="113">select 20 </td>
91     <td width="520">select stuntdoubles which global index is 20 </td>
92     </tr>
93     <tr bgcolor="#FFFFCC">
94     <td>select 20 to 30 </td>
95     <td>select stuntdoubles which global indices are between 20 (inclusive) and 30 (exclusive) </td>
96     </tr>
97     </table>
98     </ul>
99    
100     <p>&nbsp; </p>
101     <p><a name="predefine" id="predefine"><b> Predefine set </b></a></p>
102     <ul>
103     <table width="449" border=1 cellpadding=5 bgcolor="#FFFFFF">
104     <tr bgcolor="#FFCCFF">
105     <td width="91"><div align="left">keyword</div></td>
106     <td width="332"><div align="left">description</div></td>
107     </tr>
108     <tr bgcolor="#FFCCFF">
109     <td><div align="left">all</div></td>
110     <td><div align="left">select all stuntdoubles</div></td>
111     </tr>
112     <tr bgcolor="#FFCCFF">
113     <td><div align="left">none</div></td>
114     <td><div align="left">select none of the stuntdoubles </div></td>
115     </tr>
116     <tr bgcolor="#FFCCFF">
117     <td><div align="left">rigidbody</div></td>
118     <td><div align="left">select all rigid-bodies</div></td>
119     </tr>
120     </table>
121     </ul>
122     <p>&nbsp;</p>
123     <p><a name="user" id="user"><b> User define expression.</b></a></p>
124     <p> User can define arbitrary terms to represent groups of stuntdoubles, and then use the terms you have defined in select commands. The general form for the define command is: <strong>define <em>term expression</em></strong></p>
125     <p> Once defined, user can use such terms in boolean expressions </p>
126     <ul>
127     <table width="659" border=1 cellpadding=5 bgcolor="#FFFFFF">
128     <tr bgcolor="#FFFFCC">
129     <td><p>define SSDWATER SSD or SSD1 or SSDRF</p>
130     <p>select SSDWATER </p> <div align="left"></div></td>
131     </tr>
132     </table>
133     </ul>
134     <p><a name="comparison" id="comparison"> <b>Comparison expression.</b></a></p>
135     <p>Stuntdoubles can be distinguished using comparision operators on their properties. The general form for the comparison command is: a property name, followed by a comparision operator and then a number.</p>
136     <ul>
137     <table width="668" border=1 cellpadding=5 bgcolor="#FFFFFF">
138     <tr bgcolor="#FFCCFF">
139     <td width="305"><div align="left">property</div></td>
140     <td width="331"><div align="left">mass, dipole, charge </div></td>
141     </tr>
142     <tr bgcolor="#FFCCFF">
143     <td><div align="left">comparision operator</div></td>
144     <td><div align="left">&quot;&gt;&quot;, &quot;&lt;&quot;, &quot;=&quot;, &quot;&gt;=&quot;, &quot;&lt;=&quot;, &quot;!=&quot; </div></td>
145     </tr>
146     </table>
147     </ul>
148     <ul>
149     <table width="672" border=1 cellpadding=5 bgcolor="#FFFFFF">
150     <tr bgcolor="#FFFFCC">
151     <td width="302">select mass &gt; 16.0 and charge &lt; -2 </td>
152     <td width="338">select stuntdoubles which mass is great than 16.0 and charge is less than -2 </td>
153     </tr>
154     </table>
155     </ul>
156     <p>&nbsp;</p>
157     <p><b> <a name="within"></a> Within expression.</b>
158     <p> Within selection selects all stuntdoubles within the specified distance (in ?) from a selection, including the selection itself. The general form for within selection is: <b>select within(<i>distance, expression</i>) </b>
159     <ul>
160     <table width="890" border=1 cellpadding=5 bgcolor="#FFFFFF">
161     <tr bgcolor="#FFFFCC">
162     <td width="431">select within(2.5, PO4 or NC4) </td>
163     <td width="427"><blockquote>select stunntdoules which are within 2.5 ? from either PO4 or NC4 </blockquote></td>
164     </tr>
165     </table>
166     </ul>
167     <p>
168     <p><p>
169     </body>
170     </html>

Properties

Name Value
svn:executable *