| 1 | 1 <html> | 
|  | 2 <head> | 
|  | 3 <title>MayaChemTools:Documentation:Bond.pm</title> | 
|  | 4 <meta http-equiv="content-type" content="text/html;charset=utf-8"> | 
|  | 5 <link rel="stylesheet" type="text/css" href="../../css/MayaChemTools.css"> | 
|  | 6 </head> | 
|  | 7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10"> | 
|  | 8 <br/> | 
|  | 9 <center> | 
|  | 10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a> | 
|  | 11 </center> | 
|  | 12 <br/> | 
|  | 13 <div class="DocNav"> | 
|  | 14 <table width="100%" border=0 cellpadding=0 cellspacing=2> | 
|  | 15 <tr align="left" valign="top"><td width="33%" align="left"><a href="./BitVector.html" title="BitVector.html">Previous</a>  <a href="./index.html" title="Table of Contents">TOC</a>  <a href="./Constants.html" title="Constants.html">Next</a></td><td width="34%" align="middle"><strong>Bond.pm</strong></td><td width="33%" align="right"><a href="././code/Bond.html" title="View source code">Code</a> | <a href="./../pdf/Bond.pdf" title="PDF US Letter Size">PDF</a> | <a href="./../pdfgreen/Bond.pdf" title="PDF US Letter Size with narrow margins: www.changethemargins.com">PDFGreen</a> | <a href="./../pdfa4/Bond.pdf" title="PDF A4 Size">PDFA4</a> | <a href="./../pdfa4green/Bond.pdf" title="PDF A4 Size with narrow margins: www.changethemargins.com">PDFA4Green</a></td></tr> | 
|  | 16 </table> | 
|  | 17 </div> | 
|  | 18 <p> | 
|  | 19 </p> | 
|  | 20 <h2>NAME</h2> | 
|  | 21 <p>Bond</p> | 
|  | 22 <p> | 
|  | 23 </p> | 
|  | 24 <h2>SYNOPSIS</h2> | 
|  | 25 <p>use Bond;</p> | 
|  | 26 <p>use Bond qw(:all);</p> | 
|  | 27 <p> | 
|  | 28 </p> | 
|  | 29 <h2>DESCRIPTION</h2> | 
|  | 30 <p><strong>Bond</strong> class provides the following methods:</p> | 
|  | 31 <p> <a href="#new">new</a>, <a href="#copy">Copy</a>, <a href="#deletebond">DeleteBond</a>, <a href="#getatoms">GetAtoms</a>, <a href="#getbondbeginatom">GetBondBeginAtom</a>, <a href="#getbondendatom">GetBondEndAtom</a> | 
|  | 32 , <a href="#getbondfromatom">GetBondFromAtom</a>, <a href="#getbondtoatom">GetBondToAtom</a>, <a href="#getbondedatom">GetBondedAtom</a>, <a href="#getcommonatom">GetCommonAtom</a>, <a href="#getlargestring">GetLargestRing</a> | 
|  | 33 , <a href="#getnumofrings">GetNumOfRings</a>, <a href="#getnumofringswithevensize">GetNumOfRingsWithEvenSize</a>, <a href="#getnumofringswithoddsize">GetNumOfRingsWithOddSize</a> | 
|  | 34 , <a href="#getnumofringswithsize">GetNumOfRingsWithSize</a>, <a href="#getnumofringswithsizegreaterthan">GetNumOfRingsWithSizeGreaterThan</a> | 
|  | 35 , <a href="#getnumofringswithsizelessthan">GetNumOfRingsWithSizeLessThan</a>, <a href="#getrings">GetRings</a>, <a href="#getringswithevensize">GetRingsWithEvenSize</a> | 
|  | 36 , <a href="#getringswithoddsize">GetRingsWithOddSize</a>, <a href="#getringswithsize">GetRingsWithSize</a>, <a href="#getringswithsizegreaterthan">GetRingsWithSizeGreaterThan</a> | 
|  | 37 , <a href="#getringswithsizelessthan">GetRingsWithSizeLessThan</a>, <a href="#getsizeoflargestring">GetSizeOfLargestRing</a>, <a href="#getsizeofsmallestring">GetSizeOfSmallestRing</a> | 
|  | 38 , <a href="#getsmallestring">GetSmallestRing</a>, <a href="#isaromatic">IsAromatic</a>, <a href="#isbondstereochemistryspecified">IsBondStereochemistrySpecified</a>, <a href="#isbondtypespecified">IsBondTypeSpecified</a> | 
|  | 39 , <a href="#iscis">IsCis</a>, <a href="#iscisortrans">IsCisOrTrans</a>, <a href="#iscoordinate">IsCoordinate</a>, <a href="#isdative">IsDative</a>, <a href="#isdouble">IsDouble</a>, <a href="#isdown">IsDown</a>, <a href="#isdownward">IsDownward</a>, <a href="#ishash">IsHash</a> | 
|  | 40 , <a href="#isinring">IsInRing</a>, <a href="#isinringofsize">IsInRingOfSize</a>, <a href="#isionic">IsIonic</a>, <a href="#isnotinring">IsNotInRing</a>, <a href="#isonlyinonering">IsOnlyInOneRing</a>, <a href="#isquadruple">IsQuadruple</a> | 
|  | 41 , <a href="#isquintuple">IsQuintuple</a>, <a href="#issextuple">IsSextuple</a>, <a href="#issingle">IsSingle</a>, <a href="#istautomeric">IsTautomeric</a>, <a href="#istrans">IsTrans</a>, <a href="#istriple">IsTriple</a>, <a href="#isup">IsUp</a> | 
|  | 42 , <a href="#isupordown">IsUpOrDown</a>, <a href="#isupward">IsUpward</a>, <a href="#iswedge">IsWedge</a>, <a href="#iswedgeorhash">IsWedgeOrHash</a>, <a href="#setatoms">SetAtoms</a>, <a href="#setbondorder">SetBondOrder</a> | 
|  | 43 , <a href="#setbondstereochemistry">SetBondStereochemistry</a>, <a href="#setbondtype">SetBondType</a>, <a href="#stringifybond">StringifyBond</a>, <a href="#switchbondfromandtoatoms">SwitchBondFromAndToAtoms</a> | 
|  | 44 </p><p><strong>Bond</strong> class is derived from <strong>ObjectProperty</strong> base class which provides methods not explicitly | 
|  | 45 defined in <strong>Atom</strong> or <strong>ObjectProperty</strong> class using Perl's AUTOLOAD functionality. These methods | 
|  | 46 are generated on-the-fly for a specified object property:</p> | 
|  | 47 <div class="OptionsBox"> | 
|  | 48     Set<PropertyName>(<PropertyValue>); | 
|  | 49 <br/>    $PropertyValue = Get<PropertyName>(); | 
|  | 50 <br/>    Delete<PropertyName>();</div> | 
|  | 51 <p> | 
|  | 52 </p> | 
|  | 53 <h2>METHODS</h2> | 
|  | 54 <dl> | 
|  | 55 <dt><strong><a name="new" class="item"><strong>new</strong></a></strong></dt> | 
|  | 56 <dd> | 
|  | 57 <div class="OptionsBox"> | 
|  | 58     $NewBond = new Bond([%PropertyNameAndValues]);</div> | 
|  | 59 <p>Using specified <em>Bond</em> property names and values hash, <strong>new</strong> method creates a new object | 
|  | 60 and returns a reference to newly created <strong>Bond</strong> object. By default, following properties are | 
|  | 61 initialized:</p> | 
|  | 62 <div class="OptionsBox"> | 
|  | 63     ID = SequentialObjectID | 
|  | 64 <br/>    @Atoms = (); | 
|  | 65 <br/>    BondType = "" | 
|  | 66 <br/>    BondOrder = ""</div> | 
|  | 67 <p>Except for <em>ID</em> property, all other default properties and other additional properties can | 
|  | 68 be set during invocation of this method.</p> | 
|  | 69 <p>Examples:</p> | 
|  | 70 <div class="OptionsBox"> | 
|  | 71     $Bond = new Bond(); | 
|  | 72 <br/>    $DoubleBond = new Bond('Atoms' => [$Atom2, $Atom1], | 
|  | 73                            'BondOrder' => 2);</div> | 
|  | 74 </dd> | 
|  | 75 <dt><strong><a name="copy" class="item"><strong>Copy</strong></a></strong></dt> | 
|  | 76 <dd> | 
|  | 77 <div class="OptionsBox"> | 
|  | 78     $BondCopy = $Bond->Copy();</div> | 
|  | 79 <p>Copy <em>Bond</em> and its associated data using <strong>Storable::dclone</strong> and return a new | 
|  | 80 <strong>Bond</strong> object.</p> | 
|  | 81 </dd> | 
|  | 82 <dt><strong><a name="deletebond" class="item"><strong>DeleteBond</strong></a></strong></dt> | 
|  | 83 <dd> | 
|  | 84 <div class="OptionsBox"> | 
|  | 85     $Bond->DeleteBond();</div> | 
|  | 86 <p>Delete <em>Bond</em> between atoms in from a molecule.</p> | 
|  | 87 </dd> | 
|  | 88 <dt><strong><a name="getatoms" class="item"><strong>GetAtoms</strong></a></strong></dt> | 
|  | 89 <dd> | 
|  | 90 <div class="OptionsBox"> | 
|  | 91     @BondedAtoms = $Bond->GetAtoms();</div> | 
|  | 92 <p>Returns an array containing <em>Atoms</em> invoved in <em>Bond</em>.</p> | 
|  | 93 </dd> | 
|  | 94 <dt><strong><a name="getbondedatom" class="item"><strong>GetBondedAtom</strong></a></strong></dt> | 
|  | 95 <dd> | 
|  | 96 <div class="OptionsBox"> | 
|  | 97     $BondedAtom = $Bond->GetBondedAtom($Atom);</div> | 
|  | 98 <p>Returns <strong>BondedAtom</strong> bonded to <em>Atom</em> in  <em>Bond</em>.</p> | 
|  | 99 </dd> | 
|  | 100 <dt><strong><a name="getbondbeginatom" class="item"><strong>GetBondBeginAtom</strong></a></strong></dt> | 
|  | 101 <dd> | 
|  | 102 <div class="OptionsBox"> | 
|  | 103     $BeginAtom = $Bond->GetBondBeginAtom();</div> | 
|  | 104 <p>Returns <strong>BeginAtom</strong> corresponding to bond starting atom in <em>Bond</em>.</p> | 
|  | 105 </dd> | 
|  | 106 <dt><strong><a name="getbondendatom" class="item"><strong>GetBondEndAtom</strong></a></strong></dt> | 
|  | 107 <dd> | 
|  | 108 <div class="OptionsBox"> | 
|  | 109     $EndAtom = $Bond->GetBondEndAtom();</div> | 
|  | 110 <p>Returns <strong>EndAtom</strong> corresponding to bond ending atom in <em>Bond</em>.</p> | 
|  | 111 </dd> | 
|  | 112 <dt><strong><a name="getbondfromatom" class="item"><strong>GetBondFromAtom</strong></a></strong></dt> | 
|  | 113 <dd> | 
|  | 114 <div class="OptionsBox"> | 
|  | 115     $FromAtom = $Bond->GetBondFromAtom();</div> | 
|  | 116 <p>Returns <strong>FromAtom</strong> corresponding to bond starting atom in <em>Bond</em>.</p> | 
|  | 117 </dd> | 
|  | 118 <dt><strong><a name="getbondtoatom" class="item"><strong>GetBondToAtom</strong></a></strong></dt> | 
|  | 119 <dd> | 
|  | 120 <div class="OptionsBox"> | 
|  | 121     $ToAotm = $Bond->GetBondToAtom();</div> | 
|  | 122 <p>Returns <strong>ToAtom</strong> corresponding to bond ending atom in <em>Bond</em>.</p> | 
|  | 123 </dd> | 
|  | 124 <dt><strong><a name="getcommonatom" class="item"><strong>GetCommonAtom</strong></a></strong></dt> | 
|  | 125 <dd> | 
|  | 126 <div class="OptionsBox"> | 
|  | 127     $CommonAtom = $Bond->GetCommonAtom($OtherBond);</div> | 
|  | 128 <p>Returns <strong>Atom</strong> common to both <em>Bond</em> and <em>$OtherBond</em>.</p> | 
|  | 129 </dd> | 
|  | 130 <dt><strong><a name="getlargestring" class="item"><strong>GetLargestRing</strong></a></strong></dt> | 
|  | 131 <dd> | 
|  | 132 <div class="OptionsBox"> | 
|  | 133     @RingAtoms = $Bond->GetLargestRing();</div> | 
|  | 134 <p>Returns an array of ring <em>Atoms</em> corresponding to the largest ring containing <em>Bond</em>. | 
|  | 135 in a molecule</p> | 
|  | 136 </dd> | 
|  | 137 <dt><strong><a name="getnumofrings" class="item"><strong>GetNumOfRings</strong></a></strong></dt> | 
|  | 138 <dd> | 
|  | 139 <div class="OptionsBox"> | 
|  | 140     $NumOfRings = $Bond->GetNumOfRings();</div> | 
|  | 141 <p>Returns number of rings containing <em>Bond</em> in a molecule.</p> | 
|  | 142 </dd> | 
|  | 143 <dt><strong><a name="getnumofringswithevensize" class="item"><strong>GetNumOfRingsWithEvenSize</strong></a></strong></dt> | 
|  | 144 <dd> | 
|  | 145 <div class="OptionsBox"> | 
|  | 146     $NumOfRings = $Bond->GetNumOfRingsWithEvenSize();</div> | 
|  | 147 <p>Returns number of rings with even size containing <em>Bond</em> in a molecule.</p> | 
|  | 148 </dd> | 
|  | 149 <dt><strong><a name="getnumofringswithoddsize" class="item"><strong>GetNumOfRingsWithOddSize</strong></a></strong></dt> | 
|  | 150 <dd> | 
|  | 151 <div class="OptionsBox"> | 
|  | 152     $NumOfRings = $Bond->GetNumOfRingsWithOddSize();</div> | 
|  | 153 <p>Returns number of rings with odd size containing <em>Bond</em> in a molecule.</p> | 
|  | 154 </dd> | 
|  | 155 <dt><strong><a name="getnumofringswithsize" class="item"><strong>GetNumOfRingsWithSize</strong></a></strong></dt> | 
|  | 156 <dd> | 
|  | 157 <div class="OptionsBox"> | 
|  | 158     $NumOfRings = $Bond->GetNumOfRingsWithSize($RingSize);</div> | 
|  | 159 <p>Returns number of rings with specific <em>RingSize</em> containing <em>Bond</em> in a molecule.</p> | 
|  | 160 </dd> | 
|  | 161 <dt><strong><a name="getnumofringswithsizegreaterthan" class="item"><strong>GetNumOfRingsWithSizeGreaterThan</strong></a></strong></dt> | 
|  | 162 <dd> | 
|  | 163 <div class="OptionsBox"> | 
|  | 164     $NumOfRings = $Bond->GetNumOfRingsWithSizeGreaterThan($RingSize);</div> | 
|  | 165 <p>Returns number of rings with size greater than specific <em>RingSize</em> containing | 
|  | 166 <em>Bond</em> in a molecule.</p> | 
|  | 167 </dd> | 
|  | 168 <dt><strong><a name="getnumofringswithsizelessthan" class="item"><strong>GetNumOfRingsWithSizeLessThan</strong></a></strong></dt> | 
|  | 169 <dd> | 
|  | 170 <div class="OptionsBox"> | 
|  | 171     $NumOfRings = $Bond->GetNumOfRingsWithSizeLessThan($RingSize);</div> | 
|  | 172 <p>Returns number of rings with size less than specific <em>RingSize</em> containing <em>Bond</em> | 
|  | 173 in a molecule.</p> | 
|  | 174 </dd> | 
|  | 175 <dt><strong><a name="getrings" class="item"><strong>GetRings</strong></a></strong></dt> | 
|  | 176 <dd> | 
|  | 177 <div class="OptionsBox"> | 
|  | 178     @Rings = $Bond->GetRings();</div> | 
|  | 179 <p>Returns an array of references to arrays containing ring atoms corressponding | 
|  | 180 to all rings containing <em>Bond</em> in a molecule.</p> | 
|  | 181 </dd> | 
|  | 182 <dt><strong><a name="getringswithevensize" class="item"><strong>GetRingsWithEvenSize</strong></a></strong></dt> | 
|  | 183 <dd> | 
|  | 184 <div class="OptionsBox"> | 
|  | 185     @Rings = $Bond->GetRingsWithEvenSize();</div> | 
|  | 186 <p>Returns an array of references to arrays containing ring atoms corressponding to all rings with even size | 
|  | 187 containing <em>Bond</em> in a molecule.</p> | 
|  | 188 </dd> | 
|  | 189 <dt><strong><a name="getringswithoddsize" class="item"><strong>GetRingsWithOddSize</strong></a></strong></dt> | 
|  | 190 <dd> | 
|  | 191 <div class="OptionsBox"> | 
|  | 192     @Rings = $Bond->GetRingsWithOddSize();</div> | 
|  | 193 <p>Returns an array of references to arrays containing ring atoms corressponding to all rings with odd size | 
|  | 194 containing <em>Bond</em> in a molecule.</p> | 
|  | 195 </dd> | 
|  | 196 <dt><strong><a name="getringswithsize" class="item"><strong>GetRingsWithSize</strong></a></strong></dt> | 
|  | 197 <dd> | 
|  | 198 <div class="OptionsBox"> | 
|  | 199     @Rings = $Bond->GetRingsWithSize($RingSize);</div> | 
|  | 200 <p>Returns an array of references to arrays containing ring atoms corressponding to all rings with specific | 
|  | 201 <em>RingSize </em>containing <em>Bond</em> in a molecule.</p> | 
|  | 202 </dd> | 
|  | 203 <dt><strong><a name="getringswithsizegreaterthan" class="item"><strong>GetRingsWithSizeGreaterThan</strong></a></strong></dt> | 
|  | 204 <dd> | 
|  | 205 <div class="OptionsBox"> | 
|  | 206     @Rings = $Bond->GetRingsWithSizeGreaterThan($RingSize);</div> | 
|  | 207 <p>Returns an array of references to arrays containing ring atoms corressponding to all rings with size | 
|  | 208 greater than specific <em>RingSize </em>containing <em>Bond</em> in a molecule.</p> | 
|  | 209 </dd> | 
|  | 210 <dt><strong><a name="getringswithsizelessthan" class="item"><strong>GetRingsWithSizeLessThan</strong></a></strong></dt> | 
|  | 211 <dd> | 
|  | 212 <div class="OptionsBox"> | 
|  | 213     @Rings = $Bond->GetRingsWithSizeLessThan($RingSize);</div> | 
|  | 214 <p>Returns an array of references to arrays containing ring atoms corressponding to all rings with size | 
|  | 215 less than specific <em>RingSize </em>containing <em>Bond</em> in a molecule.</p> | 
|  | 216 </dd> | 
|  | 217 <dt><strong><a name="getsizeoflargestring" class="item"><strong>GetSizeOfLargestRing</strong></a></strong></dt> | 
|  | 218 <dd> | 
|  | 219 <div class="OptionsBox"> | 
|  | 220     $Size = $Bond->GetSizeOfLargestRing();</div> | 
|  | 221 <p>Returns size of the largest ring containing <em>Bond</em> in a molecule.</p> | 
|  | 222 </dd> | 
|  | 223 <dt><strong><a name="getsizeofsmallestring" class="item"><strong>GetSizeOfSmallestRing</strong></a></strong></dt> | 
|  | 224 <dd> | 
|  | 225 <div class="OptionsBox"> | 
|  | 226     $Size = $Bond->GetSizeOfSmallestRing();</div> | 
|  | 227 <p>Returns size of the smallest ring containing <em>Bond</em> in a molecule.</p> | 
|  | 228 </dd> | 
|  | 229 <dt><strong><a name="getsmallestring" class="item"><strong>GetSmallestRing</strong></a></strong></dt> | 
|  | 230 <dd> | 
|  | 231 <div class="OptionsBox"> | 
|  | 232     @RingAtoms = $Bond->GetSmallestRing();</div> | 
|  | 233 <p>Returns an array of ring <em>Atoms</em> corresponding to the largest ring containing <em>Bond</em> | 
|  | 234 in a molecule.</p> | 
|  | 235 </dd> | 
|  | 236 <dt><strong><a name="isaromatic" class="item"><strong>IsAromatic</strong></a></strong></dt> | 
|  | 237 <dd> | 
|  | 238 <div class="OptionsBox"> | 
|  | 239     $Status = $Bond->IsAromatic();</div> | 
|  | 240 <p>Returns 1 or 0 based on whether it's an aromatic <em>Bond</em>.</p> | 
|  | 241 </dd> | 
|  | 242 <dt><strong><a name="isbondstereochemistryspecified" class="item"><strong>IsBondStereochemistrySpecified</strong></a></strong></dt> | 
|  | 243 <dd> | 
|  | 244 <div class="OptionsBox"> | 
|  | 245     $Status = $Bond->IsBondStereochemistrySpecified();</div> | 
|  | 246 <p>Returns 1 or 0 based on whether <em>Bond</em>'s sterochemistry is specified.</p> | 
|  | 247 </dd> | 
|  | 248 <dt><strong><a name="isbondtypespecified" class="item"><strong>IsBondTypeSpecified</strong></a></strong></dt> | 
|  | 249 <dd> | 
|  | 250 <div class="OptionsBox"> | 
|  | 251     $Status = $Bond->IsBondTypeSpecified();</div> | 
|  | 252 <p>Returns 1 or 0 based on whether <em>Bond</em>'s type is specified.</p> | 
|  | 253 </dd> | 
|  | 254 <dt><strong><a name="iscis" class="item"><strong>IsCis</strong></a></strong></dt> | 
|  | 255 <dd> | 
|  | 256 <div class="OptionsBox"> | 
|  | 257     $Status = $Bond->IsCis();</div> | 
|  | 258 <p>Returns 1 or 0 based on whether it's a cis <em>Bond</em>.</p> | 
|  | 259 </dd> | 
|  | 260 <dt><strong><a name="iscisortrans" class="item"><strong>IsCisOrTrans</strong></a></strong></dt> | 
|  | 261 <dd> | 
|  | 262 <div class="OptionsBox"> | 
|  | 263     $Status = $Bond->IsCisOrTrans();</div> | 
|  | 264 <p>Returns 1 or 0 based on whether it's a cis or trans <em>Bond</em>.</p> | 
|  | 265 </dd> | 
|  | 266 <dt><strong><a name="iscoordinate" class="item"><strong>IsCoordinate</strong></a></strong></dt> | 
|  | 267 <dd> | 
|  | 268 <div class="OptionsBox"> | 
|  | 269     $Status = $Bond->IsCoordinate();</div> | 
|  | 270 <p>Returns 1 or 0 based on whether it's a coordinate or dative  <em>Bond</em>.</p> | 
|  | 271 </dd> | 
|  | 272 <dt><strong><a name="isdative" class="item"><strong>IsDative</strong></a></strong></dt> | 
|  | 273 <dd> | 
|  | 274 <div class="OptionsBox"> | 
|  | 275     $Status = $Bond->IsDative();</div> | 
|  | 276 <p>Returns 1 or 0 based on whether it's a coordinate or dative  <em>Bond</em>.</p> | 
|  | 277 </dd> | 
|  | 278 <dt><strong><a name="isdouble" class="item"><strong>IsDouble</strong></a></strong></dt> | 
|  | 279 <dd> | 
|  | 280 <div class="OptionsBox"> | 
|  | 281     $Status =$Bond->IsDouble();</div> | 
|  | 282 <p>Returns 1 or 0 based on whether it's a double <em>Bond</em>.</p> | 
|  | 283 </dd> | 
|  | 284 <dt><strong><a name="isdown" class="item"><strong>IsDown</strong></a></strong></dt> | 
|  | 285 <dd> | 
|  | 286 <div class="OptionsBox"> | 
|  | 287     $Status = $Bond->IsDown();</div> | 
|  | 288 <p>Returns 1 or 0 based on whether it's a hash or down single <em>Bond</em>.</p> | 
|  | 289 </dd> | 
|  | 290 <dt><strong><a name="isdownward" class="item"><strong>IsDownward</strong></a></strong></dt> | 
|  | 291 <dd> | 
|  | 292 <div class="OptionsBox"> | 
|  | 293     $Return = $Bond->IsDownward();</div> | 
|  | 294 <p>Returns 1 or 0 based on whether it's a downward <em>Bond</em>.</p> | 
|  | 295 </dd> | 
|  | 296 <dt><strong><a name="ishash" class="item"><strong>IsHash</strong></a></strong></dt> | 
|  | 297 <dd> | 
|  | 298 <div class="OptionsBox"> | 
|  | 299     $Status = $Bond->IsHash();</div> | 
|  | 300 <p>Returns 1 or 0 based on whether it's a hash or down single <em>Bond</em>.</p> | 
|  | 301 </dd> | 
|  | 302 <dt><strong><a name="isinring" class="item"><strong>IsInRing</strong></a></strong></dt> | 
|  | 303 <dd> | 
|  | 304 <div class="OptionsBox"> | 
|  | 305     $Status = $Bond->IsInRing();</div> | 
|  | 306 <p>Returns 1 or 0 based on whether <em>Bond</em> is present in a ring.</p> | 
|  | 307 </dd> | 
|  | 308 <dt><strong><a name="isinringofsize" class="item"><strong>IsInRingOfSize</strong></a></strong></dt> | 
|  | 309 <dd> | 
|  | 310 <div class="OptionsBox"> | 
|  | 311     $Status = $Bond->IsInRingOfSize($Size);</div> | 
|  | 312 <p>Returns 1 or 0 based on whether <em>Bond</em> is present in a ring of specific <em>Size</em>.</p> | 
|  | 313 </dd> | 
|  | 314 <dt><strong><a name="isionic" class="item"><strong>IsIonic</strong></a></strong></dt> | 
|  | 315 <dd> | 
|  | 316 <div class="OptionsBox"> | 
|  | 317     $Status = $Bond->IsIonic();</div> | 
|  | 318 <p>Returns 1 or 0 based on whether it's an ionic <em>Bond</em>.</p> | 
|  | 319 </dd> | 
|  | 320 <dt><strong><a name="isnotinring" class="item"><strong>IsNotInRing</strong></a></strong></dt> | 
|  | 321 <dd> | 
|  | 322 <div class="OptionsBox"> | 
|  | 323     $Status = $Bond->IsNotInRing();</div> | 
|  | 324 <p>Returns 1 or 0 based on whether <em>Bond</em> is not present in a ring.</p> | 
|  | 325 </dd> | 
|  | 326 <dt><strong><a name="isonlyinonering" class="item"><strong>IsOnlyInOneRing</strong></a></strong></dt> | 
|  | 327 <dd> | 
|  | 328 <div class="OptionsBox"> | 
|  | 329     $Status = $Bond->IsOnlyInOneRing();</div> | 
|  | 330 <p>Returns 1 or 0 based on whether <em>Bond</em> is only present in one ring.</p> | 
|  | 331 </dd> | 
|  | 332 <dt><strong><a name="isquadruple" class="item"><strong>IsQuadruple</strong></a></strong></dt> | 
|  | 333 <dd> | 
|  | 334 <div class="OptionsBox"> | 
|  | 335     $Status = $Bond->IsQuadruple();</div> | 
|  | 336 <p>Returns 1 or 0 based on whether it's a quadruple <em>Bond</em>.</p> | 
|  | 337 </dd> | 
|  | 338 <dt><strong><a name="isquintuple" class="item"><strong>IsQuintuple</strong></a></strong></dt> | 
|  | 339 <dd> | 
|  | 340 <div class="OptionsBox"> | 
|  | 341     $Status = $Bond->IsQuintuple();</div> | 
|  | 342 <p>Returns 1 or 0 based on whether it's a quintuple <em>Bond</em>.</p> | 
|  | 343 </dd> | 
|  | 344 <dt><strong><a name="issextuple" class="item"><strong>IsSextuple</strong></a></strong></dt> | 
|  | 345 <dd> | 
|  | 346 <div class="OptionsBox"> | 
|  | 347     $Status = $Bond->IsSextuple();</div> | 
|  | 348 <p>Returns 1 or 0 based on whether it's a sextuple <em>Bond</em>.</p> | 
|  | 349 </dd> | 
|  | 350 <dt><strong><a name="issingle" class="item"><strong>IsSingle</strong></a></strong></dt> | 
|  | 351 <dd> | 
|  | 352 <div class="OptionsBox"> | 
|  | 353     $Status =$Bond->IsSingle();</div> | 
|  | 354 <p>Returns 1 or 0 based on whether it's a single <em>Bond</em>.</p> | 
|  | 355 </dd> | 
|  | 356 <dt><strong><a name="istriple" class="item"><strong>IsTriple</strong></a></strong></dt> | 
|  | 357 <dd> | 
|  | 358 <div class="OptionsBox"> | 
|  | 359     $Status =$Bond->IsTriple();</div> | 
|  | 360 <p>Returns 1 or 0 based on whether it's a triple <em>Bond</em>.</p> | 
|  | 361 </dd> | 
|  | 362 <dt><strong><a name="istautomeric" class="item"><strong>IsTautomeric</strong></a></strong></dt> | 
|  | 363 <dd> | 
|  | 364 <div class="OptionsBox"> | 
|  | 365     $Status = $Bond->IsTautomeric();</div> | 
|  | 366 <p>Returns 1 or 0 based on whether it's a <em>Bond</em>.</p> | 
|  | 367 </dd> | 
|  | 368 <dt><strong><a name="istrans" class="item"><strong>IsTrans</strong></a></strong></dt> | 
|  | 369 <dd> | 
|  | 370 <div class="OptionsBox"> | 
|  | 371     $Status = $Bond->IsTrans();</div> | 
|  | 372 <p>Returns 1 or 0 based on whether it's a trans <em>Bond</em>.</p> | 
|  | 373 </dd> | 
|  | 374 <dt><strong><a name="isup" class="item"><strong>IsUp</strong></a></strong></dt> | 
|  | 375 <dd> | 
|  | 376 <div class="OptionsBox"> | 
|  | 377     $Status = $Bond->IsUp();</div> | 
|  | 378 <p>Returns 1 or 0 based on whether it's a up <em>Bond</em>.</p> | 
|  | 379 </dd> | 
|  | 380 <dt><strong><a name="isupordown" class="item"><strong>IsUpOrDown</strong></a></strong></dt> | 
|  | 381 <dd> | 
|  | 382 <div class="OptionsBox"> | 
|  | 383     $Status = $Bond->IsUpOrDown();</div> | 
|  | 384 <p>Returns 1 or 0 based on whether it's an up or down <em>Bond</em>.</p> | 
|  | 385 </dd> | 
|  | 386 <dt><strong><a name="isupward" class="item"><strong>IsUpward</strong></a></strong></dt> | 
|  | 387 <dd> | 
|  | 388 <div class="OptionsBox"> | 
|  | 389     $Status = $Bond->IsUpward();</div> | 
|  | 390 <p>Returns 1 or 0 based on whether it's an upward <em>Bond</em>.</p> | 
|  | 391 </dd> | 
|  | 392 <dt><strong><a name="iswedge" class="item"><strong>IsWedge</strong></a></strong></dt> | 
|  | 393 <dd> | 
|  | 394 <div class="OptionsBox"> | 
|  | 395     $Status = $Bond->IsWedge();</div> | 
|  | 396 <p>Returns 1 or 0 based on whether it's a wedge <em>Bond</em>.</p> | 
|  | 397 </dd> | 
|  | 398 <dt><strong><a name="iswedgeorhash" class="item"><strong>IsWedgeOrHash</strong></a></strong></dt> | 
|  | 399 <dd> | 
|  | 400 <div class="OptionsBox"> | 
|  | 401     $Status = $Bond->IsWedgeOrHash();</div> | 
|  | 402 <p>Returns 1 or 0 based on whether it's a wedge or hash <em>Bond</em>.</p> | 
|  | 403 </dd> | 
|  | 404 <dt><strong><a name="setatoms" class="item"><strong>SetAtoms</strong></a></strong></dt> | 
|  | 405 <dd> | 
|  | 406 <div class="OptionsBox"> | 
|  | 407     $Bond->SetAtoms($AtomsRef); | 
|  | 408 <br/>    $Bond->SetAtoms(@Atoms);</div> | 
|  | 409 <p>Set atoms of <em>Bond</em> to atoms in <em>Atoms</em> array or in a reference to an array of atoms | 
|  | 410 and return <em>Bond</em>.</p> | 
|  | 411 </dd> | 
|  | 412 <dt><strong><a name="setbondorder" class="item"><strong>SetBondOrder</strong></a></strong></dt> | 
|  | 413 <dd> | 
|  | 414 <div class="OptionsBox"> | 
|  | 415     $Bond->SetBondOrder($BondOrder);</div> | 
|  | 416 <p>Sets bond order of <em>Bond</em> to specified <em>BondOrder</em> and returns <em>Bond</em>. Possible bond order | 
|  | 417 values: 1 = Single, 1.5 = Aromatic, 2 = Double, 3 = Triple, 4 = Quadruple, 5 = Quintuple, | 
|  | 418 6 = Sextuple, 7 = Septuple</p> | 
|  | 419 <p>Notes:</p> | 
|  | 420 <div class="OptionsBox"> | 
|  | 421     . BondType property is automatically assigned using default BondType | 
|  | 422       values for specified BondOrder. | 
|  | 423 <br/>    . BondType values can also be explicit set. | 
|  | 424 <br/>    . To make bonds aromatic in a ring, explicitly set "Aromatic" | 
|  | 425       property for bond/atoms and make sure appropriate BondOrder | 
|  | 426       values are assigned. | 
|  | 427 <br/>    . Dative or coordinate bond types are treated as single bond types with | 
|  | 428       explicit formal charge of + and - on first and second bond atoms.</div> | 
|  | 429 </dd> | 
|  | 430 <dt><strong><a name="setbondtype" class="item"><strong>SetBondType</strong></a></strong></dt> | 
|  | 431 <dd> | 
|  | 432 <div class="OptionsBox"> | 
|  | 433     $Bond->SetBondType($BondType);</div> | 
|  | 434 <p>Sets bond type for <em>Bond</em> to specified <em>BondType</em> and returns <em>Bond</em>. Possible bond type | 
|  | 435 values for different bond orders are:</p> | 
|  | 436 <div class="OptionsBox"> | 
|  | 437     0: None, Ionic, Unspecified | 
|  | 438 <br/>    1 : Single, Dative, Coordinate, SingleOrDouble, SingleOrAromatic, Tautomeric | 
|  | 439 <br/>    2 : Double, SingleOrDouble, DoubleOrAromatic, Tautomeric | 
|  | 440 <br/>    3 : Triple | 
|  | 441 <br/>    4 : Quadruple | 
|  | 442 <br/>    5 : Quintuple | 
|  | 443 <br/>    6 : Sextuple | 
|  | 444 <br/>    7 : Septuple | 
|  | 445 <br/>    1.5 : Aromatic, Resonance, SingleOrAromatic, DoubleOrAromatic</div> | 
|  | 446 <p>Notes:</p> | 
|  | 447 <div class="OptionsBox"> | 
|  | 448     o BondType Any is valid for all BondOrders. | 
|  | 449 <br/>    o BondOrder property is automatically assigned using default BondOrder | 
|  | 450       values for specified BondType.</div> | 
|  | 451 <p>Possible bond stereochemistry values for different bond orders are:</p> | 
|  | 452 <div class="OptionsBox"> | 
|  | 453     0 : None, Unspecified | 
|  | 454 <br/>    1 : Wedge, Up, Hash, Down, Wavy, WedgeOrHash, UpOrDown, Upward, Downward, | 
|  | 455 <br/>            None, Unspecified | 
|  | 456 <br/>    2 : Cis, Trans, Z, E, DoubleCross, CisOrTrans, None, Unspecified</div> | 
|  | 457 </dd> | 
|  | 458 <dt><strong><a name="setbondstereochemistry" class="item"><strong>SetBondStereochemistry</strong></a></strong></dt> | 
|  | 459 <dd> | 
|  | 460 <div class="OptionsBox"> | 
|  | 461     $Bond = $Bond->SetBondStereochemistry($BondStereochemistry);</div> | 
|  | 462 <p>Sets bond stereochemistry of <em>Bond</em> to specified <em>BondStereochemistry</em> and | 
|  | 463 returns <em>Bond</em>. Possible <em>BondStereoChemistry</em> values for different bond orders | 
|  | 464 are:</p> | 
|  | 465 <p>BondOrder: 1</p> | 
|  | 466 <div class="OptionsBox"> | 
|  | 467     None, Unspecified: Not a stereo bond or unspecified</div> | 
|  | 468 <div class="OptionsBox"> | 
|  | 469     Wedge, Up : Wedge end pointing up | 
|  | 470 <br/>    Hash, Down: Wedge end pointing down | 
|  | 471 <br/>    Wavy, WedgeOrHash, UpOrDown: Wedge end up or down</div> | 
|  | 472 <div class="OptionsBox"> | 
|  | 473     Upward: Single bond around cis/trans double bonds pointing upward | 
|  | 474 <br/>    Downward: Single bond around cis/trans double bonds pointing upward</div> | 
|  | 475 <p>Notes:</p> | 
|  | 476 <div class="OptionsBox"> | 
|  | 477     o Wedge starts at begin atom of a bond making wedge pointed end always | 
|  | 478       at this atom. | 
|  | 479 <br/>    o Upward/downward bonds start at atoms involved in cis/trans double bonds.</div> | 
|  | 480 <p>BondOrder: 2</p> | 
|  | 481 <div class="OptionsBox"> | 
|  | 482     None, Unspecified: Not a stereo bond or unspecified</div> | 
|  | 483 <div class="OptionsBox"> | 
|  | 484     Z, cis: Similar groups on same side of double bond | 
|  | 485 <br/>    E, trans: Similar groups on different side of double bond</div> | 
|  | 486 <div class="OptionsBox"> | 
|  | 487     CisOrTrans, DoubleCross: cis or trans</div> | 
|  | 488 </dd> | 
|  | 489 <dt><strong><a name="stringifybond" class="item"><strong>StringifyBond</strong></a></strong></dt> | 
|  | 490 <dd> | 
|  | 491 <div class="OptionsBox"> | 
|  | 492     $BondString = $Bond->StringifyBond();</div> | 
|  | 493 <p>Returns a string containing information about <em>bond</em> object.</p> | 
|  | 494 </dd> | 
|  | 495 <dt><strong><a name="switchbondfromandtoatoms" class="item"><strong>SwitchBondFromAndToAtoms</strong></a></strong></dt> | 
|  | 496 <dd> | 
|  | 497 <div class="OptionsBox"> | 
|  | 498     $Bond = $Bond->SwitchBondFromAndToAtoms();</div> | 
|  | 499 <p>Swaps bond from and to atoms in <em>Bond</em> and returns <em>Bond</em>.</p> | 
|  | 500 </dd> | 
|  | 501 </dl> | 
|  | 502 <p> | 
|  | 503 </p> | 
|  | 504 <h2>AUTHOR</h2> | 
|  | 505 <p><a href="mailto:msud@san.rr.com">Manish Sud</a></p> | 
|  | 506 <p> | 
|  | 507 </p> | 
|  | 508 <h2>SEE ALSO</h2> | 
|  | 509 <p><a href="./Atom.html">Atom.pm</a>, <a href="./Molecule.html">Molecule.pm</a> | 
|  | 510 </p> | 
|  | 511 <p> | 
|  | 512 </p> | 
|  | 513 <h2>COPYRIGHT</h2> | 
|  | 514 <p>Copyright (C) 2015 Manish Sud. All rights reserved.</p> | 
|  | 515 <p>This file is part of MayaChemTools.</p> | 
|  | 516 <p>MayaChemTools is free software; you can redistribute it and/or modify it under | 
|  | 517 the terms of the GNU Lesser General Public License as published by the Free | 
|  | 518 Software Foundation; either version 3 of the License, or (at your option) | 
|  | 519 any later version.</p> | 
|  | 520 <p> </p><p> </p><div class="DocNav"> | 
|  | 521 <table width="100%" border=0 cellpadding=0 cellspacing=2> | 
|  | 522 <tr align="left" valign="top"><td width="33%" align="left"><a href="./BitVector.html" title="BitVector.html">Previous</a>  <a href="./index.html" title="Table of Contents">TOC</a>  <a href="./Constants.html" title="Constants.html">Next</a></td><td width="34%" align="middle"><strong>March 29, 2015</strong></td><td width="33%" align="right"><strong>Bond.pm</strong></td></tr> | 
|  | 523 </table> | 
|  | 524 </div> | 
|  | 525 <br /> | 
|  | 526 <center> | 
|  | 527 <img src="../../images/h2o2.png"> | 
|  | 528 </center> | 
|  | 529 </body> | 
|  | 530 </html> |