This keyword data block is used to specify the information needed for an inverse modeling calculation. Inverse modeling attempts to determine sets of mole transfers of phases that account for changes in water chemistry between one or a mixture of initial water compositions and a final water composition. Isotope mole balance, but not isotope fractionation, can be included in the calculations. The data block includes definition of the solutions, phases, and uncertainty limits used in the calculations.
Line 0: INVERSE_MODELING 1 Line 1: -solutions 10 3 5 Line 2: -uncertainty 0.02 0.04 Line 3: -phases Line 4a: Calcite force pre 13C -1.0 1 Line 4b: Anhydrite force dis 34S 13.5 2 Line 4c: CaX2 Line 4d: NaX Line 5: -balances Line 6a pH 0.1 Line 6b: Ca 0.01 -0.005 Line 6c: Alkalinity -1.0e-6 Line 6d: Fe 0.05 0.1 0.2 Line 7: -isotopes Line 8a: 13C 0.05 0.1 0.05 Line 8b: 34S 1.0 Line 9: -range 10000 Line 10: -minimal Line 11: -tolerance 1e-10 Line 12: -force_solutions true false Line 13: -uncertainty_water 0.55 # moles (~1%) Line 14: -mineral_water false
Line 0: INVERSE_MODELING [ number ] [ description ]
INVERSE_MODELING is the keyword for the data block.
number --Positive number to designate the following inverse-modeling definition. Default is 1.
description --Optional comment that describes the inverse-modeling calculation.
Line 1: -solutions , list of solution numbers
-solutions--Identifier that indicates a list of solution numbers follows on the same line. Optionally, sol, or -s[ olutions]. Note the hyphen is required to avoid conflict with the keyword SOLUTION.
list of solution numbers --List of solution numbers to use in mole-balance calculations. At least two solution numbers are required and these solutions must be defined by SOLUTION input or by SAVE after a batch-reaction calculation in the current or previous simulations. The final solution number is listed last, all but the final solution are termed "initial solutions". If more than one initial solution is listed, the initial solutions are assumed to mix to form the final solution. The mixing proportions of the initial solutions are calculated in the modeling process. In the example data block (line 1), solution 5 is to be made by mixing solutions 10 and 3 in combination with phase mole transfers.
Line 2: -uncertainty , list of uncertainty limits
-uncertainty--Identifier that indicates a list of default uncertainty limits for each solution follows on the same line. The uncertainty limits defined with -uncertainty do not apply to pH; default for pH is 0.05 pH units and may be changed with the -balances identifier. If -uncertainty is not entered, the program uses 0.05. The default uncertainty limits can be overridden for individual elements or element valence states using -balances identifier. Optionally, uncertainty, uncertainties, -u[ ncertainty], or -u[ ncertainties].
list of uncertainty limits --List of default uncertainty limits that are applied to each solution in the order given by -solutions. The first uncertainty limit in the list is applied to all the element and element valence states in the first solution listed in -solutions. The second uncertainty limit in the list is applied to all the element and element valence states in the second solution listed in -solutions and so on. If fewer uncertainty limits are entered than the number of solutions, the final uncertainty limit in the list is used for the remaining solutions. Thus, if only one uncertainty limit is entered, it is applied to all solutions. The uncertainty limit may have two forms: (1) if the uncertainty limit is positive, it is interpreted as a fraction to be used to calculate the uncertainty limit for each element or element valence state; a value of 0.02 indicates an uncertainty limit of 2 percent of the moles of each element in solution will be used, and (2) if the uncertainty limit is negative, it is interpreted as an absolute value in moles to use for each mole-balance constraint. The second form is rarely used in -uncertainty input. In this example data block, the default uncertainty limit for the first solution is set to 0.02, which indicates that the concentration of each element in the first solution (solution 10) is allowed to vary up to plus or minus 2 percent, and a default uncertainty limit of 4 percent will be applied to each element and valence state in the second solution (solution 3) and all remaining solutions (solution 5 in this case).
-phases--Identifier that indicates a list of phases to be used in inverse modeling follows on succeeding lines. Optionally, phase, phase_data, -p[ hases], or -p[ hase_data]. Note the hyphen is required in -phases to avoid conflict with the keyword PHASES.
Line 4: phase name [ force] [ (dissolve or precipitate)] [ list of isotope name, isotope ratio, isotope uncertainty limit ]
phase name --Name of a phase to be used in inverse modeling. The phase must be defined in PHASES input or it must be a charge-balanced exchange species defined in EXCHANGE_SPECIES input. Any phases and exchange species defined in the database file or in the current or previous simulations are available for inverse modeling. Only the chemical reaction in PHASES or EXCHANGE_SPECIES input is important; the log K is not used in inverse-modeling calculations.
force--The phase is included ("forced") to be in the range calculation (see line 9) whether or not the phase mole transfer is nonzero. This will give another degree of freedom to the range calculation for models that do not include the phase and the resulting range of mole transfers may be larger. The order of this option following the phase name is not important. Optionally, f[ orce].
dissolve or precipitate--The phase may be constrained only to enter the aqueous phase, " dissolve", or leave the aqueous phase, " precipitate". Any set of initial letters from these two words are sufficient to define a constraint.
list of isotope name , isotope ratio , isotope uncertainty limit --Isotopic information for the phase may be defined for one or more isotopes by appending (to line 4) triplets of isotope name , isotope ratio , isotope uncertainty limit .
isotope name --Isotope name written with mass number first followed by element name with no intervening spaces.
isotope ratio --Isotope ratio for this isotope of this element ( isotope name ) in the phase, frequently permil, but percent or other units can be used. Units must be consistent with the units in which this isotope of the element is defined in SOLUTION input.
isotope uncertainty --Uncertainty limit for isotope ratio in the phase. Units must be consistent with the units for isotope ratio and units in which this isotope of this element is defined in SOLUTION input.
-balances--Identifier that indicates a list of element or element-valence-state name follow on succeeding lines. Optionally, bal, balance, balances, or -b[ alances].
Line 6: element or valence state name [ list of uncertainty limits ]
element or valence state name --Name of an element or element valence state to be included as a mole-balance constraint in inverse modeling. The identifier -balances is used for two purposes: (1) to include mole-balance equations for elements not contained in any of the phases ( -phases) and (2) to override the uncertainty limits defined with -uncertainty (or the default uncertainty limits) for elements, element valences states, or pH. Mole-balance equations for all elements that are found in the phases of -phases input are automatically included in inverse modeling with the default uncertainty limits defined by the -uncertainties identifier; mole-balance equations for all valence states of redox elements are included if the element is in any of the phases of -phases.
list of uncertainty limits --List of uncertainty limits for the specified element or element valence-state constraint. It is possible to input an uncertainty limit for element or valence state name for each solution used in inverse modeling (as defined by -solutions). If fewer uncertainty limits are entered than the number of solutions, the final uncertainty limit in the list is used for the remaining solutions. Thus, if only one uncertainty limit is entered, it is used for the given element or element valence state for all solutions. The uncertainty limit for pH must be given in standard units. Thus, the uncertainty limit in pH given on line 6a is 0.1 pH units for all solutions. The uncertainty limits for elements and element valence states (but not for pH) may have two forms: (1) if the uncertainty limit is positive, it is interpreted as a fraction that when multiplied times the moles in solution gives the uncertainty limit in moles. A value of 0.02 would indicate an uncertainty limit of 2 percent of the moles in solution; and (2) if the uncertainty limit is negative, it is interpreted as an absolute value in moles to use for the solution in the mole-balance equation for element or valence state name . In the example data block, line 6b, the uncertainty limit for calcium in solution 10 is 1 percent of the moles of calcium in solution 10. The uncertainty limit for calcium in solution 3 and 5 is 0.005 moles. The uncertainty limit for iron (line 6d) is 5 percent in solution 10, 10 percent in solution 3, and 20 percent in solution 5.
-isotopes--Identifier that specifies mole balance for the isotopes listed on succeeding lines will be included in the calculation. Optionally, isotopes or -i[ sotopes].
Line 8: isotope_name, list of uncertainty limits
isotope_name --Name of an isotope for which mole balance is desired. The name must be written with mass number first followed by element name or redox state with no intervening spaces.
list of uncertainty limits --List of uncertainty limits for the specified isotope for the solutions used in inverse modeling (as defined by -solutions). If fewer uncertainty limits are entered than the number of solutions, the final uncertainty limit in the list is used for the remaining solutions. Thus, if only one uncertainty limit is entered, it is used for the given isotope for all solutions. In the example data block, the uncertainty limit for carbon-13 (line 8a) is 0.05 permil in solution 10, 0.1 permil in solution 3, and 0.05 permil in solution 5. The uncertainty limit for sulfur-34 (line 8b) is 1 permil in all solutions. Units of the uncertainty limits for an isotope must be consistent with units used to define the isotope in SOLUTION input and with the units used to define isotope values under the -phases identifier (line 4).
-range--Identifier that specifies that ranges in mole transfer for each phase in each model should be calculated. The range in mole transfer for a phase is the minimum and maximum mole transfers that can be attained for a given inverse model by varying element concentrations within their uncertainty limits. The calculation of these ranges is time consuming, but provides valuable information. In the interest of expediency, it is suggested that models are first identified without using the -range identifier and the mole transfers checked for plausibility and geochemical consistency with any additional information such as saturation indices, isotopic compositions, and mineral textures; then the calculation is rerun with the -range identifier. Any phase with the force option will be included for each range calculation even if the inverse model does not contain this phase. Optionally, range, ranges, or -r[ anges].
maximum --The maximum value for the range is calculated by minimizing the difference between the value of maximum and the calculated mole transfer of the phase or the solution fraction. The minimum value of the range is calculated by minimizing the difference between the negative of the value of maximum and the calculated mole transfer of the phase or the solution fraction. In some evaporation problems, the solution fraction could be greater than 1000 (over 1000-fold evaporative concentration). In these problems, the default value is not large enough and a larger value of maximum should be entered. Default is 1000.
-minimal--Identifier that specifies that models be reduced to the minimum number of phases that can satisfy all of the constraints within the specified uncertainty limits. Note that two minimal models may have different numbers of phases; minimal models imply that no model with any proper subset of phases and solutions could be found. The -minimal identifier minimizes the number of calculations that will be performed and produces the models that contain the most essential geochemical reactions. However, models that are not minimal may also be of interest, so the use of this option is left to the discretion of the user. In the interest of expediency, it is suggested that models are first identified using the -minimal identifier, checked for plausibility and geochemical consistency, and then rerun without the -minimal identifier. Optionally, minimal, minimum, -m[ inimal], or -m[ inimum].
-tolerance--Identifier that indicates a tolerance for the optimizing solver is to be given. Optionally, tolerance or -t[ olerance].
tol --Tolerance used by the optimizing solver. The value of tol should be greater than the greatest calculated mole transfer or solution fraction multiplied by 1e-15. The default value is adequate unless very large mole transfers (greater than 1000 moles) or solution fractions (greater than 1000-fold evaporative concentration) occur. In these cases, a larger value of tol may be needed. Essentially, a value less than tol is treated as zero. Thus, the value of tol should not be too large or significantly different concentrations will be treated as equal. Uncertainty limits less than tol are assumed to be zero. Default is approximately 1e-10 for default compilation, but may be smaller if the program is compiled using long double precision.
Line 12: -force_solutions list of ( True or False )
-force_solutions--Identifier that indicates one or more solutions will be forced to be included in all range calculations. Optionally, force_solution, force_solutions, or -force_[ solutions].
list of ( True or False )-- True values include initial solutions in all range calculations. It is possible to input a True or False value for each initial solution used in inverse modeling. If fewer values are entered than the number of initial solutions ( -solutions identifier), then the final value in the list is used for the remaining initial solutions. Thus, if only one True or False value is entered, it is used for all initial solutions. In the example data block (line 12), solution 10 will be included in all range calculations for all models; even if a model does not include solution 10 (mixing fraction of zero), the range calculation will allow for nonzero mixing fractions of solution 10 in calculating the minimum and maximum mole transfers of phases. Solutions 3 and 5 will be included in range calculations only for models that have a nonzero mixing fractions for these solutions.
Line 13: -uncertainty_water moles
-uncertainty_water--Identifier for uncertainty term in the water-balance equation. For completeness in the formulation of inverse modeling, an uncertainty term can be added to the water balance equation. The sum of the moles of water derived from each initial solution must balance the moles of water in the final solution plus or minus moles of water. Optionally, uncertainty_water, u_water, -uncertainty_[ water], or -u_[ water].
moles --Uncertainty term for the water-balance equation. Default is 0.0.
Line 14: -mineral_water [( True or False )]
-mineral_water--Identifier to include or exclude water derived from minerals in the water-balance equation. Normally, water from minerals should be included in the water-balance equation. Sometimes unreasonable models are generated that create all the water in solution by dissolution and precipitation of minerals. Setting -mineral_water to False removes the terms for water derived from minerals from the water-balance equation, which eliminates these unreasonable models. However, removing these terms may introduce errors in some models by ignoring water derived from minerals (for example water from dissolution of gypsum) that should be considered in the water-balance equation. Optionally, mineral_water or -mine[ ral_water].
( True or False )-- True includes terms for water derived from minerals in the water-balance equation, False excludes these terms from the equation. Default is True.
Writing of inverse models to the output file can be enabled or disabled with the -inverse identifier in the PRINT data block. Inverse models can be written to the selected-output file by including the -inverse identifier in the SELECTED_OUTPUT data block. For each model that is found the following values are written to the selected-output file: (1) the sum of residuals, sum of each residual divided by its uncertainty limit, and the maximum fractional error, (2) for each solution--the mixing fraction, minimum mixing fraction, and maximum mixing fraction, and (3) for each phase in the list of phases ( -phase identifier)--the mole transfer, minimum mole transfer, and maximum mole transfer. Mixing fractions and mole transfers are zero for solutions and phases not included in the model. Minimum and maximum values are 0.0 unless the -range calculation is performed. The result of printing to the selected-output file is columns of numbers, where each row represents a mole-balance model.
The numerical method for inverse modeling requires consideration of the uncertainties related to aqueous concentrations. Uncertainties related to mineral compositions may be equally important, but are not automatically considered. To consider uncertainties in mineral compositions, it is possible to include two (or more) phases (under -phases identifier and definitions in PHASES data block) that represent end-member compositions for minerals. The inverse modeling calculation will attempt to find models considering the entire range of mineral composition. Usually, each model that is found will include only one or the other of the end-members, but any mixture of inverse models, which in this case would represent mixtures of the end members, is also a valid inverse model.
The possibility of evaporation or dilution can be included in inverse modeling by including water as one of the phases under the -phases identifier [ H2O(g) for databases distributed with program]. The mole transfer of this phase will affect only the water-balance equation. If the mole transfer is positive, dilution is simulated; if negative, evaporation is simulated (see example 17 in "Examples").
If -uncertainty is not included, a default uncertainty limit of 0.05 (5 percent) is used for elements and 0.05 for pH. Default uncertainty limits, specified by -uncertainty, will almost always be specified as positive numbers, indicating fractional uncertainty limits. A default uncertainty limit specified by a negative number, indicating a fixed molal uncertainty limit for all elements in solution, is usually not reasonable because of wide ranges in concentrations among elements present in solution.
No mole-balance equation is used for pH and the uncertainty limit in pH only affects the mole balance on alkalinity. Alkalinity is assumed to co-vary with pH and carbon and an equation relating the uncertainty term for alkalinity and the uncertainty terms for pH and carbon is included in the inverse model (see "Equations and Numerical Methods for Inverse Modeling").
All phase names and phase stoichiometries must be defined through PHASES or EXCHANGE_SPECIES input. Line 4c and 4d are included to allow ion-exchange reactions in the inverse model; exchange species with the names CaX 2 and NaX are among the exchange species defined in the default database and are thus available for use in inverse modeling. In the example data block and in the examples problems (16, 17, and 18), the composition of the phases is assumed to be relatively simple. In real systems, the composition of reactive phases--for example pyroxenes, amphiboles, or alumino-silicate glasses--may be complex. Application of inverse modeling in these systems will require knowledge of specific mineral compositions or appropriate simplification of the mineral stoichiometries.
By default, mole-balance equations for every element that occurs in the phases listed in -phases input are included in the inverse-modeling formulation. If an element is redox active, then mole-balance equations for all valence states of that element are included. The -balances identifier is necessary to define (1) uncertainty limits for pH, elements, or element valence states that are different from the default uncertainty limits or (2) mole-balance equations for elements not included in the phases. Mole-balance equations for alkalinity and electrons are always included in the inverse model. In some solutions, such as pure water or pure sodium chloride solutions, the alkalinity may be small (less than 1e-7) in both initial and final solutions. In this case, it may be necessary to use large (relative to 1e-7 equivalents) uncertainty limits (+1.0 or -1e-6) to obtain a mole balance on alkalinity. For most natural waters, alkalinity will not be small in both solutions and special handling of the alkalinity uncertainty will not be necessary (note alkalinity is a negative number in acid solutions). Uncertainty limits for electrons are never used because it is always assumed that no free electrons exist in an aqueous solution.
If isotope mole balances are used, then (1) isotopic values for the aqueous phases must be defined through the SOLUTION data block, (2) the -isotopes identifier must be used in the INVERSE_MODELING data block to specify the isotopes for which mole balances are desired and, optionally, the uncertainty limits in isotopic values associated with each solution, and (3) for each phase listed below the -phases identifier of the INVERSE_MODELING data block, isotopic values and uncertainty limits must be defined for each isotope that is contained in the phase. In addition, each phase that contains isotopes must be constrained either to dissolve or to precipitate. Default uncertainty limits for isotopes are given in table 5.
The options -minimal and -range affect the speed of the calculations. The fastest calculation is one that includes the -minimal identifier and does not include -range. The slowest calculation is one that does not include -minimal and does include -range.
The force option for a phase in -phases and the -force_solutions identifier affects only the range calculation; it does not affect the number of models that are found. When the -range identifier is specified and a model is found by the numerical method, then the model is augmented by any phase for which force is specified and by any solution for which -force_solutions is true; the range calculation is performed with the augmented model. The effect of these options is to calculate wider ranges for mole transfers for some models. If every phase and every solution were forced to be in the range calculation, then the results of the range calculation would be the same for every model and the results would be the maximum possible ranges of mole transfer for any models that could be derived from the given set of solutions and phases.
EXCHANGE_SPECIES, PHASES, PRINT, SELECTED_OUTPUT, SOLUTION, and SAVE.