| Next|| Previous || Top |

PRINT

This keyword data block is used to select which results are written to the output file. Fourteen blocks of calculation results may be included or excluded in the output file for each simulation. In addition, this data block allows the following to be enabled or disabled: writing of results to the selected-output file and writing a status line to the screen that monitors the type of calculation being performed.

Example data block

Line 0:  PRINT 
Line 1:       -reset                false
Line 2:       -eh                   true
Line 3:       -equilibrium_phases   true
Line 4:       -exchange             true
Line 5:       -gas_phase            true
Line 6:       -headings             true
Line 7:       -inverse              true
Line 8:       -kinetics             true
Line 9:       -other                true
Line 10:      -saturation_indices   true
Line 11:      -solid_solutions      true
Line 12:      -species              true
Line 13:      -surface              true
Line 14:      -totals               true
Line 15:      -user_print           true
Line 16:      -selected_output      false
Line 17:      -status               false

Explanation

Line 0: PRINT

Keyword for the data block. No other data are input on the keyword line.

Line 1: -reset [( True or False )]

-reset--Changes all print options listed on lines 2 through 15 to true or false. If used, this identifier should be the first identifier of the data block. Individual print options may follow. Default is true. Optionally, reset or -r[ eset].

( True or False )-- True causes all data blocks on lines 2 through 15 to be printed to the output file; false causes all these data blocks to be excluded from the output file. Optionally, t[ rue] or f[ alse], case independent.

Line 2: -eh [( True or False )]

-eh--Prints eh values derived from redox couples in initial solution calculations if value is true, excludes print if value is false. Default is true. Optionally, eh.

Line 3: -equilibrium_phases [( True or False )]

-equilibrium_phases--Prints composition of the pure-phase assemblage if value is true, excludes print if value is false. Default is true. Optionally, equilibria, equilibrium, pure, -eq[ uilibrium_phases], -eq[ uilibria], -p[ ure_phases], or -p[ ure]. Note the hyphen is required to avoid a conflict with the keyword EQUILIBRIUM_PHASES; the same is true for the synonym PURE_PHASES.

Line 4: -exchange [( True or False )]

-exchange--Prints composition of the exchange assemblage if value is true, excludes print if value is false. Default is true. Optionally, -ex[ change]. Note the hyphen is required to avoid a conflict with the keyword EXCHANGE.

Line 5: -gas_phase [( True or False )]

-gas_phase--Prints composition of the gas phase if value is true, excludes print if value is false. Default is true. Optionally, -g[ as_phase]. Note the hyphen is required to avoid a conflict with the keyword GAS_PHASE.

Line 6: -headings [( True or False )]

-headings--Prints title and headings that identify the beginning of each type of calculation if value is true, excludes print if value is false. Default is true. Optionally, heading, headings, or -h[ eadings].

Line 7: -inverse_modeling [( True or False )]

-inverse_modeling--Prints results of inverse modeling if value is true, excludes print if value is false. Default is true. Optionally, inverse, or -i[ nverse_modeling]. Note the hyphen is required to avoid a conflict with the keyword INVERSE_MODELING.

Line 8: -kinetics [( True or False )]

-kinetics--Prints information about kinetic reactants if value is true, excludes print if value is false. Default is true. Optionally, -k[ inetics]. Note the hyphen is required to avoid a conflict with the keyword KINETICS.

Line 9: -other [( True or False )]

-other--Controls all printing to the output file not controlled by any of the other identifiers, including lines that identify the solution or mixture, exchange assemblage, solid-solution assemblage, surface assemblage, pure-phase assemblage, kinetic reaction, and gas phase to be used in each calculation; and description of the stoichiometric reaction. Default is true. Optionally, other, -o[ ther], use, or -u[ se].

Line 10: -saturation_indices [( True or False )]

-saturation_indices--Prints saturation indices for each phase for which a saturation index can be calculated if value is true, excludes print if value is false. Default is true. Optionally, -si, si, saturation_indices, or -sa[ turation_indices].

