View source for GEOS-Chem Support Team

This page contains information about the GEOS-Chem Support Team (aka GCST).

== Contact information ==

=== General Inquiries ===

If you are reporting a GEOS-Chem bug or technical issue, then please also see [[Submitting GEOS-Chem support requests|our ''Submitting GEOS-Chem support requests'' wiki page]] for more detailed instructions.

For other requests, please use this email address: '''geos-chem-support [at] g.harvard.edu'''.

=== GCST Members ===

The table below lists members of the GCST:

{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC" valign="top"
!width="200px"|Name
!width="200px"|Title 
!width="450px"|Focus

|-valign="top"
|Bob Yantosca<br>(GitHub: [https://github.com/yantosca @yantosca])
|Senior Software Engineer
|Lead developer for:
*Fundamental software development
*Documentation
*User support

Other areas of focus:
*Debugging and testing
*High-performance computing
*AWS cloud computing support and development

|-valign="top"
|Melissa Sulprizio<br>(GitHub: [https://github.com/msulprizio @msulprizio])
|Senior Scientific Programmer
|Lead developer for:
*[[GEOS-Chem benchmarking|Benchmarking]] new GC versions
*[[HEMCO]] software development

Other areas of focus:
*Fundamental software development
*Debugging and testing
*Documentation
*User support

|-valign="top"
|Lizzie Lundgren<br>(GitHub: [https://github.com/lizziel @lizziel])
|Senior Scientific Software Engineer
|Lead developer for:
*GEOS-Chem in GEOS and CESM
*Liaison between GCST and [https://gmao.gsfc.nasa.gov/ GMAO]
*GCHP development advisor

Other areas of focus:
*Fundamental software development
*High performance computing
*Debugging and testing
*User support

|-valign="top"
|Lucas Estrada <br>(GitHub: [https://github.com/laestrada @laestrada])
|Scientific Programmer
|Lead developer for:
*GCPy python visualization package
*AWS cloud computing support and development

Other areas of focus:
*Fundamental software development
*Debugging and testing
*User support
*Documentation

|-valign="top"
|Liam Bindle<br>(GitHub: [https://github.com/LiamBindle @LiamBindle])
|Scientific Applications Software Engineer
|Lead developer for:
*GCHP stretched-grid development
*GCHP on AWS
*Continuous Integration and Delivery (CI/CD)

Other areas of focus:
*General GCHP development
*Improving GCHP usability
*GCHP user support

|-valign="top"
|Yanshun Li<br>(GitHub: [https://github.com/YanshunLi-washu @YanshunLi-washu])
|Doctoral Student
|Lead developer for:
*Data management on Compute Canada
*Processing GMAO met data for input into GEOS-Chem

|-valign="top"
|Jourdan He
|Research Assistant
|TBD

|}

=== GCST Liaisons ===

The table below lists contact persons for specific GEOS-Chem applications that are not directly supported by the GCST:

{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC" valign="top"
!width="200px"|Application
!width="300px"|Liaison

|-valign="top"
|[[GEOS-Chem Adjoint]]
|[http://spot.colorado.edu/~henzed/ Daven Henze]

|-valign="top"
|[[APM aerosol microphysics|APM]]
|[mailto:fangqun.yu@asrc.albany.edu Fangqun Yu]

|-valign="top"
|[[GEOS-Chem Nested Model]]
|[http://www.uh.edu/nsm/earth-atmospheric/people/faculty/yuxuan-wang/ Yuxuan Wang] (GitHub: [https://github.com/yxw246 @yxw246]) and<br>[http://www.atmos.pku.edu.cn/lzhang/ Lin Zhang]

|-valign="top"
|[[Hg and POPs Working Group|Hg and POPs]]
|Colin Thackray (GitHub: [https://github.com/cpthackray cpthackray])

|-valign="top"
|[[Coupling GEOS-Chem with RRTMG|RRTMG]]
|[https://lae.mit.edu/team/sebastian-eastham Sebastian Eastham] (GitHub: [https://github.com/sdeastham @sdeastham])

|-valign="top"
|[[TOMAS aerosol microphysics|TOMAS]]
|[https://pierce.atmos.colostate.edu/people.htm#jeff Jeff Pierce]

|}

== Workflow ==

The GEOS-Chem Support Team now uses issue trackers attached to the relevant Github repositories to manage its workflow. Users may create issues and create pull requests in these public repositories.

{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#CCCCCC" valign="top"
!width="250px"|Product
!width="400px"|Issue Tracker @ Github

|-valign="top"
|GEOS-Chem core code and GEOS-Chem Classic
|<tt>[https://github.com/geoschem/geos-chem/issues geoschem/geos-chem/issues]</tt>

|-valign="top"
|HEMCO
|<tt>[https://github.com/geoschem/HEMCO/issues geoschem/HEMCO/issues]</tt>

|-valign="top"
|GCHP
|<tt>[https://github.com/geoschem/gchp/issues geoschem/gchp/issues]</tt>

|-valign="top"
|GEOS-Chem cloud tutorial
|<tt>[https://github.com/geoschem/geos-chem-cloud/issues geoschem/geos-chem-cloud/issues]</tt>

|-valign="top"
|GCPy
|<tt>[https://github.com/geoschem/gcpy/issues geoschem/gcpy/issues]</tt>

|}

== Mission ==

The GEOS–Chem Support Team uses robust source code management techniques to facilitate the open-source development of GEOS–Chem, maintain code integrity, ensure proper documentation and traceability, and support users. Its principal activities are as follows:

#'''Implementation of new GEOS–Chem developments into the standard model'''. Most developments of the model are initiated by individual users for their own scientific purposes. Their implementation into the standard model is led by the Support Team in collaboration with the developer. We use the Git software management system (Git, www.git-scm.com) to ensure that each user’s source code revisions can be tracked properly. 
#'''Fundamental GEOS–Chem development'''. The Support Team conducts fundamental model development essential for the long term. This includes upgrades to new versions of GEOS meteorological data, acquisition and storage of data, implementation of new coding and data structures, and technical updates.
#'''Benchmarking of new versions'''. The Support Team benchmarks each new version of GEOS–Chem following a standard protocol to ensure the traceability and integrity of the model. 
#'''Documentation, communication, and education'''. The Support Team maintains the GEOS–Chem User’s Manual and wiki pages, publishes monthly e-newsletters, welcomes new users, offers programming guidelines and advice, develops standards for coding and documentation (GEOS–Chem Style Guide), instructs users on the use of various software tools, and conducts model clinics at Users’ Meetings.
#'''Development of supporting software'''. The Support Team publishes open-source software for the benefit of the GEOS–Chem and broader modeling community. It maintains GAMAP, a collection of IDL programs that facilitates the analysis and visualization of CTM data. GAMAP is the standard visualization tool for GEOS–Chem and is updated regularly to maintain compatibility with the standard model.

== Specific tasks handled by the GEOS-Chem Support Team ==

The GEOS-Chem Support Team shall be responsible for the following tasks:

# Managing the "standard" GEOS-Chem model for distribution:
#* [[Downloading_GEOS-Chem_source_code|Source code]]
#* [[Downloading_GEOS-Chem_data_directories|Shared data directories]]
#* [[Creating_GEOS-Chem_run_directories|Run directories]]
# Publishing the relevant documentation for GEOS-Chem using the following media:
#* [[Getting Started with GEOS-Chem|GEOS-Chem Online User's Guide]]
#* [http://wiki.seas.harvard.edu/geos-chem/ GEOS-Chem wiki]
#* [http://acmg.seas.harvard.edu/geos/ GEOS-Chem website]
# Validating the [[GEOS-Chem_chemistry_mechanisms|"standard" simulation]] by means of:
#* [[GEOS-Chem_benchmarking#1-month_benchmark|1-month benchmark simulations]] for each new GEOS-Chem version.<br>(GEOS-Chem Model Scientist Daniel Jacob is responsible for approving the results of each 1-month benchmark.)
#* [[GEOS-Chem_benchmarking#1-year_benchmark|1-year benchmark simulations]] for selected GEOS-Chem versions.
# Processing the [[Overview of GMAO met data products|meteorological data products]] that are used to drive GEOS-Chem simulations
# Adding updates from [http://acmg.seas.harvard.edu/geos/geos_people.html GEOS-Chem developers] into the "standard" GEOS-Chem code repository
# Distributing various [[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|software packages for visualization and data processing]]
# Assisting GEOS-Chem developers and users with [[Getting_Started_with_GEOS-Chem#Getting_help|technical problems and issues]]
# Development of [[GCHP_Main_Page|GCHP]], which is the MPI implementation of GEOS-Chem

== Responsibilities of the GEOS-Chem User Community ==

Please keep in mind that the GEOS-Chem Support Team primarily works with the GEOS-Chem source code. If your question is more scientific than technical, then the GEOS-Chem Support Team might not possess the expertise to answer your question fully. In these cases we request that you contact the relevant [http://acmg.seas.harvard.edu/geos/geos_working_groups.html GEOS-Chem Working Group] or direct your question to other members of the [http://acmg.seas.harvard.edu/geos/geos_people.html GEOS-Chem user community] who can better assist you.

We expect that the GEOS-Chem user community shall be responsible for the scientific content and validation of the following GEOS-Chem simulations:

# [[Aerosol-only_simulation|Aerosol-only simulations]]
# Aerosol Microphysics Simulations (e.g. [[TOMAS aerosol microphysics|TOMAS]], [[APM aerosol microphysics|APM]])
# [[CH4_simulation|CH4 simulations]]
# [[Tagged CO simulation|CO and Tagged CO simulations]]
# [[CO2 simulation|CO2 and Tagged CO2 simulations]]
# [[Tagged O3 simulation|Tagged O3 simulations]]
# [[Mercury|Hg and Tagged Hg simulations]]
# [[GEOS-Chem nested grid simulations|Nested-grid simulations]]
# [[Rn-Pb-Be_simulation|<sup>222</sup>Rn-<sup>210</sup>Pb-<sup>7</sup>Be simulations]]

If you use one of these types of GEOS-Chem simulations, the GEOS-Chem Support Team will of course be happy to assist you in including your updates into the standard code, or in resolving technical issues.  

Regrettably, the GEOS-Chem Support Team cannot assist you with the following:

#Teaching you how to program in Fortran, Python IDL, Matlab, Perl, etc.
#Installing libraries or software on your system
#*[[Installing libraries for GEOS-Chem|But see these instructions if you need to do so]]
#Installing hardware on your system
#Setting up web pages for your group

We invite you to read our [[GEOS-Chem basics]] wiki page for more information on these topics.

For more information about the expectations and responsibilities of GEOS-Chem users please see the [[GEOS-Chem welcome letter for new users|welcome letter for new GEOS-Chem users]].