Mercurial > repos > deepakjadmin > mayatool3_test3
comparison mayachemtools/docs/modules/man3/Bond.3 @ 0:73ae111cf86f draft
Uploaded
author | deepakjadmin |
---|---|
date | Wed, 20 Jan 2016 11:55:01 -0500 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:73ae111cf86f |
---|---|
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22) | |
2 .\" | |
3 .\" Standard preamble: | |
4 .\" ======================================================================== | |
5 .de Sp \" Vertical space (when we can't use .PP) | |
6 .if t .sp .5v | |
7 .if n .sp | |
8 .. | |
9 .de Vb \" Begin verbatim text | |
10 .ft CW | |
11 .nf | |
12 .ne \\$1 | |
13 .. | |
14 .de Ve \" End verbatim text | |
15 .ft R | |
16 .fi | |
17 .. | |
18 .\" Set up some character translations and predefined strings. \*(-- will | |
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left | |
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will | |
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and | |
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, | |
23 .\" nothing in troff, for use with C<>. | |
24 .tr \(*W- | |
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' | |
26 .ie n \{\ | |
27 . ds -- \(*W- | |
28 . ds PI pi | |
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch | |
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch | |
31 . ds L" "" | |
32 . ds R" "" | |
33 . ds C` "" | |
34 . ds C' "" | |
35 'br\} | |
36 .el\{\ | |
37 . ds -- \|\(em\| | |
38 . ds PI \(*p | |
39 . ds L" `` | |
40 . ds R" '' | |
41 'br\} | |
42 .\" | |
43 .\" Escape single quotes in literal strings from groff's Unicode transform. | |
44 .ie \n(.g .ds Aq \(aq | |
45 .el .ds Aq ' | |
46 .\" | |
47 .\" If the F register is turned on, we'll generate index entries on stderr for | |
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index | |
49 .\" entries marked with X<> in POD. Of course, you'll have to process the | |
50 .\" output yourself in some meaningful fashion. | |
51 .ie \nF \{\ | |
52 . de IX | |
53 . tm Index:\\$1\t\\n%\t"\\$2" | |
54 .. | |
55 . nr % 0 | |
56 . rr F | |
57 .\} | |
58 .el \{\ | |
59 . de IX | |
60 .. | |
61 .\} | |
62 .\" | |
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). | |
64 .\" Fear. Run. Save yourself. No user-serviceable parts. | |
65 . \" fudge factors for nroff and troff | |
66 .if n \{\ | |
67 . ds #H 0 | |
68 . ds #V .8m | |
69 . ds #F .3m | |
70 . ds #[ \f1 | |
71 . ds #] \fP | |
72 .\} | |
73 .if t \{\ | |
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m) | |
75 . ds #V .6m | |
76 . ds #F 0 | |
77 . ds #[ \& | |
78 . ds #] \& | |
79 .\} | |
80 . \" simple accents for nroff and troff | |
81 .if n \{\ | |
82 . ds ' \& | |
83 . ds ` \& | |
84 . ds ^ \& | |
85 . ds , \& | |
86 . ds ~ ~ | |
87 . ds / | |
88 .\} | |
89 .if t \{\ | |
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" | |
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' | |
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' | |
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' | |
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' | |
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' | |
96 .\} | |
97 . \" troff and (daisy-wheel) nroff accents | |
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' | |
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H' | |
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] | |
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' | |
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' | |
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] | |
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] | |
105 .ds ae a\h'-(\w'a'u*4/10)'e | |
106 .ds Ae A\h'-(\w'A'u*4/10)'E | |
107 . \" corrections for vroff | |
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' | |
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' | |
110 . \" for low resolution devices (crt and lpr) | |
111 .if \n(.H>23 .if \n(.V>19 \ | |
112 \{\ | |
113 . ds : e | |
114 . ds 8 ss | |
115 . ds o a | |
116 . ds d- d\h'-1'\(ga | |
117 . ds D- D\h'-1'\(hy | |
118 . ds th \o'bp' | |
119 . ds Th \o'LP' | |
120 . ds ae ae | |
121 . ds Ae AE | |
122 .\} | |
123 .rm #[ #] #H #V #F C | |
124 .\" ======================================================================== | |
125 .\" | |
126 .IX Title "BOND 1" | |
127 .TH BOND 1 "2015-03-29" "perl v5.14.2" "MayaChemTools" | |
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes | |
129 .\" way too many mistakes in technical documents. | |
130 .if n .ad l | |
131 .nh | |
132 .SH "NAME" | |
133 Bond | |
134 .SH "SYNOPSIS" | |
135 .IX Header "SYNOPSIS" | |
136 use Bond; | |
137 .PP | |
138 use Bond qw(:all); | |
139 .SH "DESCRIPTION" | |
140 .IX Header "DESCRIPTION" | |
141 \&\fBBond\fR class provides the following methods: | |
142 .PP | |
143 new, Copy, DeleteBond, GetAtoms, GetBondBeginAtom, GetBondEndAtom, | |
144 GetBondFromAtom, GetBondToAtom, GetBondedAtom, GetCommonAtom, GetLargestRing, | |
145 GetNumOfRings, GetNumOfRingsWithEvenSize, GetNumOfRingsWithOddSize, | |
146 GetNumOfRingsWithSize, GetNumOfRingsWithSizeGreaterThan, | |
147 GetNumOfRingsWithSizeLessThan, GetRings, GetRingsWithEvenSize, | |
148 GetRingsWithOddSize, GetRingsWithSize, GetRingsWithSizeGreaterThan, | |
149 GetRingsWithSizeLessThan, GetSizeOfLargestRing, GetSizeOfSmallestRing, | |
150 GetSmallestRing, IsAromatic, IsBondStereochemistrySpecified, IsBondTypeSpecified, | |
151 IsCis, IsCisOrTrans, IsCoordinate, IsDative, IsDouble, IsDown, IsDownward, IsHash, | |
152 IsInRing, IsInRingOfSize, IsIonic, IsNotInRing, IsOnlyInOneRing, IsQuadruple, | |
153 IsQuintuple, IsSextuple, IsSingle, IsTautomeric, IsTrans, IsTriple, IsUp, | |
154 IsUpOrDown, IsUpward, IsWedge, IsWedgeOrHash, SetAtoms, SetBondOrder, | |
155 SetBondStereochemistry, SetBondType, StringifyBond, SwitchBondFromAndToAtoms | |
156 .PP | |
157 \&\fBBond\fR class is derived from \fBObjectProperty\fR base class which provides methods not explicitly | |
158 defined in \fBAtom\fR or \fBObjectProperty\fR class using Perl's \s-1AUTOLOAD\s0 functionality. These methods | |
159 are generated on-the-fly for a specified object property: | |
160 .PP | |
161 .Vb 3 | |
162 \& Set<PropertyName>(<PropertyValue>); | |
163 \& $PropertyValue = Get<PropertyName>(); | |
164 \& Delete<PropertyName>(); | |
165 .Ve | |
166 .SS "\s-1METHODS\s0" | |
167 .IX Subsection "METHODS" | |
168 .IP "\fBnew\fR" 4 | |
169 .IX Item "new" | |
170 .Vb 1 | |
171 \& $NewBond = new Bond([%PropertyNameAndValues]); | |
172 .Ve | |
173 .Sp | |
174 Using specified \fIBond\fR property names and values hash, \fBnew\fR method creates a new object | |
175 and returns a reference to newly created \fBBond\fR object. By default, following properties are | |
176 initialized: | |
177 .Sp | |
178 .Vb 4 | |
179 \& ID = SequentialObjectID | |
180 \& @Atoms = (); | |
181 \& BondType = "" | |
182 \& BondOrder = "" | |
183 .Ve | |
184 .Sp | |
185 Except for \fI\s-1ID\s0\fR property, all other default properties and other additional properties can | |
186 be set during invocation of this method. | |
187 .Sp | |
188 Examples: | |
189 .Sp | |
190 .Vb 3 | |
191 \& $Bond = new Bond(); | |
192 \& $DoubleBond = new Bond(\*(AqAtoms\*(Aq => [$Atom2, $Atom1], | |
193 \& \*(AqBondOrder\*(Aq => 2); | |
194 .Ve | |
195 .IP "\fBCopy\fR" 4 | |
196 .IX Item "Copy" | |
197 .Vb 1 | |
198 \& $BondCopy = $Bond\->Copy(); | |
199 .Ve | |
200 .Sp | |
201 Copy \fIBond\fR and its associated data using \fBStorable::dclone\fR and return a new | |
202 \&\fBBond\fR object. | |
203 .IP "\fBDeleteBond\fR" 4 | |
204 .IX Item "DeleteBond" | |
205 .Vb 1 | |
206 \& $Bond\->DeleteBond(); | |
207 .Ve | |
208 .Sp | |
209 Delete \fIBond\fR between atoms in from a molecule. | |
210 .IP "\fBGetAtoms\fR" 4 | |
211 .IX Item "GetAtoms" | |
212 .Vb 1 | |
213 \& @BondedAtoms = $Bond\->GetAtoms(); | |
214 .Ve | |
215 .Sp | |
216 Returns an array containing \fIAtoms\fR invoved in \fIBond\fR. | |
217 .IP "\fBGetBondedAtom\fR" 4 | |
218 .IX Item "GetBondedAtom" | |
219 .Vb 1 | |
220 \& $BondedAtom = $Bond\->GetBondedAtom($Atom); | |
221 .Ve | |
222 .Sp | |
223 Returns \fBBondedAtom\fR bonded to \fIAtom\fR in \fIBond\fR. | |
224 .IP "\fBGetBondBeginAtom\fR" 4 | |
225 .IX Item "GetBondBeginAtom" | |
226 .Vb 1 | |
227 \& $BeginAtom = $Bond\->GetBondBeginAtom(); | |
228 .Ve | |
229 .Sp | |
230 Returns \fBBeginAtom\fR corresponding to bond starting atom in \fIBond\fR. | |
231 .IP "\fBGetBondEndAtom\fR" 4 | |
232 .IX Item "GetBondEndAtom" | |
233 .Vb 1 | |
234 \& $EndAtom = $Bond\->GetBondEndAtom(); | |
235 .Ve | |
236 .Sp | |
237 Returns \fBEndAtom\fR corresponding to bond ending atom in \fIBond\fR. | |
238 .IP "\fBGetBondFromAtom\fR" 4 | |
239 .IX Item "GetBondFromAtom" | |
240 .Vb 1 | |
241 \& $FromAtom = $Bond\->GetBondFromAtom(); | |
242 .Ve | |
243 .Sp | |
244 Returns \fBFromAtom\fR corresponding to bond starting atom in \fIBond\fR. | |
245 .IP "\fBGetBondToAtom\fR" 4 | |
246 .IX Item "GetBondToAtom" | |
247 .Vb 1 | |
248 \& $ToAotm = $Bond\->GetBondToAtom(); | |
249 .Ve | |
250 .Sp | |
251 Returns \fBToAtom\fR corresponding to bond ending atom in \fIBond\fR. | |
252 .IP "\fBGetCommonAtom\fR" 4 | |
253 .IX Item "GetCommonAtom" | |
254 .Vb 1 | |
255 \& $CommonAtom = $Bond\->GetCommonAtom($OtherBond); | |
256 .Ve | |
257 .Sp | |
258 Returns \fBAtom\fR common to both \fIBond\fR and \fI\f(CI$OtherBond\fI\fR. | |
259 .IP "\fBGetLargestRing\fR" 4 | |
260 .IX Item "GetLargestRing" | |
261 .Vb 1 | |
262 \& @RingAtoms = $Bond\->GetLargestRing(); | |
263 .Ve | |
264 .Sp | |
265 Returns an array of ring \fIAtoms\fR corresponding to the largest ring containing \fIBond\fR. | |
266 in a molecule | |
267 .IP "\fBGetNumOfRings\fR" 4 | |
268 .IX Item "GetNumOfRings" | |
269 .Vb 1 | |
270 \& $NumOfRings = $Bond\->GetNumOfRings(); | |
271 .Ve | |
272 .Sp | |
273 Returns number of rings containing \fIBond\fR in a molecule. | |
274 .IP "\fBGetNumOfRingsWithEvenSize\fR" 4 | |
275 .IX Item "GetNumOfRingsWithEvenSize" | |
276 .Vb 1 | |
277 \& $NumOfRings = $Bond\->GetNumOfRingsWithEvenSize(); | |
278 .Ve | |
279 .Sp | |
280 Returns number of rings with even size containing \fIBond\fR in a molecule. | |
281 .IP "\fBGetNumOfRingsWithOddSize\fR" 4 | |
282 .IX Item "GetNumOfRingsWithOddSize" | |
283 .Vb 1 | |
284 \& $NumOfRings = $Bond\->GetNumOfRingsWithOddSize(); | |
285 .Ve | |
286 .Sp | |
287 Returns number of rings with odd size containing \fIBond\fR in a molecule. | |
288 .IP "\fBGetNumOfRingsWithSize\fR" 4 | |
289 .IX Item "GetNumOfRingsWithSize" | |
290 .Vb 1 | |
291 \& $NumOfRings = $Bond\->GetNumOfRingsWithSize($RingSize); | |
292 .Ve | |
293 .Sp | |
294 Returns number of rings with specific \fIRingSize\fR containing \fIBond\fR in a molecule. | |
295 .IP "\fBGetNumOfRingsWithSizeGreaterThan\fR" 4 | |
296 .IX Item "GetNumOfRingsWithSizeGreaterThan" | |
297 .Vb 1 | |
298 \& $NumOfRings = $Bond\->GetNumOfRingsWithSizeGreaterThan($RingSize); | |
299 .Ve | |
300 .Sp | |
301 Returns number of rings with size greater than specific \fIRingSize\fR containing | |
302 \&\fIBond\fR in a molecule. | |
303 .IP "\fBGetNumOfRingsWithSizeLessThan\fR" 4 | |
304 .IX Item "GetNumOfRingsWithSizeLessThan" | |
305 .Vb 1 | |
306 \& $NumOfRings = $Bond\->GetNumOfRingsWithSizeLessThan($RingSize); | |
307 .Ve | |
308 .Sp | |
309 Returns number of rings with size less than specific \fIRingSize\fR containing \fIBond\fR | |
310 in a molecule. | |
311 .IP "\fBGetRings\fR" 4 | |
312 .IX Item "GetRings" | |
313 .Vb 1 | |
314 \& @Rings = $Bond\->GetRings(); | |
315 .Ve | |
316 .Sp | |
317 Returns an array of references to arrays containing ring atoms corressponding | |
318 to all rings containing \fIBond\fR in a molecule. | |
319 .IP "\fBGetRingsWithEvenSize\fR" 4 | |
320 .IX Item "GetRingsWithEvenSize" | |
321 .Vb 1 | |
322 \& @Rings = $Bond\->GetRingsWithEvenSize(); | |
323 .Ve | |
324 .Sp | |
325 Returns an array of references to arrays containing ring atoms corressponding to all rings with even size | |
326 containing \fIBond\fR in a molecule. | |
327 .IP "\fBGetRingsWithOddSize\fR" 4 | |
328 .IX Item "GetRingsWithOddSize" | |
329 .Vb 1 | |
330 \& @Rings = $Bond\->GetRingsWithOddSize(); | |
331 .Ve | |
332 .Sp | |
333 Returns an array of references to arrays containing ring atoms corressponding to all rings with odd size | |
334 containing \fIBond\fR in a molecule. | |
335 .IP "\fBGetRingsWithSize\fR" 4 | |
336 .IX Item "GetRingsWithSize" | |
337 .Vb 1 | |
338 \& @Rings = $Bond\->GetRingsWithSize($RingSize); | |
339 .Ve | |
340 .Sp | |
341 Returns an array of references to arrays containing ring atoms corressponding to all rings with specific | |
342 \&\fIRingSize \fRcontaining \fIBond\fR in a molecule. | |
343 .IP "\fBGetRingsWithSizeGreaterThan\fR" 4 | |
344 .IX Item "GetRingsWithSizeGreaterThan" | |
345 .Vb 1 | |
346 \& @Rings = $Bond\->GetRingsWithSizeGreaterThan($RingSize); | |
347 .Ve | |
348 .Sp | |
349 Returns an array of references to arrays containing ring atoms corressponding to all rings with size | |
350 greater than specific \fIRingSize \fRcontaining \fIBond\fR in a molecule. | |
351 .IP "\fBGetRingsWithSizeLessThan\fR" 4 | |
352 .IX Item "GetRingsWithSizeLessThan" | |
353 .Vb 1 | |
354 \& @Rings = $Bond\->GetRingsWithSizeLessThan($RingSize); | |
355 .Ve | |
356 .Sp | |
357 Returns an array of references to arrays containing ring atoms corressponding to all rings with size | |
358 less than specific \fIRingSize \fRcontaining \fIBond\fR in a molecule. | |
359 .IP "\fBGetSizeOfLargestRing\fR" 4 | |
360 .IX Item "GetSizeOfLargestRing" | |
361 .Vb 1 | |
362 \& $Size = $Bond\->GetSizeOfLargestRing(); | |
363 .Ve | |
364 .Sp | |
365 Returns size of the largest ring containing \fIBond\fR in a molecule. | |
366 .IP "\fBGetSizeOfSmallestRing\fR" 4 | |
367 .IX Item "GetSizeOfSmallestRing" | |
368 .Vb 1 | |
369 \& $Size = $Bond\->GetSizeOfSmallestRing(); | |
370 .Ve | |
371 .Sp | |
372 Returns size of the smallest ring containing \fIBond\fR in a molecule. | |
373 .IP "\fBGetSmallestRing\fR" 4 | |
374 .IX Item "GetSmallestRing" | |
375 .Vb 1 | |
376 \& @RingAtoms = $Bond\->GetSmallestRing(); | |
377 .Ve | |
378 .Sp | |
379 Returns an array of ring \fIAtoms\fR corresponding to the largest ring containing \fIBond\fR | |
380 in a molecule. | |
381 .IP "\fBIsAromatic\fR" 4 | |
382 .IX Item "IsAromatic" | |
383 .Vb 1 | |
384 \& $Status = $Bond\->IsAromatic(); | |
385 .Ve | |
386 .Sp | |
387 Returns 1 or 0 based on whether it's an aromatic \fIBond\fR. | |
388 .IP "\fBIsBondStereochemistrySpecified\fR" 4 | |
389 .IX Item "IsBondStereochemistrySpecified" | |
390 .Vb 1 | |
391 \& $Status = $Bond\->IsBondStereochemistrySpecified(); | |
392 .Ve | |
393 .Sp | |
394 Returns 1 or 0 based on whether \fIBond\fR's sterochemistry is specified. | |
395 .IP "\fBIsBondTypeSpecified\fR" 4 | |
396 .IX Item "IsBondTypeSpecified" | |
397 .Vb 1 | |
398 \& $Status = $Bond\->IsBondTypeSpecified(); | |
399 .Ve | |
400 .Sp | |
401 Returns 1 or 0 based on whether \fIBond\fR's type is specified. | |
402 .IP "\fBIsCis\fR" 4 | |
403 .IX Item "IsCis" | |
404 .Vb 1 | |
405 \& $Status = $Bond\->IsCis(); | |
406 .Ve | |
407 .Sp | |
408 Returns 1 or 0 based on whether it's a cis \fIBond\fR. | |
409 .IP "\fBIsCisOrTrans\fR" 4 | |
410 .IX Item "IsCisOrTrans" | |
411 .Vb 1 | |
412 \& $Status = $Bond\->IsCisOrTrans(); | |
413 .Ve | |
414 .Sp | |
415 Returns 1 or 0 based on whether it's a cis or trans \fIBond\fR. | |
416 .IP "\fBIsCoordinate\fR" 4 | |
417 .IX Item "IsCoordinate" | |
418 .Vb 1 | |
419 \& $Status = $Bond\->IsCoordinate(); | |
420 .Ve | |
421 .Sp | |
422 Returns 1 or 0 based on whether it's a coordinate or dative \fIBond\fR. | |
423 .IP "\fBIsDative\fR" 4 | |
424 .IX Item "IsDative" | |
425 .Vb 1 | |
426 \& $Status = $Bond\->IsDative(); | |
427 .Ve | |
428 .Sp | |
429 Returns 1 or 0 based on whether it's a coordinate or dative \fIBond\fR. | |
430 .IP "\fBIsDouble\fR" 4 | |
431 .IX Item "IsDouble" | |
432 .Vb 1 | |
433 \& $Status =$Bond\->IsDouble(); | |
434 .Ve | |
435 .Sp | |
436 Returns 1 or 0 based on whether it's a double \fIBond\fR. | |
437 .IP "\fBIsDown\fR" 4 | |
438 .IX Item "IsDown" | |
439 .Vb 1 | |
440 \& $Status = $Bond\->IsDown(); | |
441 .Ve | |
442 .Sp | |
443 Returns 1 or 0 based on whether it's a hash or down single \fIBond\fR. | |
444 .IP "\fBIsDownward\fR" 4 | |
445 .IX Item "IsDownward" | |
446 .Vb 1 | |
447 \& $Return = $Bond\->IsDownward(); | |
448 .Ve | |
449 .Sp | |
450 Returns 1 or 0 based on whether it's a downward \fIBond\fR. | |
451 .IP "\fBIsHash\fR" 4 | |
452 .IX Item "IsHash" | |
453 .Vb 1 | |
454 \& $Status = $Bond\->IsHash(); | |
455 .Ve | |
456 .Sp | |
457 Returns 1 or 0 based on whether it's a hash or down single \fIBond\fR. | |
458 .IP "\fBIsInRing\fR" 4 | |
459 .IX Item "IsInRing" | |
460 .Vb 1 | |
461 \& $Status = $Bond\->IsInRing(); | |
462 .Ve | |
463 .Sp | |
464 Returns 1 or 0 based on whether \fIBond\fR is present in a ring. | |
465 .IP "\fBIsInRingOfSize\fR" 4 | |
466 .IX Item "IsInRingOfSize" | |
467 .Vb 1 | |
468 \& $Status = $Bond\->IsInRingOfSize($Size); | |
469 .Ve | |
470 .Sp | |
471 Returns 1 or 0 based on whether \fIBond\fR is present in a ring of specific \fISize\fR. | |
472 .IP "\fBIsIonic\fR" 4 | |
473 .IX Item "IsIonic" | |
474 .Vb 1 | |
475 \& $Status = $Bond\->IsIonic(); | |
476 .Ve | |
477 .Sp | |
478 Returns 1 or 0 based on whether it's an ionic \fIBond\fR. | |
479 .IP "\fBIsNotInRing\fR" 4 | |
480 .IX Item "IsNotInRing" | |
481 .Vb 1 | |
482 \& $Status = $Bond\->IsNotInRing(); | |
483 .Ve | |
484 .Sp | |
485 Returns 1 or 0 based on whether \fIBond\fR is not present in a ring. | |
486 .IP "\fBIsOnlyInOneRing\fR" 4 | |
487 .IX Item "IsOnlyInOneRing" | |
488 .Vb 1 | |
489 \& $Status = $Bond\->IsOnlyInOneRing(); | |
490 .Ve | |
491 .Sp | |
492 Returns 1 or 0 based on whether \fIBond\fR is only present in one ring. | |
493 .IP "\fBIsQuadruple\fR" 4 | |
494 .IX Item "IsQuadruple" | |
495 .Vb 1 | |
496 \& $Status = $Bond\->IsQuadruple(); | |
497 .Ve | |
498 .Sp | |
499 Returns 1 or 0 based on whether it's a quadruple \fIBond\fR. | |
500 .IP "\fBIsQuintuple\fR" 4 | |
501 .IX Item "IsQuintuple" | |
502 .Vb 1 | |
503 \& $Status = $Bond\->IsQuintuple(); | |
504 .Ve | |
505 .Sp | |
506 Returns 1 or 0 based on whether it's a quintuple \fIBond\fR. | |
507 .IP "\fBIsSextuple\fR" 4 | |
508 .IX Item "IsSextuple" | |
509 .Vb 1 | |
510 \& $Status = $Bond\->IsSextuple(); | |
511 .Ve | |
512 .Sp | |
513 Returns 1 or 0 based on whether it's a sextuple \fIBond\fR. | |
514 .IP "\fBIsSingle\fR" 4 | |
515 .IX Item "IsSingle" | |
516 .Vb 1 | |
517 \& $Status =$Bond\->IsSingle(); | |
518 .Ve | |
519 .Sp | |
520 Returns 1 or 0 based on whether it's a single \fIBond\fR. | |
521 .IP "\fBIsTriple\fR" 4 | |
522 .IX Item "IsTriple" | |
523 .Vb 1 | |
524 \& $Status =$Bond\->IsTriple(); | |
525 .Ve | |
526 .Sp | |
527 Returns 1 or 0 based on whether it's a triple \fIBond\fR. | |
528 .IP "\fBIsTautomeric\fR" 4 | |
529 .IX Item "IsTautomeric" | |
530 .Vb 1 | |
531 \& $Status = $Bond\->IsTautomeric(); | |
532 .Ve | |
533 .Sp | |
534 Returns 1 or 0 based on whether it's a \fIBond\fR. | |
535 .IP "\fBIsTrans\fR" 4 | |
536 .IX Item "IsTrans" | |
537 .Vb 1 | |
538 \& $Status = $Bond\->IsTrans(); | |
539 .Ve | |
540 .Sp | |
541 Returns 1 or 0 based on whether it's a trans \fIBond\fR. | |
542 .IP "\fBIsUp\fR" 4 | |
543 .IX Item "IsUp" | |
544 .Vb 1 | |
545 \& $Status = $Bond\->IsUp(); | |
546 .Ve | |
547 .Sp | |
548 Returns 1 or 0 based on whether it's a up \fIBond\fR. | |
549 .IP "\fBIsUpOrDown\fR" 4 | |
550 .IX Item "IsUpOrDown" | |
551 .Vb 1 | |
552 \& $Status = $Bond\->IsUpOrDown(); | |
553 .Ve | |
554 .Sp | |
555 Returns 1 or 0 based on whether it's an up or down \fIBond\fR. | |
556 .IP "\fBIsUpward\fR" 4 | |
557 .IX Item "IsUpward" | |
558 .Vb 1 | |
559 \& $Status = $Bond\->IsUpward(); | |
560 .Ve | |
561 .Sp | |
562 Returns 1 or 0 based on whether it's an upward \fIBond\fR. | |
563 .IP "\fBIsWedge\fR" 4 | |
564 .IX Item "IsWedge" | |
565 .Vb 1 | |
566 \& $Status = $Bond\->IsWedge(); | |
567 .Ve | |
568 .Sp | |
569 Returns 1 or 0 based on whether it's a wedge \fIBond\fR. | |
570 .IP "\fBIsWedgeOrHash\fR" 4 | |
571 .IX Item "IsWedgeOrHash" | |
572 .Vb 1 | |
573 \& $Status = $Bond\->IsWedgeOrHash(); | |
574 .Ve | |
575 .Sp | |
576 Returns 1 or 0 based on whether it's a wedge or hash \fIBond\fR. | |
577 .IP "\fBSetAtoms\fR" 4 | |
578 .IX Item "SetAtoms" | |
579 .Vb 2 | |
580 \& $Bond\->SetAtoms($AtomsRef); | |
581 \& $Bond\->SetAtoms(@Atoms); | |
582 .Ve | |
583 .Sp | |
584 Set atoms of \fIBond\fR to atoms in \fIAtoms\fR array or in a reference to an array of atoms | |
585 and return \fIBond\fR. | |
586 .IP "\fBSetBondOrder\fR" 4 | |
587 .IX Item "SetBondOrder" | |
588 .Vb 1 | |
589 \& $Bond\->SetBondOrder($BondOrder); | |
590 .Ve | |
591 .Sp | |
592 Sets bond order of \fIBond\fR to specified \fIBondOrder\fR and returns \fIBond\fR. Possible bond order | |
593 values: 1 = Single, 1.5 = Aromatic, 2 = Double, 3 = Triple, 4 = Quadruple, 5 = Quintuple, | |
594 6 = Sextuple, 7 = Septuple | |
595 .Sp | |
596 Notes: | |
597 .Sp | |
598 .Vb 8 | |
599 \& . BondType property is automatically assigned using default BondType | |
600 \& values for specified BondOrder. | |
601 \& . BondType values can also be explicit set. | |
602 \& . To make bonds aromatic in a ring, explicitly set "Aromatic" | |
603 \& property for bond/atoms and make sure appropriate BondOrder | |
604 \& values are assigned. | |
605 \& . Dative or coordinate bond types are treated as single bond types with | |
606 \& explicit formal charge of + and \- on first and second bond atoms. | |
607 .Ve | |
608 .IP "\fBSetBondType\fR" 4 | |
609 .IX Item "SetBondType" | |
610 .Vb 1 | |
611 \& $Bond\->SetBondType($BondType); | |
612 .Ve | |
613 .Sp | |
614 Sets bond type for \fIBond\fR to specified \fIBondType\fR and returns \fIBond\fR. Possible bond type | |
615 values for different bond orders are: | |
616 .Sp | |
617 .Vb 9 | |
618 \& 0: None, Ionic, Unspecified | |
619 \& 1 : Single, Dative, Coordinate, SingleOrDouble, SingleOrAromatic, Tautomeric | |
620 \& 2 : Double, SingleOrDouble, DoubleOrAromatic, Tautomeric | |
621 \& 3 : Triple | |
622 \& 4 : Quadruple | |
623 \& 5 : Quintuple | |
624 \& 6 : Sextuple | |
625 \& 7 : Septuple | |
626 \& 1.5 : Aromatic, Resonance, SingleOrAromatic, DoubleOrAromatic | |
627 .Ve | |
628 .Sp | |
629 Notes: | |
630 .Sp | |
631 .Vb 3 | |
632 \& o BondType Any is valid for all BondOrders. | |
633 \& o BondOrder property is automatically assigned using default BondOrder | |
634 \& values for specified BondType. | |
635 .Ve | |
636 .Sp | |
637 Possible bond stereochemistry values for different bond orders are: | |
638 .Sp | |
639 .Vb 4 | |
640 \& 0 : None, Unspecified | |
641 \& 1 : Wedge, Up, Hash, Down, Wavy, WedgeOrHash, UpOrDown, Upward, Downward, | |
642 \& None, Unspecified | |
643 \& 2 : Cis, Trans, Z, E, DoubleCross, CisOrTrans, None, Unspecified | |
644 .Ve | |
645 .IP "\fBSetBondStereochemistry\fR" 4 | |
646 .IX Item "SetBondStereochemistry" | |
647 .Vb 1 | |
648 \& $Bond = $Bond\->SetBondStereochemistry($BondStereochemistry); | |
649 .Ve | |
650 .Sp | |
651 Sets bond stereochemistry of \fIBond\fR to specified \fIBondStereochemistry\fR and | |
652 returns \fIBond\fR. Possible \fIBondStereoChemistry\fR values for different bond orders | |
653 are: | |
654 .Sp | |
655 BondOrder: 1 | |
656 .Sp | |
657 .Vb 1 | |
658 \& None, Unspecified: Not a stereo bond or unspecified | |
659 \& | |
660 \& Wedge, Up : Wedge end pointing up | |
661 \& Hash, Down: Wedge end pointing down | |
662 \& Wavy, WedgeOrHash, UpOrDown: Wedge end up or down | |
663 \& | |
664 \& Upward: Single bond around cis/trans double bonds pointing upward | |
665 \& Downward: Single bond around cis/trans double bonds pointing upward | |
666 .Ve | |
667 .Sp | |
668 Notes: | |
669 .Sp | |
670 .Vb 3 | |
671 \& o Wedge starts at begin atom of a bond making wedge pointed end always | |
672 \& at this atom. | |
673 \& o Upward/downward bonds start at atoms involved in cis/trans double bonds. | |
674 .Ve | |
675 .Sp | |
676 BondOrder: 2 | |
677 .Sp | |
678 .Vb 1 | |
679 \& None, Unspecified: Not a stereo bond or unspecified | |
680 \& | |
681 \& Z, cis: Similar groups on same side of double bond | |
682 \& E, trans: Similar groups on different side of double bond | |
683 \& | |
684 \& CisOrTrans, DoubleCross: cis or trans | |
685 .Ve | |
686 .IP "\fBStringifyBond\fR" 4 | |
687 .IX Item "StringifyBond" | |
688 .Vb 1 | |
689 \& $BondString = $Bond\->StringifyBond(); | |
690 .Ve | |
691 .Sp | |
692 Returns a string containing information about \fIbond\fR object. | |
693 .IP "\fBSwitchBondFromAndToAtoms\fR" 4 | |
694 .IX Item "SwitchBondFromAndToAtoms" | |
695 .Vb 1 | |
696 \& $Bond = $Bond\->SwitchBondFromAndToAtoms(); | |
697 .Ve | |
698 .Sp | |
699 Swaps bond from and to atoms in \fIBond\fR and returns \fIBond\fR. | |
700 .SH "AUTHOR" | |
701 .IX Header "AUTHOR" | |
702 Manish Sud <msud@san.rr.com> | |
703 .SH "SEE ALSO" | |
704 .IX Header "SEE ALSO" | |
705 Atom.pm, Molecule.pm | |
706 .SH "COPYRIGHT" | |
707 .IX Header "COPYRIGHT" | |
708 Copyright (C) 2015 Manish Sud. All rights reserved. | |
709 .PP | |
710 This file is part of MayaChemTools. | |
711 .PP | |
712 MayaChemTools is free software; you can redistribute it and/or modify it under | |
713 the terms of the \s-1GNU\s0 Lesser General Public License as published by the Free | |
714 Software Foundation; either version 3 of the License, or (at your option) | |
715 any later version. |