Struct feos_core::StateBuilder

pub struct StateBuilder<'a, U: EosUnit, E: EquationOfState> { /* private fields */ }

A simple tool to construct States with arbitrary input parameters.

Examples

// Create a state for given T,V,N
let eos = Rc::new(PengRobinson::new(Rc::new(PengRobinsonParameters::new_simple(&[369.8], &[41.9 * 1e5], &[0.15], &[15.0])?)));
let state = StateBuilder::new(&eos)
                .temperature(300.0 * KELVIN)
                .volume(12.5 * METER.powi(3))
                .moles(&(arr1(&[2.5]) * MOL))
                .build()?;
assert_eq!(state.density, 0.2 * MOL / METER.powi(3));

// For a pure component, the composition does not need to be specified.
let eos = Rc::new(PengRobinson::new(Rc::new(PengRobinsonParameters::new_simple(&[369.8], &[41.9 * 1e5], &[0.15], &[15.0])?)));
let state = StateBuilder::new(&eos)
                .temperature(300.0 * KELVIN)
                .volume(12.5 * METER.powi(3))
                .total_moles(2.5 * MOL)
                .build()?;
assert_eq!(state.density, 0.2 * MOL / METER.powi(3));

// The state can be constructed without providing any extensive property.
let eos = Rc::new(PengRobinson::new(
    Rc::new(PengRobinsonParameters::new_simple(
        &[369.8, 305.4],
        &[41.9 * 1e5, 48.2 * 1e5],
        &[0.15, 0.10],
        &[15.0, 30.0]
    )?)
));
let state = StateBuilder::new(&eos)
                .temperature(300.0 * KELVIN)
                .partial_density(&(arr1(&[0.2, 0.6]) * MOL / METER.powi(3)))
                .build()?;
assert_relative_eq!(state.molefracs, arr1(&[0.25, 0.75]));
assert_relative_eq!(state.density, 0.8 * MOL / METER.powi(3));

Implementations

impl<'a, U: EosUnit, E: EquationOfState> StateBuilder<'a, U, E>

pub fn new(eos: &Rc<E>) -> Self

Create a new StateBuilder for the given equation of state.

pub fn temperature(self, temperature: QuantityScalar<U>) -> Self

Provide the temperature for the new state.

pub fn volume(self, volume: QuantityScalar<U>) -> Self

Provide the volume for the new state.

pub fn density(self, density: QuantityScalar<U>) -> Self

Provide the density for the new state.

pub fn partial_density(self, partial_density: &'a QuantityArray1<U>) -> Self

Provide partial densities for the new state.

pub fn total_moles(self, total_moles: QuantityScalar<U>) -> Self

Provide the total moles for the new state.

pub fn moles(self, moles: &'a QuantityArray1<U>) -> Self

Provide the moles for the new state.

pub fn molefracs(self, molefracs: &'a Array1<f64>) -> Self

Provide the molefracs for the new state.

pub fn pressure(self, pressure: QuantityScalar<U>) -> Self

Provide the pressure for the new state.

pub fn molar_enthalpy(self, molar_enthalpy: QuantityScalar<U>) -> Self

Provide the molar enthalpy for the new state.

pub fn molar_entropy(self, molar_entropy: QuantityScalar<U>) -> Self

Provide the molar entropy for the new state.

pub fn molar_internal_energy(
    self,
    molar_internal_energy: QuantityScalar<U>
) -> Self

Provide the molar internal energy for the new state.

pub fn vapor(self) -> Self

Specify a vapor state.

pub fn liquid(self) -> Self

Specify a liquid state.

pub fn initial_density(self, initial_density: QuantityScalar<U>) -> Self

Provide an initial density used in density iterations.

pub fn initial_temperature(self, initial_temperature: QuantityScalar<U>) -> Self

Provide an initial temperature used in the Newton solver.

pub fn build(self) -> EosResult<State<U, E>>

Try to build the state with the given inputs.

Trait Implementations

impl<'a, U: EosUnit, E: EquationOfState> Clone for StateBuilder<'a, U, E>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.