/** * @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). */ // This file is part of Cantera. See License.txt in the top-level directory or // at http://www.cantera.org/license.txt for license and copyright information. #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 std::string& inputFile, const std::string& id_) { initThermoFile(inputFile, id_); } LatticePhase::LatticePhase(XML_Node& phaseRef, const std::string& id_) { importPhase(phaseRef, 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); double mv = 1.0 / m_site_density; if (spec->input.hasKey("equation-of-state")) { auto& eos = spec->input["equation-of-state"].as(); if (eos.getString("model", "") != "constant-volume") { throw CanteraError("LatticePhase::initThermo", "lattice model requires constant-volume species model " "for species '{}'", spec->name); } if (eos.hasKey("density")) { mv = molecularWeight(m_kk-1) / eos.convert("density", "kg/m^3"); } else if (eos.hasKey("molar-density")) { mv = 1.0 / eos.convert("molar-density", "kmol/m^3"); } else if (eos.hasKey("molar-volume")) { mv = eos.convert("molar-volume", "m^3/kmol"); } } else if (spec->extra.hasKey("molar_volume")) { // from XML mv = spec->extra["molar_volume"].asDouble(); } m_speciesMolarVolume.push_back(mv); } return added; } void LatticePhase::setSiteDensity(double sitedens) { m_site_density = sitedens; for (size_t k = 0; k < m_kk; k++) { if (species(k)->extra.hasKey("molar_volume")) { continue; } else if (species(k)->input.hasKey("equation-of-state")) { auto& eos = species(k)->input["equation-of-state"]; if (eos.hasKey("molar-volume") || eos.hasKey("density") || eos.hasKey("molar-density")) { continue; } } m_speciesMolarVolume[k] = 1.0 / m_site_density; } } 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::initThermo() { if (m_input.hasKey("site-density")) { setSiteDensity(m_input.convert("site-density", "kmol/m^3")); } } void LatticePhase::setParametersFromXML(const XML_Node& eosdata) { eosdata._require("model", "Lattice"); setSiteDensity(getFloat(eosdata, "site_density", "toSI")); } }