An open API service indexing awesome lists of open source software.

https://github.com/ARM-DOE/EMC2

Earth Model Column Collabratory
https://github.com/ARM-DOE/EMC2

Last synced: about 1 year ago
JSON representation

Earth Model Column Collabratory

Awesome Lists containing this project

README

          

EMC²: the Earth Model Column Collaboratory
==========================================

.. image:: https://img.shields.io/pypi/v/emc2.svg
:target: https://pypi.python.org/pypi/emc2
:alt: Latest PyPI version

.. image:: https://travis-ci.org/ARM-DOE/EMC2.png
:target: https://travis-ci.org/ARM-DOE/EMC2
:alt: Latest Travis CI build status

The Earth Model Column Collaboratory (EMC²) is an open-source framework for
atmospheric model evaluation against observational data and model
intercomparisons. It consisting of an instrument simulator and a sub-column
generator, which enables statistically emulating a higher spatial resolution.
This framework is specifically designed to simulate the `Atmospheric
Radiation Measurement (ARM) User Facility `_ remote-
sensing measurements while being faithful to the representation of physical
processes and sub-grid scale assumptions in various state-of-the-art models,
thereby serving as a practical bridge between observations and models.

Detailed description of EMC² is provided in Silber et al. (GMD, 2022;
https://doi.org/10.5194/gmd-15-901-2022).

Useful links
============

- source code repository: https://github.com/ARM-DOE/EMC2
- EMC² Documentation: https://arm-doe.github.io/EMC2
- EMC² tutorial (from the 2022 ARM Open-Science Workshop): https://github.com/ARM-Development/ARM-Notebooks/blob/main/Tutorials/Open-Science-Workshop-2022/tutorials/EMC2_demo_w_E3SM.ipynb

Citing
======

If the Earth Model Column Collaboratory (EMC²) is used in your manuscript,
please cite:

Silber, I., Jackson, R. C., Fridlind, A. M., Ackerman, A. S., Collis, S.,
Verlinde, J., and Ding, J.: The Earth Model Column Collaboratory (EMC2)
v1.1: an open-source ground-based lidar and radar instrument simulator and
subcolumn generator for large-scale models, Geosci. Model Dev., 15,
901–927, https://doi.org/10.5194/gmd-15-901-2022, 2022.

and references therein.

Installation
============

In order to install EMC², you can use either pip or anaconda. In a terminal, simply type either of::

$ pip install emc2
$ conda install -c conda-forge emc2

In addition, if you want to build EMC² from source and install, type in the following commands::

$ git clone https://github.com/ARM-DOE/EMC2
$ cd EMC2
$ pip install .

Dependencies
============

EMC² requires Python 3.10+ as well as:
* Atmoshperic Community Toolkit (https://arm-doe.github.io/ACT)
* Numpy (https://numpy.org)
* Scipy (https://scipy.org)
* Matplotlib (https://matplotlib.org)
* Xarray (http://xarray.pydata.org)
* Pandas (https://pandas.pydata.org/)
* matplotlib (https://matplotlib.org/)
* netCDF4 (https://github.com/Unidata/netcdf4-python)

Contributions
=============

As its acronym suggests, EMC² is a collaboratory...
Contributions are welcome and encouraged, provided that the code can be
distributed under the BSD 3-clause license (see the LICENSE.txt file).
See the `contributor's guide. `_ for more information.