Logo Search packages:      
Sourcecode: cdk version File versions  Download package

AtomType.java

/* $RCSfile$
 * $Author: egonw $    
 * $Date: 2007-01-04 18:46:10 +0100 (Thu, 04 Jan 2007) $    
 * $Revision: 7636 $
 *
 *  Copyright (C) 2001-2007  Christoph Steinbeck <steinbeck@users.sf.net>
 *
 *  Contact: cdk-devel@lists.sourceforge.net
 *
 *  This program is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public License
 *  as published by the Free Software Foundation; either version 2.1
 *  of the License, or (at your option) any later version.
 *  All we ask is that proper credit is given for our work, which includes
 *  - but is not limited to - adding the above copyright notice to the beginning
 *  of your source code files, and to any copyright notice that you may distribute
 *  with programs based on this work.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 */
package org.openscience.cdk;

import org.openscience.cdk.interfaces.IAtomType;
import org.openscience.cdk.interfaces.IElement;

import java.io.Serializable;

/**
 * The base class for atom types. Atom types are typically used to describe the
 * behaviour of an atom of a particular element in different environment like 
 * sp<sup>3</sup>
 * hybridized carbon C3, etc., in some molecular modelling applications.
 *
 * @author       steinbeck
 * @cdk.created  2001-08-08
 * @cdk.module   data
 * @cdk.keyword  atom, type
 */
