substance.hh

Go to the documentation of this file.

/*!
 *
 * Copyright (C) 2015 Technical University of Liberec.  All rights reserved.
 * 
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License version 3 as published by the
 * Free Software Foundation. (http://www.gnu.org/licenses/gpl-3.0.en.html)
 * 
 * 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 General Public License for more details.
 *
 * 
 * @file    substance.hh
 * @brief   Classes for storing substance data.
 * @author  Jan Stebel
 */
 
#ifndef SUBSTANCE_HH_
#define SUBSTANCE_HH_
 
 
 
 
#include "input/accessors.hh"
 
 
/**
 * Class Substance is a storage for data which are specific for a (chemical) substance.
 * The purpose is to easily share them among equations (e.g. between transport and reactions).
 */
class Substance {
 
public:
 
    /// Default constructor.
    Substance();
 
    /// Initialization from input tree.
    Substance(const Input::Record &in_rec);
 
    /// Getter for substance name.
    std::string name() const { return name_; }
 
    /// Getter for molar mass.
    double molar_mass() const { return molar_mass_; }
 
 
    /// Input type for a substance.
    static const Input::Type::Record & get_input_type();
 
protected:
 
    /// Name of a chemical substance.
    std::string name_;
 
    /// Molar mass [kg/mol] of the substance.
    double molar_mass_;
 
    friend class SubstanceList;
};
 
 
/**
 * SubstanceList is an envelope around a vector of substances, which provides
 * some additional functionality such as:
 * - various ways of initialization (fron JSON input, reference, or list of names)
 * - export of vector of names (required e.g. by some field classes)
 */
class SubstanceList {
 
public:
 
    /// Read from input array.
    void initialize(const Input::Array &in_array);
 
    /// Bind to existing list.
    void initialize(SubstanceList &list);
 
    /// Construct from a list of names.
    void initialize(const std::vector<std::string> &names);
 
    inline const Substance &operator[](unsigned int index) { return (*substances_)[index]; }
 
    inline const std::vector<std::string> &names() { return (*names_); }
 
    unsigned int size() const { return substances_->size(); }
 
private:
 
    /// The actual list of substances.
    std::shared_ptr<std::vector<Substance> > substances_;
 
    /// Auxiliary list of substance names used in some classes.
    std::shared_ptr<std::vector<std::string> > names_;
};
 
 
 
 
 
 
 
 
#endif // SUBSTANCE_HH_