Skip to content

Commit

Permalink
Polish front page
Browse files Browse the repository at this point in the history
  • Loading branch information
JiaweiZhuang committed Dec 11, 2018
1 parent 8e015e1 commit ce7a21a
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 13 deletions.
8 changes: 4 additions & 4 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
GEOS-Chem on cloud computing platforms
======================================
Running GEOS-Chem on AWS cloud -- it is easy!
=============================================

|docs| |license| |DOI|

`GEOSChem-on-cloud <http://acmg.seas.harvard.edu/research.html#cloud>`_ project aims to build a cloud computing capability for `GEOS-Chem <http://acmg.seas.harvard.edu/geos/>`_ that can be easily accessed by researchers worldwide.
`GEOSChem-on-cloud <http://acmg.seas.harvard.edu/research.html#cloud>`_ project provides easy and immediate access to the the latest, standard `GEOS-Chem <http://acmg.seas.harvard.edu/geos/>`_ model and `all its input datasets <https://registry.opendata.aws/geoschem-input-data/>`_ on the `Amazon Web Services (AWS) cloud <https://aws.amazon.com>`_.

Please see `online documentation <http://cloud-gc.readthedocs.io>`_.
Please see `online documentation <http://cloud-gc.readthedocs.io>`_ to get started.

.. |docs| image:: https://readthedocs.org/projects/cloud-gc/badge/?version=latest
:target: http://cloud-gc.readthedocs.io/en/latest/?badge=latest
Expand Down
18 changes: 9 additions & 9 deletions doc/source/index.rst
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
GEOS-Chem on cloud computing platforms
======================================
Running GEOS-Chem on AWS cloud -- it is easy!
=============================================

`GEOSChem-on-cloud <http://acmg.seas.harvard.edu/research.html#cloud>`_ project aims to build a cloud computing capability for `GEOS-Chem <http://acmg.seas.harvard.edu/geos/>`_ that can be easily accessed by researchers worldwide.
`GEOSChem-on-cloud <http://acmg.seas.harvard.edu/research.html#cloud>`_ project provides easy and immediate access to the latest, standard `GEOS-Chem <http://acmg.seas.harvard.edu/geos/>`_ model and `all its input datasets <https://registry.opendata.aws/geoschem-input-data/>`_ on the `Amazon Web Services (AWS) cloud <https://aws.amazon.com>`_.

See :ref:`motivation-label` for the motivation of this project. See :ref:`quick-start-label` to start your first GEOS-Chem simulation on the `Amazon Web Services (AWS) <https://aws.amazon.com/>`_ cloud within 10 minutes (and within seconds for the next time).
See :ref:`Quick start guide <quick-start-label>` to start your first GEOS-Chem simulation within 15 minutes (and within seconds for the next time). See :ref:`motivation-label` for the motivation of this project.

This project is supported by the `AWS Public Data Set Program <https://registry.opendata.aws/geoschem-input-data/>`_ and the NASA Atmospheric Composition Modeling and Analysis Program (ACMAP).
This project is supported by the `AWS Public Data Set Program <https://aws.amazon.com/opendata/public-datasets/>`_ and the `NASA Atmospheric Composition Modeling and Analysis Program (ACMAP) <https://science.nasa.gov/earth-science/focus-areas/atmospheric-composition>`_.

.. note::
You are invited to attend the user survey! Please `click here <https://github.com/geoschem/cloud_GC/issues/15>`_ to see the instruction.
**How to request support**: For any questions, bug reports, or functionality requests, please post your issue on the `GitHub issue tracker <https://github.com/geoschem/geos-chem-cloud/issues>`_. All you need is `a free GitHub account <https://github.com/join>`_ Alternatively, you can contact Jiawei Zhuang (jiaweizhuang@g.harvard.edu) and Bob Yantosca (yantosca@seas.harvard.edu). Using the GitHub issue tracker is the preferred approach because all discussions are public and can be easily found by anyone with similar problems.

For any questions, bug reports, or functionality requests, please raise a new issue on the `GitHub issue tracker <https://github.com/geoschem/cloud_GC/issues>`_. It is a much better approach than sending emails, because all discussions are public and can be easily found by anyone with similar problems.
**Help us improving the user experience**: You are invited to attend our `user survey <https://github.com/geoschem/geos-chem-cloud/issues/15>`_!

How to use this documentation
-----------------------------

