Personal tools
User menu

Difference between revisions of "WRF-GC"

From atmoschem

Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:
 
WRF-GC ([https://gmd.copernicus.org/articles/13/3241/2020/gmd-13-3241-2020.html Lin et al., 2020]; [https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al., 2021]) is a new, online coupled model based on the the regional meteorology model, [https://www.mmm.ucar.edu/weather-research-and-forecasting-model WRF], and the chemical transport model, [http://acmg.seas.harvard.edu/geos/ GEOS-Chem]. The coupling structure is designed to be easy to use, massively parallel, and ready for the future. In particular, either one of the two parent models to be updated independently. This allows WRF-GC to take full advantage of the updates in WRF and GEOS-Chem, respectively, and stay state-of-the-science.
 
WRF-GC ([https://gmd.copernicus.org/articles/13/3241/2020/gmd-13-3241-2020.html Lin et al., 2020]; [https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al., 2021]) is a new, online coupled model based on the the regional meteorology model, [https://www.mmm.ucar.edu/weather-research-and-forecasting-model WRF], and the chemical transport model, [http://acmg.seas.harvard.edu/geos/ GEOS-Chem]. The coupling structure is designed to be easy to use, massively parallel, and ready for the future. In particular, either one of the two parent models to be updated independently. This allows WRF-GC to take full advantage of the updates in WRF and GEOS-Chem, respectively, and stay state-of-the-science.
  
 +
WRF-GC is open-source and free to use.
  
 
[[File:WRF_GC_two-way_Structure_submitted.png|700px|thumb|center|Architectural overview of the WRF-GC model (v2.0). The WRF-GC two-way Coupler (all parts shown in red) includes interfaces to the two parent models, as well as the state conversion and state management modules. The parent models (shown in grey) are standard codes downloaded from their sources, without any modifications. From [https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al. (2021).] ]]  
 
[[File:WRF_GC_two-way_Structure_submitted.png|700px|thumb|center|Architectural overview of the WRF-GC model (v2.0). The WRF-GC two-way Coupler (all parts shown in red) includes interfaces to the two parent models, as well as the state conversion and state management modules. The parent models (shown in grey) are standard codes downloaded from their sources, without any modifications. From [https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al. (2021).] ]]  
Line 14: Line 15:
 
(updated Feb 9, 2021)
 
(updated Feb 9, 2021)
 
WRF-GC v2.0 ([https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al. (2021)]) is an online two-way coupling of the Weather Research and Forecasting (WRF) meteorological model (v3.9.1.1) and the GEOS-Chem chemical model (v12.7.2). WRF-GC v2.0 is built on the modular framework of WRF-GC v1.0 and further includes aerosol-radiation interactions (ARI) and aerosol-cloud interactions (ACI) based on bulk aerosol mass and composition, as well as the capability to nest multiple domains for high-resolution simulations.
 
WRF-GC v2.0 ([https://gmd.copernicus.org/preprints/gmd-2020-441/ Feng et al. (2021)]) is an online two-way coupling of the Weather Research and Forecasting (WRF) meteorological model (v3.9.1.1) and the GEOS-Chem chemical model (v12.7.2). WRF-GC v2.0 is built on the modular framework of WRF-GC v1.0 and further includes aerosol-radiation interactions (ARI) and aerosol-cloud interactions (ACI) based on bulk aerosol mass and composition, as well as the capability to nest multiple domains for high-resolution simulations.
 +
 +
Major features of WRF-GC v2.0:
 +
* Updated compatibility with the latest release of GEOS-Chem v12.8.1
 +
* Aerosol-radiation interactions and aerosol-cloud interactions that can be turned on/off
 +
* Nested-domain functionality
 +
* Online lightning NOx emissions
 +
* Restart run functionality
 +
* Bug fixes from v1.0
  
 
===Version 1.0===
 
===Version 1.0===
The first version of WRF-GC (v1.0) ([https://gmd.copernicus.org/articles/13/3241/2020/gmd-13-3241-2020.html Lin et al., 2020]) was released on January 4, 2019. A more mature and stable version (v 1.0) was released in Fall 2019. This is the current version.
+
The first version of WRF-GC (v1.0) ([https://gmd.copernicus.org/articles/13/3241/2020/gmd-13-3241-2020.html Lin et al., 2020]) was released on January 4, 2019. A more mature and stable version (v 1.0) was released in Fall 2019.  
 +
 
 +
(updated Feb 26, 2021) We recommend that all users upgrade to WRF-GC v2.0.
  
A few notes about the current version (v 1.0):  
+
A few notes about v1.0:  
 
* The coupling between WRF and GEOS-Chem is one-way only, i.e., there is no feedback from GEOS-Chem to WRF.  
 
* The coupling between WRF and GEOS-Chem is one-way only, i.e., there is no feedback from GEOS-Chem to WRF.  
 
* The nested domain capability of WRF is not yet supported.
 
* The nested domain capability of WRF is not yet supported.
Line 32: Line 43:
 
==Obtaining the code==
 
==Obtaining the code==
  
If you are interested in downloading WRF-GC and and giving it a spin, please send us an email (fuzm AT sustech DOT edu DOT cn) and tell us your name, affiliation, and intended general application. We will add you to a mailing list and keep you updated on new version releases.
+
WRF-GC can be downloaded from [https://github.com/jimmielin/wrf-gc-release GitHub]. We also encourage you to [https://fugroup.org/index.php/WRF-GC#WRF-GC_google_group subscribe to the WRF-GC google group] (WRF-GC@googlegroups.com) to stay updated with the model status.
  
  
 
==Getting started==
 
==Getting started==
[https://www.geosci-model-dev-discuss.net/gmd-2019-333/ Model description paper of WRF-GC (v1.0)]. Accepted for publication in ''Geoscientific Model Development''
+
[https://fugroup.org/wrf-gc/WRF-GC_Documentation_updated_for_v2_Feb2021.pdf WRF-GC v2.0 documentation, including step-by-step instructions] (updated Feb 2021)
 +
 
 +
[https://gmd.copernicus.org/preprints/gmd-2020-441/ Model description paper of WRF-GC (v2.0)]. Under review in ''Geoscientific Model Development Discussion''
 +
 
 +
[http://www.fugroup.org/wrf-gc/wrf-gc-starter-kit.zip Starter kit for use in the WRF-GC model clinic] This is a package of an example simulation using WRF-GC to be used with the tutorial above.
 +
 
 +
[https://gmd.copernicus.org/articles/13/3241/2020/gmd-13-3241-2020.html Model description paper of WRF-GC (v1.0)]. Published in ''Geoscientific Model Development''
  
 
[http://www.fugroup.org/wrf-gc/WRF-GC_IGC9.pdf Overview of the WRF-GC as of May 2019]  
 
[http://www.fugroup.org/wrf-gc/WRF-GC_IGC9.pdf Overview of the WRF-GC as of May 2019]  
Line 49: Line 66:
  
  
==Tutorial at the 9th International GEOS-Chem Meeting (IGC9)==
 
[http://www.fugroup.org/wrf-gc/WRF-GC_IGC9.pdf Overview of the WRF-GC as of May 2019]
 
  
[http://www.fugroup.org/wrf-gc/IGC9_Clinic_Public.pdf Slides for the WRF-GC model clinic] This is a step-by-step tutorial on how to run WRF-GC
+
=Help with WRF-GC=
 +
==WRF-GC google group==
 +
The WRF-GC google group (WRF-GC@googlegroups.com) is a place for WRF-GC users to ask questions and exchange experiences about using the WRF-GC model.
  
[http://www.fugroup.org/wrf-gc/wrf-gc-starter-kit.zip Starter kit for use in the WRF-GC model clinic] This is a package of an example simulation using WRF-GC to be used with the tutorial above.
+
To join the google group, please sign in your google account and search for '''WRF-GC''' on [groups.google.com Google Groups] and click 'Ask to join'. Your group membership should be processed by the group managers shortly.
  
 
 
 
=Help with WRF-GC=
 
  
 
==Contact us==
 
==Contact us==
 
If you encounter any problems running WRF-GC or have suggestions for model improvements, please email us (fuzm AT sustech DOT edu DOT cn).
 
If you encounter any problems running WRF-GC or have suggestions for model improvements, please email us (fuzm AT sustech DOT edu DOT cn).
 
 
==WRF-GC google group==
 
The WRF-GC google group (WRF-GC@googlegroups.com) is a place for WRF-GC users to ask questions and exchange experiences about using the WRF-GC model.
 
 
To join the google group, please sign in your google account and search for '''WRF-GC''' on [groups.google.com Google Groups] and click 'Ask to join'. Your group membership should be processed by the group managers shortly.
 

Latest revision as of 00:57, 26 February 2021

About WRF-GC

WRF-GC (Lin et al., 2020; Feng et al., 2021) is a new, online coupled model based on the the regional meteorology model, WRF, and the chemical transport model, GEOS-Chem. The coupling structure is designed to be easy to use, massively parallel, and ready for the future. In particular, either one of the two parent models to be updated independently. This allows WRF-GC to take full advantage of the updates in WRF and GEOS-Chem, respectively, and stay state-of-the-science.

WRF-GC is open-source and free to use.

Architectural overview of the WRF-GC model (v2.0). The WRF-GC two-way Coupler (all parts shown in red) includes interfaces to the two parent models, as well as the state conversion and state management modules. The parent models (shown in grey) are standard codes downloaded from their sources, without any modifications. From Feng et al. (2021).


The development of WRF-GC was led by Haipeng LIN, Xu FENG, and Tzung-May FU. In addition, the GEOS-Chem Support Team provided valuable assistance in updating the GEOS-Chem code to accommodate the coupling.


Version history

Version 2.0

(updated Feb 9, 2021) WRF-GC v2.0 (Feng et al. (2021)) is an online two-way coupling of the Weather Research and Forecasting (WRF) meteorological model (v3.9.1.1) and the GEOS-Chem chemical model (v12.7.2). WRF-GC v2.0 is built on the modular framework of WRF-GC v1.0 and further includes aerosol-radiation interactions (ARI) and aerosol-cloud interactions (ACI) based on bulk aerosol mass and composition, as well as the capability to nest multiple domains for high-resolution simulations.

Major features of WRF-GC v2.0:

  • Updated compatibility with the latest release of GEOS-Chem v12.8.1
  • Aerosol-radiation interactions and aerosol-cloud interactions that can be turned on/off
  • Nested-domain functionality
  • Online lightning NOx emissions
  • Restart run functionality
  • Bug fixes from v1.0

Version 1.0

The first version of WRF-GC (v1.0) (Lin et al., 2020) was released on January 4, 2019. A more mature and stable version (v 1.0) was released in Fall 2019.

(updated Feb 26, 2021) We recommend that all users upgrade to WRF-GC v2.0.

A few notes about v1.0:

  • The coupling between WRF and GEOS-Chem is one-way only, i.e., there is no feedback from GEOS-Chem to WRF.
  • The nested domain capability of WRF is not yet supported.


Reference

  • Lin, H., Feng, X., Fu, T.-M.*, Tian, H., Ma, Y., Zhang, L., Jacob, D.J., Yantosca, R.M., Sulprizio, M.P., Lundgren, E.W., Zhuang, J., Zhang, Q., Lu, X., Zhang, L., Shen, L., Guo, J., Eastham, S.D., Keller, C.A. (2020), WRF-GC (v1.0): online coupling of WRF (v3.9.1.1) and GEOS-Chem (v12.2.1) for regional atmospheric chemistry modeling – Part 1: Description of the one-way model, Geosci. Model Dev., doi:10.5194/gmd-13-3241-2020, Full text
  • Feng, X., Lin, H., Fu, T.-M.*, Sulprizio, M. P., Zhuang, J., Jacob, D. J., Tian, H., Ma, Y., Zhang, L., Wang, X., Chen, Q. (2021), WRF-GC (v2.0): online two-way coupling of WRF (v3.9.1.1) and GEOS-Chem (v12.7.2) for modeling regional atmospheric chemistry-meteorology interactions, Geosci. Model. Dev. Discuss., doi:10.5194/gmd-2020-441. Full text
  • Feng, X., Lin, H., and Fu, T.-M.* (2020), WRF-GC: online two-way coupling of WRF and GEOS-Chem for regional atmospheric chemistry modeling, EGU General Assembly 2020, Online, 4–8 May 2020, EGU2020-5165, doi:10.5194/egusphere-egu2020-5165. Link.


Using WRF-GC

Obtaining the code

WRF-GC can be downloaded from GitHub. We also encourage you to subscribe to the WRF-GC google group (WRF-GC@googlegroups.com) to stay updated with the model status.


Getting started

WRF-GC v2.0 documentation, including step-by-step instructions (updated Feb 2021)

Model description paper of WRF-GC (v2.0). Under review in Geoscientific Model Development Discussion

Starter kit for use in the WRF-GC model clinic This is a package of an example simulation using WRF-GC to be used with the tutorial above.

Model description paper of WRF-GC (v1.0). Published in Geoscientific Model Development

Overview of the WRF-GC as of May 2019

Downloading WRF-GC

Installing WRF-GC

Running WRF-GC

Analyzing WRF-GC outputs


Help with WRF-GC

WRF-GC google group

The WRF-GC google group (WRF-GC@googlegroups.com) is a place for WRF-GC users to ask questions and exchange experiences about using the WRF-GC model.

To join the google group, please sign in your google account and search for WRF-GC on [groups.google.com Google Groups] and click 'Ask to join'. Your group membership should be processed by the group managers shortly.


Contact us

If you encounter any problems running WRF-GC or have suggestions for model improvements, please email us (fuzm AT sustech DOT edu DOT cn).

  • This page was last modified on 26 February 2021, at 00:57.
  • This page has been accessed 9,388 times.