00047 public class AtomType extends Isotope implements IAtomType, Serializable, Cloneable
{

      /**
     * Determines if a de-serialized object is compatible with this class.
     *
     * This value must only be changed if and only if the new version
     * of this class is imcompatible with the old version. See Sun docs
     * for <a href=http://java.sun.com/products/jdk/1.1/docs/guide
     * /serialization/spec/version.doc.html>details</a>.
       */
00058       private static final long serialVersionUID = -7950397716808229972L;

      /**
       *  The maximum bond order allowed for this atom type.
       */
00063       double maxBondOrder;
      /**
       *  The maximum sum of all bondorders allowed for this atom type.
       */
00067       double bondOrderSum;

    /**
     * The Vanderwaals radius of this atom type.
     */
00072     double vanderwaalsRadius;
    /**
     * The covalent radius of this atom type.
     */
00076     double covalentRadius;
    
    /**
     *  The formal charge of the atom with CDKConstants.UNSET as default. Implements RFC #6.
     *
     */
00082     protected int formalCharge;

    /**
     * The hybridization state of this atom with CDKConstants.HYBRIDIZATION_UNSET
     * as default.
     */
00088     protected int hybridization;

    /**
     *  The electron Valency of this atom with CDKConstants.UNSET as default.
     */
00093     protected int electronValency;

    /**
     * The formal number of neighbours this atom type can have with CDKConstants_UNSET
     * as default. This includes explicitely and implicitely connected atoms, including
     * implicit hydrogens.
     */
00100     protected int formalNeighbourCount;

    /**
     * String representing the identifier for this atom type with null as default.
     */
00105     private String identifier;
    
    /**
       * Constructor for the AtomType object. Defaults to a zero formal charge.
     *
     * @param elementSymbol  Symbol of the atom
       */
00112       public AtomType(String elementSymbol) {
            super(elementSymbol);
            this.identifier = null;
            this.formalNeighbourCount = 0;
            this.electronValency = 0;
            this.hybridization = CDKConstants.HYBRIDIZATION_UNSET;
            this.formalCharge = 0;
      }


      /**
       * Constructor for the AtomType object. Defaults to a zero formal charge.
       *
       * @param  identifier     An id for this atom type, like C3 for sp3 carbon
       * @param  elementSymbol  The element symbol identifying the element to which this atom type applies
       */
00128       public AtomType(String identifier, String elementSymbol)
      {
            this(elementSymbol);
            this.identifier = identifier;
      }

      /**
       * Constructs an isotope by copying the symbol, atomic number,
       * flags, identifier, exact mass, natural abundance and mass 
       * number from the given IIsotope. It does not copy the
       * listeners and properties. If the element is an instanceof
       * IAtomType, then the maximum bond order, bond order sum,
       * vanderwaals and covalent radii, formal charge, hybridization,
       * electron valency, formal neighbour count and atom type name
       * are copied too.
       * 
       * @param element IIsotope to copy information from
       */
00146       public AtomType(IElement element) {
            super(element);
            if (element instanceof IAtomType) {
                  this.maxBondOrder = ((IAtomType)element).getMaxBondOrder();
                  this.bondOrderSum = ((IAtomType)element).getBondOrderSum();
                  this.vanderwaalsRadius = ((IAtomType)element).getVanderwaalsRadius();
                  this.covalentRadius = ((IAtomType)element).getCovalentRadius();
                  this.formalCharge = ((IAtomType)element).getFormalCharge();
                  this.hybridization = ((IAtomType)element).getHybridization();
                  this.electronValency = ((IAtomType)element).getValency();
                  this.formalNeighbourCount = ((IAtomType)element).getFormalNeighbourCount();
                  this.identifier = ((IAtomType)element).getAtomTypeName();
            }
      }

      /**
       *  Sets the if attribute of the AtomType object.
       *
       * @param  identifier  The new AtomTypeID value. Null if unset.
     *
     * @see    #getAtomTypeName
       */
00168       public void setAtomTypeName(String identifier)
      {
            this.identifier = identifier;
            notifyChanged();
      }


      /**
       *  Sets the MaxBondOrder attribute of the AtomType object.
       *
       * @param  maxBondOrder  The new MaxBondOrder value
     *
     * @see       #getMaxBondOrder
       */
00182       public void setMaxBondOrder(double maxBondOrder)
      {
            this.maxBondOrder = maxBondOrder;
            notifyChanged();
      }


      /**
       *  Sets the the exact bond order sum attribute of the AtomType object.
       *
       * @param  bondOrderSum  The new bondOrderSum value
     *
     * @see       #getBondOrderSum
       */
00196       public void setBondOrderSum(double bondOrderSum)
      {
            this.bondOrderSum = bondOrderSum;
            notifyChanged();
      }


      /**
       *  Gets the id attribute of the AtomType object.
       *
       * @return    The id value
     *
     * @see       #setAtomTypeName
       */
00210       public String getAtomTypeName()
      {
            return this.identifier;
      }


      /**
       *  Gets the MaxBondOrder attribute of the AtomType object.
       *
       * @return    The MaxBondOrder value
     *
     * @see       #setMaxBondOrder
       */
00223       public double getMaxBondOrder()
      {
            return maxBondOrder;
      }


      /**
       *  Gets the bondOrderSum attribute of the AtomType object.
       *
       * @return    The bondOrderSum value
     *
     * @see       #setBondOrderSum
       */
00236       public double getBondOrderSum()
      {
            return bondOrderSum;
      }

    /**
     *  Sets the formal charge of this atom.
     *
     * @param  charge  The formal charge
     *
     * @see    #getFormalCharge
     */
00248     public void setFormalCharge(int charge) {
        this.formalCharge = charge;
      notifyChanged();
    }
    
    /**
     *  Returns the formal charge of this atom.
     *
     * @return the formal charge of this atom
     *
     * @see    #setFormalCharge
     */
00260     public int getFormalCharge() {
        return this.formalCharge;
    }
    
    /**
     * Sets the formal neighbour count of this atom.
     *
     * @param  count  The neighbour count
     *
     * @see    #getFormalNeighbourCount
     */
00271     public void setFormalNeighbourCount(int count) {
        this.formalNeighbourCount = count;
      notifyChanged();
    }
    
    /**
     * Returns the formal neighbour count of this atom.
     *
     * @return the formal neighbour count of this atom
     *
     * @see    #setFormalNeighbourCount
     */
00283     public int getFormalNeighbourCount() {
        return this.formalNeighbourCount;
    }
    
    /**
     *  Sets the hybridization of this atom.
     *
     * @param  hybridization  The hybridization
     *
     * @see    #getHybridization
     */
00294     public void setHybridization(int hybridization) {
        this.hybridization = hybridization;
        notifyChanged();
    }
    
    /**
     *  Returns the hybridization of this atom.
     *
     * @return the hybridization of this atom
     *
     * @see    #setHybridization
     */
00306     public int getHybridization() {
        return this.hybridization;
    }
    
    /**
     * Compare a atom type with this atom type.
     *
     * @param  object Object of type AtomType
     * @return        Return true, if the atomtypes are equal
     */
00316     public boolean compare(Object object) {
        if (!(object instanceof IAtomType)) {
            return false;
        }
        if (!super.compare(object)) {
            return false;
        }
        AtomType type = (AtomType) object;
        if ((getAtomTypeName() == type.getAtomTypeName()) &&
            (maxBondOrder == type.maxBondOrder) &&
            (bondOrderSum == type.bondOrderSum)) {
            return true;
        }
        return false;
    }
    
    /**
     * Sets the Vanderwaals radius for this AtomType.
     *
     * @param radius The Vanderwaals radius for this AtomType
     * @see   #getVanderwaalsRadius
     */
00338     public void setVanderwaalsRadius(double radius) {
        this.vanderwaalsRadius = radius;
      notifyChanged();
    }
    
    /**
     * Returns the Vanderwaals radius for this AtomType.
     *
     * @return The Vanderwaals radius for this AtomType
     * @see    #setVanderwaalsRadius
     */
00349     public double getVanderwaalsRadius() {
        return this.vanderwaalsRadius;
    }
    
    /**
     * Sets the covalent radius for this AtomType.
     *
     * @param radius The covalent radius for this AtomType
     * @see    #getCovalentRadius
     */
00359     public void setCovalentRadius(double radius) {
        this.covalentRadius = radius;
      notifyChanged();
    }
    
    /**
     * Returns the covalent radius for this AtomType.
     *
     * @return The covalent radius for this AtomType
     * @see    #setCovalentRadius
     */
00370     public double getCovalentRadius() {
        return this.covalentRadius;
    }
    
      /**
       *  Sets the the exact electron valency of the AtomType object.
       *
       * @param  valency  The new valency value
       * @see #getValency
       *
       */
00381       public void setValency(int valency)
      {
            this.electronValency = valency;
            notifyChanged();
      }

      /**
       *  Gets the the exact electron valency of the AtomType object.
       *
       * @return The valency value
       * @see #setValency
       *
       */
00394       public int getValency()
      {
            return this.electronValency;
      }

00399     public Object clone() throws CloneNotSupportedException {
        return super.clone();
    }
      
00403     public String toString() {
        StringBuffer resultString = new StringBuffer(64);
        resultString.append("AtomType(");
        resultString.append(getAtomTypeName());
        resultString.append(", MBO:").append(getMaxBondOrder());
        resultString.append(", BOS:").append(getBondOrderSum());
        resultString.append(", FC:").append(getFormalCharge());
        resultString.append(", H:").append(getHybridization());
        resultString.append(", NC:").append(getFormalNeighbourCount());
        resultString.append(", CR:").append(getCovalentRadius());
        resultString.append(", VDWR:").append(getVanderwaalsRadius());
        resultString.append(", EV:").append(getValency()).append(", ");
        resultString.append(super.toString());
        resultString.append(')');
        return resultString.toString(); 
    }
}


Generated by  Doxygen 1.6.0   Back to index