Preprints
https://doi.org/10.5194/gmd-2023-159
https://doi.org/10.5194/gmd-2023-159
Submitted as: development and technical paper
 | 
28 Sep 2023
Submitted as: development and technical paper |  | 28 Sep 2023
Status: this preprint is currently under review for the journal GMD.

HETerogeneous vectorized or Parallel (HETPv1.0): An updated inorganic heterogeneous chemistry solver for metastable state NH4+–Na+–Ca2+–K+–Mg2+–SO42––NO3–Cl based on ISORROPIA II

Stefan J. Miller, Paul A. Makar, and Colin J. Lee

Abstract. We describe a new FORTRAN 90 computer program to solve the system of equations for the NH4+–Na+–Ca2+–K+–Mg2+–SO42––NO3–Cl system, based on the algorithms of ISORROPIA II, but containing algorithm improvements and corrections. These allow the code to deliver more accurate solution results in formal evaluations of accuracy of the roots of the systems of equations, while reducing processing time in practical applications by about 50 %. The improved solution performance results from several implementation improvements relative to the original ISORROPIA algorithms. These improvements include (i) the use of the ‘interpolate, truncate and project’ (ITP) root–finding approach rather than bisection, (ii) the allowance of search interval endpoints as valid roots at the onset of a search, (iii) the use of a more accurate method to solve polynomial subsystems of equations, (iv) the elimination of negative concentrations during iterative solutions, (v) corrections for mass conservation enforcement, and (vi) several code structure improvements. The new code may be run in either a “vectorization” mode wherein a global convergence criterion is used across multiple tests within the same chemical subspace, or a “by gridpoint” mode wherein individual test cases are solved with the same convergence criteria. The latter approach was found to be more efficient on the compiler tested here, but users of the code are recommended to test both options on their own systems. We also note that implementation of inorganic chemistry within chemical transport models should take care to retain residual or “free” mass of aerosol species remaining after partitioning, to ensure mass conservation – the new code has been constructed to explicitly conserve the input mass. The new code is provided as open–source FORTRAN 90 shareware.

Stefan J. Miller et al.

Status: open (until 06 Dec 2023)

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse
  • CC1: 'Improving HETP portability', Sebastian Eastham, 18 Oct 2023 reply
  • RC1: 'Comment on gmd-2023-159', Anonymous Referee #1, 21 Nov 2023 reply
  • RC2: 'Comment on gmd-2023-159', Anonymous Referee #2, 29 Nov 2023 reply
  • RC3: 'Comment on gmd-2023-159', Anonymous Referee #3, 06 Dec 2023 reply

Stefan J. Miller et al.

Model code and software

HETP: An updated inorganic heterogeneous chemistry solver for metastable state based on ISORROPIA II Stefan Miller https://doi.org/10.5281/zenodo.8164705

Stefan J. Miller et al.

Viewed

Total article views: 428 (including HTML, PDF, and XML)
HTML PDF XML Total Supplement BibTeX EndNote
304 116 8 428 22 1 0
  • HTML: 304
  • PDF: 116
  • XML: 8
  • Total: 428
  • Supplement: 22
  • BibTeX: 1
  • EndNote: 0
Views and downloads (calculated since 28 Sep 2023)
Cumulative views and downloads (calculated since 28 Sep 2023)

Viewed (geographical distribution)

Total article views: 417 (including HTML, PDF, and XML) Thereof 417 with geography defined and 0 with unknown origin.
Country # Views %
  • 1
1
 
 
 
 
Latest update: 06 Dec 2023
Download
Short summary
This work outlines a new solver written in Fortran 90 to calculate the partitioning of metastable aerosols at thermodynamic equilibrium based on the algorithms of ISORROPIA II. The new code includes numerical improvements that decrease the computational speed (compared to ISORROPIA II) while improving the accuracy of the partitioning solution.