FixedChemPotSSTP.cpp

Go to the documentation of this file.

/**
 *  @file FixedChemPotSSTP.cpp
 * Definition file for the FixedChemPotSSTP class, which represents a fixed-composition
 * incompressible substance with a constant chemical potential (see \ref thermoprops and
 * class \link Cantera::FixedChemPotSSTP FixedChemPotSSTP\endlink)
 */
 
// This file is part of Cantera. See License.txt in the top-level directory or
// at https://cantera.org/license.txt for license and copyright information.
 
#include "cantera/thermo/FixedChemPotSSTP.h"
#include "cantera/thermo/ThermoFactory.h"
#include "cantera/thermo/SpeciesThermoFactory.h"
#include "cantera/thermo/SpeciesThermoInterpType.h"
#include "cantera/base/ctml.h"
#include "cantera/base/stringUtils.h"
 
namespace Cantera
{
 
// ----  Constructors -------
 
FixedChemPotSSTP::FixedChemPotSSTP() :
    chemPot_(0.0)
{
    warn_deprecated("class FixedChemPotSSTP", "To be removed after Cantera 2.5. "
        "Use class StoichSubstance with a constant-cp species thermo model, "
        "with 'h0' set to the desired chemical potential and 's0' set to 0.");
}
 
FixedChemPotSSTP::FixedChemPotSSTP(const std::string& infile, const std::string& id_) :
    chemPot_(0.0)
{
    warn_deprecated("class FixedChemPotSSTP", "To be removed after Cantera 2.5. "
        "Use class StoichSubstance with a constant-cp species thermo model, "
        "with 'h0' set to the desired chemical potential and 's0' set to 0.");
    initThermoFile(infile, id_);
}
FixedChemPotSSTP::FixedChemPotSSTP(XML_Node& xmlphase, const std::string& id_) :
    chemPot_(0.0)
{
    warn_deprecated("class FixedChemPotSSTP", "To be removed after Cantera 2.5. "
        "Use class StoichSubstance with a constant-cp species thermo model, "
        "with 'h0' set to the desired chemical potential and 's0' set to 0.");
    importPhase(xmlphase, this);
}
 
FixedChemPotSSTP::FixedChemPotSSTP(const std::string& Ename, doublereal val) :
    chemPot_(0.0)
{
    warn_deprecated("class FixedChemPotSSTP", "To be removed after Cantera 2.5. "
        "Use class StoichSubstance with a constant-cp species thermo model, "
        "with 'h0' set to the desired chemical potential and 's0' set to 0.");
    std::string pname = Ename + "Fixed";
    setName(pname);
    setNDim(3);
    addElement(Ename);
    auto sp = make_shared<Species>(pname, parseCompString(Ename + ":1.0"));
    double c[4] = {298.15, val, 0.0, 0.0};
    shared_ptr<SpeciesThermoInterpType> stit(
            newSpeciesThermoInterpType("const_cp", 0.1, 1e30, OneAtm, c));
    sp->thermo = stit;
    addSpecies(sp);
    initThermo();
    m_p0 = OneAtm;
    m_tlast = 298.15;
    setChemicalPotential(val);
 
    // Create an XML_Node entry for this species
    XML_Node s("species", 0);
    s.addAttribute("name", pname);
    std::string aaS = Ename + ":1";
    s.addChild("atomArray", aaS);
    XML_Node& tt = s.addChild("thermo");
    XML_Node& ss = tt.addChild("Simple");
    ss.addAttribute("Pref", "1 bar");
    ss.addAttribute("Tmax", "5000.");
    ss.addAttribute("Tmin", "100.");
    ss.addChild("t0", "298.15");
    ss.addChild("cp0", "0.0");
    ss.addChild("h", fmt::format("{}", val));
    ss.addChild("s", "0.0");
    saveSpeciesData(0, &s);
}
 
// ----- Mechanical Equation of State ------
 
doublereal FixedChemPotSSTP::pressure() const
{
    return m_press;
}
 
void FixedChemPotSSTP::setPressure(doublereal p)
{
    m_press = p;
}
 
doublereal FixedChemPotSSTP::isothermalCompressibility() const
{
    return 0.0;
}
 
doublereal FixedChemPotSSTP::thermalExpansionCoeff() const
{
    return 0.0;
}
 
// ---- Chemical Potentials and Activities ----
 
Units FixedChemPotSSTP::standardConcentrationUnits() const
{
    return Units(1.0); // dimensionless
}
 
void FixedChemPotSSTP::getActivityConcentrations(doublereal* c) const
{
    c[0] = 1.0;
}
 
doublereal FixedChemPotSSTP::standardConcentration(size_t k) const
{
    return 1.0;
}
 
doublereal FixedChemPotSSTP::logStandardConc(size_t k) const
{
    return 0.0;
}
 
// ---- Partial Molar Properties of the Solution ----
 
void FixedChemPotSSTP::getPartialMolarVolumes(doublereal* vbar) const
{
    vbar[0] = 0.0;
}
 
// Properties of the Standard State of the Species in the Solution
 
void FixedChemPotSSTP::getStandardChemPotentials(doublereal* mu0) const
{
    mu0[0] = chemPot_;
}
 
void FixedChemPotSSTP::getEnthalpy_RT(doublereal* hrt) const
{
    hrt[0] = chemPot_ / RT();
}
 
void FixedChemPotSSTP::getEntropy_R(doublereal* sr) const
{
    sr[0] = 0.0;
}
 
void FixedChemPotSSTP::getGibbs_RT(doublereal* grt) const
{
    grt[0] = chemPot_ / RT();
}
 
void FixedChemPotSSTP::getCp_R(doublereal* cpr) const
{
    cpr[0] = 0.0;
}
 
void FixedChemPotSSTP::getIntEnergy_RT(doublereal* urt) const
{
    urt[0] = chemPot_;
}
 
void FixedChemPotSSTP::getStandardVolumes(doublereal* vbar) const
{
    vbar[0] = 0.0;
}
 
// ---- Thermodynamic Values for the Species Reference States ----
 
void FixedChemPotSSTP::getIntEnergy_RT_ref(doublereal* urt) const
{
    urt[0] = chemPot_;
}
 
void FixedChemPotSSTP::getEnthalpy_RT_ref(doublereal* hrt) const
{
    hrt[0] = chemPot_ / RT();
}
 
void FixedChemPotSSTP::getEntropy_R_ref(doublereal* sr) const
{
    sr[0] = 0.0;
}
 
void FixedChemPotSSTP::getGibbs_RT_ref(doublereal* grt) const
{
    grt[0] = chemPot_ / RT();
}
 
void FixedChemPotSSTP::getGibbs_ref(doublereal* g) const
{
    g[0] = chemPot_;
}
 
void FixedChemPotSSTP::getCp_R_ref(doublereal* cpr) const
{
    cpr[0] = 0.0;
}
 
// ---- Initialization and Internal functions
 
void FixedChemPotSSTP::initThermoXML(XML_Node& phaseNode, const std::string& id_)
{
    // Find the Thermo XML node
    if (!phaseNode.hasChild("thermo")) {
        throw CanteraError("FixedChemPotSSTP::initThermoXML", "no thermo XML node");
    }
    XML_Node& tnode = phaseNode.child("thermo");
    std::string model = tnode["model"];
    if (model != "StoichSubstance" && model != "FixedChemPot" && model != "StoichSubstanceSSTP") {
        throw CanteraError("FixedChemPotSSTP::initThermoXML",
                           "thermo model attribute must be FixedChemPot or StoichSubstance or StoichSubstanceSSTP");
    }
 
    SingleSpeciesTP::initThermoXML(phaseNode, id_);
    if (model == "FixedChemPot") {
        double val = getFloat(tnode, "chemicalPotential", "toSI");
        chemPot_ = val;
    } else {
        _updateThermo();
        chemPot_ = (m_h0_RT - m_s0_R) * RT();
    }
}
 
void FixedChemPotSSTP::initThermo()
{
    if (m_input.hasKey("chemical-potential")) {
        chemPot_ = m_input.convert("chemical-potential", "J/kmol");
    }
    SingleSpeciesTP::initThermo();
}
 
void FixedChemPotSSTP::setParameters(int n, doublereal* const c)
{
    chemPot_ = c[0];
}
 
void FixedChemPotSSTP::getParameters(int& n, doublereal* const c) const
{
    n = 1;
    c[0] = chemPot_;
}
 
void FixedChemPotSSTP::setParametersFromXML(const XML_Node& eosdata)
{
    std::string model = eosdata["model"];
    if (model != "StoichSubstance" && model != "FixedChemPot" && model != "StoichSubstanceSSTP") {
        throw CanteraError("FixedChemPotSSTP::setParametersFromXML",
                           "thermo model attribute must be FixedChemPot or StoichSubstance or StoichSubstanceSSTP");
    }
    if (model == "FixedChemPotSSTP") {
        doublereal val = getFloat(eosdata, "chemicalPotential", "toSI");
        chemPot_ = val;
    }
}
 
void FixedChemPotSSTP::setChemicalPotential(doublereal chemPot)
{
    chemPot_ = chemPot;
}
 
}