Metadata-Version: 2.1
Name: asediag
Version: 1.2.0
Summary: Aerosol Diagnostics on Model Native Grid
Home-page: https://github.com/eagles-project/asediag
Author: Taufiq Hassan
Author-email: taufiq.hassan@pnnl.gov
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: cartopy
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: setuptools
Requires-Dist: xarray
Requires-Dist: six

## Aerosol Diagnostics on Model Native Grid

**Aerosol process analysis in model-native Spectral Element (SE) grid**

Aerosol Diagnostics on Model Native Grid is a Python-based standalone tool designed for aerosol process analysis within the model-native spectral element (SE) grid. As such, it is also known as Aerosol SE Diagnostics or “asediag”. It includes functionalities for aerosol budget analysis, optical diagnostics, and decomposed anthropogenic aerosol radiative forcing analysis. The tool supports both SE and regular latitude-longitude (RLL) grids, and can operate in batch mode with multiprocessing capabilities.

**Primary Developer & Maintainer:** Taufiq Hassan

**For Questions:** [taufiq.hassan@pnnl.gov](taufiq.hassan@pnnl.gov)

[**Contributors**](./AUTHORS.rst)

Installation
------------

Git clone the repo
```bash
git clone git@github.com:TaufiqHassan/asediag.git
```

### Submit as a batch job

`asediag` works with e3sm_unifed environment in *Compy* and *Perlmutter*.

Make adjustments in the batch configuration file `batch_config.ini`.

Submit the batch jobs with:
```bash
python submit_asediag_batches.py
```
### Example 

[Demo output page](https://compy-dtn.pnl.gov/hass877/share/aer_diag/F20TR_2016Emis_ne30pg2_def_minus_F20TR_1850Emis_ne30pg2_def/aerosol.html)

Acknowledgement
---------------
`asediag` is based on earlier developments in `NCL` and individual contributions from:
* Po-Lun Ma: [Original budget analysis and diagnostics](https://github.com/eagles-project/aerosol_diag)
* Jian Sun & Kai Zhang: [Aerosol number and species per mode budget and spatial distribution analysis](https://github.com/eagles-project/aerosol_diag/tree/jian/develop)
* Jianfeng Li: [Aerosol optics diagnostics](https://github.com/eagles-project/aerosol_diag/tree/jianfeng_update)
* Kai Zhang: [Aerosol forcing diagnostics](https://github.com/kaizhangpnl/e3sm_erf_aerosol)

**Note:** Currently undegoing small patchworks and further developments!
