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.