comparison tleap.xml @ 0:3de1359b86cc draft default tip

"planemo upload for repository https://github.com/galaxycomputationalchemistry/galaxy-tools-compchem/ commit def3e8d4a983ab47ceedde678f585b54c79bb8d1"
author chemteam
date Thu, 27 Jan 2022 17:17:54 +0000
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:3de1359b86cc
1 <tool id="tleap" name="Build tLEaP" version="@TOOL_VERSION@+galaxy@GALAXY_VERSION@">
2 <description>interactively build and run tLEaP files to set up systems with AmberTools</description>
3 <macros>
4 <import>macros.xml</import>
5 <token name="@GALAXY_VERSION@">0</token>
6 </macros>
7 <expand macro="requirements" />
8 <version_command>tleap -h</version_command>
9 <command detect_errors="exit_code"><![CDATA[
10 cp '${tleap_in}' '${output_tleap_in}' && mkdir out && tleap -f '${tleap_in}' > '${output_tleap}'
11 ]]> </command>
12 <configfiles>
13 <configfile name="tleap_in"><![CDATA[#for $i, $cmd in $enumerate($tleap_cmds):
14 #if $cmd.tleap_cond.tleap_cmd == "add":
15 add ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b}
16 #elif $cmd.tleap_cond.tleap_cmd == "addAtomTypes":
17 addAtomTypes {
18 #for $atmvars in $cmd.tleap_cond.atomtypevars:
19 { "${atmvars.arg_addAtomTypes_var1}" "${atmvars.arg_addAtomTypes_var2}" "${atmvars.arg_addAtomTypes_var3}" }
20 #end for
21 }
22 #elif $cmd.tleap_cond.tleap_cmd == "addH":
23 addH ${cmd.tleap_cond.arg_obj}
24 #elif $cmd.tleap_cond.tleap_cmd == "addIons":
25 addIons ${cmd.tleap_cond.arg_variable} ${cmd.tleap_cond.arg_ion1} ${cmd.tleap_cond.arg__ion1}
26 addIons ${cmd.tleap_cond.arg_variable} ${cmd.tleap_cond.arg_ion2} ${cmd.tleap_cond.arg__ion2}
27 #elif $cmd.tleap_cond.tleap_cmd == "addIons2":
28 addIons2 ${cmd.tleap_cond.arg_variable} ${cmd.tleap_cond.arg_ion1} ${cmd.tleap_cond.arg__ion1} ${cmd.tleap_cond.arg_ion2} ${cmd.tleap_cond.arg__ion2}
29 #elif $cmd.tleap_cond.tleap_cmd == "addIonsRand":
30 addIonsRand ${cmd.tleap_cond.arg_variable} ${cmd.tleap_cond.arg_ion1} ${cmd.tleap_cond.arg__ion1} ${cmd.tleap_cond.arg_ion2} ${cmd.tleap_cond.arg__ion2} ${cmd.tleap_cond.arg_separation}
31 #elif $cmd.tleap_cond.tleap_cmd == "addPath":
32 addPath ${cmd.tleap_cond.arg_path}
33 #elif $cmd.tleap_cond.tleap_cmd == "addPdbAtomMap":
34 addPdbAtomMap {
35 #for $atmmapvars in $cmd.tleap_cond.AtomMapList:
36 {$atmmapvars.oddpdbname $atmmapvars.libpdbname}
37 #end for
38 }
39 #elif $cmd.tleap_cond.tleap_cmd == "addPdbResMap":
40 addPdbResMap {
41 #for $atmresmapvars in $cmd.tleap_cond.resmap:
42 {$atmresmapvars.terminalflag "$atmresmapvars.pdbname" "$atmresmapvars.leapvar"}
43 #end for
44 }
45 #elif $cmd.tleap_cond.tleap_cmd == "alignAxes":
46 alignAxes ${cmd.tleap_cond.arg_unit}
47 #elif $cmd.tleap_cond.tleap_cmd == "bond":
48 bond ${cmd.tleap_cond.arg_atom1} ${cmd.tleap_cond.arg_atom2} ${cmd.tleap_cond.arg_order}
49 #elif $cmd.tleap_cond.tleap_cmd == "bondByDistance":
50 bondByDistance ${cmd.tleap_cond.arg_container} ${cmd.tleap_cond.arg_maxBond}
51 #elif $cmd.tleap_cond.tleap_cmd == "center":
52 center ${cmd.tleap_cond.arg_container}
53 #elif $cmd.tleap_cond.tleap_cmd == "charge":
54 charge ${cmd.tleap_cond.arg_container}
55 #elif $cmd.tleap_cond.tleap_cmd == "check":
56 check ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_parmset}
57 #elif $cmd.tleap_cond.tleap_cmd == "clearPdbAtomMap":
58 clearPdbAtomMap
59 #elif $cmd.tleap_cond.tleap_cmd == "clearPdbResMap":
60 clearPdbResMap
61 #elif $cmd.tleap_cond.tleap_cmd == "clearVariables":
62 clearVariables { ${cmd.tleap_cond.arg_list} }
63 #elif $cmd.tleap_cond.tleap_cmd == "combine":
64 #if $cmd.tleap_cond.combine_assign:
65 ${cmd.tleap_cond.combine_assign} = combine { ${cmd.tleap_cond.arg_list} }h
66 #else:
67 combine ${cmd.tleap_cond.arg_list}
68 #end if
69 #elif $cmd.tleap_cond.tleap_cmd == "copy":
70 #if $cmd.tleap_cond.copy_assign:
71 ${cmd.tleap_cond.copy_assign} = copy ${cmd.tleap_cond.arg_variable}
72 #else:
73 copy ${cmd.tleap_cond.arg_variable}
74 #end if
75 #elif $cmd.tleap_cond.tleap_cmd == "createAtom":
76 #if $cmd.tleap_cond.createVar_assign:
77 ${cmd.tleap_cond.createVar_assign} = createAtom ${cmd.tleap_cond.arg_name} ${cmd.tleap_cond.arg_type} ${cmd.tleap_cond.arg_charge}
78 #else:
79 createAtom ${cmd.tleap_cond.arg_name} ${cmd.tleap_cond.arg_type} ${cmd.tleap_cond.arg_charge}
80 #end if
81 #elif $cmd.tleap_cond.tleap_cmd == "createParmset":
82 #if $cmd.tleap_cond.createVar_assign:
83 ${cmd.tleap_cond.createVar_assign} = createParmset ${cmd.tleap_cond.arg_name}
84 #else:
85 createParmset ${cmd.tleap_cond.arg_name}
86 #end if
87 #elif $cmd.tleap_cond.tleap_cmd == "createResidue":
88 #if $cmd.tleap_cond.createVar_assign:
89 ${cmd.tleap_cond.createVar_assign} = createResidue ${cmd.tleap_cond.arg_name}
90 #else:
91 createResidue ${cmd.tleap_cond.arg_name}
92 #end if
93 #elif $cmd.tleap_cond.tleap_cmd == "createUnit":
94 #if $cmd.tleap_cond.createVar_assign:
95 ${cmd.tleap_cond.createVar_assign} = createUnit ${cmd.tleap_cond.arg_name}
96 #else:
97 createUnit ${cmd.tleap_cond.arg_name}
98 #end if
99 #elif $cmd.tleap_cond.tleap_cmd == "crossLink":
100 crossLink ${cmd.tleap_cond.arg_res1} ${cmd.tleap_cond.arg_conn1} ${cmd.tleap_cond.arg_res2} ${cmd.tleap_cond.arg_conn2}
101 #elif $cmd.tleap_cond.tleap_cmd == "debugOff":
102 debugOff ${cmd.tleap_cond.arg_filename}
103 #elif $cmd.tleap_cond.tleap_cmd == "debugOn":
104 debugOn ${cmd.tleap_cond.arg_filename}
105 #elif $cmd.tleap_cond.tleap_cmd == "debugStatus":
106 debugStatus
107 #elif $cmd.tleap_cond.tleap_cmd == "deleteBond":
108 deleteBond ${cmd.tleap_cond.arg_atom1} ${cmd.tleap_cond.arg_atom2}
109 #elif $cmd.tleap_cond.tleap_cmd == "deleteOffLibEntry":
110 deleteOffLibEntry ${cmd.tleap_cond.arg_library} ${cmd.tleap_cond.arg_entry}
111 #elif $cmd.tleap_cond.tleap_cmd == "deleteRestraint":
112 deleteRestraint ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b} ${cmd.tleap_cond.arg_c} ${cmd.tleap_cond.arg_d}
113 #elif $cmd.tleap_cond.tleap_cmd == "desc":
114 desc ${cmd.tleap_cond.arg_unit}
115 #elif $cmd.tleap_cond.tleap_cmd == "deSelect":
116 deSelect ${cmd.tleap_cond.arg_obj}
117 #elif $cmd.tleap_cond.tleap_cmd == "displayPdbAtomMap":
118 displayPdbAtomMap
119 #elif $cmd.tleap_cond.tleap_cmd == "displayPdbResMap":
120 displayPdbResMap
121 #elif $cmd.tleap_cond.tleap_cmd == "edit":
122 edit ${cmd.tleap_cond.arg_unit_parmset}
123 #elif $cmd.tleap_cond.tleap_cmd == "flip":
124 flip ${cmd.tleap_cond.arg_obj}
125 #elif $cmd.tleap_cond.tleap_cmd == "groupSelectedAtoms":
126 groupSelectedAtoms ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_name}
127 #elif $cmd.tleap_cond.tleap_cmd == "help":
128 help ${cmd.tleap_cond.arg_string}
129 #elif $cmd.tleap_cond.tleap_cmd == "impose":
130 impose ${cmd.tleap_cond.arg_unit} { ${cmd.tleap_cond.arg_seqlist} } { { "$cmd.tleap_cond.arg_internals_atom1" "$cmd.tleap_cond.arg_internals_atom2" $cmd.tleap_cond.arg_internals_displacement} }
131 #elif $cmd.tleap_cond.tleap_cmd == "list":
132 list
133 #elif $cmd.tleap_cond.tleap_cmd == "listOff":
134 listOff ${cmd.tleap_cond.arg_library}
135 #elif $cmd.tleap_cond.tleap_cmd == "loadAmberParams":
136 #if $cmd.tleap_cond.loadAmberParams_assign:
137 ${cmd.tleap_cond.loadAmberParams_assign} = loadAmberParams ${cmd.tleap_cond.file_source.arg_filename}
138 #else:
139 loadAmberParams ${cmd.tleap_cond.file_source.arg_filename}
140 #end if
141 #elif $cmd.tleap_cond.tleap_cmd == "loadAmberPrep":
142 loadAmberPrep ${cmd.tleap_cond.file_source.arg_filename} ${cmd.tleap_cond.arg_prefix}
143 #elif $cmd.tleap_cond.tleap_cmd == "loadMol2":
144 #if $cmd.tleap_cond.loadMol2_assign:
145 ${cmd.tleap_cond.loadMol2_assign} = loadMol2 ${cmd.tleap_cond.arg_filename}
146 #else:
147 loadMol2 ${cmd.tleap_cond.arg_filename}
148 #end if
149 #elif $cmd.tleap_cond.tleap_cmd == "loadMol3":
150 #if $cmd.tleap_cond.loadMol3_assign:
151 ${cmd.tleap_cond.loadMol3_assign} = loadMol3 ${cmd.tleap_cond.arg_filename}
152 #else:
153 loadMol3 ${cmd.tleap_cond.arg_filename}
154 #end if
155 #elif $cmd.tleap_cond.tleap_cmd == "loadOff":
156 loadOff ${cmd.tleap_cond.arg_filename}
157 #elif $cmd.tleap_cond.tleap_cmd == "loadPdb":
158 #if $cmd.tleap_cond.loadPdb_assign:
159 ${cmd.tleap_cond.loadPdb_assign} = loadPdb ${cmd.tleap_cond.arg_filename}
160 #else:
161 loadPdb ${cmd.tleap_cond.arg_filename}
162 #end if
163 #elif $cmd.tleap_cond.tleap_cmd == "loadPdbUsingSeq":
164 loadPdbUsingSeq ${cmd.tleap_cond.arg_filename} { ${cmd.tleap_cond.arg_unitlist} }
165 #elif $cmd.tleap_cond.tleap_cmd == "logFile":
166 logFile ${cmd.tleap_cond.arg_filename}
167 #elif $cmd.tleap_cond.tleap_cmd == "matchVariables":
168 #if $cmd.tleap_cond.matchVariables_assign:
169 ${cmd.tleap_cond.matchVariables_assign} = matchVariables ${cmd.tleap_cond.arg_string}
170 #else:
171 matchVariables ${cmd.tleap_cond.arg_string}
172 #end if
173 #elif $cmd.tleap_cond.tleap_cmd == "measureGeom":
174 measureGeom ${cmd.tleap_cond.arg_atom1} ${cmd.tleap_cond.arg_atom2} ${cmd.tleap_cond.arg_atom3} ${cmd.tleap_cond.arg_atom4}
175 #elif $cmd.tleap_cond.tleap_cmd == "relax":
176 relax ${cmd.tleap_cond.arg_obj}
177 #elif $cmd.tleap_cond.tleap_cmd == "remove":
178 remove ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b}
179 #elif $cmd.tleap_cond.tleap_cmd == "restrainAngle":
180 restrainAngle ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b} ${cmd.tleap_cond.arg_c} ${cmd.tleap_cond.arg_force} ${cmd.tleap_cond.arg_angle}
181 #elif $cmd.tleap_cond.tleap_cmd == "restrainBond":
182 restrainBond ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b} ${cmd.tleap_cond.arg_force} ${cmd.tleap_cond.arg_length}
183 #elif $cmd.tleap_cond.tleap_cmd == "restrainTorsion":
184 restrainTorsion ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_a} ${cmd.tleap_cond.arg_b} ${cmd.tleap_cond.arg_c} ${cmd.tleap_cond.arg_d} ${cmd.tleap_cond.arg_force} ${cmd.tleap_cond.arg_phi} ${cmd.tleap_cond.arg_multiplicity}
185 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberParm":
186 saveAmberParm ${cmd.tleap_cond.arg_unit} out/saveAmberParm_topologyfilename_${i}_1.prmtop out/saveAmberParm_coordinatefilename_${i}_2.inpcrd
187 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberParmNetcdf":
188 saveAmberParmNetcdf ${cmd.tleap_cond.arg_unit} out/saveAmberParmNetcdf_topologyfilename_${i}_1.top out/saveAmberParmNetcdf_coordinatefilename_${i}_2.coord
189 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberParmPert":
190 saveAmberParmPert ${cmd.tleap_cond.arg_unit} out/saveAmberParmPert_topologyfilename_${i}_1.top out/saveAmberParmPert_coordinatefilename_${i}_2.coord
191 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberParmPol":
192 saveAmberParmPol ${cmd.tleap_cond.arg_unit} out/saveAmberParmPol_topologyfilename_${i}_1.top out/saveAmberParmPol_coordinatefilename_${i}_2.coord
193 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberParmPolPert":
194 saveAmberParmPolPert ${cmd.tleap_cond.arg_unit} out/saveAmberParmPolPert_topologyfilename_${i}_1.top out/saveAmberParmPolPert_coordinatefilename_${i}_2.coord
195 #elif $cmd.tleap_cond.tleap_cmd == "saveAmberPrep":
196 saveAmberPrep ${cmd.tleap_cond.arg_unit} out/saveAmberPrep_filename_${i}_1.txt
197 #elif $cmd.tleap_cond.tleap_cmd == "saveMol2":
198 saveMol2 ${cmd.tleap_cond.arg_unit} out/saveMol2_filename_${i}_1.mol2 ${cmd.tleap_cond.arg_option}
199 #elif $cmd.tleap_cond.tleap_cmd == "saveMol3":
200 saveMol3 ${cmd.tleap_cond.arg_unit} out/saveMol3_filename_${i}_1.mol3 ${cmd.tleap_cond.arg_option}
201 #elif $cmd.tleap_cond.tleap_cmd == "saveOff":
202 saveOff ${cmd.tleap_cond.arg_obj} out/saveOff_filename_${i}_1.txt
203 #elif $cmd.tleap_cond.tleap_cmd == "savePdb":
204 savePdb ${cmd.tleap_cond.arg_unit} out/savePdb_filename_${i}_1.pdb
205 #elif $cmd.tleap_cond.tleap_cmd == "scaleCharges":
206 scaleCharges ${cmd.tleap_cond.arg_container} ${cmd.tleap_cond.arg_scale_factor}
207 #elif $cmd.tleap_cond.tleap_cmd == "select":
208 select ${cmd.tleap_cond.arg_obj}
209 #elif $cmd.tleap_cond.tleap_cmd == "sequence":
210 #if $cmd.tleap_cond.sequence_assign:
211 ${cmd.tleap_cond.sequence_assign} = sequence { ${cmd.tleap_cond.arg_list} }
212 #else:
213 sequence { ${cmd.tleap_cond.arg_list} }
214 #end if
215 #elif $cmd.tleap_cond.tleap_cmd == "set":
216 set ${cmd.tleap_cond.arg_variable} ${cmd.tleap_cond.arg_container} ${cmd.tleap_cond.arg_dim}
217 #elif $cmd.tleap_cond.tleap_cmd == "set_default":
218 #for $setdefaultsvar in $cmd.tleap_cond.defaults:
219 set default ${setdefaultsvar.settingsvariable} ${setdefaultsvar.usersetting}
220 #end for
221 #elif $cmd.tleap_cond.tleap_cmd == "setBox":
222 setBox ${cmd.tleap_cond.arg_unit} ${cmd.tleap_cond.arg_enclosure} ${cmd.tleap_cond.arg_buffer}
223 #elif $cmd.tleap_cond.tleap_cmd == "showdefault":
224 showdefault
225 #elif $cmd.tleap_cond.tleap_cmd == "solvateBox":
226 solvateBox ${cmd.tleap_cond.arg_solute} ${cmd.tleap_cond.arg_solvent} ${cmd.tleap_cond.arg_buffer} ${cmd.tleap_cond.arg_iso} ${cmd.tleap_cond.arg_closeness}
227 #elif $cmd.tleap_cond.tleap_cmd == "solvateCap":
228 solvateCap ${cmd.tleap_cond.arg_solute} ${cmd.tleap_cond.arg_solvent} ${cmd.tleap_cond.arg_position} ${cmd.tleap_cond.arg_radius} ${cmd.tleap_cond.arg_closeness}
229 #elif $cmd.tleap_cond.tleap_cmd == "solvateDontClip":
230 solvateDontClip ${cmd.tleap_cond.arg_solute} ${cmd.tleap_cond.arg_solvent} ${cmd.tleap_cond.arg_buffer} ${cmd.tleap_cond.arg_closeness}
231 #elif $cmd.tleap_cond.tleap_cmd == "solvateOct":
232 solvateOct ${cmd.tleap_cond.arg_solute} ${cmd.tleap_cond.arg_solvent} ${cmd.tleap_cond.arg_buffer} ${cmd.tleap_cond.arg_iso} ${cmd.tleap_cond.arg_closeness}
233 #elif $cmd.tleap_cond.tleap_cmd == "solvateShell":
234 solvateShell ${cmd.tleap_cond.arg_solute} ${cmd.tleap_cond.arg_solvent} ${cmd.tleap_cond.arg_thickness} ${cmd.tleap_cond.arg_closeness}
235 #elif $cmd.tleap_cond.tleap_cmd == "source":
236 source ${cmd.tleap_cond.arg_filename}
237 #elif $cmd.tleap_cond.tleap_cmd == "transform":
238 transform ${cmd.tleap_cond.arg_atoms} {
239 { ${cmd.tleap_cond.arg_matrix_row1} }
240 { ${cmd.tleap_cond.arg_matrix_row2} }
241 { ${cmd.tleap_cond.arg_matrix_row3} }
242 { 0 0 0 1 }
243 }
244 #elif $cmd.tleap_cond.tleap_cmd == "translate":
245 translate ${cmd.tleap_cond.arg_atoms} { ${cmd.tleap_cond.arg_direction} }
246 #elif $cmd.tleap_cond.tleap_cmd == "verbosity":
247 verbosity ${cmd.tleap_cond.arg_level}
248 #elif $cmd.tleap_cond.tleap_cmd == "zMatrix":
249 zMatrix ${cmd.tleap_cond.arg_obj} ${cmd.tleap_cond.arg_zmatrix}
250 #end if
251 #end for]]>
252 quit
253 </configfile>
254 </configfiles>
255
256 <inputs>
257
258 <repeat name="tleap_cmds" title="Add tLEaP command" min="1">
259 <conditional name="tleap_cond">
260 <param type="select" name="tleap_cmd" label="Choose tLEaP command">
261 <option value="add">add</option>
262 <option value="addAtomTypes">addAtomTypes</option>
263 <option value="addH">addH</option>
264 <option value="addIons">addIons</option>
265 <option value="addIons2">addIons2</option>
266 <option value="addIonsRand">addIonsRand</option>
267 <option value="addPath">addPath</option>
268 <option value="addPdbAtomMap">addPdbAtomMap</option>
269 <option value="addPdbResMap">addPdbResMap</option>
270 <option value="alignAxes">alignAxes</option>
271 <option value="bond">bond</option>
272 <option value="bondByDistance">bondByDistance</option>
273 <option value="center">center</option>
274 <option value="charge">charge</option>
275 <option value="check">check</option>
276 <option value="clearPdbAtomMap">clearPdbAtomMap</option>
277 <option value="clearPdbResMap">clearPdbResMap</option>
278 <option value="clearVariables">clearVariables</option>
279 <option value="combine">combine</option>
280 <option value="copy">copy</option>
281 <option value="createAtom">createAtom</option>
282 <option value="createParmset">createParmset</option>
283 <option value="createResidue">createResidue</option>
284 <option value="createUnit">createUnit</option>
285 <option value="crossLink">crossLink</option>
286 <option value="debugOff">debugOff</option>
287 <option value="debugOn">debugOn</option>
288 <option value="debugStatus">debugStatus</option>
289 <option value="deleteBond">deleteBond</option>
290 <option value="deleteOffLibEntry">deleteOffLibEntry</option>
291 <option value="deleteRestraint">deleteRestraint</option>
292 <option value="desc">desc</option>
293 <option value="deSelect">deSelect</option>
294 <option value="displayPdbAtomMap">displayPdbAtomMap</option>
295 <option value="displayPdbResMap">displayPdbResMap</option>
296 <option value="edit">edit</option>
297 <option value="flip">flip</option>
298 <option value="groupSelectedAtoms">groupSelectedAtoms</option>
299 <option value="help">help</option>
300 <option value="impose">impose</option>
301 <option value="list">list</option>
302 <option value="listOff">listOff</option>
303 <option value="loadAmberParams">loadAmberParams</option>
304 <option value="loadAmberPrep">loadAmberPrep</option>
305 <option value="loadMol2">loadMol2</option>
306 <option value="loadMol3">loadMol3</option>
307 <option value="loadOff">loadOff</option>
308 <option value="loadPdb">loadPdb</option>
309 <option value="loadPdbUsingSeq">loadPdbUsingSeq</option>
310 <option value="logFile">logFile</option>
311 <option value="matchVariables">matchVariables</option>
312 <option value="measureGeom">measureGeom</option>
313 <option value="relax">relax</option>
314 <option value="remove">remove</option>
315 <option value="restrainAngle">restrainAngle</option>
316 <option value="restrainBond">restrainBond</option>
317 <option value="restrainTorsion">restrainTorsion</option>
318 <option value="saveAmberParm">saveAmberParm</option>
319 <option value="saveAmberParmNetcdf">saveAmberParmNetcdf</option>
320 <option value="saveAmberParmPert">saveAmberParmPert</option>
321 <option value="saveAmberParmPol">saveAmberParmPol</option>
322 <option value="saveAmberParmPolPert">saveAmberParmPolPert</option>
323 <option value="saveAmberPrep">saveAmberPrep</option>
324 <option value="saveMol2">saveMol2</option>
325 <option value="saveMol3">saveMol3</option>
326 <option value="saveOff">saveOff</option>
327 <option value="savePdb">savePdb</option>
328 <option value="scaleCharges">scaleCharges</option>
329 <option value="select">select</option>
330 <option value="sequence">sequence</option>
331 <option value="set">set</option>
332 <option value="set_default">set_default</option>
333 <option value="setBox">setBox</option>
334 <option value="showdefault">showdefault</option>
335 <option value="solvateBox">solvateBox</option>
336 <option value="solvateCap">solvateCap</option>
337 <option value="solvateDontClip">solvateDontClip</option>
338 <option value="solvateOct">solvateOct</option>
339 <option value="solvateShell">solvateShell</option>
340 <option value="source">source</option>
341 <option value="transform">transform</option>
342 <option value="translate">translate</option>
343 <option value="verbosity">verbosity</option>
344 <option value="zMatrix">zMatrix</option>
345 </param>
346 <when value="add">
347 <param name="arg_a" label="a value" type="text" value="" help="UNIT/RESIDUE/ATOM"/>
348 <param name="arg_b" label="b value" type="text" value="" help="UNIT/RESIDUE/ATOM"/>
349 </when>
350 <when value="addAtomTypes">
351 <repeat name="atomtypevars" title="new atom type parameters" min="1">
352 <param name="arg_addAtomTypes_var1" label="name" type="text" value="" help="designated name in the force field"/>
353 <param name="arg_addAtomTypes_var2" label="element" type="text" value="" help="atom name as it appear in the periodic table"/>
354 <param name="arg_addAtomTypes_var3" label="hybridization state" type="text" value="" help="sp2, sp3, etc."/>
355 </repeat>
356 </when>
357 <when value="addH">
358 <param name="arg_obj" label="Assign to UNIT with variable name:" type="text" value="" help="this should be the same variable given to a previously loaded target structure"/>
359 </when>
360 <when value="addIons">
361 <expand macro="addingions" />
362 </when>
363 <when value="addIons2">
364 <expand macro="addingions" />
365 </when>
366 <when value="addIonsRand">
367 <expand macro="addingions" />
368 <param name="arg_separation" label="separation value" type="text" value="" help="This value guarantees a minimum distance between inserted ions, in angstsroms."/>
369 </when>
370 <when value="addPath">
371 <param name="arg_path" label="path to directory" type="text" value="" help="Specify additional paths for leap to search for files when executing commands."/>
372 </when>
373 <when value="addPdbAtomMap">
374 <repeat name="AtomMapList" title="Add atom name from a pdb file to a list" min="1">
375 <param name="oddpdbname" label="Odd atom type from pdb file" type="text" value="" help=""/>
376 <param name="libpdbname" label="Atom type to reference in the library" type="text" value="" help=""/>
377 </repeat>
378 </when>
379 <when value="addPdbResMap">
380 <repeat name="resmap" title="Add atom name from a pdb file to a residue map in LEaP" min="1">
381 <param name="terminalflag" label="If terminal atom, select type:" type="text" value="" help="select 0 for beginning residues (N-terminal for proteins, 5' for nucleic acids) and 1 for ending residues (C-terminal for proteins, 3' for nucleic acids). Leave blank if neither. "/>
382 <param name="pdbname" label="atom name in pdb file" type="text" value="" help=""/>
383 <param name="leapvar" label="variable name within leap to map onto" type="text" value="" help=""/>
384 </repeat>
385 </when>
386 <when value="alignAxes">
387 <expand macro="unitvariable" />
388 </when>
389 <when value="bond">
390 <param name="arg_atom1" label="Bonding atom 1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype', where the assigned UNITvariable is the same one used to define your structure in loadPdb, saveAmberParm, savePdb, and other commands in your tleap script. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. "/>
391 <param name="arg_atom2" label="Bonding atom 2" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype', where the assigned UNITvariable is the same one used to define your structure in loadPdb, saveAmberParm, savePdb, and other commands in your tleap script. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. "/>
392 <param name="arg_order" label="order value" type="select" value="" help="Choose 'S' for single bond, 'D' for double bond, 'T' for triple bond, or 'A' for aromatic bond. The default value is 'S' if left blank.">
393 <option value="">default</option>
394 <option value="S">single bond</option>
395 <option value="D">double bond</option>
396 <option value="T">triple bond</option>
397 <option value="A">aromatic bond</option>
398 </param>
399 </when>
400 <when value="bondByDistance">
401 <expand macro="container" />
402 <param name="arg_maxBond" label="maxBond value" type="text" value="" help="maximum distance, in angstroms"/>
403 </when>
404 <when value="center">
405 <expand macro="container"/>
406 </when>
407 <when value="charge">
408 <expand macro="container"/>
409 </when>
410 <when value="check">
411 <expand macro="unitvariable" />
412 <param name="arg_parmset" label="parmset value" type="text" value="" help="PARMSET/STRING where all mising parameters are placed. This is optional."/>
413 </when>
414 <when value="clearPdbAtomMap">
415 </when>
416 <when value="clearPdbResMap">
417 </when>
418 <when value="clearVariables">
419 <param name="arg_list" label="list of variables to clear" type="text" value="" help="This is optional. Use only if a specific set of variables need to be cleared. If left empty, all variables will be cleared by default."/>
420 </when>
421 <when value="combine">
422 <param name="combine_assign" label="Name of the new combined list of variables" type="text" value=""/>
423 <param name="arg_list" label="list of variables" type="text" value="" help="Write the name of previously defined variables that you'd like to combine into this new list. "/>
424 </when>
425 <when value="copy">
426 <param name="copy_assign" label="Name of the newly copied variable:" type="text" value=""/>
427 <param name="arg_variable" label="Variable you are making a copy of:" type="text" value="" help=""/>
428 </when>
429 <when value="createAtom">
430 <expand macro="create" />
431 <param name="arg_type" label="new atom type" type="text" value="" help="STRING"/>
432 <param name="arg_charge" label="atomic charge" type="text" value="" help="NUMBER"/>
433 </when>
434 <when value="createParmset">
435 <expand macro="create" />
436 </when>
437 <when value="createResidue">
438 <expand macro="create" />
439 </when>
440 <when value="createUnit">
441 <expand macro="create" />
442 </when>
443 <when value="crossLink">
444 <param name="arg_res1" label="res1 value" type="text" value="" help="Residue 1"/>
445 <param name="arg_conn1" label="conn1 value" type="text" value="" help="connecting atom on residue 1"/>
446 <param name="arg_res2" label="res2 value" type="text" value="" help="Residue 2"/>
447 <param name="arg_conn2" label="conn2 value" type="text" value="" help="connecting atom on residue 2"/>
448 </when>
449 <when value="debugOff">
450 <expand macro="builtin_amberfiles" />
451 </when>
452 <when value="debugOn">
453 <expand macro="builtin_amberfiles" />
454 </when>
455 <when value="debugStatus">
456 </when>
457 <when value="deleteBond">
458 <param name="arg_atom1" label="Bonding atom 1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype', where the assigned UNITvariable is the same one used to define your structure in loadPdb, saveAmberParm, savePdb, and other commands in your tleap script. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. "/>
459 <param name="arg_atom2" label="Bonding atom 2" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype', where the assigned UNITvariable is the same one used to define your structure in loadPdb, saveAmberParm, savePdb, and other commands in your tleap script. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. "/>
460 </when>
461 <when value="deleteOffLibEntry">
462 <param name="arg_library" label="library value" type="text" format="txt" value="" help="STRING"/>
463 <param name="arg_entry" label="entry value" type="text" value="" help="STRING"/>
464 </when>
465 <when value="deleteRestraint">
466 <expand macro="unitvariable" />
467 <param name="arg_a" label="a value" type="text" value="" help="ATOM"/>
468 <param name="arg_b" label="b value" type="text" value="" help="ATOM"/>
469 <param name="arg_c" label="c value" type="text" value="" help="ATOM"/>
470 <param name="arg_d" label="d value" type="text" value="" help="ATOM"/>
471 </when>
472 <when value="desc">
473 <expand macro="unitvariable" />
474 </when>
475 <when value="deSelect">
476 <expand macro="object" />
477 </when>
478 <when value="displayPdbAtomMap">
479 </when>
480 <when value="displayPdbResMap">
481 </when>
482 <when value="edit">
483 <param name="arg_unit_parmset" label="unit-parmset value" type="text" value="" help="UNIT/PARMSET"/>
484 </when>
485 <when value="flip">
486 <expand macro="object" />
487 </when>
488 <when value="groupSelectedAtoms">
489 <expand macro="unitvariable" />
490 <param name="arg_name" label="name value" type="text" value="" help="STRING"/>
491 </when>
492 <when value="help">
493 <param name="arg_string" label="string value" type="text" value="" help="STRING"/>
494 </when>
495 <when value="impose">
496 <expand macro="unitvariable" />
497 <param name="arg_seqlist" label="seqlist value" type="text" value="" help="LIST"/>
498 <param name="arg_internals_atom1" label="internals atom1" type="text" value="" help=""/>
499 <param name="arg_internals_atom2" label="internals atom2" type="text" value="" help=""/>
500 <param name="arg_internals_displacement" label="displacement" type="text" value="" help="can be positive or negative, in angstroms"/>
501 </when>
502 <when value="list">
503 </when>
504 <when value="listOff">
505 <param name="arg_library" label="library value" type="data" value="" format="txt" help="STRING"/>
506 </when>
507 <when value="loadAmberParams">
508 <param name="loadAmberParams_assign" label="Assign to variable named" type="text" value=""/>
509 <expand macro="amberfiles_conditional" />
510 </when>
511 <when value="loadAmberPrep">
512 <expand macro="amberfiles_conditional" />
513 <param name="arg_prefix" label="prefix value" type="text" value="" help="STRING"/>
514 </when>
515 <when value="loadMol2">
516 <param name="loadMol2_assign" label="Assign to variable named" type="text" value="" help="This is the molecule's residue name as it appears in the mol2 file."/>
517 <expand macro="loadfile" data_format="mol2"/>
518 </when>
519 <when value="loadMol3">
520 <param name="loadMol3_assign" label="Assign to variable named" type="text" value="" help="This is the molecule's residue name as it appears in the mol2 file."/>
521 <expand macro="loadfile" data_format="mol3"/>
522 </when>
523 <when value="loadOff">
524 <expand macro="loadfile" />
525 </when>
526 <when value="loadPdb">
527 <param name="loadPdb_assign" label="Assign to variable named" type="text" value="" help="The variable name that your system's components are assigned to. This should generally be the same variable used when saving the output files (when using savePdb, saveAmberParm, etc.)."/>
528 <expand macro="loadfile" data_format="pdb"/>
529 </when>
530 <when value="loadPdbUsingSeq">
531 <expand macro="loadfile" data_format="pdb"/>
532 <param name="arg_unitlist" label="unitlist value" type="text" value="" help="LIST"/>
533 </when>
534 <when value="logFile">
535 <expand macro="loadfile" />
536 >
537 </when>
538 <when value="matchVariables">
539 <param name="matchVariables_assign" label="Assign to variable named" type="text" value=""/>
540 <param name="arg_string" label="string value" type="text" value="" help="STRING"/>
541 </when>
542 <when value="measureGeom">
543 <param name="arg_atom1" label="atom1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
544 <param name="arg_atom2" label="atom2" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
545 <param name="arg_atom3" label="atom3" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
546 <param name="arg_atom4" label="atom4" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber.atomtype'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
547 </when>
548 <when value="relax">
549 <expand macro="object" />
550 </when>
551 <when value="remove">
552 <param name="arg_a" label="a value --> Object you are removing contents FROM" type="text" value="" help="UNIT/RESIDUE/ATOM. The object can be a specific residue [ type 'UNITvariable.residuenumber(or name)' ], or an entire UNIT [ only type 'UNITvariable' ]. "/>
553 <param name="arg_b" label="b value --> The specific content you are removing" type="text" value="" help="UNIT/RESIDUE/ATOM. The contents can be a single atom [type 'UNITvariable.residuenumber(or name).atomtype(or number)' ], or an entire residue [type 'UNITvariable.residuenumber(or name)' ]. "/>
554 </when>
555 <when value="restrainAngle">
556 <expand macro="unitvariable" />
557 <param name="arg_a" label="atom1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
558 <param name="arg_b" label="atom2 or the middle atom" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
559 <param name="arg_c" label="atom3" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
560 <param name="arg_force" label="Force constant K_theta" type="text" value="" help="This is the force constant value you are setting to restrain this angle, in kcal/mol/radian^2."/>
561 <param name="arg_angle" label="Equilibrium angle theta" type="text" value="" help="This is the equilibrium angle, in degrees, between these 3 interacting atoms."/>
562 </when>
563 <when value="restrainBond">
564 <expand macro="unitvariable" />
565 <param name="arg_a" label="atom1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
566 <param name="arg_b" label="atom2" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
567 <param name="arg_force" label="Force constant K_b" type="text" value="" help="This is the force constant value you are setting to restrain this length, in kcal/mol/angstrom^2. "/>
568 <param name="arg_length" label="Equilibrium length" type="text" value="" help="This is the equilibrium bond length between these two atoms."/>
569 </when>
570 <when value="restrainTorsion">
571 <expand macro="unitvariable" />
572 <param name="arg_a" label="atom1" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
573 <param name="arg_b" label="atom2" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
574 <param name="arg_c" label="atom3" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
575 <param name="arg_d" label="atom4" type="text" value="" help="Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'." />
576 <param name="arg_force" label="Force constant K_phi" type="text" value="" help="This is the force constant you are setting to restrain this dihedral."/>
577 <param name="arg_phi" label="Equilibrium torsion angle phi" type="text" value="" help="This is the equilibrium torsion angle for this dihedral."/>
578 <param name="arg_multiplicity" label="multiplicity value" type="text" value="" help="NUMBER"/>
579 </when>
580 <when value="saveAmberParm">
581 <param name="arg_unit" label="Assign to variable named" type="text" value="" help="The variable name that your system's components are assigned to. This should generally be the same variable used previously with input commands like 'loadPdb'."/>
582 </when>
583 <when value="saveAmberParmNetcdf">
584 <expand macro="unitvariable" />
585 </when>
586 <when value="saveAmberParmPert">
587 <expand macro="unitvariable" />
588 </when>
589 <when value="saveAmberParmPol">
590 <expand macro="unitvariable" />
591 </when>
592 <when value="saveAmberParmPolPert">
593 <expand macro="unitvariable" />
594 </when>
595 <when value="saveAmberPrep">
596 <expand macro="unitvariable" />
597 <expand macro="newfile" />
598 </when>
599 <when value="saveMol2">
600 <expand macro="unitvariable" />
601
602 <param name="arg_option" label="option value" type="text" value="" help="NUMBER"/>
603 </when>
604 <when value="saveMol3">
605 <expand macro="unitvariable" />
606 <param name="arg_option" label="option value" type="text" value="" help="NUMBER"/>
607 </when>
608 <when value="saveOff">
609 <expand macro="object" />
610 </when>
611 <when value="savePdb">
612 <param name="arg_unit" label="Assign to variable named" type="text" value="" help="The variable name that your system's components are assigned to. This should generally be the same variable used previously with input commands like 'loadPdb'."/>
613 </when>
614 <when value="scaleCharges">
615 <expand macro="container" />
616 <param name="arg_scale_factor" label="scale_factor value" type="text" value="" help="NUMBER"/>
617 </when>
618 <when value="select">
619 <expand macro="object" />
620 </when>
621 <when value="sequence">
622 <param name="sequence_assign" label="Assign to variable named" type="text" value=""/>
623 <param name="arg_list" label="list value" type="text" value="" help="LIST"/>
624 </when>
625 <when value="set">
626 <param name="arg_variable" label="variable value" type="text" value="" help="the variable name that your components are assigned to"/>
627 <param name="arg_container" label="container value" type="text" value="" help="type'box' if you are using this command to set box dimensions"/>
628 <param name="arg_dim" label="dimensions value" type="text" value="" help="dimension magnitude for X, Y, and Z"/>
629 </when>
630 <when value="set_default">
631 <repeat name="defaults" title="Default setting to adjust:">
632 <expand macro="defaultsettings" />
633 <expand macro="settingoptions" />
634 </repeat>
635 </when>
636 <when value="setBox">
637 <expand macro="unitvariable" />
638 <param name="arg_enclosure" label="enclosure value" type="text" value="" help="type 'vdw' or 'centers'"/>
639 <param name="arg_buffer" label="buffer value" type="text" value="" help="object"/>
640 </when>
641 <when value="showdefault">
642 </when>
643 <when value="solvateBox">
644 <expand macro="solvateparams" />
645 <param name="arg_iso" label="iso value" type="text" value="" help="type 'iso' if using this option"/>
646 </when>
647 <when value="solvateCap">
648 <expand macro="solvateparams" />
649 <param name="arg_position" label="position value" type="text" value="" help="Defines the center of the solvent cap. Can be listed directly using coordinates for { X Y Z }, or you can specify a UNIT, RESIDUE, ATOM, or LIST of any of these 3 as a reference for position."/>
650 <param name="arg_radius" label="radius value" type="text" value="" help="NUMBER"/>
651 </when>
652 <when value="solvateDontClip">
653 <expand macro="solvateparams" />
654 <param name="arg_closeness" label="closeness value" type="text" value="" help="NUMBER"/>
655 </when>
656 <when value="solvateOct">
657 <expand macro="solvateparams" />
658 <param name="arg_iso" label="iso value" type="text" value="" help="type 'iso' if choosing this option"/>
659 </when>
660 <when value="solvateShell">
661 <expand macro="solvateparams" />
662 <param name="arg_thickness" label="thickness value" type="text" value="" help="NUMBER"/>
663 </when>
664 <when value="source">
665 <expand macro="builtin_amberfiles" />
666 </when>
667 <when value="transform">
668 <param name="arg_atoms" label="atoms value" type="text" value="" help="UNIT/RESIDUE/ATOM. You can transform an entire UNIT, an entire RESIDUE, or a specific atom. Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. Multiple selections can be typed into this list so a transformation is performed on several components of your system at once, just separate each choice of UNIT/RESIDUE/ATOM with a single space in between. " />
669 <param name="arg_matrix_row1" label="Row 1 of matrix" type="text" value="" help="type the following: ' r11 r12 r13 -tx ', where r11-r13 are matrix elements for the X dimension. If you would like to translate along this dimension, assign a value to -tx, in angstroms. For a simple reflection along this axis, set this row to r11=-1, r12=0, r13=0. "/>
670 <param name="arg_matrix_row2" label="Row 2 of matrix" type="text" value="" help="type the following: ' r21 r22 r23 -tx ', where r21-r23 are matrix elements for the Y dimension. If you would like to translate along this dimension, assign a value to -ty, in angstroms. For a simple reflection along this axis, set this row to r21=0, r22=-1, r23=0. "/>
671 <param name="arg_matrix_row3" label="Row 3 of matrix" type="text" value="" help="type the following: ' r31 r32 r33 -tz ', where r31-r33 are matrix elements for the Z dimension. If you would like to translate along this dimension, assign a value to -tz, in angstroms. For a simple reflection along this axis, set this row to r31=0, r32=0, r33=-1. "/>
672 </when>
673 <when value="translate">
674 <param name="arg_atoms" label="list of atoms" type="text" value="" help="UNIT/RESIDUE/ATOM. You can translate an entire UNIT, an entire RESIDUE, or a specific atom. Each atom is defined as 'UNITvariable.residuenumber(or name).atomtype(or number)'. For example, typing 'mol.5.SG' tells tleap that the bonding atom is assigned to the variable 'mol', in residue number 5, and is the atom type 'SG'. Multiple selections can be typed into this list so a transformation is performed on several components of your system at once, just separate each choice of UNIT/RESIDUE/ATOM with a single space in between. " />
675 <param name="arg_direction" label="direction value in each dimension" type="text" value="" help="Displace by this amount { X Y Z }. The direction is based on whether each vector is positive or negative. "/>
676 </when>
677 <when value="verbosity">
678 <param name="arg_level" label="level value" type="text" value="" help="This command sets the level of output that LEaP provides the user. A value of 0 is the default, providing the minimum of messages. A value of 1 will produce more output, and a value of 2 will produce all of the output of level 1 and display the text of the script lines executed with the source command."/>
679 </when>
680 <when value="zMatrix">
681 <param name="arg_obj" label="obj value" type="text" value="" help="UNIT/RESIDUE/ATOM"/>
682 <param name="arg_zmatrix" label="zmatrix value" type="text" value="" help="LIST"/>
683 </when>
684 </conditional>
685 </repeat>
686 </inputs>
687 <outputs>
688 <data format="txt" name="output_tleap_in" label="Build tLEaP: tleap.in"/>
689 <data format="txt" name="output_tleap" label="Build tLEaP: tleap.log"/>
690 <collection name="output_pdb" type="list" label="Collection of pdb" format="pdb">
691 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.pdb" directory="out" format="pdb"/>
692 </collection>
693 <collection name="output_top" type="list" label="Collection of topology files" format="prmtop">
694 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.prmtop" directory="out" format="prmtop"/>
695 </collection>
696 <collection name="output_txt" type="list" label="Collection of txt" format="txt">
697 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.txt" directory="out" format="txt"/>
698 </collection>
699 <collection name="output_coord" type="list" label="Collection of coordinate files" format="inpcrd">
700 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.inpcrd" directory="out" format="inpcrd"/>
701 </collection>
702 <collection name="output_mol2" type="list" label="Collection of mol2" format="mol2">
703 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.mol2" directory="out" format="mol2"/>
704 </collection>
705 <collection name="output_mol3" type="list" label="Collection of mol3" format="mol3">
706 <discover_datasets pattern="(?P&lt;designation&gt;.+)\.mol3" directory="out" format="mol3"/>
707 </collection>
708 </outputs>
709 <tests>
710 <test expect_num_outputs="8">
711 <repeat name="tleap_cmds">
712 <conditional name="tleap_cond">
713 <param name="tleap_cmd" value="source"/>
714 <param name="arg_filename" value="oldff/leaprc.ff14SB"/>
715 </conditional>
716 </repeat>
717 <repeat name="tleap_cmds">
718 <conditional name="tleap_cond">
719 <param name="tleap_cmd" value="loadAmberParams" />
720 <conditional name="file_source">
721 <param name="file_source_selector" value="builtin"/>
722 <param name="arg_filename" value="frcmod.ff14SB"/>
723 </conditional>
724 </conditional>
725 </repeat>
726 <repeat name="tleap_cmds">
727 <conditional name="tleap_cond">
728 <param name="tleap_cmd" value="loadAmberParams" />
729 <conditional name="file_source">
730 <param name="file_source_selector" value="builtin"/>
731 <param name="arg_filename" value="frcmod.ionsjc_tip4pew"/>
732 </conditional>
733 </conditional>
734 </repeat>
735 <repeat name="tleap_cmds">
736 <conditional name="tleap_cond">
737 <param name="tleap_cmd" value="loadAmberPrep" />
738 <conditional name="file_source">
739 <param name="file_source_selector" value="history"/>
740 <param name="arg_filename" value="ZAFF.prep"/>
741 </conditional>
742 </conditional>
743 </repeat>
744 <repeat name="tleap_cmds">
745 <conditional name="tleap_cond">
746 <param name="tleap_cmd" value="loadAmberParams" />
747 <conditional name="file_source">
748 <param name="file_source_selector" value="history"/>
749 <param name="arg_filename" value="ZAFF.frcmod"/>
750 </conditional>
751 </conditional>
752 </repeat>
753 <repeat name="tleap_cmds">
754 <conditional name="tleap_cond">
755 <param name="tleap_cmd" value="loadPdb" />
756 <param name="loadPdb_assign" value="mol" />
757 <param name="arg_filename" value="sarscov2_helicase_ZincBindingDomain.pdb"/>
758 </conditional>
759 </repeat>
760 <repeat name="tleap_cmds">
761 <conditional name="tleap_cond">
762 <param name="tleap_cmd" value="bond" />
763 <param name="arg_atom1" value="mol.114.ZN" />
764 <param name="arg_atom2" value="mol.5.SG" />
765 </conditional>
766 </repeat>
767 <repeat name="tleap_cmds">
768 <conditional name="tleap_cond">
769 <param name="tleap_cmd" value="set" />
770 <param name="arg_variable" value="mol" />
771 <param name="arg_container" value="box" />
772 <param name="arg_dim" value="12" />
773 </conditional>
774 </repeat>
775 <repeat name="tleap_cmds">
776 <conditional name="tleap_cond">
777 <param name="tleap_cmd" value="addIons" />
778 <param name="arg_variable" value="mol" />
779 <param name="arg_ion1" value="Cl-" />
780 <param name="arg__ion1" value="0" />
781 <param name="arg_ion2" value="Na+" />
782 <param name="arg__ion2" value="0" />
783 </conditional>
784 </repeat>
785 <repeat name="tleap_cmds">
786 <conditional name="tleap_cond">
787 <param name="tleap_cmd" value="saveAmberParm" />
788 <param name="arg_unit" value="mol" />
789 </conditional>
790 </repeat>
791 <repeat name="tleap_cmds">
792 <conditional name="tleap_cond">
793 <param name="tleap_cmd" value="savePdb" />
794 <param name="arg_unit" value="mol" />
795 </conditional>
796 </repeat>
797 <output name="output_tleap_in" value="leap_testfile.txt" lines_diff="6">
798 <assert_contents>
799 <has_text text="loadAmberParams frcmod.ff14SB" />
800 <has_text text="bond mol.114.ZN mol.5.SG" />
801 <has_text text="quit" />
802 </assert_contents>
803 </output>
804 <output name="output_tleap">
805 <assert_contents>
806 <has_text text="Welcome to LEaP!" />
807 </assert_contents>
808 </output>
809 <output_collection name="output_top" type="list" count="1">
810 <element name="saveAmberParm_topologyfilename_9_1">
811 <assert_contents>
812 <has_text text="N H1 H2 H3 CA HA CB HB1 HB2 HB3 C O N H CA HA CB HB CG1" />
813 </assert_contents>
814 </element>
815 </output_collection>
816 <output_collection name="output_coord" type="list" count="1">
817 <element name="saveAmberParm_coordinatefilename_9_2">
818 <assert_contents>
819 <has_text text="12.0000000 12.0000000 12.0000000 90.0000000 90.0000000 90.0000000" />
820 </assert_contents>
821 </element>
822 </output_collection>
823 <output_collection name="output_pdb" type="list" count="1">
824 <element name="savePdb_filename_10_1">
825 <assert_contents>
826 <has_text text="CRYST1 12.000 12.000 12.000 90.00 90.00 90.00 P 1 1" />
827 </assert_contents>
828 </element>
829 </output_collection>
830 </test>
831 </tests>
832 <help><![CDATA[
833 ::
834
835 add a b
836
837 UNIT/RESIDUE/ATOM _a_
838 UNIT/RESIDUE/ATOM _b_
839
840 Add the object _b_ to the object _a_. This command is used to place
841 ATOMs within RESIDUEs, and RESIDUEs within UNITs.
842
843 addAtomTypes {
844 { "H" "H" "sp3" }
845 { "HO" "H" "sp3" }
846 ...
847 }
848 Add mapping of AMBER atom type to element and hybridization. Typically in
849 leaprc.
850
851 addH obj
852
853 UNIT _obj_
854
855 Add missing hydrogens and build external coordinates for _obj_.
856
857 addIons unit ion1 #ion1 [ion2 #ion2]
858 UNIT _unit_
859 UNIT _ion1_
860 NUMBER _#ion1_
861 UNIT _ion2_
862 NUMBER _#ion2_
863 Adds counterions in a shell around _unit_ using a Coulombic potential
864 on a grid. If _#ion1_ is 0, the _unit_ is neutralized (_ion1_ must be
865 opposite in charge to _unit_, and _ion2_ cannot be specified). Otherwise,
866 the specified numbers of _ion1_ [_ion2_] are added [in alternating order].
867 If solvent is present, it is ignored in the charge and steric calculations,
868 and if an ion has a steric conflict with a solvent molecule, the ion is
869 moved to the center of said molecule, and the latter is deleted. (To
870 avoid this behavior, either solvate _after_ addIons, or use addIons2.)
871 Ions must be monoatomic. Note that the one-at-a-time procedure is not
872 guaranteed to globally minimize the electrostatic energy. When neutralizing
873 regular-backbone nucleic acids, the first cations will generally be added
874 between phosphates, leaving the final two ions to be placed somewhere around
875 the middle of the molecule.
876 The default grid resolution is 1 Angstrom, extending from an inner radius
877 of (max ion size + max solute atom size) to an outer radius 4 Angstroms
878 beyond. A distance-dependent dielectric is used for speed.
879
880 addIons2 unit ion1 #ion1 [ion2 #ion2]
881 UNIT _unit_
882 UNIT _ion1_
883 NUMBER _#ion1_
884 UNIT _ion2_
885 NUMBER _#ion2_
886 Same as addIons, except solvent and solute are treated the same.
887
888 addIonsRand unit ion1 #ion1 [ion2 #ion2] [separation]
889
890 UNIT _unit_
891 UNIT _ion1_
892 NUMBER _#ion1_
893 UNIT _ion2_
894 NUMBER _#ion2_
895 NUMBER _separation_
896
897 Adds counterions in a shell around _unit_ by replacing random solvent
898 molecules. If _#ion1_ is 0, the _unit_ is neutralized (_ion1_ must be
899 opposite in charge to _unit_, and _ion2_ cannot be specified). Otherwise,
900 the specified numbers of _ion1_ [_ion2_] are added [in alternating order].
901 If _separation_ is specified, ions will be guaranteed to be more than that
902 distance apart in Angstroms.
903
904 Ions must be monoatomic. This procedure is much faster than addIons, as
905 it does not calculate charges. Solvent must be present. It must be possible
906 to position the requested number of ions with the given separation in the
907 solvent.
908
909 addPath path
910
911 STRING _path_
912
913 Add the directory in _path_ to the list of directories that are searched
914 for files specified by other commands.
915
916 addPdbAtomMap list
917 LIST _list_
918
919 The atom Name Map is used to try to map atom names read from PDB files
920 to atoms within residue UNITs when the atom name in the PDB file does
921 not match an atom in the residue. This enables PDB files to be read
922 in without extensive editing of atom names. The LIST is a LIST of LISTs:
923 { {sublist} {sublist} ... }
924 where each sublist is of the form
925 { "OddAtomName" "LibAtomName" }
926 Many `odd' atom names can map to one `standard' atom name, but any single
927 odd atom name maps only to the last standard atom name it was mapped to.
928
929 addPdbResMap list
930 LIST _list_
931
932 The Name Map is used to map residue names read from PDB files to variable
933 names within LEaP. The LIST is a LIST of LISTs:
934 { {sublist} {sublist} ... }
935 Each sublist contains two or three entries to add to the Name Map:
936 { [terminalflag] PDBName LEaPVar }
937 where the PDBName will be mapped to the LEaPVar. The terminalflag indicates
938 the special cases of terminal residues: allowable values are 0 for beginning
939 residues (N-terminal for proteins, 5' for nucleic acids) and 1 for ending
940 residues (C-terminal for proteins, 3' for nucleic acids). If the
941 terminalflag is given, the PDBName->LEaPVar name map will only be applied
942 for the appropriate terminal residue. The `leaprc' file included with
943 the distribution contains default mappings.
944
945 alias [alias[ string]]
946 STRING _alias_
947 STRING _string_
948
949 alias string1 command - equivalence string1 to command.
950 alias string1 - delete the alias for string1.
951 alias - report all current aliases.
952
953 alignAxes unit
954
955 UNIT _unit_
956
957 Translate the geometric center of _unit_ to the origin and align
958 the principle axes of the ATOMs within _unit_ along the coordinate
959 axes. This is done by calculating the moment of inertia of the UNIT
960 using unit mass for each ATOM, and then diagonalizing the resulting
961 matrix and aligning the eigenvectors along the coordinate axes.
962 This command modifies the coordinates of the UNIT. It may be
963 especially useful for preparing long solutes such as nucleic acids
964 for solvation.
965
966 bond atom1 atom2 [ order ]
967
968 ATOM _atom1_
969 ATOM _atom2_
970 STRING _order_
971
972 Create a bond between _atom1_ and _atom2_. Both of these ATOMs must
973 be contained by the same UNIT. By default, the bond will be a single
974 bond. By specifying "S", "D", "T", or "A" as the optional argument
975 _order_ the user can specify a single, double, triple, or aromatic
976 bond.
977
978 bondByDistance container [ maxBond ]
979
980 UNIT/RESIDUE/ATOM _container_
981 NUMBER _maxBond_
982
983 Create single bonds between all ATOMs in _container_ that are within
984 _maxBond_ angstroms of each other. If _maxBond_ is not specified,
985 a default distance of 2 angstroms used.
986
987 center container
988 UNIT/RESIDUE/ATOM _container_
989
990 Display the coordinates of the geometric center of the ATOMs within
991 _container_.
992
993 charge container
994
995 UNIT/RESIDUE/ATOM _container_
996
997 This command calculates the total charge of the ATOMs within _container_.
998 The unperturbed and perturbed total charge are displayed.
999
1000 check unit [ parmset ]
1001 UNIT _unit_
1002 PARMSET/STRING _parmset_
1003
1004 This command can be used to check the UNIT for internal inconsistencies
1005 that could cause problems when performing calculations. This is
1006 a very useful command that should be used before a UNIT is saved
1007 with saveAmberParm or its variations.
1008 With the optional parmset, all missing parameters are placed in the
1009 PARMSET to allow for easy editing of those parameters. If a string is
1010 passed, a PARMSET will be created with that name.
1011 Currently it checks for the following possible problems:
1012
1013 - Long bonds. A long bond is greater than 3.0 angstroms.
1014
1015 - Short bonds. A short bond is less than 0.5 angstroms.
1016
1017 - Non-integral total charge of the UNIT.
1018
1019 - Missing types.
1020
1021 - Close contacts between non-bonded ATOMs. A close contact is
1022 less than 1.5 angstroms.
1023
1024 clearPdbAtomMap
1025
1026 Clear the Name Map used for ``second-chance'' mapping of atom names in
1027 PDB files to atoms within residue UNITs. See addPdbAtomMap.
1028
1029 clearPdbResMap
1030
1031 Clear the Name Map used to map residue names in PDB files to variable
1032 names within LEaP. See addPdbResMap.
1033
1034 clearVariables [ list ]
1035
1036 LIST _list_
1037
1038 This command removes variables from LEaP. If the _list_ argument
1039 is provided, then only the variables in the LIST will be removed.
1040 If no argument is provided then ALL variables will be removed.
1041
1042 variable = combine list
1043 object _variable_
1044 LIST _list_
1045
1046 Combine the contents of the UNITs within _list_ into a single UNIT.
1047 The new UNIT is placed in _variable_. This command is similar to
1048 the sequence command except it does not link the ATOMs of the UNITs
1049 together.
1050
1051 newvariable = copy variable
1052
1053 object _newvariable_
1054 object _variable_
1055
1056 Create an exact duplicate of the object _variable_. Changing the object
1057 _variable_ will not affect the object _newvariable_.
1058 This is in contrast to the situation created by "newvariable = variable"
1059 in which both names reference the same object.
1060
1061 variable = createAtom name type charge
1062
1063 ATOM _variable_
1064 STRING _name_
1065 STRING _type_
1066 NUMBER _charge_
1067
1068 Return a new ATOM with _name_, _type_, and _charge_.
1069
1070 variable = createParmset name
1071 PARMSET _variable_
1072 STRING _name_
1073
1074 Return a new and empty PARMSET with the name _name_.
1075
1076 variable = createResidue name
1077 RESIDUE _variable_
1078 STRING _name_
1079
1080 Return a new and empty RESIDUE with the name _name_.
1081
1082 variable = createUnit name
1083 UNIT _variable_
1084 STRING _name_
1085
1086 Return a new and empty UNIT with the name _name_.
1087
1088 crossLink res1 conn1 res2 conn2
1089
1090 RESIDUE _res1_
1091 STRING _connect1_
1092 RESIDUE _res2_
1093 STRING _connect2_
1094
1095 Create a bond between ATOMs at the connection point specified by
1096 _conn1_ and _conn2_. The argument _conn1_ and _conn2_ can have the
1097 following values:
1098
1099 Name_ Alternatives__
1100 $connect0 $nend, $firstend
1101 $connect1 $cend, $lastend
1102 $connect2 $send, $disulphide
1103 $connect3
1104 $connect4
1105 $connect5
1106
1107 debugOff filename
1108
1109 STRING _filename_
1110
1111 This command is a system debugging function. It turns off debugging
1112 messages from the source (.c) file _filename_. The symbol *
1113 matches all files. The default for all filenames is `off'.
1114 Note that system debugging is in effect only if LEaP was compiled
1115 with the preprocessor macro DEBUG defined.
1116
1117 debugOn filename
1118
1119 STRING _filename_
1120
1121 This command is a system debugging function. It turns on debugging
1122 messages from the source (.c) file _filename_. The symbol *
1123 matches all files. The default for all filenames is `off'.
1124 Note that system debugging is in effect only if LEaP was compiled
1125 with the preprocessor macro DEBUG defined.
1126
1127 debugStatus
1128 This command is a memory debugging function. It displays various
1129 messages that describe LEaP's usage of system resources.
1130 Note that memory debugging is in effect only if LEaP was compiled
1131 with the preprocessor macro MEMORY_DEBUG defined; MEMORY_DEBUG values
1132 range from 1 through 4 with the greatest being the most aggressive.
1133
1134 deleteBond atom1 atom2
1135
1136 ATOM _atom1_
1137 ATOM _atom2_
1138
1139 Remove the bond between the ATOMs _atom1_ and _atom2_. If no bond
1140 exists, an error will be displayed.
1141
1142 deleteOffLibEntry library entry
1143 STRING _library_
1144 STRING _entry_
1145
1146 Delete _entry_ from the Object File Format file named _library_.
1147
1148 deleteRestraint unit a b [c [d]]
1149
1150 UNIT _unit_
1151 ATOM _a_
1152 ATOM _b_
1153 ATOM _c_
1154 ATOM _d_
1155
1156 Remove a bond, angle, or torsion restraint from _unit_, depending
1157 on the number of ATOMs specified.
1158
1159 desc variable
1160 object _variable_
1161
1162 Print a description of the object.
1163
1164 deSelect obj
1165
1166 UNIT/RESIDUE/ATOM _obj_
1167
1168 Clears the SELECT flag on all ATOMs within _obj_. See the select command.
1169
1170 displayPdbAtomMap
1171
1172 Display the Name Map used for ``second chance'' mapping of atom names
1173 in PDB files to atoms within residue UNITs. See addPdbAtomMap.
1174
1175 displayPdbResMap
1176
1177 Display the Name Map used to map residue names in PDB files to variable
1178 names within LEaP. See addPdbResMap.
1179
1180 edit unit-parmset
1181 UNIT/PARMSET _unit-parmset_
1182
1183 In xLEaP this command creates a unit editor or parameter set editor
1184 that contains the UNIT or PARMSET _unit-parmset_. The user can view
1185 and edit the contents of the UNIT or PARMSET by using the mouse.
1186 If _unit-parmset_ is a PARMSET, then the user may select the Atom, Bond,
1187 Angle, Torsion, Improper Torsion, or Hydrogen Bond Parameters to
1188 edit by selecting the appropriate button.
1189 In tLEaP this command prints an error message.
1190
1191 flip obj
1192
1193 UNIT _obj_
1194
1195 Flips the chirality of the selected atoms within _obj_.
1196
1197 groupSelectedAtoms unit name
1198
1199 UNIT _unit_
1200 STRING _name_
1201
1202 Create a group within _unit_ with the name _name_ using all of the
1203 ATOMs within the UNIT that are selected. If the group has already
1204 been defined then overwrite the old group.
1205
1206 help [string]
1207
1208 STRING _string_
1209
1210 This command prints a description of the command in _string_. If
1211 the STRING is not given then a list of legal STRINGs is provided.
1212
1213 impose unit seqlist internals
1214
1215 UNIT _unit_
1216 LIST _seqlist_
1217 LIST _internals_
1218
1219 The impose command allows the user to impose internal coordinates
1220 on the UNIT. The list of RESIDUEs to impose the internal coordinates
1221 upon is in _seqlist_. The internal coordinates to impose are in
1222 the LIST _internals_.
1223 The command works by looking into each RESIDUE within the UNIT that
1224 is listed in the _seqlist_ argument and attempts to apply each of
1225 the internal coordinates within _internals_. The _seqlist_ argument
1226 is a LIST of NUMBERs that represent sequence numbers or ranges of
1227 sequence numbers. Ranges of sequence numbers are represented by
1228 two-element LISTs that contain the first and last sequence number
1229 in the range. The user can specify sequence number ranges that are
1230 larger than what is found in the UNIT. For example the range { 1 999 }
1231 represents all RESIDUEs in a 200 RESIDUE UNIT.
1232 The _internals_ argument is a LIST of LISTs. Each sublist contains
1233 a sequence of ATOM names which are of type STRING followed by the
1234 value of the internal coordinate. See the output of help _types_ for
1235 details on specifying STRINGs. Examples of the impose command are:
1236
1237 impose peptide { 1 2 3 } { { $N $CA $C $N -40.0 } { $C $N $CA $C
1238 -60.0 } }
1239
1240 The RESIDUEs with sequence numbers 1, 2, and 5 within the UNIT peptide
1241 will assume an alpha helix conformation.
1242
1243 impose peptide { 1 2 { 5 10 } 12 } { { "CA" "CB" 5.0 } }
1244
1245 This will impose on the residues with sequence numbers 1, 2, 5, 6,
1246 7, 8, 9, 10, and 12 within the UNIT peptide a bond length of 5.0
1247 angstroms between the alpha and beta carbons. RESIDUEs without an
1248 ATOM named $CB (like glycine) will be unaffected.
1249 Three types of conformational change are supported; bond length changes,
1250 bond angle changes, and torsion angle changes. If the conformational
1251 change involves a torsion angle, then all dihedrals around the central
1252 pair of atoms are rotated. The entire list of internals are applied
1253 to each RESIDUE.
1254
1255 list
1256 List all of the variables currently defined.
1257
1258 listOff library
1259 STRING _library_
1260
1261 List the UNITs/PARMSETs stored within the Object File Format file
1262 named _library_.
1263
1264 variable = loadAmberParams filename
1265 PARMSET _variable_
1266 STRING _filename_
1267
1268 Load an AMBER format parameter set file and place it in _variable_.
1269 All interactions defined in the parameter set will be contained within
1270 _variable_. This command causes the loaded parameter set to be included
1271 in LEaP's list of parameter sets that are searched when parameters are
1272 required. General proper and improper torsion parameters are modified,
1273 the AMBER general type "X" is replaced with the LEaP general type "?".
1274
1275 loadAmberPrep filename [ prefix ]
1276
1277 STRING _filename_
1278 STRING _prefix_
1279
1280 This command loads an AMBER PREP input file. For each residue that
1281 is loaded, a new UNIT is constructed that contains a single RESIDUE
1282 and a variable is created with the same name as the name of the residue
1283 within the PREP file. If the optional argument _prefix_ is provided
1284 it will be prefixed to each variable name; this feature is used to
1285 prefix united atom residues, which have the same names as all-atom
1286 residues, with the string $U to distinguish them.
1287
1288 variable = loadMol2 filename
1289 STRING _filename_
1290
1291 Load a Sybyl Mol2-format file with the file name _filename_. The UNIT
1292 loaded will have the name specified for the MOLECULE in the input file.
1293
1294 variable = loadMol3 filename
1295 STRING _filename_
1296
1297 Load a Sybyl-derived Mol3-format file with the file name _filename_.
1298 The UNIT loaded will have the name specified for the MOLECULE in the
1299 input file.
1300
1301 More information:
1302 http://q4md-forcefieldtools.org/Tutorial/leap-mol3.php
1303
1304 loadOff filename
1305 STRING _filename_
1306
1307 This command loads the Object File Format library within the file named
1308 _filename_. All UNITs and PARMSETs within the library will be loaded.
1309 The objects are loaded into LEaP under the variable names the objects
1310 had when they were saved. Variables already in existence that have the
1311 same names as the objects being loaded will be overwritten. PARMSETs
1312 loaded using this command are included in LEaP's library of PARMSETs
1313 that is searched whenever parameters are required.
1314
1315 variable = loadPdb filename
1316 STRING _filename_
1317
1318 Load a Protein Data Bank format file with the file name _filename_.
1319 The sequence numbers of the RESIDUEs will be determined from the order
1320 of residues within the PDB file ATOM records. For each residue in the
1321 PDB file, LEaP searches the variables currently defined for variable
1322 names that match the residue name. If a match is found then the
1323 contents of the variable are copied into the UNIT created for the PDB
1324 structure. If no PDB `TER' card separates the current residue from the
1325 previous one, a bond is created between the connect1 ATOM of the
1326 previous residue and the connect0 atom of the new one. (A PDB TER
1327 record is also used to detect a new residue in the case of contiguous
1328 residues with identical residue sequence numbers.) As atoms are read
1329 from the ATOM records, their coordinates are written into the
1330 correspondingly named ATOMs within the residue being built. If the
1331 entire residue is read and it is found that ATOM coordinates are missing
1332 then external coordinates are built from the internal coordinates that
1333 were defined in the matching UNIT (residue) variable. This allows LEaP
1334 to build coordinates for hydrogens and lone pairs which are not
1335 specified in PDB files.
1336
1337 loadPdbUsingSeq filename unitlist
1338
1339 STRING _filename_
1340 LIST _unitlist_
1341
1342 This command reads a Protein Data Bank format file from the file
1343 named _filename_. This command is identical to loadPdb except it
1344 does not use the residue names within the PDB file. Instead, the
1345 sequence is defined by the user in _unitlist_. For more details
1346 see loadPdb.
1347
1348 logFile filename
1349
1350 STRING _filename_
1351
1352 This command opens the file with the file name _filename_ as a log
1353 file. User input and ALL output is written to the log file. Output
1354 is written to the log file as if the verbosity level were set to 2.
1355
1356 variable = matchVariables string
1357
1358 LIST _variable_
1359 STRING _string_
1360
1361 Create a LIST of variables with names that match _string_. The _string_
1362 argument can contain the wildcard characters "?" and "*" to match any
1363 single character or substring of characters, respectively.
1364
1365 measureGeom atom1 atom2 [ atom3 [ atom4 ] ]
1366 ATOM _atom1_ _atom2_ _atom3_ _atom4_
1367
1368 Measure the distance, angle, or torsion between two, three, or four ATOMs,
1369 respectively.
1370
1371 quit
1372
1373 relax obj
1374
1375 UNIT _obj_
1376
1377 Relaxes the selected atoms within _obj_.
1378
1379 remove a b
1380
1381 UNIT/RESIDUE/ATOM _a_
1382 UNIT/RESIDUE/ATOM _b_
1383
1384 Remove the object _b_ from the object _a_. If _a_ is not contained
1385 by _b_ then an error message will be displayed. This command is
1386 used to remove ATOMs from RESIDUEs, and RESIDUEs from UNITs. If
1387 the object represented by _b_ is not referenced by some variable
1388 name then it will be destroyed.
1389
1390 restrainAngle unit a b c force angle
1391
1392 UNIT _unit_
1393 ATOM _a_
1394 ATOM _b_
1395 ATOM _c_
1396 NUMBER _force_
1397 NUMBER _angle_
1398
1399 Add an angle restraint to _unit_ between atoms _a_, _b_, and _c_,
1400 having force constant of _force_, and equilibrium angle _angle_.
1401
1402 restrainBond unit a b force length
1403
1404 UNIT _unit_
1405 ATOM _a_
1406 ATOM _b_
1407 NUMBER _force_
1408 NUMBER _length_
1409
1410 Add a bond (distance) restraint to _unit_ between atoms _a_ and _b_
1411 with a force constant of _force_ and an equilibrium distance of _length_.
1412
1413 restrainTorsion unit a b c d force phi multiplicity
1414
1415 UNIT _unit_
1416 ATOM _a_
1417 ATOM _b_
1418 ATOM _c_
1419 ATOM _d_
1420 NUMBER _force_
1421 NUMBER _phi_
1422 NUMBER _multiplicity_
1423
1424 Add a torsion restraint to _unit_ between atoms _a_, _b_, _c_, and
1425 _d_, with a force constant of _force_, an equilibrium torsion angle
1426 of _phi_, and a multiplicity of _multiplicity_.
1427
1428 saveAmberParm unit topologyfilename coordinatefilename
1429
1430 UNIT _unit_
1431 STRING _topologyfilename_
1432 STRING _coordinatefilename_
1433
1434 Save the AMBER topology and coordinate files for the UNIT into the
1435 files named _topologyfilename_ and _coordinatefilename_ respectively.
1436 This command will cause LEaP to search its list of PARMSETs for
1437 parameters defining all of the interactions between the ATOMs within
1438 the UNIT. This command produces a topology file and a coordinate file
1439 which are identical in format to those produced by the AMBER program
1440 PARM, and which can be read into AMBER and SPASMS for energy minimization,
1441 dynamics, or nmode calculations.
1442 See also: saveAmberParmPol, saveAmberParmPert, and saveAmberParmPolPert
1443 for including atomic polarizabilities and preparing free energy
1444 perturbation calculations and saveAmberParmNetcdf for saving in a
1445 binary format.
1446
1447 saveAmberParmNetcdf unit topologyfilename coordinatefilename
1448
1449 UNIT _unit_
1450 STRING _topologyfilename_
1451 STRING _coordinatefilename_
1452
1453 Save the AMBER topology and coordinate files for the UNIT into the
1454 files named _topologyfilename_ and _coordinatefilename_ respectively.
1455 This command will cause LEaP to search its list of PARMSETs for
1456 parameters defining all of the interactions between the ATOMs within
1457 the UNIT. This command produces a topology file and a coordinate file
1458 which can be read into AMBER and SPASMS for energy minimization, dynamics,
1459 or nmode calculations.
1460 The coordinate file written will be in the binary NetCDF AMBER restart
1461 format, which enables the writing of larger input files and quicker I/O.
1462 Use saveAmberParm for the regular ASCII coordinate format.
1463
1464 saveAmberParmPert unit topologyfilename coordinatefilename
1465
1466 UNIT _unit_
1467 STRING _topologyfilename_
1468 STRING _coordinatefilename_
1469
1470 Save the AMBER topology and coordinate files for the UNIT into the
1471 files named _topologyfilename_ and _coordinatefilename_ respectively.
1472 This command will cause LEaP to search its list of PARMSETs for
1473 parameters defining all of the interactions between the ATOMs within
1474 the UNIT - including the perturbed ATOMs (which are ignored by the
1475 vanilla saveAmberParm command). This command produces a topology file
1476 and a coordinate file that are identical in format to those produced by
1477 the AMBER PARM program using the PERT option, and which can be read into
1478 AMBER and SPASMS for free energy calculations.
1479
1480 saveAmberParmPol unit topologyfilename coordinatefilename
1481
1482 Like saveAmberParm, but includes atomic polarizabilities in the topology
1483 file for use with IPOL=1 in Sander. The polarizabilities are according
1484 to atom type, and are defined in the 'mass' section of the parm.dat or
1485 frcmod file. Note: charges are normally scaled when polarizabilities are
1486 used - see scaleCharges for an easy way of doing this.
1487
1488 saveAmberParmPolPert unit topologyfilename coordinatefilename
1489
1490 Like saveAmberParmPert, but includes atomic polarizabilities in the topology
1491 file for use with IPOL=1 in Gibbs. The polarizabilities are according to
1492 atom type, and are defined in the 'mass' section of the parm.dat or frcmod
1493 file. Note: charges are normally scaled when polarizabilities are used -
1494 see scaleCharges for an easy way of doing this.
1495
1496 saveAmberPrep unit filename
1497
1498 UNIT _unit_
1499 STRING _filename_
1500
1501 Save all residues in the UNIT to a prep.in file. All possible improper
1502 dihedrals are given for each residue, so unwanted ones need to be
1503 deleted from the file. 'Connect0' and 'connect1' atoms must be defined
1504 for each residue.
1505
1506 saveMol2 unit filename option
1507
1508 UNIT _unit_
1509 STRING _filename_
1510 NUMBER _option_
1511
1512 Write UNIT to the file _filename_ as a Mol2 format file.
1513 option = 0 for Default atom types
1514 option = 1 for AMBER atom types
1515
1516 More information:
1517 https://upjv.q4md-forcefieldtools.org/Tutorial/leap-mol2.php
1518
1519 saveMol3 unit filename option
1520
1521 UNIT _unit_
1522 STRING _filename_
1523 NUMBER _option_
1524
1525 Write UNIT to the file _filename_ as a Mol3 format file.
1526 option = 0 for Default atom types
1527 option = 1 for AMBER atom types
1528
1529 More information:
1530 http://q4md-forcefieldtools.org/Tutorial/leap-mol3.php
1531
1532 saveOff object filename
1533
1534 object _object_
1535 STRING _filename_
1536
1537 The saveOff command allows the user to save UNITs, and PARMSETs to a
1538 file named _filename_. The file is written using the Object File
1539 Format (OFF) and can accommodate an unlimited number of uniquely
1540 named objects. The names by which the objects are stored are the
1541 variable names specified in the argument of this command. If the
1542 file _filename_ already exists then the new objects will be added
1543 to the file. If there are objects within the file with the same
1544 names as objects being saved then the old objects will be overwritten.
1545 The argument _object_ can be a single UNIT, a single PARMSET, or
1546 a LIST of mixed UNITs and PARMSETs.
1547
1548 savePdb unit filename
1549
1550 UNIT _unit_
1551 STRING _filename_
1552
1553 Write UNIT to the file _filename_ as a PDB format file.
1554
1555 scaleCharges container scale_factor
1556
1557 UNIT/RESIDUE/ATOM _container_
1558 NUMBER _scale_factor_
1559
1560 This command scales the charges in the object by _scale_factor_,
1561 which must be > 0. It is useful for building systems for use
1562 with polarizable atoms, e.g.
1563 > x = copy solute
1564 > scaleCharges x 0.8
1565 > y = copy WATBOX216
1566 > scalecharges y 0.875
1567 > solvatebox x y 10
1568 > saveamberparmpol x x.top x.crd
1569
1570 select obj
1571
1572 UNIT/RESIDUE/ATOM _obj_
1573
1574 Sets the SELECT flag on all ATOMs within _obj_. See the deSelect command.
1575
1576 variable = sequence list
1577
1578 LIST _list_
1579
1580 The sequence command is used to create a new UNIT by copying the
1581 contents of a LIST of UNITs. As each UNIT in the list is copied,
1582 a bond is created between its head atom and the tail ATOM of the
1583 previous UNIT, if both connect ATOMs are defined. If only one of
1584 the connect pair is defined, a warning is generated and no bond is
1585 created. If neither connection ATOM is defined then no bond is
1586 created. As each RESIDUE within a UNIT is copied, it is assigned a
1587 sequence number reflecting the order added. The order of RESIDUEs
1588 in multi-RESIDUE UNITs is maintained.
1589 This command builds reasonable starting coordinates for the new UNIT
1590 by assigning internal coordinates to the linkages between the component
1591 UNITs and building the Cartesian coordinates from these and the
1592 internal coordinates of the component UNITs.
1593
1594 set default variable value
1595 STRING _variable_
1596 STRING _value_
1597 OR
1598 set container parameter object
1599 UNIT/RESIDUE/ATOM/STRING _container_
1600 STRING _parameter_
1601 object _object/value_
1602
1603 This command sets the values of some global parameters (when the first
1604 argument is "default") or sets various parameters associated with _container_.
1605
1606 To see the possible variables for "set default", type "help set_default".
1607
1608 The box parameter of a UNIT defines the bounding box of the UNIT; this is
1609 not a UNIT's periodic box. The setBox and solvate family of commands add a
1610 periodic box to a UNIT; for a description, type, e.g., "help setBox".
1611
1612 The more useful parameters for each type of _container_ are the following:
1613 container parameters values
1614
1615 UNIT name STRING
1616 head, tail ATOM [e.g. unit.1.1]
1617 restype "protein" "nucleic" "saccharide" "solvent"
1618 "undefined" [sets all residues in UNIT]
1619 box LIST [side lengths: {A B C}]
1620 or NUMBER [cube side length] or "null"
1621 cap LIST [center, radius: {X Y Z R}]
1622 or "null"
1623
1624 RESIDUE name STRING
1625 [e.g. restype [see UNIT]
1626 unit.1] connect0, connect1 ATOM [e.g. unit.1.1]
1627 imagingAtom ATOM [e.g. unit.1.1]
1628
1629 ATOM name, pertName STRING [<= 4 chars]
1630 [e.g. type, pertType STRING [<= 2 chars]
1631 unit.1.1] element STRING
1632 pert "true" [or pert flag unset]
1633 charge, pertCharge DOUBLE
1634 position LIST [{X Y Z}]
1635
1636 Allowed arguments to "set default variable value" are these:
1637 variables values descriptions
1638
1639 PdbWriteCharges "on" add charges to each ATOM record
1640 "off" don't do this (default)
1641
1642 OldPrmtopFormat "on" use prmtop format from Amber6 and earlier
1643 "off" use the new prmtop format (default)
1644
1645 Gibbs "on" require perturbed atoms to be set explicitly
1646 (needed for gibbs)
1647 "off" set perturbed if Type != PertType (default)
1648 (OK for sander)
1649
1650 UseResIds "on" put cols 22-27 of the input pdb file into
1651 "off" a RESIDUE_ID table in prmtop files; default
1652 is "off"; only works with new prmtop formats,
1653 and when a single loadPdb command is used to
1654 create a unit.
1655
1656 Charmm "on" include terms for CHARMM22 force fields
1657 "off" don't include these (default)
1658
1659 DeleteExtraPointAngles
1660 "on" delete angles and torsions relating to
1661 extra points (default)
1662 "off" don't delete these (for older codes only)
1663
1664 FlexibleWater "on" allow for flexible 3-point water models
1665 "off" assume 3-point water models are rigid (default)
1666
1667 PBRadii "bondi" use Bondi radii for generalized Born
1668 "mbondi" use H-modified Bondi radii (default)
1669 "mbondi2" use H(N)-modified Bondi radii
1670 "mbondi3" ArgH and AspGluO modified Bondi2 radii
1671 "parse" Radii from the Sitkoff et al. parse parameters
1672 "pbamber" Huo and Kollman optimized radii (old!)
1673 "amber6" use radii that were the default in amber6
1674 (only recommended for backwards compat.)
1675
1676 Dielectric "distance" use distance-dependent dielectric (default)
1677 "constant" use constant dielectric
1678
1679 dipole_damp_factor real sets the default value for "DIPOLE_DAMP_FACTOR"
1680 for dipole screening factors in Thole models.
1681 Valid value > 0.0
1682
1683 sceescalefactor real sets the default value for "SCEE_SCALE_FACTOR"
1684 for 1-4 EEL scaling factors. Valid value > 0.0.
1685 Default=1.2.
1686
1687 scnbscalefactor real sets the default value for "SCNB_SCALE_FACTOR"
1688 for 1-4 NB scaling factors. Valid value > 0.0.
1689 Default=2.0.
1690
1691 CMAP "on" include CMAP corrections for dihedrals
1692 "off" don't include these (default)
1693
1694 PHIPSIMAP "on" include residue-based PHIPSI parameters
1695 "off" don't include these (default)
1696
1697 ipol integer Sets the default value for IPOL.
1698 Valid values are 0 - 4.
1699 Default value is 0, meaning disabled.
1700
1701 nocenter "on" coordinates will not be centered in the
1702 periodic simulation box
1703 "off" coordinates will be centered (default)
1704
1705 reorder_residues "on" solvent will be moved to the end (default)
1706 "off" residue order will be maintained as input.
1707 Beta feature: use at your own risk!
1708
1709 setBox solute enclosure [ buffer ]
1710 UNIT _solute_
1711 "vdw" OR "centers" _enclosure_
1712 object _buffer_
1713
1714 The setBox command creates a periodic box around the _solute_ UNIT, turning
1715 it into a periodic system for the simulation programs. It does not add
1716 any solvent to the system. The choice of "vdw" or "centers" determines
1717 whether the box encloses all entire atoms or just all atom centers -
1718 use "centers" if the system has been previously equilibrated as a
1719 periodic box. See the solvateBox command for a description of the
1720 buffer object, which extends either type of box by an arbitrary amount.
1721
1722 showDefault [ variable OR all OR * ]
1723 STRING _variable_
1724
1725 The showdefault command shows the values assigned to the variables by
1726 the "set default" command. Without variable, with "all", or with "*",
1727 all default variables are shown.
1728
1729 solvateBox solute solvent buffer [ "iso" ] [ closeness ]
1730
1731 UNIT _solute_
1732 UNIT _solvent_
1733 object _buffer_
1734 NUMBER _closeness_
1735
1736 The solvateBox command creates a solvent box around the _solute_ UNIT.
1737 The _solute_ UNIT is modified by the addition of _solvent_ RESIDUEs.
1738
1739 The user may want to first align long solutes that are not expected
1740 to tumble using alignAxes, in order to minimize box volume.
1741
1742 The normal choice for a TIP3 _solvent_ UNIT is WATBOX216. Note that
1743 constant pressure equilibration is required to bring the artificial box
1744 to reasonable density, since Van der Waals voids remain due to the
1745 impossibility of natural packing of solvent around the solute and at
1746 the edges of the box.
1747
1748 The solvent box UNIT is copied and repeated in all three spatial directions
1749 to create a box containing the entire solute and a buffer zone defined
1750 by the _buffer_ argument. The _buffer_ argument defines the distance,
1751 in angstroms, between the wall of the box and the closest ATOM in the
1752 solute.
1753
1754 If the buffer argument is a single NUMBER, then the buffer distance is
1755 the same for the x, y, and z directions, unless the "iso" option is used
1756 to make the box isometric, with the shortest box clearance = buffer. If
1757 "iso" is used, the solute is rotated to orient the principal axes,
1758 otherwise it is just centered on the origin.
1759
1760 If the buffer argument is a LIST of three NUMBERS, then the NUMBERs are
1761 applied to the x, y, and z axes respectively. As the larger box is created
1762 and superimposed on the solute, solvent molecules overlapping the solute
1763 are removed.
1764
1765 The optional _closeness_ parameter can be used to control the extent to
1766 which _solvent_ ATOMs overlap _solute_ ATOMs. The default value of
1767 the _closeness_ argument is 1.0, which allows no overlap. Smaller
1768 values allow solvent ATOMs to overlap _solute_ ATOMs by (1 - closeness) *
1769 R*ij, where R*ij is the sum of the Van der Waals radii of solute and
1770 solvent atoms. Values greater than 1 enforce a minimum gap between
1771 solvent and solute of (closeness - 1) * R*ij.
1772
1773 This command modifies the _solute_ UNIT in several ways. First, the
1774 coordinates of the ATOMs are modified to move the center of a box
1775 enclosing the Van der Waals radii of the atoms to the origin. Secondly,
1776 the UNIT is modified by the addition of _solvent_ RESIDUEs copied from
1777 the _solvent_ UNIT. Finally, the box parameter of the new system (still
1778 named for the _solute_) is modified to reflect the fact that a periodic,
1779 rectilinear solvent box has been created around it.
1780
1781 solvateCap solute solvent position radius [ closeness ]
1782
1783 UNIT _solute_
1784 UNIT _solvent_
1785 object _position_
1786 NUMBER _radius_
1787 NUMBER _closeness_
1788
1789 The solvateCap command creates a solvent cap around the _solute_ UNIT
1790 or a part thereof. The _solute_ UNIT is modified by the addition of
1791 _solvent_ RESIDUEs.
1792 The normal choice for a TIP3 _solvent_ UNIT is WATBOX216. The _solvent_
1793 box is repeated in all three spatial directions and _solvent_ RESIDUEs
1794 selected to create a solvent sphere with a radius of _radius_ Angstroms.
1795
1796 The _position_ argument defines where the center of the solvent cap
1797 is to be placed. If _position_ is a UNIT, RESIDUE, ATOM, or a LIST
1798 of UNITs, RESIDUEs, or ATOMs, then the geometric center of the ATOMs
1799 within the object will be used as the center of the solvent cap sphere.
1800 If _position_ is a LIST containing three NUMBERs then the _position_
1801 argument will be treated as a vector that defines the position of
1802 the solvent cap sphere center.
1803
1804 The optional _closeness_ parameter can be used to control the extent to
1805 which _solvent_ ATOMs overlap _solute_ ATOMs. The default value of
1806 the _closeness_ argument is 1.0, which allows no overlap. Smaller
1807 values allow solvent ATOMs to overlap _solute_ ATOMs by (1 - closeness) *
1808 R*ij, where R*ij is the sum of the Van der Waals radii of solute and
1809 solvent atoms. Values greater than 1 enforce a minimum gap between
1810 solvent and solute of (closeness - 1) * R*ij.
1811
1812 This command modifies the _solute_ UNIT in several ways. First,
1813 the UNIT is modified by the addition of _solvent_ RESIDUEs copied
1814 from the _solvent_ UNIT. Secondly, the cap parameter of the UNIT
1815 _solute_ is modified to reflect the fact that a solvent cap has been
1816 created around the solute.
1817
1818 solvateDontClip solute solvent buffer [ closeness ]
1819
1820 UNIT _solute_
1821 UNIT _solvent_
1822 object _buffer_
1823 NUMBER _closeness_
1824
1825 This command is identical to the solvateBox command except that the
1826 solvent box that is created is not clipped to the boundary of the
1827 _buffer_ region. This command forms larger solvent boxes than does
1828 solvateBox because it does not cause solvent that is outside the buffer
1829 region to be discarded. This helps to preserve the periodic structure
1830 of properly constructed solvent boxes, preventing hot-spots from
1831 forming.
1832
1833 solvateOct solute solvent buffer [ "iso" ] [ closeness ]
1834
1835 UNIT _solute_
1836 UNIT _solvent_
1837 object _buffer_
1838 NUMBER _closeness_
1839
1840 The solvateOct command is the same as solvateBox, except the corners
1841 of the box are sliced off, resulting in a truncated octahedron, which
1842 typically gives a more uniform distribution of solvent around the
1843 solute.
1844
1845 In solvateOct, when a LIST is given for the buffer argument, four
1846 numbers are given instead of three, where the fourth is the diagonal
1847 clearance. If 0.0 is given as the fourth number, the diagonal clearance
1848 resulting from the application of the x,y,z clearances is reported. If
1849 a non-0 value is given, this may require scaling up the other clearances,
1850 which is also reported. Similarly, if a single number is given, any
1851 scaleup of the x,y,z buffer to accommodate the diagonal clip is reported.
1852
1853 If the "iso" option is used, the isometric truncated octahedron is
1854 rotated to an orientation used by the PME code, and the box and angle
1855 dimensions output by the saveAmberParm* commands are adjusted for PME
1856 code imaging.
1857
1858 solvateShell solute solvent thickness [ closeness ]
1859
1860 UNIT _solute_
1861 UNIT _solvent_
1862 NUMBER _thickness_
1863 NUMBER _closeness_
1864
1865 The solvateShell command creates a solvent shell around the _solute_ UNIT.
1866 The _solute_ UNIT is modified by the addition of _solvent_ RESIDUEs.
1867
1868 The normal choice for a TIP3 _solvent_ UNIT is WATBOX216. The _solvent_ box
1869 is repeated in all three spatial directions and _solvent_ RESIDUEs selected
1870 to create a solvent shell with a radius of _thickness_ Angstroms around the
1871 _solute_.
1872
1873 The _thickness_ argument defines the maximum distance a _solvent_ ATOM may
1874 be from the closest _solute_ ATOM.
1875
1876 The optional _closeness_ parameter can be used to control overlap of _solvent_
1877 with _solute_ ATOMs. The default value of the _closeness_ argument is
1878 1.0, which allows contact but no overlap. Please see the solvateBox
1879 command for more details on the _closeness_ parameter.
1880
1881 source filename
1882 STRING _filename_
1883
1884 This command executes LEaP commands within a text file. To display the
1885 commands as they are read, see the verbosity command. The text within
1886 the source file must be formatted exactly like the text the user types
1887 into LEaP.
1888
1889 transform atoms matrix
1890
1891 CONTAINER/LIST _atoms_
1892 LIST _matrix_
1893
1894 Translate all of the ATOMs within _atoms_ by the (3X3) or (4X4) matrix
1895 defined by the 9 or 16 NUMBERs in the LIST of LISTs _matrix_.
1896 { { r11 r12 r13 -tx }
1897 { r21 r22 r23 -ty }
1898 { r31 r32 r33 -tz }
1899 { 0 0 0 1 } }
1900 The diagonal upper left elements, rII can be used for symmetry operations,
1901 e.g. a reflection in the XY plane can be produced with r11=1, r22=1, r33=-1
1902 where the other rIJ elements are 0. The -t column is used to specify
1903 translations along the appropriate axes (0 for no translation).
1904
1905 translate atoms direction
1906
1907 UNIT/RESIDUE/ATOM _atoms_
1908 LIST _direction_
1909
1910 Translate all of the ATOMs within _atoms_ by the vector defined by
1911 the three NUMBERs in the LIST _ direction_.
1912
1913 verbosity level
1914
1915 NUMBER _level_
1916
1917 This command sets the level of output that LEaP provides the user.
1918 A value of 0 is the default, providing the minimum of messages. A
1919 value of 1 will produce more output, and a value of 2 will produce
1920 all of the output of level 1 and display the text of the script lines
1921 executed with the source command.
1922
1923 zMatrix obj zmatrix
1924
1925 UNIT/RESIDUE/ATOM _obj_
1926 LIST _zmatrix_
1927
1928 The zMatrix command is quite complicated. It is used to define the
1929 external coordinates of ATOMs within _obj_ using internal coordinates.
1930 The second parameter of the zMatrix command is a LIST of LISTs; each
1931 sub-list has several arguments:
1932
1933 { a1 a2 bond12 }
1934
1935 This entry defines the coordinate of _a1_ by placing it _bond12_ angstroms
1936 along the x-axis from ATOM _a2_. If ATOM _a2_ does not have coordinates
1937 defined then ATOM _a2_ is placed at the origin.
1938
1939 { a1 a2 a3 bond12 angle123 }
1940
1941 This entry defines the coordinate of _a1_ by placing it _bond12_ angstroms
1942 away from ATOM _a2_ making an angle of _angle123_ degrees between
1943 _a1_, _a2_ and _a3_. The angle is measured in a right hand sense
1944 and in the x-y plane. ATOMs _a2_ and _a3_ must have coordinates defined.
1945
1946 { a1 a2 a3 a4 bond12 angle123 torsion1234 }
1947
1948 This entry defines the coordinate of _a1_ by placing it _bond12_ angstroms
1949 away from ATOM _a2_, creating an angle of _angle123_ degrees between
1950 _a1_, _a2_, and _a3_, and making a torsion angle of _torsion1234_ between
1951 _a1_, _a2_, _a3_, and _a4_.
1952
1953 { a1 a2 a3 a4 bond12 angle123 angle124 orientation }
1954
1955 This entry defines the coordinate of _a1_ by placing it _bond12_ angstroms
1956 away from ATOM _a2_, making angles _angle123_ between ATOMs _a1_,
1957 _a2_, and _a3_, and _angle124_ between ATOMs _a1_, _a2_, and _a4_. The
1958 argument _orientation_ defines whether the ATOM _a1_ is above or below
1959 a plane defined by the ATOMs _a2_, _a3_, and _a4_. If _orientation_
1960 is positive then _a1_ will be placed in such a way so that the inner
1961 product of (_a3_-_a2_) cross (_a4_-_a2_) with (_a1_-_a2_) is positive.
1962 Otherwise _a1_ will be placed on the other side of the plane. This
1963 allows the coordinates of a molecule like fluoro-chloro-bromo-methane
1964 to be defined without having to resort to dummy atoms.
1965 The first arguments within the zMatrix entries ( _a1_, _a2_, _a3_,
1966 _a4_ ) are either ATOMs or STRINGs containing names of ATOMs within
1967 _obj_. The subsequent arguments are all NUMBERs. Any ATOM can be
1968 placed at the _a1_ position, even those that have coordinates defined.
1969 This feature can be used to provide an endless supply of dummy atoms,
1970 if they are required. A predefined dummy atom with the name "*"
1971 (a single asterisk, no quotes) can also be used.
1972 No order is imposed in the sub-lists. The user can place sub-lists
1973 in arbitrary order, as long as they maintain the requirement that
1974 all atoms _a2_, _a3_, and _a4_ must have external coordinates defined,
1975 except for entries that define the coordinate of an ATOM using only
1976 a bond length.
1977
1978
1979 ]]> </help>
1980 <expand macro="citations" />
1981 </tool>