cantera/Cantera/cxx/include/Interface.h

/**
 * @file Interface.h
 *   Declaration and Definition for the class Interface.
 */
#ifndef CXX_INTERFACE
#define CXX_INTERFACE

#include <string>
#include "Cantera.h"
#include "thermo.h"
#include "kinetics.h"

namespace Cantera
{

//! An interface between multiple bulk phases.
/*!
 * This class isdefined mostly for convenience. It inherits both from
 * Cantera::SurfPhase and Cantera::InterfaceKinetics. It therefore
 * represents a surface phase, and also acts as the kinetics
 * manager to manage reactions occurring on the surface, possibly
 * involving species from other phases.
 */
class Interface :
    public SurfPhase,
    public InterfaceKinetics
{
public:
    //! Constructor.
    /*!
     *   Construct an Interface instance from a specification in an input file.
     *
     *   @param infile.          Cantera input file in CTI or CTML format.
     *   @param id               Identification string to distinguish between
     *                           multiple definitions within one input file.
     *   @param otherPhases      Neighboring phases that may participate in the
     *                           reactions on this interface. Don't include the
     *                           surface phase
     *
     * @deprecated
     *   While it's convenient to have the surface phase and the interfacial reaction
     *   together, this class doesn't satisfy the primary issue, which is one
     *   of instantiation of all the ThermoPhase classes that accompany a
     *   surface reaction. This is accomplished by the PhaseList class along with
     *   the ReactingSurface class. These classes will be migrated into Cantera
     *   soon.
     */
    Interface(std::string infile, std::string id,
              std::vector<Cantera::ThermoPhase*> otherPhases) :
        m_ok(false),
        m_r(0) {
        m_r = Cantera::get_XML_File(infile);
        if (id == "-") {
            id = "";
        }

        Cantera::XML_Node* x = Cantera::get_XML_Node("#"+id, m_r);
        if (!x) {
            throw Cantera::CanteraError("Interface","error in get_XML_Node");
        }
        Cantera::importPhase(*x, this);
        otherPhases.push_back(this);
        Cantera::importKinetics(*x, otherPhases, this);
        m_ok = true;
    }

    //! Copy Constructor
    /*!
     *  @param ii   Interface object to be copied.
     */
    Interface(const Interface& ii) :
        Cantera::SurfPhase(ii),
        Cantera::InterfaceKinetics(ii),
        m_ok(ii.m_ok),
        m_r(ii.m_r) {
    }

    //! Assignment operator
    /*!
     *  @param right   Interface object to be copied.
     */
    Interface& operator=(const Interface& right) {
        if (this == &right) {
            return *this;
        }
        Cantera::SurfPhase::operator=(right);
        Cantera::InterfaceKinetics::operator=(right);
        m_ok = right.m_ok;
        m_r = right.m_r;
        return *this;
    }

    //! Destructor. Does nothing.
    virtual ~Interface() {
    }

    //! Not operator
    bool operator!() {
        return !m_ok;
    }

    //! return whether the object has been instantiated
    /*!
     *  @return  Returns a bool.
     */
    bool ready() const {
        return m_ok;
    }

protected:

    //! Flag indicating that the object has been instantiated
    bool m_ok;

    //! XML_Node pointer to the XML File object that contains the Surface and the Interfacial Reaction object
    //! description
    Cantera::XML_Node* m_r;

};


//! Import an instance of class Interface from a specification in an input file.
/*!
 *  This is the preferred method to create an Interface instance.
 */
Interface* importInterface(std::string infile, std::string id, std::vector<Cantera::ThermoPhase*> phases)
{
    return new Interface(infile, id, phases);
}

}


#endif