aermod_outputs¶
aermod_outputs ¶
PyAERMOD auxiliary output-file parsers.
AERMOD emits several text-format auxiliary files in addition to the
main .OUT log and the POSTFILE binary (handled by postfile.py):
- PLOTFILE one value per receptor for a given averaging period
- MAXIFILE ranked top-N values at every receptor
- RANKFILE overall top-N values across receptors, with dates
- SEASONHR seasonal-hourly-average grid (4 seasons * 24 hours)
- TOXXFILE top-N concentrations for toxics post-processing
- deposition DDEP / WDEP / TOTDEP (same layout as PLOTFILE)
All share a common structure: comment header lines starting with '*' followed by whitespace-delimited numeric rows. The readers here return either a pandas DataFrame (preferred) or a list of dicts.
AERMODFileHeader
dataclass
¶
Parsed comment-header info common to all AERMOD text outputs.
AERMODAuxResult
dataclass
¶
Unified result for any AERMOD auxiliary output file.
parse_aermod_header ¶
Parse the comment-header block of any AERMOD auxiliary file.
read_aermod_aux_file ¶
Read any AERMOD text auxiliary output file.
Auto-detects the file type (PLOTFILE, MAXIFILE, RANKFILE, SEASONHR, TOXXFILE, DDEP, WDEP, TOTDEP) from the header comments and infers columns when the header doesn't label them.
read_plotfile ¶
Read a PLOTFILE (one concentration value per receptor).
read_maxifile ¶
Read a MAXIFILE (top-N values at each receptor).
read_rankfile ¶
Read a RANKFILE (overall top-N values across receptors).
read_seasonhr ¶
Read a SEASONHR file (seasonal-hourly averages).
read_toxxfile ¶
Read a TOXXFILE (toxics post-processing top-N).
read_deposition ¶
Read a deposition output file (DDEP, WDEP, or TOTDEP).