**For GEOS-Chem users**, this website contains everything you need in order to use GEOS-Chem on the cloud. You will be able to finish a complete research workflow, from model simulations to output data analysis and management. **If it is your first time trying GEOS-Chem, this project is perhaps your best starting point**, because :ref:`you don't need to do any initial setup <motivation-label>` and the model is guaranteed to work correctly (see :ref:`quick start guide <quick-start-label>`). Note that this website is not a user guide on the GEOS-Chem model itself. Please refer to our comprehensive `user guide <http://acmg.seas.harvard.edu/geos/doc/man/>`_ and `wiki <http://wiki.seas.harvard.edu/geos-chem/index.php/Main_Page>`_ for all details about GEOS-Chem.
**For GEOS-Chem users**, this website contains everything you need in order to use GEOS-Chem on the cloud. You will be able to finish a complete research workflow, from model simulations to output data analysis and management. **If it is your first time trying GEOS-Chem, this project is perhaps your best starting point**, because :ref:`you don't need to do any initial setup <motivation-label>` and the model is guaranteed to work correctly (see :ref:`quick start guide <quick-start-label>`). For more all details about the GEOS-Chem model itself, please refer to our comprehensive `user guide <http://acmg.seas.harvard.edu/geos/doc/man/>`_ and `wiki <http://wiki.seas.harvard.edu/geos-chem/index.php/Main_Page>`_ for

**For non-GEOS-Chem-users**, this documentation can be used as an introduction to AWS for scientific computing, especially for **Earth science model simulations**. Since all Earth science models are highly similar from a software perspective, it should be quite easy to adapt this guide for you specific use case. More than 90% of this website is about general AWS concepts and tutorials, which doesn't require GEOS-Chem-specific knowledge. Please get a feeling of cloud computing workflow by exploring :doc:`beginner tutorials <./chapter02_beginner-tutorial/index>` and then refer to the :doc:`developer guide <./chapter04_developer-guide/index>` to build your own model. Although cloud computing has a lot of potential in Earth science, it is still significantly under-utilized due to :doc:`the lack of accessible tutorials <./chapter01_overview/external-resources>` for Earth science researchers. This project tries to fill this gap.

For general reference, GEOS-Chem is a `Chemical Transport Model <https://en.wikipedia.org/wiki/Chemical_transport_model>`_ for simulating atmospheric chemical compositions. It has been developed over 20 years and is used by `more than 100 research groups worldwide <http://acmg.seas.harvard.edu/geos/geos_people.html>`_. The program is mainly written in Fortran 90. `All model source code <https://bitbucket.org/account/user/gcst/projects/GEOS>`_ is `distributed freely under the MIT license <http://acmg.seas.harvard.edu/geos/geos_licensing.html>`_. Input and output data formats are mostly NetCDF, which can be analyzed easily by most languages such as Python, R and MATLAB. IDL (Interactive Data Language) has historically been the major data analysis tool but now we embrace open-source tools especially Python, `Jupyter <http://jupyter.org>`_ and `xarray <http://xarray.pydata.org>`_. The classic version of GEOS-Chem uses OpenMP parallelization (shared-memory, multi-threading). `The MPI version of GEOS-Chem <https://www.geosci-model-dev.net/11/2941/2018/gmd-11-2941-2018.html>`_ has also been developed and we have an :doc:`an experimental version that runs on the cloud<./chapter03_advanced-tutorial/gchp>`.
For general reference, GEOS-Chem is a `Chemical Transport Model <https://en.wikipedia.org/wiki/Chemical_transport_model>`_ for simulating atmospheric chemical compositions. It has been developed over 20 years and is used by `more than 100 research groups worldwide <http://acmg.seas.harvard.edu/geos/geos_people.html>`_. The program is mainly written in Fortran 90. `All model source code <https://github.com/geoschem>`_ is `distributed freely under the MIT license <http://acmg.seas.harvard.edu/geos/geos_licensing.html>`_. Input and output data formats are mostly NetCDF, which can be analyzed easily by most languages such as Python, R and MATLAB. IDL (Interactive Data Language) has historically been the major data analysis tool but now we embrace open-source tools especially Python, `Jupyter <http://jupyter.org>`_ and `xarray <http://xarray.pydata.org>`_. The classic version of GEOS-Chem uses OpenMP parallelization (shared-memory, multi-threading). `The MPI version of GEOS-Chem <https://www.geosci-model-dev.net/11/2941/2018/gmd-11-2941-2018.html>`_ has also been developed and we have an :doc:`an experimental version that runs on the cloud<./chapter03_advanced-tutorial/gchp>`.


Table of Contents
Expand Down

0 comments on commit ce7a21a

Please sign in to comment.