Line 11: -solid_solutions [( True or False )]

-solid_solutions--Prints compositions of solid solutions if value is true, excludes print if value is false. Default is true. Optionally, -so[ lid_solutions]. Note the hyphen is required to avoid a conflict with the keyword SOLID_SOLUTIONS.

Line 12: -species [( True or False )]

-species--Prints the distribution of aqueous species, including molality, activity, and activity coefficient, if value is true, excludes print if value is false. Default is true. Optionally, species or -sp[ ecies].

Line 13: -surface [( True or False )]

-surface--Prints composition of the surface assemblage if true, excludes print if false. Default is true. Optionally, -su[ rface]. Note the hyphen is required to avoid a conflict with the keyword SURFACE.

Line 14: -totals [( True or False )]

-totals--Prints the total molalities of elements (or element valence states in initial solutions), pH, pe, temperature, and other solution characteristics if true, excludes print if false. Note printing of molalities and other properties of all of the aqueous species is controlled by the -species identifier. Default is true. Optionally, totals or -t[ otals].

Line 15: -user_print [( True or False )]

-user_print--Controls writing of information defined in USER_PRINT to the output file. When set to false, information defined in USER_PRINT will not be written to the output file. Default is true. Optionally, -user[ _print]. Note the hyphen is required to avoid a conflict with the keyword USER_PRINT.

Line 16: -selected_output [( True or False )]

-selected_output--Controls writing of information to the selected-output file. This identifier has no effect unless the SELECTED_OUTPUT data block is included in the file. If a SELECTED_OUTPUT data block is included and -selected_output is false, no results are written to the selected-output file. Writing to the selected-output file can be resumed if -selected_output is set to true in a PRINT data block in a subsequent simulation. This print-control option is not affected by -reset. Default is true. Optionally, -se[ lected_output]. Note the hyphen is required to avoid a conflict with the keyword SELECTED_OUTPUT.

Line 17: -status [( True or False )]

-status--Controls printing of information to the screen that monitors calculations. When set to true, a status line is printed to the screen identifying the simulation number and the type of calculation that is currently being processed by the program. When set to false, no status line will be printed to the screen. This print-control option is not affected by -reset. Default is true. Optionally, status or -st[ atus].

Notes

By default, all print options are set to true at the beginning of a run. Once set by the keyword data block PRINT, options remain in effect until the end of the run or until changed in another PRINT data block.

Unlike most of PHREEQC input, the order in which the identifiers are entered is important when using the -reset identifier. Any identifier set before the -reset in the data block will be reset when -reset is encountered. Thus, -reset should be the first identifier in the data block. Using -reset false will eliminate all printing to the output file except echoes of the input data set and warning and error messages.

For long TRANSPORT and ADVECTION calculations with KINETICS, printing the status line [ -status true (default)] may cause a significant increase in run time. This has found to be the case on some Macintosh systems. If printing to the screen is unbuffered, the program must wait for the status line to be written before continuing calculations, which slows overall execution time. In this case, setting - status false may speed up run times.

The identifiers -species and -saturation_indices control the longest output data blocks and are the most likely to be selectively excluded from long computer runs. If transport calculations are made, the output file could become very large unless some or all of the output is excluded though the PRINT data block ( -reset false). Alternatively, the output in transport calculations may be limited by using the -print_cells and -print_frequency identifiers in the ADVECTION and TRANSPORT data block. For transport calculations, the SELECTED_OUTPUT data block is usually used to produce a compact file of selected results.

Example problems

The keyword PRINT is used in example problems 10, 12, 13, 14, and 15.

Related keywords

ADVECTION: -print_cells and -print_frequency, SELECTED_OUTPUT, TRANSPORT: -print_cells and -print_frequency, USER_PRINT, and USER_PUNCH.


| Next|| Previous || Top |