EMC²

An open source framework for atmospheric model and observational column comparison.
https://github.com/ARM-DOE/EMC2

Category: Atmosphere
Sub Category: Atmospheric Composition and Dynamics

Keywords from Contributors

meteorology atmospheric-science corrections meteorological-data retrieval skew-t

Last synced: about 8 hours ago
JSON representation

Repository metadata

Earth Model Column Collabratory

README.rst

          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.

        

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: about 11 hours ago

Total Commits: 489
Total Committers: 14
Avg Commits per committer: 34.929
Development Distribution Score (DDS): 0.397

Commits in past year: 67
Committers in past year: 5
Avg Commits per committer in past year: 13.4
Development Distribution Score (DDS) in past year: 0.104

Name Email Commits
Israel Silber i****4@p****u 295
Jackson r****n@a****v 101
Robert Clyde Jackson r****n@c****v 35
Robert Jackson r****n@R****l 18
Robert Jackson r****n@R****l 9
Scott Collis s****f@g****m 8
Robert Jackson r****n@R****l 6
JingjingTina j****5@g****m 5
McKenna Stanford m****5@c****u 3
mengz1993 8****3 3
Max Grover m****x@g****m 2
Robert Jackson r****n@c****v 2
Robert Jackson r****n@e****v 1
Robert Jackson r****n@e****v 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 22
Total pull requests: 186
Average time to close issues: 2 months
Average time to close pull requests: 4 days
Total issue authors: 2
Total pull request authors: 6
Average comments per issue: 1.45
Average comments per pull request: 0.41
Merged pull request: 179
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 51
Past year average time to close issues: N/A
Past year average time to close pull requests: 3 days
Past year issue authors: 0
Past year pull request authors: 4
Past year average comments per issue: 0
Past year average comments per pull request: 0.24
Past year merged pull request: 49
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ARM-DOE/EMC2

Top Issue Authors

  • isilber (16)
  • rcjackson (6)

Top Pull Request Authors

  • isilber (131)
  • rcjackson (41)
  • mengz1993 (6)
  • JingjingTina (4)
  • mgrover1 (2)
  • mckenna-stanford-columbia (2)

Top Issue Labels

Top Pull Request Labels


Package metadata

pypi.org: emc2

An open source framework for atmospheric model evaluation using observational data

  • Homepage: https://github.com/ARM-DOE/EMC2
  • Documentation: https://emc2.readthedocs.io/
  • Licenses: MIT
  • Latest release: 1.3.4 (published about 1 month ago)
  • Last Synced: 2025-06-06T10:32:02.495Z (1 day ago)
  • Versions: 15
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 723 Last month
  • Rankings:
    • Dependent packages count: 7.31%
    • Forks count: 15.416%
    • Average: 18.237%
    • Stargazers count: 18.529%
    • Dependent repos count: 22.088%
    • Downloads: 27.842%
  • Maintainers (2)

Dependencies

.github/workflows/python-package.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
.github/workflows/sphinx.yml actions
  • actions/checkout v2 composite
  • conda-incubator/setup-miniconda v2 composite
  • peaceiris/actions-gh-pages v3.8.0 composite
.github/workflows/pypi-release.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v4 composite
  • actions/setup-python v5 composite
  • actions/upload-artifact v4 composite
  • pypa/gh-action-pypi-publish v1.8.14 composite
requirements.txt pypi
  • act-atmos *
  • nc-time-axis *
  • numpy *
  • pint *
  • xarray *
requirements_docs.txt pypi
  • nbsphinx *
  • numpydoc *
  • pandoc *
  • sphinx *
  • sphinx-autobuild *
  • sphinx_copybutton *
  • sphinx_gallery *
  • sphinx_minipres *
  • sphinx_rtd_theme *
  • sphinx_tabs *
  • sphinx_togglebutton >=0.2.0
setup.py pypi
.github/workflows/antivirus.yml actions
  • actions/checkout v4 composite
  • djdefi/gitavscan main composite
.github/workflows/codeql.yml actions
  • actions/checkout v4 composite
  • github/codeql-action/analyze v3 composite
  • github/codeql-action/autobuild v3 composite
  • github/codeql-action/init v3 composite

Score: 11.711513994228055