PHREEQC-BASIC

sys(<str:element>)


sys(<str:element>,<txt:count>,<txt:names$>,<txt:type$>,<txt:moles>)

MY-BASIC

sys(<str:element>)


sys(<str:element>,<str:count>,<str:names$>,<str:type$>,<str:moles>)



One argument: it returns the number of moles of the element in all phases.


Arguments


element

Element name


Return value: real


Five argument: it returns the number of moles of the element in all phases, except the first argument is one of following strings:

"elements","phases","aq","equi","ex","kin","surf","s_s","gas"

In addition, it returns three vectors with names defined in names$; type$ and moles, each having the dimension of the integer returned with the name count 


Return value: real, an integer value in variable count, two string-vectors in variables names$ and type$, and one real-vector in moles.


Arguments


element

element name - returns the number of moles of the element in all phases


or, in addition for the five argument variant, one of the following strings for special return values:


"elements" - returns the number of moles of elements (not H and O) in aqueous, exchange and surface species.

"phases"   - returns the maximum saturation index for all phases

"aq"          - returns the sum of all moles of all aqueous species

"equi"       - returns the sum of moles of all equilibrium phases

"ex"          - returns the sum of all moles of all exchange species

"kin"         - returns the sum of moles of all kinetic reactants

"surf"       - returns the sum of all moles of all surface species

"s_s"        - returns the sum of moles of all solid solution components

"gas"        - returns the sum of moles of all gas components

count

variable name containing the number of species, phases, components etc.

names$

variable name of a vector with strings of length count containing the names of species, phases, components etc.

types$

variable name of a vector with strings of length count containing the types of species, phases, components etc.

moles

variable name of a vector with reals of length count containing the number of moles of species, phases, components etc.


Following table gives the details on the information in the vectors

Return value

Count

names$

types$

moles

Element name

 the number of moles of the element in all phases

number of species for the element

name of the species

species type:

"aq" for dissolved species

"ex" for exchange

"equi" for equilibrium phase

"surface" for surface species

"ex" for exchange species

"s_s" for solid_solution

"gas" for gas phase

"diff" for surface diffuse layer 

the number of moles of the species

"elements"

the number of moles of elements (not H and O) in aqueous, exchange and surface species

number of elements, valence states, exchangers and surfaces

element name

element type:

"dis" for dissolved

"ex" for exchange

"surf" for surface

the number of moles of the elements in each type of phase

"phases"

maximum saturation index for all phases

number of pure phases

phase names (defined by PHASES)

"phase"

saturation index of the phase

"aq"

the sum of all moles of all aqueous species

number of aqueous species

aqueous phase name

"aq"

moles of species

"equi"

the sum of moles of all equilibrium phases

number of equilibrium phases

equilibrium phase name

"equi"

moles of equilibrium phases

"ex"

the sum of all moles of all exchange species

number of exchange species

exchange species name 

'"ex"

moles of species

"kin"

the sum of moles of all kinetic reactants

number of kinetic reactants

kinetic reactant name

"kin"

moles of kinetic reactant

"surf"

the sum of all moles of all surface species

number of surface species

surface species name

"surf"

moles of species

"s_s"

the sum of moles of all solid solution components

number of solid solution components

names of the solid solution component

"s_s"

moles of solid solution component

"gas"

the sum of moles of all gas components

number of gas components

gas component name

"gas"

moles of gas component



Examples

       First argument is "elements" - Print total moles in system, aqueous phase and solid phase for (primary) components - See string.format

How to

Change transport properties - Porosity (scaling factor of water content)