/** * @file LatticePhase.cpp * Definitions for a simple thermodynamics model of a bulk phase * derived from ThermoPhase, * assuming a lattice of solid atoms * (see \ref thermoprops and class \link Cantera::LatticePhase LatticePhase\endlink). */ #include "cantera/thermo/LatticePhase.h" #include "cantera/thermo/ThermoFactory.h" #include "cantera/base/stringUtils.h" #include "cantera/base/ctml.h" #include "cantera/base/utilities.h" namespace Cantera { LatticePhase::LatticePhase() : m_Pref(OneAtm), m_Pcurrent(OneAtm), m_speciesMolarVolume(0), m_site_density(0.0) { } LatticePhase::LatticePhase(const LatticePhase& right) : m_Pref(OneAtm), m_Pcurrent(OneAtm), m_speciesMolarVolume(0), m_site_density(0.0) { *this = right; } LatticePhase& LatticePhase::operator=(const LatticePhase& right) { if (&right != this) { ThermoPhase::operator=(right); m_Pref = right.m_Pref; m_Pcurrent = right.m_Pcurrent; m_h0_RT = right.m_h0_RT; m_cp0_R = right.m_cp0_R; m_g0_RT = right.m_g0_RT; m_s0_R = right.m_s0_R; m_vacancy = right.m_vacancy; m_speciesMolarVolume = right.m_speciesMolarVolume; m_site_density = right.m_site_density; } return *this; } LatticePhase::LatticePhase(const std::string& inputFile, const std::string& id_) { initThermoFile(inputFile, id_); } LatticePhase::LatticePhase(XML_Node& phaseRef, const std::string& id_) { importPhase(phaseRef, this); } ThermoPhase* LatticePhase::duplMyselfAsThermoPhase() const { return new LatticePhase(*this); } doublereal LatticePhase::enthalpy_mole() const { return RT() * mean_X(enthalpy_RT_ref()) + (pressure() - m_Pref)/molarDensity(); } doublereal LatticePhase::entropy_mole() const { return GasConstant * (mean_X(entropy_R_ref()) - sum_xlogx()); } doublereal LatticePhase::cp_mole() const { return GasConstant * mean_X(cp_R_ref()); } doublereal LatticePhase::cv_mole() const { return cp_mole(); } doublereal LatticePhase::calcDensity() { setMolarDensity(m_site_density); return meanMolecularWeight() * m_site_density; } void LatticePhase::setPressure(doublereal p) { m_Pcurrent = p; calcDensity(); } void LatticePhase::compositionChanged() { Phase::compositionChanged(); calcDensity(); } void LatticePhase::getActivityConcentrations(doublereal* c) const { getMoleFractions(c); } void LatticePhase::getActivityCoefficients(doublereal* ac) const { for (size_t k = 0; k < m_kk; k++) { ac[k] = 1.0; } } doublereal LatticePhase::standardConcentration(size_t k) const { return 1.0; } doublereal LatticePhase::logStandardConc(size_t k) const { return 0.0; } void LatticePhase::getChemPotentials(doublereal* mu) const { doublereal delta_p = m_Pcurrent - m_Pref; const vector_fp& g_RT = gibbs_RT_ref(); for (size_t k = 0; k < m_kk; k++) { double xx = std::max(SmallNumber, moleFraction(k)); mu[k] = RT() * (g_RT[k] + log(xx)) + delta_p * m_speciesMolarVolume[k]; } } void LatticePhase::getPartialMolarEnthalpies(doublereal* hbar) const { const vector_fp& _h = enthalpy_RT_ref(); scale(_h.begin(), _h.end(), hbar, RT()); } void LatticePhase::getPartialMolarEntropies(doublereal* sbar) const { const vector_fp& _s = entropy_R_ref(); for (size_t k = 0; k < m_kk; k++) { double xx = std::max(SmallNumber, moleFraction(k)); sbar[k] = GasConstant * (_s[k] - log(xx)); } } void LatticePhase::getPartialMolarCp(doublereal* cpbar) const { getCp_R(cpbar); for (size_t k = 0; k < m_kk; k++) { cpbar[k] *= GasConstant; } } void LatticePhase::getPartialMolarVolumes(doublereal* vbar) const { getStandardVolumes(vbar); } void LatticePhase::getStandardChemPotentials(doublereal* mu0) const { const vector_fp& gibbsrt = gibbs_RT_ref(); scale(gibbsrt.begin(), gibbsrt.end(), mu0, RT()); } void LatticePhase::getPureGibbs(doublereal* gpure) const { const vector_fp& gibbsrt = gibbs_RT_ref(); doublereal delta_p = (m_Pcurrent - m_Pref); for (size_t k = 0; k < m_kk; k++) { gpure[k] = RT() * gibbsrt[k] + delta_p * m_speciesMolarVolume[k]; } } void LatticePhase::getEnthalpy_RT(doublereal* hrt) const { const vector_fp& _h = enthalpy_RT_ref(); doublereal delta_prt = (m_Pcurrent - m_Pref) / RT(); for (size_t k = 0; k < m_kk; k++) { hrt[k] = _h[k] + delta_prt * m_speciesMolarVolume[k]; } } void LatticePhase::getEntropy_R(doublereal* sr) const { const vector_fp& _s = entropy_R_ref(); std::copy(_s.begin(), _s.end(), sr); } void LatticePhase::getGibbs_RT(doublereal* grt) const { const vector_fp& gibbsrt = gibbs_RT_ref(); doublereal delta_prt = (m_Pcurrent - m_Pref) / RT(); for (size_t k = 0; k < m_kk; k++) { grt[k] = gibbsrt[k] + delta_prt * m_speciesMolarVolume[k]; } } void LatticePhase::getGibbs_ref(doublereal* g) const { getGibbs_RT_ref(g); for (size_t k = 0; k < m_kk; k++) { g[k] *= RT(); } } void LatticePhase::getCp_R(doublereal* cpr) const { const vector_fp& _cpr = cp_R_ref(); std::copy(_cpr.begin(), _cpr.end(), cpr); } void LatticePhase::getStandardVolumes(doublereal* vbar) const { copy(m_speciesMolarVolume.begin(), m_speciesMolarVolume.end(), vbar); } const vector_fp& LatticePhase::enthalpy_RT_ref() const { _updateThermo(); return m_h0_RT; } const vector_fp& LatticePhase::gibbs_RT_ref() const { _updateThermo(); return m_g0_RT; } void LatticePhase::getGibbs_RT_ref(doublereal* grt) const { _updateThermo(); for (size_t k = 0; k < m_kk; k++) { grt[k] = m_g0_RT[k]; } } const vector_fp& LatticePhase::entropy_R_ref() const { _updateThermo(); return m_s0_R; } const vector_fp& LatticePhase::cp_R_ref() const { _updateThermo(); return m_cp0_R; } bool LatticePhase::addSpecies(shared_ptr spec) { bool added = ThermoPhase::addSpecies(spec); if (added) { if (m_kk == 1) { m_Pref = refPressure(); } m_h0_RT.push_back(0.0); m_g0_RT.push_back(0.0); m_cp0_R.push_back(0.0); m_s0_R.push_back(0.0); m_speciesMolarVolume.push_back(0.0); } return added; } void LatticePhase::initThermoXML(XML_Node& phaseNode, const std::string& id_) { if (!id_.empty() && id_ != phaseNode.id()) { throw CanteraError("LatticePhase::initThermoXML", "ids don't match"); } // Check on the thermo field. Must have: // if (phaseNode.hasChild("thermo")) { XML_Node& thNode = phaseNode.child("thermo"); std::string mString = thNode.attrib("model"); if (lowercase(mString) != "lattice") { throw CanteraError("LatticePhase::initThermoXML", "Unknown thermo model: " + mString); } } else { throw CanteraError("LatticePhase::initThermoXML", "Unspecified thermo model"); } // Now go get the molar volumes. use the default if not found XML_Node& speciesList = phaseNode.child("speciesArray"); XML_Node* speciesDB = get_XML_NameID("speciesData", speciesList["datasrc"], &phaseNode.root()); for (size_t k = 0; k < m_kk; k++) { m_speciesMolarVolume[k] = m_site_density; XML_Node* s = speciesDB->findByAttr("name", speciesName(k)); if (!s) { throw CanteraError(" LatticePhase::initThermoXML", "database problems"); } XML_Node* ss = s->findByName("standardState"); if (ss && ss->findByName("molarVolume")) { m_speciesMolarVolume[k] = getFloat(*ss, "molarVolume", "toSI"); } } // Call the base initThermo, which handles setting the initial state. ThermoPhase::initThermoXML(phaseNode, id_); } void LatticePhase::_updateThermo() const { doublereal tnow = temperature(); if (m_tlast != tnow) { m_spthermo->update(tnow, &m_cp0_R[0], &m_h0_RT[0], &m_s0_R[0]); m_tlast = tnow; for (size_t k = 0; k < m_kk; k++) { m_g0_RT[k] = m_h0_RT[k] - m_s0_R[k]; } m_tlast = tnow; } } void LatticePhase::setParameters(int n, doublereal* const c) { m_site_density = c[0]; setMolarDensity(m_site_density); } void LatticePhase::getParameters(int& n, doublereal* const c) const { c[0] = molarDensity(); n = 1; } void LatticePhase::setParametersFromXML(const XML_Node& eosdata) { eosdata._require("model", "Lattice"); m_site_density = getFloat(eosdata, "site_density", "toSI"); m_vacancy = getChildValue(eosdata, "vacancy_species"); } }