diff --git a/.ci-pipelines/build-matrix.yml b/.ci-pipelines/build-matrix.yml deleted file mode 100644 index 9015c5e96..000000000 --- a/.ci-pipelines/build-matrix.yml +++ /dev/null @@ -1,63 +0,0 @@ -#============================================================================= -# Build matrix pipeline: -# -# This pipeline checks that pre-releases and the main branch -# compile in a wide variety of build environments. This pipeline -# is intended to be a rigorous check of GEOS-Chem's build. -# -# This pipeline triggers on tagged pre-releases (alpha and beta -# versions, as well as release candidates). Commits to the main -# branch also trigger this pipeline. -#============================================================================= -trigger: - branches: - include: - - main - exclude: - - bugfix* - - dev* - - feature* - tags: - include: # Semantic versioning 2.0.0 examples: - - '*-alpha*' # 12.7.1-alpha.3 - - '*-beta*' # 12.7.0-beta.1 - - '*-rc*' # 12.7.0-rc.1 -pr: none - -# Basic agent set up -pool: - vmImage: 'ubuntu-latest' - - -# Define the "matrix" of build images to try building GEOS-Chem in -strategy: - matrix: - ubuntu_basic: - containerImage: geoschem/buildmatrix:netcdf-ubuntu - gcc8: - containerImage: geoschem/buildmatrix:netcdf-gcc8 - gcc9: - containerImage: geoschem/buildmatrix:netcdf-gcc9 - gcc10: - containerImage: geoschem/buildmatrix:netcdf-gcc10 -container: $[ variables['containerImage'] ] - - -# Try building GEOS-Chem (this is run for each "matrix" entry above) -steps: -- checkout: self - submodules: recursive -- script: | - . /opt/spack/share/spack/setup-env.sh - export CC=gcc - export CXX=g++ - export FC=gfortran - set -x - spack load cmake - spack load netcdf-c - spack load netcdf-fortran - mkdir build - cd build - cmake -DCMAKE_COLOR_MAKEFILE=FALSE $(Build.Repository.LocalPath) - make -j - displayName: 'Building GEOS-Chem' diff --git a/.ci-pipelines/quick-build.yml b/.ci-pipelines/quick-build.yml deleted file mode 100644 index cb62f6613..000000000 --- a/.ci-pipelines/quick-build.yml +++ /dev/null @@ -1,48 +0,0 @@ -#============================================================================= -# Quick build pipeline: -# -# This pipeline checks that commits and open pull requests don't -# introduce compiler errors. This is meant to be a quick and simple -# check that runs frequently. -# -# This pipeline triggers on commits to development and bug-fix -# branches. Commits to the main branch do not trigger this pipeline -# because those are tested against the build matrix. Commits to -# feature branches do not trigger this pipeline, but open pull requests -# and commits to pull requests do. -#============================================================================= -trigger: - branches: - include: - - dev* - - patch* - - bugfix* -pr: - branches: - include: - - '*' - -# Basic agent and container set up -pool: - vmImage: 'ubuntu-latest' -container: geoschem/buildmatrix:netcdf-ubuntu - - -# Try building GEOS-Chem -steps: -- checkout: self - submodules: recursive -- script: | - . /opt/spack/share/spack/setup-env.sh - export CC=gcc - export CXX=g++ - export FC=gfortran - set -x - spack load cmake - spack load netcdf-c - spack load netcdf-fortran - mkdir build - cd build - cmake -DCMAKE_COLOR_MAKEFILE=FALSE $(Build.Repository.LocalPath) - make -j - displayName: 'Building GEOS-Chem' diff --git a/.ci-pipelines/release.dockerfile b/.ci-pipelines/release.dockerfile deleted file mode 100644 index 2a0da0d88..000000000 --- a/.ci-pipelines/release.dockerfile +++ /dev/null @@ -1,43 +0,0 @@ -FROM geoschem/buildmatrix:netcdf-ubuntu - -# Make a directory to install GEOS-Chem to -RUN mkdir /opt/geos-chem && mkdir /opt/geos-chem/bin - -# Copy the GEOS-Chem repository (".") to /gc-src -# This means this docker build command's context must be -# GEOS-Chem's root source code directory -COPY . /gc-src -RUN cd /gc-src \ -&& mkdir build - -RUN echo ". /opt/spack/share/spack/setup-env.sh" >> /init.rc \ -&& echo "export CC=gcc" >> /init.rc \ -&& echo "export CXX=g++" >> /init.rc \ -&& echo "export FC=gfortran" >> /init.rc \ -&& echo "spack load cmake" >> /init.rc \ -&& echo "spack load netcdf-c" >> /init.rc \ -&& echo "spack load netcdf-fortran" >> /init.rc \ -&& echo 'export PATH=$PATH:/opt/geos-chem/bin' >> /init.rc - -# Make bash the default shell -SHELL ["/bin/bash", "-c"] - -# Build fullchem and copy the executable to /opt/geos-chem/bin -RUN source /init.rc \ -&& cd /gc-src/build \ -&& cmake -DCMAKE_COLOR_MAKEFILE=FALSE .. \ -&& make \ -&& cp bin/gcclassic /opt/geos-chem/bin/ \ -&& rm -rf /gc-src/build/* - -# Create fake createRunDir.sh that calls the actual one -RUN echo "#!/usr/bin/env bash" > /opt/geos-chem/bin/createRunDir.sh \ -&& echo "cd /gc-src/run" >> /opt/geos-chem/bin/createRunDir.sh \ -&& echo "bash createRunDir.sh" >> /opt/geos-chem/bin/createRunDir.sh \ -&& chmod +x /opt/geos-chem/bin/createRunDir.sh - -RUN echo "#!/usr/bin/env bash" > /usr/bin/start-container.sh \ -&& echo ". /init.rc" >> /usr/bin/start-container.sh \ -&& echo 'if [ $# -gt 0 ]; then exec "$@"; else /bin/bash ; fi' >> /usr/bin/start-container.sh \ -&& chmod +x /usr/bin/start-container.sh -ENTRYPOINT ["start-container.sh"] diff --git a/.ci-pipelines/release.yml b/.ci-pipelines/release.yml deleted file mode 100644 index 906aebb8e..000000000 --- a/.ci-pipelines/release.yml +++ /dev/null @@ -1,57 +0,0 @@ -#============================================================================= -# Release pipeline: -# -# This pipeline performs deployment actions upon a GEOS-Chem release. -# Currently, the only deployment action is to build and push a docker -# container with GCClassic for the newly release version. This only includes -# the executable for fullchem. -# -# This pipeline is triggered by tagged versions excluding -# pre-releases. -#============================================================================= -trigger: - branches: - exclude: - - '*' - tags: - include: - - '*' - exclude: - - '*-alpha*' - - '*-beta*' - - '*-rc*' - - 'GEOS_*' -pr: none - - -# Basic agent set up -pool: - vmImage: 'ubuntu-latest' - -# Login to Docker Hub, build the image, and push the built image -# to Docker Hub -steps: - - checkout: self - submodules: recursive - - script: VERSION_TAG=`git describe --tags` && echo "##vso[task.setvariable variable=VERSION_TAG]$VERSION_TAG" - displayName: Get the repo's tag - - task: Docker@2 - displayName: Login to Docker Hub - inputs: - command: login - containerRegistry: DockerHub # The name of the service connection in the Azure project - - task: Docker@2 - displayName: Build image - inputs: - command: build - buildContext: $(Build.Repository.LocalPath) # The path to the source code repo - Dockerfile: .ci-pipelines/release.dockerfile - repository: geoschem/gcclassic # Docker Hub repository - tags: $(VERSION_TAG) # Source code repo's tag - - task: Docker@2 - displayName: Push image - inputs: - containerRegistry: DockerHub - repository: geoschem/gcclassic # Docker Hub repository - command: push - tags: $(VERSION_TAG) diff --git a/.github/workflows/cloud-benchmarking-workflow.yml b/.github/workflows/cloud-benchmarking-workflow.yml index 5c4f9fcdd..bf60a14e1 100644 --- a/.github/workflows/cloud-benchmarking-workflow.yml +++ b/.github/workflows/cloud-benchmarking-workflow.yml @@ -1,7 +1,7 @@ # Release pipeline: -# +# # This pipeline triggers the cloud-based benchmarking workflow -# upon pushes to the dev environment. The benchmarking workflow +# upon pushes to the dev environment. The benchmarking workflow # infrastructure code can be found in the following repository: # https://github.com/geoschem/gc-cloud-infrastructure # @@ -9,50 +9,57 @@ # # Notes: # - This workflow requires aws credentials necessary to -# trigger the benchmarking step function via the aws cli. -# The credentials need step function permissions and can -# be added to the repo as an action secret called +# trigger the benchmarking step function via the aws cli. +# The credentials need step function permissions and can +# be added to the repo as an action secret called # AWS_SECRET_ACCESS_KEY and AWS_ACCESS_KEY_ID. name: cloud_benchmarking on: push: branches: - - dev** + - dev/* tags: - '*' pull_request: branches: - - dev** + - dev/* jobs: trigger_step_function: runs-on: ubuntu-latest # aws cli comes pre-installed steps: + # for now both use Spot instances -- may need to update to use on demand - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 with: fetch-depth: 0 persist-credentials: false + + # By default we use 1Hr benchmarks - name: Set Initial Variables - # By default we use 1Hr benchmarks run: | echo "TIME_PERIOD=1Hr" >> $GITHUB_ENV echo "RESOLUTION=4x5" >> $GITHUB_ENV - echo "GITHUB_SHA_SHORT=`echo ${GITHUB_SHA} | cut -c1-7`" >> $GITHUB_ENV - echo "COMMIT_NAME=`echo ${GITHUB_SHA} | cut -c1-7`" >> $GITHUB_ENV - # conditionally overwrite variables if a tag was the triggering event + echo "GITHUB_SHA_SHORT=${GITHUB_SHA:0:7}" >> $GITHUB_ENV + echo "COMMIT_NAME=${GITHUB_SHA:0:7}" >> $GITHUB_ENV + + # Conditionally overwrite variables if a tag was the triggering event - name: Reset Initial Variables for pull request - run: | - echo "GITHUB_SHA_SHORT=`echo ${{ github.event.pull_request.head.sha }} | cut -c1-7`" >> $GITHUB_ENV - echo "COMMIT_NAME=`echo ${{ github.event.pull_request.head.sha }} | cut -c1-7`" >> $GITHUB_ENV if: github.event_name == 'pull_request' + env: + GITHUB_SHA_SHORT: ${{ github.event.pull_request.head.sha }} + run: | + echo "GITHUB_SHA_SHORT=${GITHUB_SHA_SHORT:0:7}" >> $GITHUB_ENV + echo "COMMIT_NAME=${GITHUB_SHA_SHORT:0:7}" >> $GITHUB_ENV + + # We do a 1Month benchmark for tags - name: Reset Variables For Tags - # We do a 1Month benchmark for tags + if: startsWith(github.ref, 'refs/tags/') run: | echo "TIME_PERIOD=1Mon" >> $GITHUB_ENV echo "COMMIT_NAME=${GITHUB_REF##*/}" >> $GITHUB_ENV - if: startsWith(github.ref, 'refs/tags/') + - name: Generate Primary Key env: AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }} @@ -63,6 +70,7 @@ jobs: cd ${{ github.workspace }} echo "DEV_PRIMARY_KEY=gcc-${RESOLUTION}-${TIME_PERIOD}-`git describe --tags`" >> $GITHUB_ENV echo "REF_PRIMARY_KEY=`./.github/workflows/findRefKey.sh ${RESOLUTION} ${TIME_PERIOD} ${GITHUB_SHA}`" >> $GITHUB_ENV + - name: Trigger Step Function env: # Set config options for aws cli @@ -88,7 +96,7 @@ jobs: `"\"timePeriod\": \"${TIME_PERIOD}\","` `"\"tag\": \"${COMMIT_NAME}\","` `"\"numCores\": \"${NUM_CORES}\","` - `"\"memory\": \"40000\","` + `"\"memory\": \"40000\","` `"\"resolution\": \"${RESOLUTION}\","` `"\"sendEmailNotification\": \"true\""` `"},"` diff --git a/.github/workflows/gcclassic-compile-tests.yml b/.github/workflows/gcclassic-compile-tests.yml index 77940a3b1..037002e08 100644 --- a/.github/workflows/gcclassic-compile-tests.yml +++ b/.github/workflows/gcclassic-compile-tests.yml @@ -1,7 +1,13 @@ +# +# GitHub Actions configuration file to perform "compile-only" +# integration tests for GEOS-Chem Classic that are triggered by +# push or pull requests. +# name: gcclassic-compile-tests on: [pull_request, push] +# Cancel running jobs if new commits are pushed concurrency: group: ${{ github.workflow }}-${{ github.ref || github.run_id }} cancel-in-progress: true diff --git a/.github/workflows/lint-ci-workflows.yml b/.github/workflows/lint-ci-workflows.yml index 80d2d43a7..2f09ab478 100644 --- a/.github/workflows/lint-ci-workflows.yml +++ b/.github/workflows/lint-ci-workflows.yml @@ -3,9 +3,10 @@ name: Lint # Controls when the workflow will run on: - # Triggers the workflow on pushes to the "main" branch, i.e., PR merges + # Triggers the workflow on pushes to the "main" or "dev/"* branches, + # i.e., PR merges push: - branches: [ "main" ] + branches: [ "main", "dev/*" ] # Triggers the workflow on pushes to open pull requests with code changes pull_request: @@ -13,8 +14,13 @@ on: - '.github/workflows/*.yml' # Allows you to run this workflow manually from the Actions tab + # (usually leave it blank) workflow_dispatch: +# Allow the jobs to read the secret GitHub token +permissions: + contents: read + # Cancel jobs running if new commits are pushed concurrency: group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }} @@ -22,26 +28,39 @@ concurrency: # Workflow run - one or more jobs that can run sequentially or in parallel jobs: + # This workflow contains a single job called "lint" lint: + # The type of runner that the job will run on runs-on: ubuntu-latest + + # Don't quit the Action at the first strategy: fail-fast: false - # Steps represent a sequence of tasks that will be executed as part of the job + # GitHub secret token + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + # Steps represent a sequence of tasks that will be + # executed as part of the job steps: - # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it + + # Checks-out your repository under $GITHUB_WORKSPACE, + # so your job can access it - name: Checkout code with: persist-credentials: false uses: actions/checkout@v4 + # Installs Python 3.x - name: Install Python uses: actions/setup-python@v5 with: python-version: '3.x' + # Installs Python packages - name: Install dependencies run: | python -m pip install --upgrade pip diff --git a/CHANGELOG.md b/CHANGELOG.md index 43838d3de..e5a57b2cd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [14.7.0] - 2026-02-06 +### Added +- Added "GEOS-Chem Classic vertical grids" supplemental guide in ReadTheDocs +- Added "GEOS-Chem Classic horiziontal grids" supplemental guide in ReadTheDocs +- Added "Particulate matter in GEOS-Chem" supplemental guide in ReadTheDocs +- Added `docs/read_the_docs_environment.yml` Conda environment file + +### Changed +- Updated `lint-ci-workflows` to run on `main` and `dev/*` branches +- Updated badges on `README.md` and `docs/source/index.rst` +- Updated `geos-chem-shared-docs/editing_these_docs.rst` with instructions for using a Conda environment to build RTD doc +- Updated GEOS-Chem submodule to version 14.7.0 +- Updated HEMCO submodule to version 3.12.0 +- Updated geos-chem-shared-docs submodule to commit 03078d4 + +### Fixed +- Fixed security issues in GitHub Actions that caused the `lint-ci-workflows` action to fail + +### Removed +- Removed the Azure Dev Pipelines workflows; these are now superseded by the `gcclassic-compile-tests` GitHub action + ## [14.6.3] - 2025-07-28 ### Added - Added `-DDEBUG` flag to `GEOSChem_Fortran_FLAGS_DEBUG_Intel` and `GEOSChem_Fortran_FLAGS_DEBUG_GNU` to toggle debug-only code @@ -17,7 +38,7 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). - Updated `CMakeLists.txt` to set compilation option `mcmodel=small` for ARM-based CPUs, as ARM does not support `mcmodel=medium` - Updated ReadTheDocs documentation to state that we are using Spack v0.23.1 in the Spack installation guide - Updated GEOS-Chem submodule to 14.6.3 -- Updated HEMCO submodule to 3.11.2 +- Updated HEMCO submodule to 3.11. ## [14.6.2] - 2025-06-12 ### Changed diff --git a/CMakeLists.txt b/CMakeLists.txt index e1578db39..4eb8a32ce 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -2,7 +2,7 @@ cmake_minimum_required (VERSION 3.13) project (geos-chem-classic - VERSION 14.6.3 + VERSION 14.7.0 LANGUAGES Fortran ) diff --git a/README.md b/README.md index 075a1e416..e65829f42 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,14 @@ GEOS-Chem Logo

- - - -
- DOI - - - + Latest release + Release date + DOI
+ License + gcclassic-compile-tests + ReadTheDocs

- ## Description This is the offical repository for **GEOS-Chem Classic**. diff --git a/docs/read_the_docs_environment.yml b/docs/read_the_docs_environment.yml new file mode 100644 index 000000000..5aefcac13 --- /dev/null +++ b/docs/read_the_docs_environment.yml @@ -0,0 +1,24 @@ +--- +# ====================================================================== +# ReadTheDocs environment file +# +# If you wish to build a Mamba/Conda environment with the dependencies +# needed for building the ReadTheDocs documentation, use: +# +# $ mamba env create -n rtd_env --file=read_the_docs_environment.yml +# ====================================================================== +name: rtd_env +channels: + - conda-forge + - nodefaults +dependencies: + - python==3.12.0 + - sphinx==7.2.6 + - sphinx_rtd_theme==2.0.0 + - sphinxcontrib-bibtex==2.6.2 + - sphinx-autobuild==2021.3.14 + - recommonmark==0.7.1 + - docutils==0.20.1 + - jinja2==3.1.6 + + diff --git a/docs/source/.DS_Store b/docs/source/.DS_Store new file mode 100644 index 000000000..4f45bda41 Binary files /dev/null and b/docs/source/.DS_Store differ diff --git a/docs/source/conf.py b/docs/source/conf.py index 231bc35e1..07d7a7c03 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -23,7 +23,7 @@ author = 'GEOS-Chem Support Team' # The full version, including alpha/beta/rc tags -release = '14.6.3' +release = '14.7.0' # -- General configuration --------------------------------------------------- diff --git a/docs/source/gcclassic-user-guide/compile-cmake.rst b/docs/source/gcclassic-user-guide/compile-cmake.rst index 1fc6398c5..0df37abe4 100644 --- a/docs/source/gcclassic-user-guide/compile-cmake.rst +++ b/docs/source/gcclassic-user-guide/compile-cmake.rst @@ -132,7 +132,7 @@ generate output similar to this: ================================================================= ================================================================= Cloud-J G.H.I - Current status: 8.0.2 + Current status: G.H.I ================================================================= ================================================================= GEOS-Chem X.Y.Z (science codebase) @@ -290,7 +290,7 @@ values are: Activates OpenMP parallelization. **(Default option)** GEOS-Chem Classic will execute on as many computational cores as - is specified with :option:`OMP_NUM_THREADS`. + is specified with :ref:`env-files-envvars-parallel-threads`. .. option:: n diff --git a/docs/source/gcclassic-user-guide/diag-outputs-hist.rst b/docs/source/gcclassic-user-guide/diag-outputs-hist.rst index e5c26fbd9..065531824 100644 --- a/docs/source/gcclassic-user-guide/diag-outputs-hist.rst +++ b/docs/source/gcclassic-user-guide/diag-outputs-hist.rst @@ -21,92 +21,117 @@ The filenames listed below correspond to the default diagnostic collections in the :ref:`HISTORY.rc configuration file `. -.. table:: GEOS-Chem History diagnostics output files - :align: center +.. list-table:: GEOS-Chem History diagnostics output files + :header-rows: 1 + :widths: 40 30 30 - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | History output file | Diagnostic collection | Used in simulations | - +==========================================================+=====================================+=============================+ - | :file:`GEOSChem.AdvFluxVert.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-advfluxvert` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.AerosolMass.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-aerosolmass` | :option:`fullchem` | - | | | :option:`aerosol` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.Aerosols.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-aerosols` | :option:`fullchem` | - | | | :option:`aerosol` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.BoundaryConditions.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-boundaryconditions` | Nested-grid simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.Carbon.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-carbon` | :option:`carbon` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.CH4.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-ch4` | :option:`CH4` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.CloudConvFlux.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-cloudconvflux` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.CO.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-co` | :option:`CH4` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.CO2.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-co2` | :option:`CH4` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.ConcAboveSfc.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-concabovesfc` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.ConcAfterChem.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-concafterchem` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.DryDep.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-drydep` | All simulations with dry- | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.JValues.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-jvalues` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.KppARDiags.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-kppardiags` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.KppDiags.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-kppdiags` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.LevelEdgeDiags.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-leveledgediags` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.MercuryChem.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-mercurychem` | :option:`Hg` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.MercuryEmis.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-mercuryemis` | :option:`Hg` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.MercuryOcean.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-mercuryocean` | :option:`Hg` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.Metrics.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-metrics` | :option:`fullchem` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.ProdLoss.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-prodloss` | :option:`fullchem` | - | | | :option:`aerosol` | - | | | :option:`tagCO` | - | | | :option:`tagO3` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.RadioNuclide.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-radionuclide` | :option:`TransportTracers` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.Restart.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-restart` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.RRTMG.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-rrtmg` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.RxnConst.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-rxnconst` | :option:`fullchem` | - | | | :option:`CH4` | - | | | :option:`Hg` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.RxnRates.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-rxnrates` | :option:`fullchem` | - | | | :option:`CH4` | - | | | :option:`Hg` | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.SatDiagn.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-satdiagn` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.SatDiagnEdge.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-satdiagnedge` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.SpeciesConc.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-speciesconc` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.StateChm.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-statechm` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.StateMet.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-statemet` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.StratBM.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-stratbm` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.Tomas.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-tomas` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.UVFlux.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-uvflux` | All simulations | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.WetLossConv.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-wetlossconv` | All simulations with | - | | | wet-deposited species | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ - | :file:`GEOSChem.WetLossLS.YYYYMMDD_hhhmmz.nc4` | :ref:`histguide-wetlossls` | All simulations with | - | | | wet-deposited species | - +----------------------------------------------------------+-------------------------------------+-----------------------------+ + * - History output file + - Diagnostic collection + - Used in simulations + * - :file:`GEOSChem.AdvFluxVert.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-advfluxvert` + - :option:`fullchem` + * - :file:`GEOSChem.AerosolMass.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-aerosolmass` + - :option:`fullchem` + :option:`aerosol` + * - :file:`GEOSChem.Aerosols.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-aerosols` + - :option:`fullchem` + :option:`aerosol` + * - :file:`GEOSChem.BoundaryConditions.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-boundaryconditions` + - Nested-grid simulations + * - :file:`GEOSChem.Carbon.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-carbon` + - :option:`carbon` + * - :file:`GEOSChem.CloudConvFlux.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-cloudconvflux` + - All simulations + * - :file:`GEOSChem.ConcAboveSfc.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-concabovesfc` + - :option:`fullchem` + * - :file:`GEOSChem.ConcAfterChem.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-concafterchem` + - :option:`fullchem` + * - :file:`GEOSChem.DryDep.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-drydep` + - All simulations with dry-depositing species + * - :file:`GEOSChem.JValues.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-jvalues` + - :option:`fullchem` + * - :file:`GEOSChem.KppARDiags.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-kppardiags` + - :option:`fullchem` + * - :file:`GEOSChem.KppDiags.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-kppdiags` + - :option:`fullchem` + * - :file:`GEOSChem.MercuryChem.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-mercurychem` + - :option:`Hg` + * - :file:`GEOSChem.MercuryEmis.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-mercuryemis` + - :option:`Hg` + * - :file:`GEOSChem.MercuryOcean.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-mercuryocean` + - :option:`Hg` + * - :file:`GEOSChem.Metrics.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-metrics` + - :option:`fullchem` + * - :file:`GEOSChem.ProdLoss.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-prodloss` + - :option:`fullchem` + :option:`aerosol` + :option:`tagO3` + * - :file:`GEOSChem.RadioNuclide.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-radionuclide` + - :option:`TransportTracers` + * - :file:`GEOSChem.Restart.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-restart` + - All simulations + * - :file:`GEOSChem.RRTMG.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-rrtmg` + - All simulations + * - :file:`GEOSChem.RxnConst.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-rxnconst` + - :option:`fullchem` + :option:`carbon` + :option:`Hg` + * - :file:`GEOSChem.RxnRates.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-rxnrates` + - :option:`fullchem` + :option:`carbon` + :option:`Hg` + * - :file:`GEOSChem.SatDiagn.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-satdiagn` + - All simulations + * - :file:`GEOSChem.SatDiagnEdge.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-satdiagnedge` + - All simulations + * - :file:`GEOSChem.SpeciesConc.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-speciesconc` + - All simulations + * - :file:`GEOSChem.StateChm.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-statechm` + - All simulations + * - :file:`GEOSChem.StateMet.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-statemet` + - All simulations + * - :file:`GEOSChem.StateMetLevEdge.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-statemetlevedge` + - All simulations + * - :file:`GEOSChem.StratBM.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-stratbm` + - All simulations + * - :file:`GEOSChem.Tomas.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-tomas` + - All simulations + * - :file:`GEOSChem.UVFlux.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-uvflux` + - All simulations + * - :file:`GEOSChem.WetLossConv.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-wetlossconv` + - All simulations with wet-depositing species + * - :file:`GEOSChem.WetLossLS.YYYYMMDD_hhhmmz.nc4` + - :ref:`histguide-wetlossls` + - All simulations with wet-depositing species diff --git a/docs/source/gcclassic-user-guide/dry-run-download.rst b/docs/source/gcclassic-user-guide/dry-run-download.rst index e2f964a3b..1f215ee62 100644 --- a/docs/source/gcclassic-user-guide/dry-run-download.rst +++ b/docs/source/gcclassic-user-guide/dry-run-download.rst @@ -11,32 +11,7 @@ Download data from dry-run output Once you have successfully executed a GEOS-Chem dry-run, you can use the output from the dry-run (contained in the :file:`log.dryrun` file) to download the data files that GEOS-Chem will need to perform the -corresponding "production" simulation. You may download from different -:ref:`data repositories `. - -.. important:: - - Before you use the :file:`download_data.py` script, make sure to - initialize a Mamba or Conda environment with the relevant command - shown below: - - .. code-block:: console - - $ mamba activate ENV-NAME # If using Mamba - - $ conda activate ENV-NAME # If using Conda - - Here :literal:`ENV-NAME` is the name of your environment. - - Also make sure that you have installed the PyYAML module to your - conda environment. PyYAML will allow the :file:`download_data.py` - script to read certain configurable settings from a YAML file in - your run directory. - - The Python environment for GCPy has all of the proper packages - that you need to download data from a dry-run simulation. For - more information, please see `gcpy.readthedocs.io - `_. +corresponding "production" simulation. .. _dry-run-data-download-portal: @@ -76,18 +51,47 @@ listed below. - No - No +Most of the data that you will need is contained in the +:ref:`GEOS-Chem Input Data ` portal. + +.. _dry-run-download-activate: + +==================================== +Activate the GCPy Python environment +==================================== + +You will need to activate a Python environment before you can start +downloading data. We recommend using the Python environment for `GCPy +`_, as it has all of the relevant +packages installed. If you `installed GCPy from PyPI +`_, +then no further action is needed. On the other hand, if you +`installed GCPy from conda-forge +`_, +you will need to activate the GCPy Python environment with this +command: + +.. code-block:: console + + $ conda activate gcpy_env + (gcpy_env) $ + +The prefix :literal:`(gcpy_env)` will be added to the command prompt, +which lets you know that the Python environment is active. (If you +installed GCPy from PyPI, you will not see this prefix.) + .. _dry-run-download-py: ============================================================== Run the :file:`download_data.py` script on the dryrun log file ============================================================== -Navigate to your GEOS-Chem run directory where you executed the dry-run -and type. +Navigate to your GEOS-Chem run directory. The command that you will +use to download data takes the form: .. code-block:: console - $ ./download_data.py log.dryrun PORTAL-NAME + (gcpy_env) $ ./download_data.py log.dryrun PORTAL-NAME where: @@ -132,21 +136,33 @@ where: - :ref:`GCAP 2.0 met data @ Rochester ` - :command:`wget` - HTTP + * - skip-download + - :ref:`Skips downloading data ` + - N/A + - N/A For example, to download data from the :ref:`GEOS-Chem Input Data -` portal using the AWS CLI download (which is faster than -HTTP download), use this command: +` portal, use this command: + +.. code-block:: console + + (gcpy_env) $ ./download_data.py log.dryrun geoschem+http + +But if you have `AWS CLI (command-line interface) +`_ set up on your machine, use +this command instead: .. code-block:: console - $ ./download_data.py log.dryrun geoschem+s3 + (gcpy_env) $ ./download_data.py log.dryrun geoschem+aws -.. note:: +This will result in a much faster data transfer than by HTTP. This is +also the command you will use if you are running GEOS-Chem Classic on +an AWS EC2 cloud instance. - You must have the `AWS CLI (command-line interface) - `_ software installed on your system - before in order to use the :literal:`geoschem+aws` or - :literal:`nested+aws` options in the table listed above. +=============================================== +(Optional) Examine the log of unique data files +=============================================== The :file:`download_data.py` program will generate a **log of unique data files** (i.e. with all duplicate listings removed), which @@ -187,13 +203,7 @@ example, we passed :file:`log.dryrun` to :file:`download_data.py`, so the "unique" log file will be named :file:`log.dryrun.unique`. This "unique" log file can be very useful for documentation purposes. -.. _dry-run-download-skip: - -============================================= -Skip download, but create log of unique files -============================================= - -If you wish to only produce the \*log of unique data files without +If you wish to only produce the **log of unique data files** without downloading any data, then type the following command from within your GEOS-Chem run directory: @@ -210,3 +220,63 @@ or for short: This can be useful if you already have the necessary data downloaded to your system but wish to create the log of unique files for documentation purposes (such as for benchmark simulations, etc.) + +.. _dry-run-download-deactivate: + +====================================== +Deactivate the GCPy Python environment +====================================== + +Once you have downloaded all of the data needed for your GEOS-Chem +Classic simulation, you can deactivate the GCPy Python environment. + +.. code-block:: console + + (gcpy_env) $ conda deactivate + $ + +This will remove the :literal:`(gcpy_env)` prefix from the command prompt. + +=============================================== +(Optional) Download additional meteorology data +=============================================== + +You may need to perform a subsequent dry-run simulation to download +additional data that are stored separately from the :ref:`GEOS-Chem +Input Data portal `: + +#. If you plan to run a :ref:`GEOS-Chem Classic nested-grid simulation + ` with meteorology fields that have been cropped to a + :ref:`specific nested grid domain `, then follow + these steps: + + .. code-block:: console + + $ ./gcclassic --dryrun | tee log.dryrun.nested + + $ conda activate gcpy_env # Skip if using GCPy from PyPI + + (gcpy_env) $ ./download_data.py log.dryrun.nested nested+http # or nested+aws if you have AWSCLI + + (gcpy_env) $ conda deactivate # Skip if using GCPy from PyPI + + This will download the cropped meteorology fields from our + :ref:`GEOS-Chem Nested Input Data portal + ` to your computer system or EC2 instance. + +#. If you plan to perform a GEOS-Chem Classic simulation drven by GCAP + 2.0 meteorology, follow these steps: + + .. code-block:: console + + $ ./gcclassic --dryrun | tee log.dryrun.gcap2 + + $ conda activate gcpy_env # Skip if using GCPy from PyPI + + (gcpy_env) $ ./download_data.py log.dryrun.gcap2 rochester + + (gcpy_env) $ conda deactivate # Skip if using GCPy from PyPI + + This will download the GCAP 2.0 meteorology data from the + :ref:`GCAP 2.0 data portal hosted at U. Rochester + ` to your computer system or EC2 instance. diff --git a/docs/source/gcclassic-user-guide/dry-run-run.rst b/docs/source/gcclassic-user-guide/dry-run-run.rst index ce9f11209..916da0c37 100644 --- a/docs/source/gcclassic-user-guide/dry-run-run.rst +++ b/docs/source/gcclassic-user-guide/dry-run-run.rst @@ -1,3 +1,7 @@ +.. |br| raw:: html + +
+ .. _dry-run-run: ############################ @@ -19,59 +23,71 @@ Make sure that you have done the following steps; Then doublecheck these settings in the following :ref:`configuration files `: -.. option:: geoschem_config.yml - - #. :option:`start_date`: Set the start date and time for your simulation. - #. :option:`end_date`: Set the end date and time for your simulation. - #. :option:`met_field`: Check if the meteorology setting - (:option:`GEOS-FP`, :option:`MERRA2`, :option:`GCAP2`) is - correct for your simulation. - - .. attention:: - - The convection scheme used to generate archived GEOS-FP - meteorology files changed from RAS to Grell-Freitas starting - 01 June 2020 with impact on vertical transport. Discussion - and analysis of the impact is available at - https://github.com/geoschem/geos-chem/issues/1409. - - To fix this issue, different GEOS-Chem convection schemes are - called based on simulation start time. This ensures - comparability in GEOS-Chem runs using GEOS-FP fields - generated using the RAS convection scheme and fields - generated using Grell-Freitas, but only if the simulation - does not cross the 01 June 2020 boundary. We therefore - recommend splitting up GEOS-FP runs in time such that a - single simulation does not span this date. For example, - configure one run to end on 01 June 2020 and then use its - output restart to start another run on 01 June - 2020.. Alternatively consider using MERRA2 which was entirely - generated with RAS, or GEOS-IT which was entirely generated - with Grell-Freitas. If you wish to use a GEOS-FP meteorology - year different from your simulation year please create a - GEOS-Chem GitHub issue for assistance to avoid accidentally - using zero convective precipitation flux. - - #. :option:`root_data_dir`: Make sure that the path to - :file:`ExtData` is correct. - -.. option:: HISTORY.rc - - #. Set the frequency and duration for each :ref:`diagnostic - collection ` to be consistent with the - settings in :option:`geoschem_config.yml`. - -.. option:: HEMCO_Config.rc - - #. Check the `Settings section - `_ - to make sure that diagnostic frequency :envvar:`DiagnFreq`: is - set to the interval that you wish (e.g. :envvar:`Monthly`, - :envvar:`Daily`, :envvar:`YYYYMMDD hhmmss`, etc). - #. Check the `Extension Settings section - `_, - to make sure all of the required emissions inventories and data - sets for your simulation have been switched on. + +geoschem_config.yml +------------------- + +#. :ref:`gc-yml-simulation-start`: Set the start date and time for + your simulation. |br| + |br| + +#. :ref:`gc-yml-simulation-end`: Set the end date and time for your + simulation. |br| + |br| + +#. :ref:`gc-yml-simulation-met`: Check if the meteorology setting + (:option:`GEOS-FP`, :option:`GEOS-IT`, :option:`MERRA2`, + :option:`GCAP2`) is correct for your simulation. + + .. attention:: + + The convection scheme used to generate archived GEOS-FP + meteorology files changed from RAS to Grell-Freitas starting + 01 June 2020 with impact on vertical transport. Discussion + and analysis of the impact is available at + https://github.com/geoschem/geos-chem/issues/1409. + + To fix this issue, different GEOS-Chem convection schemes are + called based on simulation start time. This ensures + comparability in GEOS-Chem runs using GEOS-FP fields + generated using the RAS convection scheme and fields + generated using Grell-Freitas, but only if the simulation + does not cross the 01 June 2020 boundary. We therefore + recommend splitting up GEOS-FP runs in time such that a + single simulation does not span this date. For example, + configure one run to end on 01 June 2020 and then use its + output restart to start another run on 01 June + 2020.. Alternatively consider using MERRA2 which was entirely + generated with RAS, or GEOS-IT which was entirely generated + with Grell-Freitas. If you wish to use a GEOS-FP meteorology + year different from your simulation year please create a + GEOS-Chem GitHub issue for assistance to avoid accidentally + using zero convective precipitation flux. + +#. :ref:`gc-yml-simulation-root`: Make sure that the path to + :file:`ExtData` is correct. + +HISTORY.rc +---------- + +#. Set the frequency and duration for each :ref:`diagnostic + collection ` to be consistent with the + settings in :ref:`cfg-gc-yml`. + +HEMCO_Config.rc +--------------- + +#. Check the `Settings section + `_ + to make sure that diagnostic frequency :envvar:`DiagnFreq`: is + set to the interval that you wish (e.g. :envvar:`Monthly`, + :envvar:`Daily`, :envvar:`YYYYMMDD hhmmss`, etc). |br| + |br| + +#. Check the `Extension Settings section + `_, + to make sure all of the required emissions inventories and data + sets for your simulation have been switched on. .. tip:: diff --git a/docs/source/gcclassic-user-guide/get-code-steps.rst b/docs/source/gcclassic-user-guide/get-code-steps.rst index d9e7ad74b..39db861ee 100644 --- a/docs/source/gcclassic-user-guide/get-code-steps.rst +++ b/docs/source/gcclassic-user-guide/get-code-steps.rst @@ -257,10 +257,10 @@ For more information about downloading the GEOS-Chem source code, please see the following Youtube video tutorials: - `Getting Started with GEOS-Chem - `_ + `_ - - `GEOS-Chem Classic Quickstart Guide (with dry-run) - `_ + - `GEOS-Chem Classic Quickstart Guide (with dry-run simulation) + `_ - `Managing branches between superproject and submodules `_ diff --git a/docs/source/gcclassic-user-guide/restart-files-gc.rst b/docs/source/gcclassic-user-guide/restart-files-gc.rst index 03454208a..8081636fc 100644 --- a/docs/source/gcclassic-user-guide/restart-files-gc.rst +++ b/docs/source/gcclassic-user-guide/restart-files-gc.rst @@ -10,12 +10,52 @@ GEOS-Chem restart files How are restart files read into GEOS-Chem? ========================================== -GEOS-Chem restart files are read via `HEMCO -`_. The entries listed below have been -added to :file:`HEMCO_Config.rc` (and may vary slightly for different -simulation types). These fields are obtained from HEMCO and copied to -the appropriate :code:`State_Chm` and :code:`State_Met` fields in -routine :code:`Get_GC_Restart` (located in +GEOS-Chem restart files may be read via `HEMCO +`_ or via GEOS-Chem. If using HEMCO then +all fields are read as single precision floating point +(:code:`REAL*4`). If using GEOS-Chem then all fields are read with +the native precision stored in the file, e.g. double precision +floating point (:code:`REAL*8`) for species concentrations. Using +HEMCO is on by default, but you may choose to use GEOS-Chem instead by +updating the :file:`geoschem_config.yml` configuration file entry +:literal:`read_restart_as_real8` to :literal:`true`. + +There are pros and cons to both methods of reading the GEOS-Chem +restart file. Using HEMCO allows forcing the timestamp of the restart +file to match run start date and time as well as doing custom +alterations such as changing the names of the expected variables in +the file. It also allows online regridding and cropping of restart +files at run-time, a requirement for nested grid simulations if using +a global restart file. However, using HEMCO to read the restart file +prevents bit-for-bit reproducibility when restarting a run and also +prevents restart file mass conservation. This is because of the +precision loss associated with reading restart fields as +:code:`REAL*4` when they are stored internally in the model as +:code:`REAL*8`. + +Using GEOS-Chem to read restart files enables bit-for-bit +reproducibility upon restart as well as file mass +conservation. However, it prevents using HEMCO read features. In +particular it is not appropriate to use if the restart file horizontal +grid does not match the run horizontal grid or if the restart file +needs to be cropped. In both cases the model will fail. The model will +also exit with an error message if using the mercury simulation since +this feature has not yet been validated for that simulation. + +================================ +Using HEMCO to read restart file +================================ + +This section pertains only to using HEMCO to read the GEOS-Chem +restart file. All fields are read in as :code:`REAL*4`. See the +section above if you instead wish to read fields at their native +precision. + +The entries for restart files are stored in +:file:`HEMCO_Config.rc`. They may vary slightly for different +simulation types. These fields are obtained from HEMCO and +copied to the appropriate :code:`State_Chm` and :code:`State_Met` +fields in routine :code:`Get_GC_Restart` (located in :file:`GeosCore/hcoi_gc_main_mod.F90`). .. code-block:: console @@ -42,24 +82,26 @@ GEOS-Chem species (the :file:`SPC_` entry) use HEMCO time cycle flag :code:`EFYO` by default. Other restart file fields use the time cycle flag :code:`EY`. These are explained below. -.. option:: E - - :command:`Exact`: Stops with an error if the date of the - simulation is different than the file timestamp. - -.. option:: F - - :command:`Forced`: Stops with an error if the file isn't found. - -.. option:: Y - - :command:`Simulation Year`: Only reads the data for the simulation - year but not for other years. - -.. option:: O - - :command:`Once`: Does not keep cycling in time but only reads the - file once. +.. list-table:: HEMCO time cycle flags used with GEOS-Chem restart files + :header-rows: 1 + :widths: 10 20 70 + + * - Flag + - Name + - Description + * - :command:`E` + - :command:`Exact` + - Stops with an error if the date of the simulation is different + than the file timestamp. + * - :command:`F` + - :command:`Forced` + - Stops with an error if the file isn't found. + * - :command:`Y` + - :command:`Simulation Year` + - Only reads the data for the simulation year but not for other years. + * - :command:`O` + - :command:`Once` + - Does not keep cycling in time but only reads the file once. When reading the **species concentrations** (time cycle flag: :code:`EFYO`) from the restart file, HEMCO will cause your simulation @@ -103,10 +145,10 @@ When reading **other restart file fields** (time cycle flag: Skipped species will be assigned the initial concentration (units: :math:`mol\ mol^{-1}` w/r/t dry air) specified by its - :option:`BackgroundVV` entry in :ref:`species_database.yml - `. If the species does not have a - :option:`BackgroundVV` value specified, then its initial - concentration will be set to :math:`1.0{\times}10^{-20}` + :ref:`spcguide-defs-other-bkgdvv` entry in + :ref:`species_database.yml `. If the species does not + have a :ref:`spcguide-defs-other-bkgdvv` value specified, then its + initial concentration will be set to :math:`1.0{\times}10^{-20}` instead. .. _restart-files-gc-date: @@ -115,7 +157,8 @@ When reading **other restart file fields** (time cycle flag: How can I determine the date of a restart file? =============================================== -To determine the date of a netCDF restart file, you may use :command:`ncdump`. +The date of the restart file is in the filename. It is also stored in the +file metadata. You may check the metadata using :command:`ncdump`. For example: .. code-block:: console @@ -126,6 +169,13 @@ The :command:`-t` option will return the time value in human-readable date-time strings rather than numerical values in unit such as :code:`"hours since 1985-1-1 00:00:0.0.` +If using HEMCO to read the restart file then the timestamp in the +filename and within the file must match the simulation start date and time. +You can change this by modifying :file:`HEMCO_Config.rc` (see earlier section +on using HEMCO to read restart files). If using GEOS-Chem +to read the restart file then only the date and time in the filename must +match the simulation start. + .. _restart-files-gc-where: ================================================= @@ -193,8 +243,14 @@ How do I check my initial conditions? ===================================== To ensure you are using the expected initial conditions for your -simulation, please check the GEOS-Chem log file. You should see -something like: +simulation please check the GEOS-Chem log file. You should see +min, max, and sum of all fields stored in the GEOS-Chem restart file +printed to log. If you enable the :literal:`verbose` option in configuration +file :file:`geoschem_config.yml` and your restart file contains meteorology +field :literal:`Met_DELPDRY` then you will also see the global mass per +species computed entirely from restart file values printed to log. This +mass can be compared to global mass printed at the start of each timestep +when in :literal:`verbose` mode to check mass conservation. .. code-block:: console diff --git a/docs/source/gcclassic-user-guide/restart-files-what.rst b/docs/source/gcclassic-user-guide/restart-files-what.rst index 1569345b9..e810bc64f 100644 --- a/docs/source/gcclassic-user-guide/restart-files-what.rst +++ b/docs/source/gcclassic-user-guide/restart-files-what.rst @@ -23,7 +23,7 @@ GEOS-Chem simulations use two separate restart files. :file:`GEOSChem.Restart.20190801_0000z.nc4`. The :file:`z` character indicates "Zulu" time (aka UTC). - GEOS-Chem restart files are created in the :option:`Restarts/` + GEOS-Chem restart files are created in the :file:`Restarts/` folder of your :ref:`GEOS-Chem run directory ` directory. .. option:: HEMCO_restart.YYYYMMDDhhmm.nc @@ -35,7 +35,7 @@ GEOS-Chem simulations use two separate restart files. and biogenic emissions in order to facilitate long GEOS-Chem simulations with several run stages. - HEMCO restart files are created in the :option:`Restarts/` + HEMCO restart files are created in the :file:`Restarts/` folder of your :ref:`GEOS-Chem run directory ` directory. When you run a GEOS-Chem simulation, it will write new GEOS-Chem restart diff --git a/docs/source/gcclassic-user-guide/run-cmd-line.rst b/docs/source/gcclassic-user-guide/run-cmd-line.rst index 54ae3bc45..7f34ee30c 100644 --- a/docs/source/gcclassic-user-guide/run-cmd-line.rst +++ b/docs/source/gcclassic-user-guide/run-cmd-line.rst @@ -56,7 +56,8 @@ The modifications entail: export OMP_NUM_THREADS=`ncpus` to the run script. This will automatically set - :option:`OMP_NUM_THREADS` to the available number of cores. + :ref:`env-files-envvars-parallel-threads` to the available + number of cores. To run GEOS-Chem interactively, type: diff --git a/docs/source/gcclassic-user-guide/run-script.rst b/docs/source/gcclassic-user-guide/run-script.rst index f7925ee7e..df381f39e 100644 --- a/docs/source/gcclassic-user-guide/run-script.rst +++ b/docs/source/gcclassic-user-guide/run-script.rst @@ -161,4 +161,5 @@ the :file:`gcclassic` executable. .. option:: srun -c $OMP_NUM_THREADS Tells SLURM to run the GEOS-Chem Classic executable using the - number of cores specified in :option:`OMP_NUM_THREADS`. + number of cores specified in + :ref:`env-files-envvars-parallel-threads`. diff --git a/docs/source/gcclassic-user-guide/rundir-carbon.rst b/docs/source/gcclassic-user-guide/rundir-carbon.rst index d04c682e2..e7d3e836e 100644 --- a/docs/source/gcclassic-user-guide/rundir-carbon.rst +++ b/docs/source/gcclassic-user-guide/rundir-carbon.rst @@ -74,9 +74,6 @@ simulation. We'll use the carbon gases simulation as an example. 6. Tagged O3 7. Trace metals 8. TransportTracers - 9. CH4 - 10. CO2 - 11. Tagged CO >>> To select the GEOS-Chem carbon gases specialty simulation, type diff --git a/docs/source/gcclassic-user-guide/rundir-fullchem.rst b/docs/source/gcclassic-user-guide/rundir-fullchem.rst index 08ebc6bd7..e90b444e4 100644 --- a/docs/source/gcclassic-user-guide/rundir-fullchem.rst +++ b/docs/source/gcclassic-user-guide/rundir-fullchem.rst @@ -71,9 +71,6 @@ GEOS-Chem full-chemistry simulation. 6. Tagged O3 7. Trace metals 8. TransportTracers - 9. CH4 - 10. CO2 - 11. Tagged CO >>> To create a run directory for the full-chemistry simulation, type diff --git a/docs/source/geos-chem-shared-docs b/docs/source/geos-chem-shared-docs index 3887938a1..03078d470 160000 --- a/docs/source/geos-chem-shared-docs +++ b/docs/source/geos-chem-shared-docs @@ -1 +1 @@ -Subproject commit 3887938a14f933607b597e04436e1741f102d017 +Subproject commit 03078d47075177a7c2684664a6afe15024272234 diff --git a/docs/source/getting-started/disk-space.rst b/docs/source/getting-started/disk-space.rst index faa9f5ac7..c3a463fa8 100644 --- a/docs/source/getting-started/disk-space.rst +++ b/docs/source/getting-started/disk-space.rst @@ -39,49 +39,108 @@ The amount of disk space that you will need depends on two things: .. _merra2-size-table: -.. table:: Disk space needed for 1-year of MERRA-2 data - - +--------------------------------------------+------------------+--------+ - | Resolution | Type | Size | - | | | GB/yr | - +============================================+==================+========+ - | :math:`1^{\circ}{\times}1.25^{\circ}` | Global | ~30 | - +--------------------------------------------+------------------+--------+ - | :math:`2^{\circ}{\times}2.5^{\circ}` | Global | ~110 | - +--------------------------------------------+------------------+--------+ - | :math:`0.5^{\circ}{\times}0.625^{\circ}` | Nested Asia | ~115 | - | | (aka AS) | | - +--------------------------------------------+------------------+--------+ - | :math:`0.5^{\circ}{\times}0.625^{\circ}` | Nested Europe | ~58 | - | | (aka EU) | | - +--------------------------------------------+------------------+--------+ - | :math:`0.5^{\circ}{\times}0.625^{\circ}` | Nested North | ~110 | - | | America (aka NA) | | - +--------------------------------------------+------------------+--------+ +MERRA-2 +~~~~~~~ + +.. list-table:: Disk space needed for 1-year of MERRA-2 data + :header-rows: 1 + :widths: 60 40 + + * - Grid + - Approzimate Size (GB/yr) + * - :ref:`gcc-hgrids-global-4x5` + - 30 + * - :ref:`gcc-hgrids-global-2x25` + - 110 + * - :ref:`gcc-hgrids-nested-05-as` + - 115 + * - :ref:`gcc-hgrids-nested-05-eu` + - 60 + * - :ref:`gcc-hgrids-nested-05-na` + - 110 .. _geosfp-size-table: -.. table:: Disk space needed for 1-year of GEOS-FP data - - +--------------------------------------------+------------------+--------+ - | Resolution | Type | Size | - | | | GB/yr | - +============================================+==================+========+ - | :math:`1^{\circ}{\times}1.25^{\circ}` | Global | ~30 | - +--------------------------------------------+------------------+--------+ - | :math:`2^{\circ}{\times}2.5^{\circ}` | Global | ~120 | - +--------------------------------------------+------------------+--------+ - | :math:`0.25^{\circ}{\times}0.3125^{\circ}` | Nested Asia | ~175 | - | | (aka AS) | | - +--------------------------------------------+------------------+--------+ - | :math:`0.25^{\circ}{\times}0.3125^{\circ}` | Nested Europe | ~175 | - | | (aka EU) | | - +--------------------------------------------+------------------+--------+ - | :math:`0.25^{\circ}{\times}0.3125^{\circ}` | Nested North | ~175 | - | | America (aka NA) | | - +--------------------------------------------+------------------+--------+ - -GCAP 2.0: to be added +GEOS-FP +~~~~~~~ + +.. list-table:: Disk space needed for 1-year of GEOS-FP data + :header-rows: 1 + :widths: 60 40 + + * - Grid + - Approximate Size (GB/yr) + * - :ref:`gcc-hgrids-global-4x5` + - 30 + * - :ref:`gcc-hgrids-global-2x25` + - 120 + * - :ref:`gcc-hgrids-nested-025-af` + - 434 + * - :ref:`gcc-hgrids-nested-025-as` + - 380 + * - :ref:`gcc-hgrids-nested-025-eu` + - 125 + * - :ref:`gcc-hgrids-nested-025-me` + - 175 + * - :ref:`gcc-hgrids-nested-025-na` + - 200 + * - :ref:`gcc-hgrids-nested-025-oc` + - 240 + * - :ref:`gcc-hgrids-nested-025-sa` + - 250 + * - :ref:`gcc-hgrids-nested-025-ru` + - 375 + * - :ref:`gcc-hgrids-nested-0125-af` + - 2,100 [#A]_ + * - :ref:`gcc-hgrids-nested-0125-as` + - 2,200 [#B]_ + * - :ref:`gcc-hgrids-nested-0125-na` + - 1,250 [#C]_ + * - :ref:`gcc-hgrids-nested-025-sa` + - 1,900 [#D]_ + +.. rubric:: Notes + +.. [#A] Winds, pressures, and specific humidity are read at 0.125° x + 0.15625° over the nested Africa domain. Other met fields are + taken from the GEOS-FP :ref:`gcc-hgrids-nested-025-af` archive. + +.. [#B] Winds, pressures, and specific humidity are read at 0.125° x + 0.15625° over the nested Asia domain. Other met fields are + taken from the GEOS-FP :ref:`gcc-hgrids-nested-025-as` archive. + +.. [#C] Winds, pressures, and specific humidity are read at 0.125° x + 0.15625° over the nested North America domain. Other met + fields are taken from the GEOS-FP + :ref:`gcc-hgrids-nested-025-na` archive. + +.. [#D] Winds, pressures, and specific humidity are read at 0.125° x + 0.15625° over the nested South America domain. Other met + fields are taken from the GEOS-FP + :ref:`gcc-hgrids-nested-025-sa` archive. + +.. _geosit-size-table: + +GEOS-IT +~~~~~~~ + +.. list-table:: Disk space needed for 1-year of GEOS-IT data + :header-rows: 1 + :widths: 60 40 + + * - Grid + - Approximate Size (GB/yr) + * - :ref:`gcc-hgrids-global-4x5` + - 26 + * - :ref:`gcc-hgrids-global-2x25` + - 78 + +.. _gcap2-size-table: + +GCAP 2.0 +~~~~~~~~ + +See the U. Rochester data portal: http://atmos.earth.rochester.edu/input/gc/ExtData/ .. _obtaining-emissions-data-and-met-fields: diff --git a/docs/source/getting-started/login-env-parallel.rst b/docs/source/getting-started/login-env-parallel.rst index 17701ba25..7523a3e16 100644 --- a/docs/source/getting-started/login-env-parallel.rst +++ b/docs/source/getting-started/login-env-parallel.rst @@ -28,49 +28,61 @@ In the the sample environment files for :ref:`GNU ` and :ref:`Intel `, we define the following **environment varaiables** for OpenMP parallelization: -.. option:: OMP_NUM_THREADS +.. _env-files-envvars-parallel-envvars: - The :envvar:`OMP_NUM_THREADS` environment variable sets the number of - computational cores (aka threads) that you would like GEOS-Chem - Classic to use. +================================================= +Environment variables controlling parallelization +================================================= - For example, the command below will tell :program:`GEOS-Chem Classic` - to use 8 cores within parallel sections of code: +.. _env-files-envvars-parallel-threads: - .. code:: console +OMP_NUM_THREADS +--------------- - $ export OMP_NUM_THREADS=8 +The :envvar:`OMP_NUM_THREADS` environment variable sets the number of +computational cores (aka threads) that you would like GEOS-Chem +Classic to use. - We recommend that you define :envvar:`OMP_NUM_THREADS` not only in your - environment file, but also in your :ref:`GEOS-Chem run script - `. +For example, the command below will tell :program:`GEOS-Chem Classic` +to use 8 cores within parallel sections of code: -.. option:: OMP_STACKSIZE +.. code:: console - In order to use :program:`GEOS-Chem Classic` with - `OpenMP parallelization `_, you must - request the maximum amount of stack memory in your Unix environment. - (The stack memory is where local automatic variables and temporary - :envvar:`!$OMP PRIVATE` variables will be created.) + $ export OMP_NUM_THREADS=8 - Add the following lines to your system startup file - (e.g. :file:`.bashrc`) and to your :ref:`GEOS-Chem run scripts - `: +We recommend that you define :envvar:`OMP_NUM_THREADS` +not only in your environment file, but also in your :ref:`GEOS-Chem +run script `. - .. code-block:: bash +.. _env-files-envvars-parallel-stack: - ulimit -s unlimited - export OMP_STACKSIZE=500m +OMP_STACKSIZE +------------- - The :command:`ulimit -s unlimited` will tell the bash shell to use the - maximum amount of stack memory that is available. +In order to use :program:`GEOS-Chem Classic` with +`OpenMP parallelization `_, you must +request the maximum amount of stack memory in your Unix environment. +(The stack memory is where local automatic variables and temporary +:envvar:`!$OMP PRIVATE` variables will be created.) - The environment variable :envvar:`OMP_STACKSIZE` must also be set to a very - large number. In this example, we are nominally requesting 500 MB of - memory. But in practice, this will tell the GNU Fortran compiler to use - the maximum amount of stack memory available on your system. The value - **500m** is a good round number that is larger than the amount of stack - memory on most computer clusters, but you can increase this if you wish. +Add the following lines to your system startup file +(e.g. :file:`.bashrc`) and to your :ref:`GEOS-Chem run scripts +`: + +.. code-block:: bash + + ulimit -s unlimited + export OMP_STACKSIZE=500m + +The :command:`ulimit -s unlimited` will tell the bash shell to use the +maximum amount of stack memory that is available. + +The environment variable :envvar:`OMP_STACKSIZE` must also be set to a very +large number. In this example, we are nominally requesting 500 MB of +memory. But in practice, this will tell the GNU Fortran compiler to use +the maximum amount of stack memory available on your system. The value +**500m** is a good round number that is larger than the amount of stack +memory on most computer clusters, but you can increase this if you wish. .. _env-files-envvars-errors: @@ -80,15 +92,15 @@ Errors caused by incorrect environment variable settings Be on the lookout for these errors: - #. If :option:`OMP_NUM_THREADS` is set to 1, then your - simulation will execute using only one computational core. - This will make your simulation take much longer than - necessary. |br| - |br| - - #. If :option:`OMP_STACKSIZE` environment variable is not included - in your environment file (or if it is set to a very low value), - you might encounter a :ref:`errguide-segfault-tpcore` error. In - this case, GEOS-Chem Classic "thinks" that it does not have - enough memory to perform the simulation, even though sufficient - memory may be present. + #. If :ref:`env-files-envvars-parallel-threads` is set to 1, then + your simulation will execute using only one computational + core. This will make your simulation take much longer than + necessary. |br| + |br| + + #. If the :ref:`env-files-envvars-parallel-stack` environment + variable is not included in your environment file (or if it is + set to a very low value), you might encounter a + :ref:`errguide-segfault-tpcore` error. In this case, GEOS-Chem + Classic "thinks" that it does not have enough memory to perform + the simulation, even though sufficient memory may be present. diff --git a/docs/source/getting-started/quick-start.rst b/docs/source/getting-started/quick-start.rst index 9da9e9c7a..bd16b54ad 100644 --- a/docs/source/getting-started/quick-start.rst +++ b/docs/source/getting-started/quick-start.rst @@ -293,20 +293,23 @@ Now, navigate to your run directory: You should review these files before starting a simulation: -- :ref:`geoschem_config.yml ` - - Controls several frequently-updated simulation settings - (e.g. start and end time, which operations to turn on/off, etc.) - -- :ref:`HISTORY.rc ` - - Controls GEOS-Chem diagnostic settings. - -- :ref:`HEMCO_Diagn.rc ` - - Controls emissions diagnostic settings via `HEMCO `_. - -- :ref:`HEMCO_Config.rc ` - - Controls which emissions inventories and other non-emissions data - will be read from disk (via `HEMCO - `_). +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Configuration file + - Description + * - :ref:`geoschem_config.yml ` + - Controls several frequently-updated simulation settings + (e.g. start and end time, which operations to turn on/off, etc.) + * - :ref:`HISTORY.rc ` + - Controls GEOS-Chem diagnostic settings. + * - :ref:`HEMCO_Diagn.rc ` + - Controls emissions diagnostic settings via `HEMCO `_. + * - :ref:`HEMCO_Config.rc ` + - Controls which emissions inventories and other non-emissions data + will be read from disk (via `HEMCO + `_). .. attention:: @@ -333,10 +336,10 @@ You should review these files before starting a simulation: Skipped species will be assigned the initial concentration (units: :math:`mol\ mol^{-1}` w/r/t dry air) specified by its - :option:`BackgroundVV` entry in :ref:`species_database.yml - `. If the species does not have a - :option:`BackgroundVV` value specified, then its initial - concentration will be set to :math:`1.0{\times}10^{-20}` + :ref:`spcguide-defs-other-bkgdvv` entry in + :ref:`species_database.yml `. If the species does + not have a :ref:`spcguide-defs-other-bkgdvv` value specified, then + its initial concentration will be set to :math:`1.0{\times}10^{-20}` instead. Please see our :ref:`customguide` Supplemental Guide to learn how you @@ -365,6 +368,9 @@ Before you can run your GEOS-Chem Classic simulation, you must first you may :ref:`start running your your GEOS-Chem Classic simulation ` right away. +7a. Run GEOS-Chem Classic in "dry-run" mode +-------------------------------------------- + The easiest way to download data is to perform a :ref:`dry-run simulation `. This is a GEOS-Chem Classic simulation that steps through time, but does not perform computations or read data @@ -380,42 +386,107 @@ To start a dry-run simulation, type this command: This will generate the :file:`log.dryrun` log file, which contains the list of data files to be downloaded. +7b. Download the data (requires Python) +--------------------------------------- + Once the dry-run simulation has finished, use the :file:`download_data.py` file (included in your run directory) to :ref:`download the required data `. -.. note:: +You will need to activate a Python environment before you can download +the data. We recommend using the Python environment for `GCPy +`_, as it has all of the relevant +packages installed. If you have `installed GCPy from PyPI +`_, then no further action is needed. On the other hand, if you +`installed GCPy from conda-forge +`_, +you will need to activate the GCPy Python environment with this command: + +.. code-block:: console - Depending on your system, you might have to activate a Conda or - Mamba environment containing a version of Python before running the - :file:`download.data.py` script. Ask your sysadmin. + $ conda activate gcpy_env -To start the data download, type: +The prefix :literal:`(gcpy_env)` will be added to the command line prompt, +which lets you know that the Python environment is active. (If you +installed GCPy from PyPI, you will not see this prefix.) + +You may now begin downloading data from the :ref:`GEOS-Chem Input Data +` portal: .. code-block:: console - $ ./download_data.py log.dryrun geoschem+http + (gcpy_env) $ ./download_data.py log.dryrun geoschem+http -This will download data from the :ref:`GEOS-Chem Input Data ` -portal using the HTTP data transfer protocol. +The data will be transfered using HTTP protocol. But if you have `AWS +CLI (command line interface) `_ installed +on your system, you can this command instead: -.. tip:: +.. code-block:: console + + (gcpy_env) $ ./download_data.py log.dryrun geoschem+aws + +This will use the AWS CLI data download protocol instead, which +should be faster than regular HTTP connections. This is the +command you should use if you are running GEOS-Chem Classic in an +AWS EC2 instance. + +If you have activated the GCPy Python environment, you may now +deactivate it: + +.. code-block:: console + + (gcpy_env) $ conda deactivate + $ + +This will remove the :literal:`(gcpy_env)` prefix from the command +prompt. + +At this point the required data files for your simulation should have +been successfully downloaded from the :ref:`GEOS-Chem Input Data +portal ` to your computer system or EC2 instance. + +7c. (Optional) Download additional meteorology data +--------------------------------------------------- - If you have `AWS CLI (command line interface) - `_ installed on your system, you - can use this command instead: +You may need to perform a subsequent dry-run simulation to download +additional data that are stored separately from the :ref:`GEOS-Chem +Input Data portal `: + +#. If you plan to run a :ref:`GEOS-Chem Classic nested-grid simulation + ` with meteorology fields that have been cropped to a + :ref:`specific nested grid domain `, then follow + these steps: .. code-block:: console - $ ./download_data.py log.dryrun geoschem+aws + $ ./gcclassic --dryrun | tee log.dryrun.nested + + $ conda activate gcpy_env # Skip if using GCPy from PyPI + + (gcpy_env) $ ./download_data.py log.dryrun.nested nested+http # or nested+aws if you have AWSCLI + + $ conda deactivate # Skip if using GCPy from PyPI + + This will download the cropped meteorology fields from our + :ref:`GEOS-Chem Nested Input Data portal + ` to your computer system or EC2 instance. + +#. If you plan to perform a GEOS-Chem Classic simulation drven by GCAP + 2.0 meteorology, follow these steps: + + .. code-block:: console + + $ ./gcclassic --dryrun | tee log.dryrun.gcap2 + + $ conda activate gcpy_env # Skip if using GCPy from PyPI + + (gcpy_env) $ ./download_data.py log.dryrun.gcap2 rochester - This will use the AWS CLI data download protocol instead, which - should be faster than regular HTTP connections. This is the - command you should use if you are running GEOS-Chem Classic in an - AWS EC2 instance. + $ conda deactivate # Skip if using GCPy from PyPI -We also maintain :ref:`separate data portals ` -for special nested-grid domains as well as the GCAP 2.0 meteorology. + This will download the GCAP 2.0 meteorology data from the + :ref:`GCAP 2.0 data portal hosted at U. Rochester + ` to your computer system or EC2 instance. For more information about dry-run simulations, please see our :ref:`dry-run` chapter. diff --git a/docs/source/index.rst b/docs/source/index.rst index e2a5e353d..b4707c09b 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -6,12 +6,12 @@ GEOS-Chem Classic .. raw:: html

- - -
- DOI - - + Latest release + Release date + DOI
+ License + gcclassic-compile-tests + ReadTheDocs

This site provides instructions for :program:`GEOS-Chem Classic`, @@ -81,7 +81,10 @@ modifications to GEOS-Chem Classic source code. :caption: Supplemental guides :maxdepth: 4 + supplemental-guides/run-gcc-on-aws-ec2.rst supplemental-guides/directory-structure.rst + supplemental-guides/horizontal-grids.rst + supplemental-guides/vertical-grids.rst supplemental-guides/run-script-examples.rst geos-chem-shared-docs/supplemental-guides/load-libraries-guide.rst geos-chem-shared-docs/supplemental-guides/spack-guide.rst @@ -97,6 +100,7 @@ modifications to GEOS-Chem Classic source code. supplemental-guides/nested-grid-guide.rst geos-chem-shared-docs/supplemental-guides/using-kpp-with-gc.rst geos-chem-shared-docs/supplemental-guides/using-kpp-standalone.rst + geos-chem-shared-docs/supplemental-guides/pm25-pm10-guide.rst geos-chem-shared-docs/supplemental-guides/related-docs.rst .. toctree:: @@ -108,4 +112,3 @@ modifications to GEOS-Chem Classic source code. help-and-reference/CONTRIBUTING.md help-and-reference/SUPPORT.md geos-chem-shared-docs/editing_these_docs.rst - diff --git a/docs/source/supplemental-guides/.DS_Store b/docs/source/supplemental-guides/.DS_Store new file mode 100644 index 000000000..22169f348 Binary files /dev/null and b/docs/source/supplemental-guides/.DS_Store differ diff --git a/docs/source/supplemental-guides/directory-structure.rst b/docs/source/supplemental-guides/directory-structure.rst index e6f93e693..eba105817 100644 --- a/docs/source/supplemental-guides/directory-structure.rst +++ b/docs/source/supplemental-guides/directory-structure.rst @@ -22,13 +22,13 @@ GEOS-Chem Classic reside. | +---geos-chem-shared-docs # Submodule containing shared documentation files | | # (such as common supplemental guides) | | - | +---getting-started # Markup files (ReST format) for ReadTheDocs + | +---getting-started # Markup files (reST format) for ReadTheDocs | | - | +---help-and-reference # Markup files (ReST format) for ReadTheDocs + | +---help-and-reference # Markup files (reST format) for ReadTheDocs | | | +---_static # Static content (e.g. images) for ReadTheDocs | | - | +---supplemental-guides # Markup files (ReST format) for ReadTheDocs + | +---supplemental-guides # Markup files (reST format) for ReadTheDocs | # (Content specific to GEOS-Chem Classic) | +---run # Link to src/GEOS-Chem/run/GCClassic @@ -138,11 +138,11 @@ GEOS-Chem Classic reside. | | | +---geos-chem-shared-docs # Submodule containing shared documentation files | | | | # (such as common supplemental guides) | | | | - | | | +---hco-ref-guide # Markup files (ReST format) for ReadTheDocs + | | | +---hco-ref-guide # Markup files (reST format) for ReadTheDocs | | | | - | | | +---hco-sa-guide # Markup files (ReST format) for ReadTheDocs + | | | +---hco-sa-guide # Markup files (reST format) for ReadTheDocs | | | | - | | | +---reference # Markup files (ReST format) for ReadTheDocs + | | | +---reference # Markup files (reST format) for ReadTheDocs | | | | | | | +---_static # Static content (e.g. images) for ReadTheDocs | | | @@ -185,4 +185,4 @@ GEOS-Chem Classic reside. | +---spack # Link to docs/source/geos-chem-shared-docs/spack | - +---test # Link to src/GEOS-Chem/test \ No newline at end of file + +---test # Link to src/GEOS-Chem/test diff --git a/docs/source/supplemental-guides/horizontal-grids.rst b/docs/source/supplemental-guides/horizontal-grids.rst new file mode 100644 index 000000000..8e78316a8 --- /dev/null +++ b/docs/source/supplemental-guides/horizontal-grids.rst @@ -0,0 +1,1950 @@ +.. _gcc-hgrids: + +################################## +GEOS-Chem Classic horizontal grids +################################## + +On this page we provide information about the horizontal grids used by +GEOS-Chem "Classic" simulations. For information about the vertical +coordinates used by GEOS-Chem, please see our Supplemental Guide +entitled :ref:`gcc-vgrids`. + +The FlexGrid feature of GEOS-Chem Classic allows you to specify the +global GEOS-Chem grid definitions (listed below), as well as +custom grids, at runtime. + +.. _gcc-hgrids-global: + +============ +Global grids +============ + +.. _gcc-hgrids-global-4x5: + +4° x 5° global grid +------------------- + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: MERRA2 # or GEOSFP or GEOSIT + ... + grid: + resolution: 4.0x5.0 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-180.0, 180.0] + center_at_180: true + latitude: + range: [-90.0, 90.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: false + buffer_zone_NSEW: [0, 0, 0, 0] + +4° x 5° longitudes +~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -180.0000 -175.0000 -170.0000 -165.0000 -160.0000 -155.0000 -150.0000 -145.0000 + -140.0000 -135.0000 -130.0000 -125.0000 -120.0000 -115.0000 -110.0000 -105.0000 + -100.0000 -95.0000 -90.0000 -85.0000 -80.0000 -75.0000 -70.0000 -65.0000 + -60.0000 -55.0000 -50.0000 -45.0000 -40.0000 -35.0000 -30.0000 -25.0000 + -20.0000 -15.0000 -10.0000 -5.0000 0.0000 5.0000 10.0000 15.0000 + 20.0000 25.0000 30.0000 35.0000 40.0000 45.0000 50.0000 55.0000 + 60.0000 65.0000 70.0000 75.0000 80.0000 85.0000 90.0000 95.0000 + 100.0000 105.0000 110.0000 115.0000 120.0000 125.0000 130.0000 135.0000 + 140.0000 145.0000 150.0000 155.0000 160.0000 165.0000 + 170.0000 175.0000 + +4° x 5° latitudes +~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -89.0000 -86.0000 -82.0000 -78.0000 -74.0000 -70.0000 -66.0000 -62.0000 + -58.0000 -54.0000 -50.0000 -46.0000 -42.0000 -38.0000 -34.0000 -30.0000 + -26.0000 -22.0000 -18.0000 -14.0000 -10.0000 -6.0000 -2.0000 2.0000 + 6.0000 10.0000 14.0000 18.0000 22.0000 26.0000 30.0000 34.0000 + 38.0000 42.0000 46.0000 50.0000 54.0000 58.0000 62.0000 66.0000 + 70.0000 74.0000 78.0000 82.0000 86.0000 89.0000 + +.. _gcc-hgrids-global-2x25: + +2° x 2.5° global grid +--------------------- + +Select this grid by specifying these in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: MERRA2 # or GEOSFP or GEOSIT + ... + grid: + resolution: 2.0x2.5 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-180.0, 180.0] + center_at_180: true + latitude: + range: [-90.0, 90.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: false + buffer_zone_NSEW: [0, 0, 0, 0] + +2° x 2.5° longitudes +~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -180.0000 -177.5000 -175.0000 -172.5000 -170.0000 -167.5000 -165.0000 -162.5000 + -160.0000 -157.5000 -155.0000 -152.5000 -150.0000 -147.5000 -145.0000 -142.5000 + -140.0000 -137.5000 -135.0000 -132.5000 -130.0000 -127.5000 -125.0000 -122.5000 + -120.0000 -117.5000 -115.0000 -112.5000 -110.0000 -107.5000 -105.0000 -102.5000 + -100.0000 -97.5000 -95.0000 -92.5000 -90.0000 -87.5000 -85.0000 -82.5000 + -80.0000 -77.5000 -75.0000 -72.5000 -70.0000 -67.5000 -65.0000 -62.5000 + -60.0000 -57.5000 -55.0000 -52.5000 -50.0000 -47.5000 -45.0000 -42.5000 + -40.0000 -37.5000 -35.0000 -32.5000 -30.0000 -27.5000 -25.0000 -22.5000 + -20.0000 -17.5000 -15.0000 -12.5000 -10.0000 -7.5000 -5.0000 -2.5000 + 0.0000 2.5000 5.0000 7.5000 10.0000 12.5000 15.0000 17.5000 + 20.0000 22.5000 25.0000 27.5000 30.0000 32.5000 35.0000 37.5000 + 40.0000 42.5000 45.0000 47.5000 50.0000 52.5000 55.0000 57.5000 + 60.0000 62.5000 65.0000 67.5000 70.0000 72.5000 75.0000 77.5000 + 80.0000 82.5000 85.0000 87.5000 90.0000 92.5000 95.0000 97.5000 + 100.0000 102.5000 105.0000 107.5000 110.0000 112.5000 115.0000 117.5000 + 120.0000 122.5000 125.0000 127.5000 130.0000 132.5000 135.0000 137.5000 + 140.0000 142.5000 145.0000 147.5000 150.0000 152.5000 155.0000 157.5000 + 160.0000 162.5000 165.0000 167.5000 170.0000 172.5000 175.0000 177.5000 + +2° x 2.5° latitudes +~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -89.5000 -88.0000 -86.0000 -84.0000 -82.0000 -80.0000 -78.0000 -76.0000 + -74.0000 -72.0000 -70.0000 -68.0000 -66.0000 -64.0000 -62.0000 -60.0000 + -58.0000 -56.0000 -54.0000 -52.0000 -50.0000 -48.0000 -46.0000 -44.0000 + -42.0000 -40.0000 -38.0000 -36.0000 -34.0000 -32.0000 -30.0000 -28.0000 + -26.0000 -24.0000 -22.0000 -20.0000 -18.0000 -16.0000 -14.0000 -12.0000 + -10.0000 -8.0000 -6.0000 -4.0000 -2.0000 0.0000 2.0000 4.0000 + 6.0000 8.0000 10.0000 12.0000 14.0000 16.0000 18.0000 20.0000 + 22.0000 24.0000 26.0000 28.0000 30.0000 32.0000 34.0000 36.0000 + 38.0000 40.0000 42.0000 44.0000 46.0000 48.0000 50.0000 52.0000 + 54.0000 56.0000 58.0000 60.0000 62.0000 64.0000 66.0000 68.0000 + 70.0000 72.0000 74.0000 76.0000 78.0000 80.0000 82.0000 84.0000 + 86.0000 88.0000 89.5000 + +.. _gcc-hgrids-global-05: + +0.5° x 0.625° global grid +------------------------- + +This is the native resolution of the MERRA-2 and GEOS-IT reanalysis +products from GMAO. The grid coordinates are constructed as follows: + +.. math:: + + Lon_{center}(I) = -180° + 0.625° \times ( I - 1 ),~~~~I = 1..576 + +.. math:: + + Lat_{center}(J) = -90° + 0.5° \times ( J - 1 ),~~~~J = 1..361 + +.. _gcc-hgrids-global-025: + +0.25° x 0.3125° global grid +--------------------------- + +This is the native resolution of the GEOS-FP operational data product +from GMAO. The grid coordinates are computed as follows: + +.. math:: + + Lon_{center}(I) = -180° + 0.3125° \times ( I - 1 ),~~~~I = 1..1152 + +.. math:: + + Lat_{center}(I) = -90° + 0.25° \times ( J - 1 ),~~~~J = 1..721 + + +.. _gcc-hgrids-nested: + +============ +Nested grids +============ + +You may choose any nested grid region of interest to use with +GEOS-Chem Classic. You may also use one of the "traditional" nested +grids listed below. + +.. _gcc-hgrids-nested-05-as: + +0.5° x 0.625° AS nested grid +---------------------------- + +Domain: Asia + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: MERRA2 # or GEOSIT + ... + grid: + resolution: 0.5x0.625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [60.0, 150.0] + center_at_180: true + latitude: + range: [-11.0, 55.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.5° x 0.625° AS longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 60.0000 60.6250 61.2500 61.8750 62.5000 63.1250 63.7500 64.3750 + 65.0000 65.6250 66.2500 66.8750 67.5000 68.1250 68.7500 69.3750 + 70.0000 70.6250 71.2500 71.8750 72.5000 73.1250 73.7500 74.3750 + 75.0000 75.6250 76.2500 76.8750 77.5000 78.1250 78.7500 79.3750 + 80.0000 80.6250 81.2500 81.8750 82.5000 83.1250 83.7500 84.3750 + 85.0000 85.6250 86.2500 86.8750 87.5000 88.1250 88.7500 89.3750 + 90.0000 90.6250 91.2500 91.8750 92.5000 93.1250 93.7500 94.3750 + 95.0000 95.6250 96.2500 96.8750 97.5000 98.1250 98.7500 99.3750 + 100.0000 100.6250 101.2500 101.8750 102.5000 103.1250 103.7500 104.3750 + 105.0000 105.6250 106.2500 106.8750 107.5000 108.1250 108.7500 109.3750 + 110.0000 110.6250 111.2500 111.8750 112.5000 113.1250 113.7500 114.3750 + 115.0000 115.6250 116.2500 116.8750 117.5000 118.1250 118.7500 119.3750 + 120.0000 120.6250 121.2500 121.8750 122.5000 123.1250 123.7500 124.3750 + 125.0000 125.6250 126.2500 126.8750 127.5000 128.1250 128.7500 129.3750 + 130.0000 130.6250 131.2500 131.8750 132.5000 133.1250 133.7500 134.3750 + 135.0000 135.6250 136.2500 136.8750 137.5000 138.1250 138.7500 139.3750 + 140.0000 140.6250 141.2500 141.8750 142.5000 143.1250 143.7500 144.3750 + 145.0000 145.6250 146.2500 146.8750 147.5000 148.1250 148.7500 149.3750 + 150.0000 + +0.5° x 0.625° AS latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -11.0000 -10.5000 -10.0000 -9.5000 -9.0000 -8.5000 -8.0000 -7.5000 + -7.0000 -6.5000 -6.0000 -5.5000 -5.0000 -4.5000 -4.0000 -3.5000 + -3.0000 -2.5000 -2.0000 -1.5000 -1.0000 -0.5000 0.0000 0.5000 + 1.0000 1.5000 2.0000 2.5000 3.0000 3.5000 4.0000 4.5000 + 5.0000 5.5000 6.0000 6.5000 7.0000 7.5000 8.0000 8.5000 + 9.0000 9.5000 10.0000 10.5000 11.0000 11.5000 12.0000 12.5000 + 13.0000 13.5000 14.0000 14.5000 15.0000 15.5000 16.0000 16.5000 + 17.0000 17.5000 18.0000 18.5000 19.0000 19.5000 20.0000 20.5000 + 21.0000 21.5000 22.0000 22.5000 23.0000 23.5000 24.0000 24.5000 + 25.0000 25.5000 26.0000 26.5000 27.0000 27.5000 28.0000 28.5000 + 29.0000 29.5000 30.0000 30.5000 31.0000 31.5000 32.0000 32.5000 + 33.0000 33.5000 34.0000 34.5000 35.0000 35.5000 36.0000 36.5000 + 37.0000 37.5000 38.0000 38.5000 39.0000 39.5000 40.0000 40.5000 + 41.0000 41.5000 42.0000 42.5000 43.0000 43.5000 44.0000 44.5000 + 45.0000 45.5000 46.0000 46.5000 47.0000 47.5000 48.0000 48.5000 + 49.0000 49.5000 50.0000 50.5000 51.0000 51.5000 52.0000 52.5000 + 53.0000 53.5000 54.0000 54.5000 55.0000 + +.. _gcc-hgrids-nested-05-eu: + +0.5° x 0.625° EU nested grid +---------------------------- + +Domain: Europe + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: MERRA2 # or GEOSIT + ... + grid: + resolution: 0.5x0.625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [ -30.0, 50.0] + center_at_180: true + latitude: + range: [30.0, 70.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.5° x 0.625° EU longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -30.0000 -29.3750 -28.7500 -28.1250 -27.5000 -26.8750 -26.2500 -25.6250 + -25.0000 -24.3750 -23.7500 -23.1250 -22.5000 -21.8750 -21.2500 -20.6250 + -20.0000 -19.3750 -18.7500 -18.1250 -17.5000 -16.8750 -16.2500 -15.6250 + -15.0000 -14.3750 -13.7500 -13.1250 -12.5000 -11.8750 -11.2500 -10.6250 + -10.0000 -9.3750 -8.7500 -8.1250 -7.5000 -6.8750 -6.2500 -5.6250 + -5.0000 -4.3750 -3.7500 -3.1250 -2.5000 -1.8750 -1.2500 -0.6250 + 0.0000 0.6250 1.2500 1.8750 2.5000 3.1250 3.7500 4.3750 + 5.0000 5.6250 6.2500 6.8750 7.5000 8.1250 8.7500 9.3750 + 10.0000 10.6250 11.2500 11.8750 12.5000 13.1250 13.7500 14.3750 + 15.0000 15.6250 16.2500 16.8750 17.5000 18.1250 18.7500 19.3750 + 20.0000 20.6250 21.2500 21.8750 22.5000 23.1250 23.7500 24.3750 + 25.0000 25.6250 26.2500 26.8750 27.5000 28.1250 28.7500 29.3750 + 30.0000 30.6250 31.2500 31.8750 32.5000 33.1250 33.7500 34.3750 + 35.0000 35.6250 36.2500 36.8750 37.5000 38.1250 38.7500 39.3750 + 40.0000 40.6250 41.2500 41.8750 42.5000 43.1250 43.7500 44.3750 + 45.0000 45.6250 46.2500 46.8750 47.5000 48.1250 48.7500 49.3750 + 50.0000 + +0.5° x 0.625° EU latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 30.0000 30.5000 31.0000 31.5000 32.0000 32.5000 33.0000 33.5000 + 34.0000 34.5000 35.0000 35.5000 36.0000 36.5000 37.0000 37.5000 + 38.0000 38.5000 39.0000 39.5000 40.0000 40.5000 41.0000 41.5000 + 42.0000 42.5000 43.0000 43.5000 44.0000 44.5000 45.0000 45.5000 + 46.0000 46.5000 47.0000 47.5000 48.0000 48.5000 49.0000 49.5000 + 50.0000 50.5000 51.0000 51.5000 52.0000 52.5000 53.0000 53.5000 + 54.0000 54.5000 55.0000 55.5000 56.0000 56.5000 57.0000 57.5000 + 58.0000 58.5000 59.0000 59.5000 60.0000 60.5000 61.0000 61.5000 + 62.0000 62.5000 63.0000 63.5000 64.0000 64.5000 65.0000 65.5000 + 66.0000 66.5000 67.0000 67.5000 68.0000 68.5000 69.0000 69.5000 + 70.0000 + +.. _gcc-hgrids-nested-05-na: + +0.5° x 0.625° NA nested grid +---------------------------- + +Domain: North America + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: MERRA2 # or GEOSIT + ... + grid: + resolution: 0.5x0.625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-140.0, -40.0] + center_at_180: true + latitude: + range: [10.0, 70.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.5° x 0.625° NA longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -140.0000 -139.3750 -138.7500 -138.1250 -137.5000 -136.8750 -136.2500 -135.6250 + -135.0000 -134.3750 -133.7500 -133.1250 -132.5000 -131.8750 -131.2500 -130.6250 + -130.0000 -129.3750 -128.7500 -128.1250 -127.5000 -126.8750 -126.2500 -125.6250 + -125.0000 -124.3750 -123.7500 -123.1250 -122.5000 -121.8750 -121.2500 -120.6250 + -120.0000 -119.3750 -118.7500 -118.1250 -117.5000 -116.8750 -116.2500 -115.6250 + -115.0000 -114.3750 -113.7500 -113.1250 -112.5000 -111.8750 -111.2500 -110.6250 + -110.0000 -109.3750 -108.7500 -108.1250 -107.5000 -106.8750 -106.2500 -105.6250 + -105.0000 -104.3750 -103.7500 -103.1250 -102.5000 -101.8750 -101.2500 -100.6250 + -100.0000 -99.3750 -98.7500 -98.1250 -97.5000 -96.8750 -96.2500 -95.6250 + -95.0000 -94.3750 -93.7500 -93.1250 -92.5000 -91.8750 -91.2500 -90.6250 + -90.0000 -89.3750 -88.7500 -88.1250 -87.5000 -86.8750 -86.2500 -85.6250 + -85.0000 -84.3750 -83.7500 -83.1250 -82.5000 -81.8750 -81.2500 -80.6250 + -80.0000 -79.3750 -78.7500 -78.1250 -77.5000 -76.8750 -76.2500 -75.6250 + -75.0000 -74.3750 -73.7500 -73.1250 -72.5000 -71.8750 -71.2500 -70.6250 + -70.0000 -69.3750 -68.7500 -68.1250 -67.5000 -66.8750 -66.2500 -65.6250 + -65.0000 -64.3750 -63.7500 -63.1250 -62.5000 -61.8750 -61.2500 -60.6250 + -60.0000 -59.3750 -58.7500 -58.1250 -57.5000 -56.8750 -56.2500 -55.6250 + -55.0000 -54.3750 -53.7500 -53.1250 -52.5000 -51.8750 -51.2500 -50.6250 + -50.0000 -49.3750 -48.7500 -48.1250 -47.5000 -46.8750 -46.2500 -45.6250 + -45.0000 -44.3750 -43.7500 -43.1250 -42.5000 -41.8750 -41.2500 -40.6250 + -40.0000 + +0.5° x 0.625° NA latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 10.0000 10.5000 11.0000 11.5000 12.0000 12.5000 13.0000 13.5000 + 14.0000 14.5000 15.0000 15.5000 16.0000 16.5000 17.0000 17.5000 + 18.0000 18.5000 19.0000 19.5000 20.0000 20.5000 21.0000 21.5000 + 22.0000 22.5000 23.0000 23.5000 24.0000 24.5000 25.0000 25.5000 + 26.0000 26.5000 27.0000 27.5000 28.0000 28.5000 29.0000 29.5000 + 30.0000 30.5000 31.0000 31.5000 32.0000 32.5000 33.0000 33.5000 + 34.0000 34.5000 35.0000 35.5000 36.0000 36.5000 37.0000 37.5000 + 38.0000 38.5000 39.0000 39.5000 40.0000 40.5000 41.0000 41.5000 + 42.0000 42.5000 43.0000 43.5000 44.0000 44.5000 45.0000 45.5000 + 46.0000 46.5000 47.0000 47.5000 48.0000 48.5000 49.0000 49.5000 + 50.0000 50.5000 51.0000 51.5000 52.0000 52.5000 53.0000 53.5000 + 54.0000 54.5000 55.0000 55.5000 56.0000 56.5000 57.0000 57.5000 + 58.0000 58.5000 59.0000 59.5000 60.0000 60.5000 61.0000 61.5000 + 62.0000 62.5000 63.0000 63.5000 64.0000 64.5000 65.0000 65.5000 + 66.0000 66.5000 67.0000 67.5000 68.0000 68.5000 69.0000 69.5000 + 70.0000 + +.. _gcc-hgrids-nested-025-af: + +0.25° x 0.3125° AF nested grid +------------------------------ + +Domain: Africa + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-20.0, 52.8125] + center_at_180: true + latitude: + range: [-37.0, 40.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° AF longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -20.0000 -19.6875 -19.3750 -19.0625 -18.7500 -18.4375 -18.1250 -17.8125 + -17.5000 -17.1875 -16.8750 -16.5625 -16.2500 -15.9375 -15.6250 -15.3125 + -15.0000 -14.6875 -14.3750 -14.0625 -13.7500 -13.4375 -13.1250 -12.8125 + -12.5000 -12.1875 -11.8750 -11.5625 -11.2500 -10.9375 -10.6250 -10.3125 + -10.0000 -9.6875 -9.3750 -9.0625 -8.7500 -8.4375 -8.1250 -7.8125 + -7.5000 -7.1875 -6.8750 -6.5625 -6.2500 -5.9375 -5.6250 -5.3125 + -5.0000 -4.6875 -4.3750 -4.0625 -3.7500 -3.4375 -3.1250 -2.8125 + -2.5000 -2.1875 -1.8750 -1.5625 -1.2500 -0.9375 -0.6250 -0.3125 + 0.0000 0.3125 0.6250 0.9375 1.2500 1.5625 1.8750 2.1875 + 2.5000 2.8125 3.1250 3.4375 3.7500 4.0625 4.3750 4.6875 + 5.0000 5.3125 5.6250 5.9375 6.2500 6.5625 6.8750 7.1875 + 7.5000 7.8125 8.1250 8.4375 8.7500 9.0625 9.3750 9.6875 + 10.0000 10.3125 10.6250 10.9375 11.2500 11.5625 11.8750 12.1875 + 12.5000 12.8125 13.1250 13.4375 13.7500 14.0625 14.3750 14.6875 + 15.0000 15.3125 15.6250 15.9375 16.2500 16.5625 16.8750 17.1875 + 17.5000 17.8125 18.1250 18.4375 18.7500 19.0625 19.3750 19.6875 + 20.0000 20.3125 20.6250 20.9375 21.2500 21.5625 21.8750 22.1875 + 22.5000 22.8125 23.1250 23.4375 23.7500 24.0625 24.3750 24.6875 + 25.0000 25.3125 25.6250 25.9375 26.2500 26.5625 26.8750 27.1875 + 27.5000 27.8125 28.1250 28.4375 28.7500 29.0625 29.3750 29.6875 + 30.0000 30.3125 30.6250 30.9375 31.2500 31.5625 31.8750 32.1875 + 32.5000 32.8125 33.1250 33.4375 33.7500 34.0625 34.3750 34.6875 + 35.0000 35.3125 35.6250 35.9375 36.2500 36.5625 36.8750 37.1875 + 37.5000 37.8125 38.1250 38.4375 38.7500 39.0625 39.3750 39.6875 + 40.0000 40.3125 40.6250 40.9375 41.2500 41.5625 41.8750 42.1875 + 42.5000 42.8125 43.1250 43.4375 43.7500 44.0625 44.3750 44.6875 + 45.0000 45.3125 45.6250 45.9375 46.2500 46.5625 46.8750 47.1875 + 47.5000 47.8125 48.1250 48.4375 48.7500 49.0625 49.3750 49.6875 + 50.0000 50.3125 50.6250 50.9375 51.2500 51.5625 51.8750 52.1875 + 52.5000 52.8125 + +0.25° x 0.3125° AF latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -37.0000 -36.7500 -36.5000 -36.2500 -36.0000 -35.7500 -35.5000 -35.2500 + -35.0000 -34.7500 -34.5000 -34.2500 -34.0000 -33.7500 -33.5000 -33.2500 + -33.0000 -32.7500 -32.5000 -32.2500 -32.0000 -31.7500 -31.5000 -31.2500 + -31.0000 -30.7500 -30.5000 -30.2500 -30.0000 -29.7500 -29.5000 -29.2500 + -29.0000 -28.7500 -28.5000 -28.2500 -28.0000 -27.7500 -27.5000 -27.2500 + -27.0000 -26.7500 -26.5000 -26.2500 -26.0000 -25.7500 -25.5000 -25.2500 + -25.0000 -24.7500 -24.5000 -24.2500 -24.0000 -23.7500 -23.5000 -23.2500 + -23.0000 -22.7500 -22.5000 -22.2500 -22.0000 -21.7500 -21.5000 -21.2500 + -21.0000 -20.7500 -20.5000 -20.2500 -20.0000 -19.7500 -19.5000 -19.2500 + -19.0000 -18.7500 -18.5000 -18.2500 -18.0000 -17.7500 -17.5000 -17.2500 + -17.0000 -16.7500 -16.5000 -16.2500 -16.0000 -15.7500 -15.5000 -15.2500 + -15.0000 -14.7500 -14.5000 -14.2500 -14.0000 -13.7500 -13.5000 -13.2500 + -13.0000 -12.7500 -12.5000 -12.2500 -12.0000 -11.7500 -11.5000 -11.2500 + -11.0000 -10.7500 -10.5000 -10.2500 -10.0000 -9.7500 -9.5000 -9.2500 + -9.0000 -8.7500 -8.5000 -8.2500 -8.0000 -7.7500 -7.5000 -7.2500 + -7.0000 -6.7500 -6.5000 -6.2500 -6.0000 -5.7500 -5.5000 -5.2500 + -5.0000 -4.7500 -4.5000 -4.2500 -4.0000 -3.7500 -3.5000 -3.2500 + -3.0000 -2.7500 -2.5000 -2.2500 -2.0000 -1.7500 -1.5000 -1.2500 + -1.0000 -0.7500 -0.5000 -0.2500 0.0000 0.2500 0.5000 0.7500 + 1.0000 1.2500 1.5000 1.7500 2.0000 2.2500 2.5000 2.7500 + 3.0000 3.2500 3.5000 3.7500 4.0000 4.2500 4.5000 4.7500 + 5.0000 5.2500 5.5000 5.7500 6.0000 6.2500 6.5000 6.7500 + 7.0000 7.2500 7.5000 7.7500 8.0000 8.2500 8.5000 8.7500 + 9.0000 9.2500 9.5000 9.7500 10.0000 10.2500 10.5000 10.7500 + 11.0000 11.2500 11.5000 11.7500 12.0000 12.2500 12.5000 12.7500 + 13.0000 13.2500 13.5000 13.7500 14.0000 14.2500 14.5000 14.7500 + 15.0000 15.2500 15.5000 15.7500 16.0000 16.2500 16.5000 16.7500 + 17.0000 17.2500 17.5000 17.7500 18.0000 18.2500 18.5000 18.7500 + 19.0000 19.2500 19.5000 19.7500 20.0000 20.2500 20.5000 20.7500 + 21.0000 21.2500 21.5000 21.7500 22.0000 22.2500 22.5000 22.7500 + 23.0000 23.2500 23.5000 23.7500 24.0000 24.2500 24.5000 24.7500 + 25.0000 25.2500 25.5000 25.7500 26.0000 26.2500 26.5000 26.7500 + 27.0000 27.2500 27.5000 27.7500 28.0000 28.2500 28.5000 28.7500 + 29.0000 29.2500 29.5000 29.7500 30.0000 30.2500 30.5000 30.7500 + 31.0000 31.2500 31.5000 31.7500 32.0000 32.2500 32.5000 32.7500 + 33.0000 33.2500 33.5000 33.7500 34.0000 34.2500 34.5000 34.7500 + 35.0000 35.2500 35.5000 35.7500 36.0000 36.2500 36.5000 36.7500 + 37.0000 37.2500 37.5000 37.7500 38.0000 38.2500 38.5000 38.7500 + 39.0000 39.2500 39.5000 39.7500 40.0000 + +.. _gcc-hgrids-nested-025-as: + +0.25° x 0.3125° AS nested grid +------------------------------ + +Domain: Asia + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [70.0, 140.0] + center_at_180: true + latitude: + range: [15.0, 55.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° AS longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 70.0000 70.3125 70.6250 70.9375 71.2500 71.5625 71.8750 72.1875 + 72.5000 72.8125 73.1250 73.4375 73.7500 74.0625 74.3750 74.6875 + 75.0000 75.3125 75.6250 75.9375 76.2500 76.5625 76.8750 77.1875 + 77.5000 77.8125 78.1250 78.4375 78.7500 79.0625 79.3750 79.6875 + 80.0000 80.3125 80.6250 80.9375 81.2500 81.5625 81.8750 82.1875 + 82.5000 82.8125 83.1250 83.4375 83.7500 84.0625 84.3750 84.6875 + 85.0000 85.3125 85.6250 85.9375 86.2500 86.5625 86.8750 87.1875 + 87.5000 87.8125 88.1250 88.4375 88.7500 89.0625 89.3750 89.6875 + 90.0000 90.3125 90.6250 90.9375 91.2500 91.5625 91.8750 92.1875 + 92.5000 92.8125 93.1250 93.4375 93.7500 94.0625 94.3750 94.6875 + 95.0000 95.3125 95.6250 95.9375 96.2500 96.5625 96.8750 97.1875 + 97.5000 97.8125 98.1250 98.4375 98.7500 99.0625 99.3750 99.6875 + 100.0000 100.3125 100.6250 100.9375 101.2500 101.5625 101.8750 102.1875 + 102.5000 102.8125 103.1250 103.4375 103.7500 104.0625 104.3750 104.6875 + 105.0000 105.3125 105.6250 105.9375 106.2500 106.5625 106.8750 107.1875 + 107.5000 107.8125 108.1250 108.4375 108.7500 109.0625 109.3750 109.6875 + 110.0000 110.3125 110.6250 110.9375 111.2500 111.5625 111.8750 112.1875 + 112.5000 112.8125 113.1250 113.4375 113.7500 114.0625 114.3750 114.6875 + 115.0000 115.3125 115.6250 115.9375 116.2500 116.5625 116.8750 117.1875 + 117.5000 117.8125 118.1250 118.4375 118.7500 119.0625 119.3750 119.6875 + 120.0000 120.3125 120.6250 120.9375 121.2500 121.5625 121.8750 122.1875 + 122.5000 122.8125 123.1250 123.4375 123.7500 124.0625 124.3750 124.6875 + 125.0000 125.3125 125.6250 125.9375 126.2500 126.5625 126.8750 127.1875 + 127.5000 127.8125 128.1250 128.4375 128.7500 129.0625 129.3750 129.6875 + 130.0000 130.3125 130.6250 130.9375 131.2500 131.5625 131.8750 132.1875 + 132.5000 132.8125 133.1250 133.4375 133.7500 134.0625 134.3750 134.6875 + 135.0000 135.3125 135.6250 135.9375 136.2500 136.5625 136.8750 137.1875 + 137.5000 137.8125 138.1250 138.4375 138.7500 139.0625 139.3750 139.6875 + 140.0000 + +0.25° x 0.3125° AS latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 15.0000 15.2500 15.5000 15.7500 16.0000 16.2500 16.5000 16.7500 + 17.0000 17.2500 17.5000 17.7500 18.0000 18.2500 18.5000 18.7500 + 19.0000 19.2500 19.5000 19.7500 20.0000 20.2500 20.5000 20.7500 + 21.0000 21.2500 21.5000 21.7500 22.0000 22.2500 22.5000 22.7500 + 23.0000 23.2500 23.5000 23.7500 24.0000 24.2500 24.5000 24.7500 + 25.0000 25.2500 25.5000 25.7500 26.0000 26.2500 26.5000 26.7500 + 27.0000 27.2500 27.5000 27.7500 28.0000 28.2500 28.5000 28.7500 + 29.0000 29.2500 29.5000 29.7500 30.0000 30.2500 30.5000 30.7500 + 31.0000 31.2500 31.5000 31.7500 32.0000 32.2500 32.5000 32.7500 + 33.0000 33.2500 33.5000 33.7500 34.0000 34.2500 34.5000 34.7500 + 35.0000 35.2500 35.5000 35.7500 36.0000 36.2500 36.5000 36.7500 + 37.0000 37.2500 37.5000 37.7500 38.0000 38.2500 38.5000 38.7500 + 39.0000 39.2500 39.5000 39.7500 40.0000 40.2500 40.5000 40.7500 + 41.0000 41.2500 41.5000 41.7500 42.0000 42.2500 42.5000 42.7500 + 43.0000 43.2500 43.5000 43.7500 44.0000 44.2500 44.5000 44.7500 + 45.0000 45.2500 45.5000 45.7500 46.0000 46.2500 46.5000 46.7500 + 47.0000 47.2500 47.5000 47.7500 48.0000 48.2500 48.5000 48.7500 + 49.0000 49.2500 49.5000 49.7500 50.0000 50.2500 50.5000 50.7500 + 51.0000 51.2500 51.5000 51.7500 52.0000 52.2500 52.5000 52.7500 + 53.0000 53.2500 53.5000 53.7500 54.0000 54.2500 54.5000 54.7500 + 55.0000 + +.. _gcc-hgrids-nested-025-eu: + +0.25° x 0.3125° EU nested grid +------------------------------ + +Domain: Europe + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-15.0, 40.0] + center_at_180: true + latitude: + range: [32.75, 61.25] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° EU longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -15.0000 -14.6875 -14.3750 -14.0625 -13.7500 -13.4375 -13.1250 -12.8125 + -12.5000 -12.1875 -11.8750 -11.5625 -11.2500 -10.9375 -10.6250 -10.3125 + -10.0000 -9.6875 -9.3750 -9.0625 -8.7500 -8.4375 -8.1250 -7.8125 + -7.5000 -7.1875 -6.8750 -6.5625 -6.2500 -5.9375 -5.6250 -5.3125 + -5.0000 -4.6875 -4.3750 -4.0625 -3.7500 -3.4375 -3.1250 -2.8125 + -2.5000 -2.1875 -1.8750 -1.5625 -1.2500 -0.9375 -0.6250 -0.3125 + 0.0000 0.3125 0.6250 0.9375 1.2500 1.5625 1.8750 2.1875 + 2.5000 2.8125 3.1250 3.4375 3.7500 4.0625 4.3750 4.6875 + 5.0000 5.3125 5.6250 5.9375 6.2500 6.5625 6.8750 7.1875 + 7.5000 7.8125 8.1250 8.4375 8.7500 9.0625 9.3750 9.6875 + 10.0000 10.3125 10.6250 10.9375 11.2500 11.5625 11.8750 12.1875 + 12.5000 12.8125 13.1250 13.4375 13.7500 14.0625 14.3750 14.6875 + 15.0000 15.3125 15.6250 15.9375 16.2500 16.5625 16.8750 17.1875 + 17.5000 17.8125 18.1250 18.4375 18.7500 19.0625 19.3750 19.6875 + 20.0000 20.3125 20.6250 20.9375 21.2500 21.5625 21.8750 22.1875 + 22.5000 22.8125 23.1250 23.4375 23.7500 24.0625 24.3750 24.6875 + 25.0000 25.3125 25.6250 25.9375 26.2500 26.5625 26.8750 27.1875 + 27.5000 27.8125 28.1250 28.4375 28.7500 29.0625 29.3750 29.6875 + 30.0000 30.3125 30.6250 30.9375 31.2500 31.5625 31.8750 32.1875 + 32.5000 32.8125 33.1250 33.4375 33.7500 34.0625 34.3750 34.6875 + 35.0000 35.3125 35.6250 35.9375 36.2500 36.5625 36.8750 37.1875 + 37.5000 37.8125 38.1250 38.4375 38.7500 39.0625 39.3750 39.6875 + 40.0000 + +0.25° x 0.3125° EU latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 32.7500 33.0000 33.2500 33.5000 33.7500 34.0000 34.2500 34.5000 + 34.7500 35.0000 35.2500 35.5000 35.7500 36.0000 36.2500 36.5000 + 36.7500 37.0000 37.2500 37.5000 37.7500 38.0000 38.2500 38.5000 + 38.7500 39.0000 39.2500 39.5000 39.7500 40.0000 40.2500 40.5000 + 40.7500 41.0000 41.2500 41.5000 41.7500 42.0000 42.2500 42.5000 + 42.7500 43.0000 43.2500 43.5000 43.7500 44.0000 44.2500 44.5000 + 44.7500 45.0000 45.2500 45.5000 45.7500 46.0000 46.2500 46.5000 + 46.7500 47.0000 47.2500 47.5000 47.7500 48.0000 48.2500 48.5000 + 48.7500 49.0000 49.2500 49.5000 49.7500 50.0000 50.2500 50.5000 + 50.7500 51.0000 51.2500 51.5000 51.7500 52.0000 52.2500 52.5000 + 52.7500 53.0000 53.2500 53.5000 53.7500 54.0000 54.2500 54.5000 + 54.7500 55.0000 55.2500 55.5000 55.7500 56.0000 56.2500 56.5000 + 56.7500 57.0000 57.2500 57.5000 57.7500 58.0000 58.2500 58.5000 + 58.7500 59.0000 59.2500 59.5000 59.7500 60.0000 60.2500 60.5000 + 60.7500 61.0000 61.2500 + +.. _gcc-hgrids-nested-025-me: + +0.25° x 0.3125° ME nested grid +------------------------------ + +Domain: Middle East + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-20.0, 70.0] + center_at_180: true + latitude: + range: [12.0, 44.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° ME longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -20.0000 -19.6875 -19.3750 -19.0625 -18.7500 -18.4375 -18.1250 -17.8125 + -17.5000 -17.1875 -16.8750 -16.5625 -16.2500 -15.9375 -15.6250 -15.3125 + -15.0000 -14.6875 -14.3750 -14.0625 -13.7500 -13.4375 -13.1250 -12.8125 + -12.5000 -12.1875 -11.8750 -11.5625 -11.2500 -10.9375 -10.6250 -10.3125 + -10.0000 -9.6875 -9.3750 -9.0625 -8.7500 -8.4375 -8.1250 -7.8125 + -7.5000 -7.1875 -6.8750 -6.5625 -6.2500 -5.9375 -5.6250 -5.3125 + -5.0000 -4.6875 -4.3750 -4.0625 -3.7500 -3.4375 -3.1250 -2.8125 + -2.5000 -2.1875 -1.8750 -1.5625 -1.2500 -0.9375 -0.6250 -0.3125 + 0.0000 0.3125 0.6250 0.9375 1.2500 1.5625 1.8750 2.1875 + 2.5000 2.8125 3.1250 3.4375 3.7500 4.0625 4.3750 4.6875 + 5.0000 5.3125 5.6250 5.9375 6.2500 6.5625 6.8750 7.1875 + 7.5000 7.8125 8.1250 8.4375 8.7500 9.0625 9.3750 9.6875 + 10.0000 10.3125 10.6250 10.9375 11.2500 11.5625 11.8750 12.1875 + 12.5000 12.8125 13.1250 13.4375 13.7500 14.0625 14.3750 14.6875 + 15.0000 15.3125 15.6250 15.9375 16.2500 16.5625 16.8750 17.1875 + 17.5000 17.8125 18.1250 18.4375 18.7500 19.0625 19.3750 19.6875 + 20.0000 20.3125 20.6250 20.9375 21.2500 21.5625 21.8750 22.1875 + 22.5000 22.8125 23.1250 23.4375 23.7500 24.0625 24.3750 24.6875 + 25.0000 25.3125 25.6250 25.9375 26.2500 26.5625 26.8750 27.1875 + 27.5000 27.8125 28.1250 28.4375 28.7500 29.0625 29.3750 29.6875 + 30.0000 30.3125 30.6250 30.9375 31.2500 31.5625 31.8750 32.1875 + 32.5000 32.8125 33.1250 33.4375 33.7500 34.0625 34.3750 34.6875 + 35.0000 35.3125 35.6250 35.9375 36.2500 36.5625 36.8750 37.1875 + 37.5000 37.8125 38.1250 38.4375 38.7500 39.0625 39.3750 39.6875 + 40.0000 40.3125 40.6250 40.9375 41.2500 41.5625 41.8750 42.1875 + 42.5000 42.8125 43.1250 43.4375 43.7500 44.0625 44.3750 44.6875 + 45.0000 45.3125 45.6250 45.9375 46.2500 46.5625 46.8750 47.1875 + 47.5000 47.8125 48.1250 48.4375 48.7500 49.0625 49.3750 49.6875 + 50.0000 50.3125 50.6250 50.9375 51.2500 51.5625 51.8750 52.1875 + 52.5000 52.8125 53.1250 53.4375 53.7500 54.0625 54.3750 54.6875 + 55.0000 55.3125 55.6250 55.9375 56.2500 56.5625 56.8750 57.1875 + 57.5000 57.8125 58.1250 58.4375 58.7500 59.0625 59.3750 59.6875 + 60.0000 60.3125 60.6250 60.9375 61.2500 61.5625 61.8750 62.1875 + 62.5000 62.8125 63.1250 63.4375 63.7500 64.0625 64.3750 64.6875 + 65.0000 65.3125 65.6250 65.9375 66.2500 66.5625 66.8750 67.1875 + 67.5000 67.8125 68.1250 68.4375 68.7500 69.0625 69.3750 69.6875 + 70.0000 + +0.25° x 0.3125° ME latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 12.0000 12.2500 12.5000 12.7500 13.0000 13.2500 13.5000 13.7500 + 14.0000 14.2500 14.5000 14.7500 15.0000 15.2500 15.5000 15.7500 + 16.0000 16.2500 16.5000 16.7500 17.0000 17.2500 17.5000 17.7500 + 18.0000 18.2500 18.5000 18.7500 19.0000 19.2500 19.5000 19.7500 + 20.0000 20.2500 20.5000 20.7500 21.0000 21.2500 21.5000 21.7500 + 22.0000 22.2500 22.5000 22.7500 23.0000 23.2500 23.5000 23.7500 + 24.0000 24.2500 24.5000 24.7500 25.0000 25.2500 25.5000 25.7500 + 26.0000 26.2500 26.5000 26.7500 27.0000 27.2500 27.5000 27.7500 + 28.0000 28.2500 28.5000 28.7500 29.0000 29.2500 29.5000 29.7500 + 30.0000 30.2500 30.5000 30.7500 31.0000 31.2500 31.5000 31.7500 + 32.0000 32.2500 32.5000 32.7500 33.0000 33.2500 33.5000 33.7500 + 34.0000 34.2500 34.5000 34.7500 35.0000 35.2500 35.5000 35.7500 + 36.0000 36.2500 36.5000 36.7500 37.0000 37.2500 37.5000 37.7500 + 38.0000 38.2500 38.5000 38.7500 39.0000 39.2500 39.5000 39.7500 + 40.0000 40.2500 40.5000 40.7500 41.0000 41.2500 41.5000 41.7500 + 42.0000 42.2500 42.5000 42.7500 43.0000 43.2500 43.5000 43.7500 + 44.0000 + +.. _gcc-hgrids-nested-025-na: + +0.25° x 0.3125° NA nested grid +------------------------------ + +Domain: North America + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-130.0, -60.0] + center_at_180: true + latitude: + range: [9.75, 60.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + + +0.25° x 0.3125° NA longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -130.0000 -129.6875 -129.3750 -129.0625 -128.7500 -128.4375 -128.1250 -127.8125 + -127.5000 -127.1875 -126.8750 -126.5625 -126.2500 -125.9375 -125.6250 -125.3125 + -125.0000 -124.6875 -124.3750 -124.0625 -123.7500 -123.4375 -123.1250 -122.8125 + -122.5000 -122.1875 -121.8750 -121.5625 -121.2500 -120.9375 -120.6250 -120.3125 + -120.0000 -119.6875 -119.3750 -119.0625 -118.7500 -118.4375 -118.1250 -117.8125 + -117.5000 -117.1875 -116.8750 -116.5625 -116.2500 -115.9375 -115.6250 -115.3125 + -115.0000 -114.6875 -114.3750 -114.0625 -113.7500 -113.4375 -113.1250 -112.8125 + -112.5000 -112.1875 -111.8750 -111.5625 -111.2500 -110.9375 -110.6250 -110.3125 + -110.0000 -109.6875 -109.3750 -109.0625 -108.7500 -108.4375 -108.1250 -107.8125 + -107.5000 -107.1875 -106.8750 -106.5625 -106.2500 -105.9375 -105.6250 -105.3125 + -105.0000 -104.6875 -104.3750 -104.0625 -103.7500 -103.4375 -103.1250 -102.8125 + -102.5000 -102.1875 -101.8750 -101.5625 -101.2500 -100.9375 -100.6250 -100.3125 + -100.0000 -99.6875 -99.3750 -99.0625 -98.7500 -98.4375 -98.1250 -97.8125 + -97.5000 -97.1875 -96.8750 -96.5625 -96.2500 -95.9375 -95.6250 -95.3125 + -95.0000 -94.6875 -94.3750 -94.0625 -93.7500 -93.4375 -93.1250 -92.8125 + -92.5000 -92.1875 -91.8750 -91.5625 -91.2500 -90.9375 -90.6250 -90.3125 + -90.0000 -89.6875 -89.3750 -89.0625 -88.7500 -88.4375 -88.1250 -87.8125 + -87.5000 -87.1875 -86.8750 -86.5625 -86.2500 -85.9375 -85.6250 -85.3125 + -85.0000 -84.6875 -84.3750 -84.0625 -83.7500 -83.4375 -83.1250 -82.8125 + -82.5000 -82.1875 -81.8750 -81.5625 -81.2500 -80.9375 -80.6250 -80.3125 + -80.0000 -79.6875 -79.3750 -79.0625 -78.7500 -78.4375 -78.1250 -77.8125 + -77.5000 -77.1875 -76.8750 -76.5625 -76.2500 -75.9375 -75.6250 -75.3125 + -75.0000 -74.6875 -74.3750 -74.0625 -73.7500 -73.4375 -73.1250 -72.8125 + -72.5000 -72.1875 -71.8750 -71.5625 -71.2500 -70.9375 -70.6250 -70.3125 + -70.0000 -69.6875 -69.3750 -69.0625 -68.7500 -68.4375 -68.1250 -67.8125 + -67.5000 -67.1875 -66.8750 -66.5625 -66.2500 -65.9375 -65.6250 -65.3125 + -65.0000 -64.6875 -64.3750 -64.0625 -63.7500 -63.4375 -63.1250 -62.8125 + -62.5000 -62.1875 -61.8750 -61.5625 -61.2500 -60.9375 -60.6250 -60.3125 + -60.0000 + +0.25° x 0.3125° NA latitudes: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 9.7500 10.0000 10.2500 10.5000 10.7500 11.0000 11.2500 11.5000 + 11.7500 12.0000 12.2500 12.5000 12.7500 13.0000 13.2500 13.5000 + 13.7500 14.0000 14.2500 14.5000 14.7500 15.0000 15.2500 15.5000 + 15.7500 16.0000 16.2500 16.5000 16.7500 17.0000 17.2500 17.5000 + 17.7500 18.0000 18.2500 18.5000 18.7500 19.0000 19.2500 19.5000 + 19.7500 20.0000 20.2500 20.5000 20.7500 21.0000 21.2500 21.5000 + 21.7500 22.0000 22.2500 22.5000 22.7500 23.0000 23.2500 23.5000 + 23.7500 24.0000 24.2500 24.5000 24.7500 25.0000 25.2500 25.5000 + 25.7500 26.0000 26.2500 26.5000 26.7500 27.0000 27.2500 27.5000 + 27.7500 28.0000 28.2500 28.5000 28.7500 29.0000 29.2500 29.5000 + 29.7500 30.0000 30.2500 30.5000 30.7500 31.0000 31.2500 31.5000 + 31.7500 32.0000 32.2500 32.5000 32.7500 33.0000 33.2500 33.5000 + 33.7500 34.0000 34.2500 34.5000 34.7500 35.0000 35.2500 35.5000 + 35.7500 36.0000 36.2500 36.5000 36.7500 37.0000 37.2500 37.5000 + 37.7500 38.0000 38.2500 38.5000 38.7500 39.0000 39.2500 39.5000 + 39.7500 40.0000 40.2500 40.5000 40.7500 41.0000 41.2500 41.5000 + 41.7500 42.0000 42.2500 42.5000 42.7500 43.0000 43.2500 43.5000 + 43.7500 44.0000 44.2500 44.5000 44.7500 45.0000 45.2500 45.5000 + 45.7500 46.0000 46.2500 46.5000 46.7500 47.0000 47.2500 47.5000 + 47.7500 48.0000 48.2500 48.5000 48.7500 49.0000 49.2500 49.5000 + 49.7500 50.0000 50.2500 50.5000 50.7500 51.0000 51.2500 51.5000 + 51.7500 52.0000 52.2500 52.5000 52.7500 53.0000 53.2500 53.5000 + 53.7500 54.0000 54.2500 54.5000 54.7500 55.0000 55.2500 55.5000 + 55.7500 56.0000 56.2500 56.5000 56.7500 57.0000 57.2500 57.5000 + 57.7500 58.0000 58.2500 58.5000 58.7500 59.0000 59.2500 59.5000 + 59.7500 60.0000 + +.. _gcc-hgrids-nested-025-oc: + +0.25° x 0.3125° OC nested grid +------------------------------ + +Domain: Oceania + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [110.0, 180.0] + center_at_180: true + latitude: + range: [-50.0, 5.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° OC longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 110.0000 110.3125 110.6250 110.9375 111.2500 111.5625 111.8750 112.1875 + 112.5000 112.8125 113.1250 113.4375 113.7500 114.0625 114.3750 114.6875 + 115.0000 115.3125 115.6250 115.9375 116.2500 116.5625 116.8750 117.1875 + 117.5000 117.8125 118.1250 118.4375 118.7500 119.0625 119.3750 119.6875 + 120.0000 120.3125 120.6250 120.9375 121.2500 121.5625 121.8750 122.1875 + 122.5000 122.8125 123.1250 123.4375 123.7500 124.0625 124.3750 124.6875 + 125.0000 125.3125 125.6250 125.9375 126.2500 126.5625 126.8750 127.1875 + 127.5000 127.8125 128.1250 128.4375 128.7500 129.0625 129.3750 129.6875 + 130.0000 130.3125 130.6250 130.9375 131.2500 131.5625 131.8750 132.1875 + 132.5000 132.8125 133.1250 133.4375 133.7500 134.0625 134.3750 134.6875 + 135.0000 135.3125 135.6250 135.9375 136.2500 136.5625 136.8750 137.1875 + 137.5000 137.8125 138.1250 138.4375 138.7500 139.0625 139.3750 139.6875 + 140.0000 140.3125 140.6250 140.9375 141.2500 141.5625 141.8750 142.1875 + 142.5000 142.8125 143.1250 143.4375 143.7500 144.0625 144.3750 144.6875 + 145.0000 145.3125 145.6250 145.9375 146.2500 146.5625 146.8750 147.1875 + 147.5000 147.8125 148.1250 148.4375 148.7500 149.0625 149.3750 149.6875 + 150.0000 150.3125 150.6250 150.9375 151.2500 151.5625 151.8750 152.1875 + 152.5000 152.8125 153.1250 153.4375 153.7500 154.0625 154.3750 154.6875 + 155.0000 155.3125 155.6250 155.9375 156.2500 156.5625 156.8750 157.1875 + 157.5000 157.8125 158.1250 158.4375 158.7500 159.0625 159.3750 159.6875 + 160.0000 160.3125 160.6250 160.9375 161.2500 161.5625 161.8750 162.1875 + 162.5000 162.8125 163.1250 163.4375 163.7500 164.0625 164.3750 164.6875 + 165.0000 165.3125 165.6250 165.9375 166.2500 166.5625 166.8750 167.1875 + 167.5000 167.8125 168.1250 168.4375 168.7500 169.0625 169.3750 169.6875 + 170.0000 170.3125 170.6250 170.9375 171.2500 171.5625 171.8750 172.1875 + 172.5000 172.8125 173.1250 173.4375 173.7500 174.0625 174.3750 174.6875 + 175.0000 175.3125 175.6250 175.9375 176.2500 176.5625 176.8750 177.1875 + 177.5000 177.8125 178.1250 178.4375 178.7500 179.0625 179.3750 179.6875 + +0.25° x 0.3125° OC latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -50.0000 -49.7500 -49.5000 -49.2500 -49.0000 -48.7500 -48.5000 -48.2500 + -48.0000 -47.7500 -47.5000 -47.2500 -47.0000 -46.7500 -46.5000 -46.2500 + -46.0000 -45.7500 -45.5000 -45.2500 -45.0000 -44.7500 -44.5000 -44.2500 + -44.0000 -43.7500 -43.5000 -43.2500 -43.0000 -42.7500 -42.5000 -42.2500 + -42.0000 -41.7500 -41.5000 -41.2500 -41.0000 -40.7500 -40.5000 -40.2500 + -40.0000 -39.7500 -39.5000 -39.2500 -39.0000 -38.7500 -38.5000 -38.2500 + -38.0000 -37.7500 -37.5000 -37.2500 -37.0000 -36.7500 -36.5000 -36.2500 + -36.0000 -35.7500 -35.5000 -35.2500 -35.0000 -34.7500 -34.5000 -34.2500 + -34.0000 -33.7500 -33.5000 -33.2500 -33.0000 -32.7500 -32.5000 -32.2500 + -32.0000 -31.7500 -31.5000 -31.2500 -31.0000 -30.7500 -30.5000 -30.2500 + -30.0000 -29.7500 -29.5000 -29.2500 -29.0000 -28.7500 -28.5000 -28.2500 + -28.0000 -27.7500 -27.5000 -27.2500 -27.0000 -26.7500 -26.5000 -26.2500 + -26.0000 -25.7500 -25.5000 -25.2500 -25.0000 -24.7500 -24.5000 -24.2500 + -24.0000 -23.7500 -23.5000 -23.2500 -23.0000 -22.7500 -22.5000 -22.2500 + -22.0000 -21.7500 -21.5000 -21.2500 -21.0000 -20.7500 -20.5000 -20.2500 + -20.0000 -19.7500 -19.5000 -19.2500 -19.0000 -18.7500 -18.5000 -18.2500 + -18.0000 -17.7500 -17.5000 -17.2500 -17.0000 -16.7500 -16.5000 -16.2500 + -16.0000 -15.7500 -15.5000 -15.2500 -15.0000 -14.7500 -14.5000 -14.2500 + -14.0000 -13.7500 -13.5000 -13.2500 -13.0000 -12.7500 -12.5000 -12.2500 + -12.0000 -11.7500 -11.5000 -11.2500 -11.0000 -10.7500 -10.5000 -10.2500 + -10.0000 -9.7500 -9.5000 -9.2500 -9.0000 -8.7500 -8.5000 -8.2500 + -8.0000 -7.7500 -7.5000 -7.2500 -7.0000 -6.7500 -6.5000 -6.2500 + -6.0000 -5.7500 -5.5000 -5.2500 -5.0000 -4.7500 -4.5000 -4.2500 + -4.0000 -3.7500 -3.5000 -3.2500 -3.0000 -2.7500 -2.5000 -2.2500 + -2.0000 -1.7500 -1.5000 -1.2500 -1.0000 -0.7500 -0.5000 -0.2500 + 0.0000 0.2500 0.5000 0.7500 1.0000 1.2500 1.5000 1.7500 + 2.0000 2.2500 2.5000 2.7500 3.0000 3.2500 3.5000 3.7500 + 4.0000 4.2500 4.5000 4.7500 5.0000 + +.. _gcc-hgrids-nested-025-sa: + +0.25° x 0.3125° SA nested grid +------------------------------ + +Domain: South America + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-87.8125, -31.25] + center_at_180: true + latitude: + range: [-59.0, 16.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° SA longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -87.8125 -87.5000 -87.1875 -86.8750 -86.5625 -86.2500 -85.9375 -85.6250 + -85.3125 -85.0000 -84.6875 -84.3750 -84.0625 -83.7500 -83.4375 -83.1250 + -82.8125 -82.5000 -82.1875 -81.8750 -81.5625 -81.2500 -80.9375 -80.6250 + -80.3125 -80.0000 -79.6875 -79.3750 -79.0625 -78.7500 -78.4375 -78.1250 + -77.8125 -77.5000 -77.1875 -76.8750 -76.5625 -76.2500 -75.9375 -75.6250 + -75.3125 -75.0000 -74.6875 -74.3750 -74.0625 -73.7500 -73.4375 -73.1250 + -72.8125 -72.5000 -72.1875 -71.8750 -71.5625 -71.2500 -70.9375 -70.6250 + -70.3125 -70.0000 -69.6875 -69.3750 -69.0625 -68.7500 -68.4375 -68.1250 + -67.8125 -67.5000 -67.1875 -66.8750 -66.5625 -66.2500 -65.9375 -65.6250 + -65.3125 -65.0000 -64.6875 -64.3750 -64.0625 -63.7500 -63.4375 -63.1250 + -62.8125 -62.5000 -62.1875 -61.8750 -61.5625 -61.2500 -60.9375 -60.6250 + -60.3125 -60.0000 -59.6875 -59.3750 -59.0625 -58.7500 -58.4375 -58.1250 + -57.8125 -57.5000 -57.1875 -56.8750 -56.5625 -56.2500 -55.9375 -55.6250 + -55.3125 -55.0000 -54.6875 -54.3750 -54.0625 -53.7500 -53.4375 -53.1250 + -52.8125 -52.5000 -52.1875 -51.8750 -51.5625 -51.2500 -50.9375 -50.6250 + -50.3125 -50.0000 -49.6875 -49.3750 -49.0625 -48.7500 -48.4375 -48.1250 + -47.8125 -47.5000 -47.1875 -46.8750 -46.5625 -46.2500 -45.9375 -45.6250 + -45.3125 -45.0000 -44.6875 -44.3750 -44.0625 -43.7500 -43.4375 -43.1250 + -42.8125 -42.5000 -42.1875 -41.8750 -41.5625 -41.2500 -40.9375 -40.6250 + -40.3125 -40.0000 -39.6875 -39.3750 -39.0625 -38.7500 -38.4375 -38.1250 + -37.8125 -37.5000 -37.1875 -36.8750 -36.5625 -36.2500 -35.9375 -35.6250 + -35.3125 -35.0000 -34.6875 -34.3750 -34.0625 -33.7500 -33.4375 -33.1250 + -32.8125 -32.5000 -32.1875 -31.8750 -31.5625 -31.2500 + +0.25° x 0.3125° SA latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -59.0000 -58.7500 -58.5000 -58.2500 -58.0000 -57.7500 -57.5000 -57.2500 + -57.0000 -56.7500 -56.5000 -56.2500 -56.0000 -55.7500 -55.5000 -55.2500 + -55.0000 -54.7500 -54.5000 -54.2500 -54.0000 -53.7500 -53.5000 -53.2500 + -53.0000 -52.7500 -52.5000 -52.2500 -52.0000 -51.7500 -51.5000 -51.2500 + -51.0000 -50.7500 -50.5000 -50.2500 -50.0000 -49.7500 -49.5000 -49.2500 + -49.0000 -48.7500 -48.5000 -48.2500 -48.0000 -47.7500 -47.5000 -47.2500 + -47.0000 -46.7500 -46.5000 -46.2500 -46.0000 -45.7500 -45.5000 -45.2500 + -45.0000 -44.7500 -44.5000 -44.2500 -44.0000 -43.7500 -43.5000 -43.2500 + -43.0000 -42.7500 -42.5000 -42.2500 -42.0000 -41.7500 -41.5000 -41.2500 + -41.0000 -40.7500 -40.5000 -40.2500 -40.0000 -39.7500 -39.5000 -39.2500 + -39.0000 -38.7500 -38.5000 -38.2500 -38.0000 -37.7500 -37.5000 -37.2500 + -37.0000 -36.7500 -36.5000 -36.2500 -36.0000 -35.7500 -35.5000 -35.2500 + -35.0000 -34.7500 -34.5000 -34.2500 -34.0000 -33.7500 -33.5000 -33.2500 + -33.0000 -32.7500 -32.5000 -32.2500 -32.0000 -31.7500 -31.5000 -31.2500 + -31.0000 -30.7500 -30.5000 -30.2500 -30.0000 -29.7500 -29.5000 -29.2500 + -29.0000 -28.7500 -28.5000 -28.2500 -28.0000 -27.7500 -27.5000 -27.2500 + -27.0000 -26.7500 -26.5000 -26.2500 -26.0000 -25.7500 -25.5000 -25.2500 + -25.0000 -24.7500 -24.5000 -24.2500 -24.0000 -23.7500 -23.5000 -23.2500 + -23.0000 -22.7500 -22.5000 -22.2500 -22.0000 -21.7500 -21.5000 -21.2500 + -21.0000 -20.7500 -20.5000 -20.2500 -20.0000 -19.7500 -19.5000 -19.2500 + -19.0000 -18.7500 -18.5000 -18.2500 -18.0000 -17.7500 -17.5000 -17.2500 + -17.0000 -16.7500 -16.5000 -16.2500 -16.0000 -15.7500 -15.5000 -15.2500 + -15.0000 -14.7500 -14.5000 -14.2500 -14.0000 -13.7500 -13.5000 -13.2500 + -13.0000 -12.7500 -12.5000 -12.2500 -12.0000 -11.7500 -11.5000 -11.2500 + -11.0000 -10.7500 -10.5000 -10.2500 -10.0000 -9.7500 -9.5000 -9.2500 + -9.0000 -8.7500 -8.5000 -8.2500 -8.0000 -7.7500 -7.5000 -7.2500 + -7.0000 -6.7500 -6.5000 -6.2500 -6.0000 -5.7500 -5.5000 -5.2500 + -5.0000 -4.7500 -4.5000 -4.2500 -4.0000 -3.7500 -3.5000 -3.2500 + -3.0000 -2.7500 -2.5000 -2.2500 -2.0000 -1.7500 -1.5000 -1.2500 + -1.0000 -0.7500 -0.5000 -0.2500 0.0000 0.2500 0.5000 0.7500 + 1.0000 1.2500 1.5000 1.7500 2.0000 2.2500 2.5000 2.7500 + 3.0000 3.2500 3.5000 3.7500 4.0000 4.2500 4.5000 4.7500 + 5.0000 5.2500 5.5000 5.7500 6.0000 6.2500 6.5000 6.7500 + 7.0000 7.2500 7.5000 7.7500 8.0000 8.2500 8.5000 8.7500 + 9.0000 9.2500 9.5000 9.7500 10.0000 10.2500 10.5000 10.7500 + 11.0000 11.2500 11.5000 11.7500 12.0000 12.2500 12.5000 12.7500 + 13.0000 13.2500 13.5000 13.7500 14.0000 14.2500 14.5000 14.7500 + 15.0000 15.2500 15.5000 15.7500 16.0000 + +.. _gcc-hgrids-nested-025-ru: + +0.25° x 0.3125° RU nested grid +------------------------------ + +Domain: Russia + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.25x0.3125 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [20.0, 180.0] + center_at_180: true + latitude: + range: [41.0, 83.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.25° x 0.3125° RU longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 20.0000 20.3125 20.6250 20.9375 21.2500 21.5625 21.8750 22.1875 + 22.5000 22.8125 23.1250 23.4375 23.7500 24.0625 24.3750 24.6875 + 25.0000 25.3125 25.6250 25.9375 26.2500 26.5625 26.8750 27.1875 + 27.5000 27.8125 28.1250 28.4375 28.7500 29.0625 29.3750 29.6875 + 30.0000 30.3125 30.6250 30.9375 31.2500 31.5625 31.8750 32.1875 + 32.5000 32.8125 33.1250 33.4375 33.7500 34.0625 34.3750 34.6875 + 35.0000 35.3125 35.6250 35.9375 36.2500 36.5625 36.8750 37.1875 + 37.5000 37.8125 38.1250 38.4375 38.7500 39.0625 39.3750 39.6875 + 40.0000 40.3125 40.6250 40.9375 41.2500 41.5625 41.8750 42.1875 + 42.5000 42.8125 43.1250 43.4375 43.7500 44.0625 44.3750 44.6875 + 45.0000 45.3125 45.6250 45.9375 46.2500 46.5625 46.8750 47.1875 + 47.5000 47.8125 48.1250 48.4375 48.7500 49.0625 49.3750 49.6875 + 50.0000 50.3125 50.6250 50.9375 51.2500 51.5625 51.8750 52.1875 + 52.5000 52.8125 53.1250 53.4375 53.7500 54.0625 54.3750 54.6875 + 55.0000 55.3125 55.6250 55.9375 56.2500 56.5625 56.8750 57.1875 + 57.5000 57.8125 58.1250 58.4375 58.7500 59.0625 59.3750 59.6875 + 60.0000 60.3125 60.6250 60.9375 61.2500 61.5625 61.8750 62.1875 + 62.5000 62.8125 63.1250 63.4375 63.7500 64.0625 64.3750 64.6875 + 65.0000 65.3125 65.6250 65.9375 66.2500 66.5625 66.8750 67.1875 + 67.5000 67.8125 68.1250 68.4375 68.7500 69.0625 69.3750 69.6875 + 70.0000 70.3125 70.6250 70.9375 71.2500 71.5625 71.8750 72.1875 + 72.5000 72.8125 73.1250 73.4375 73.7500 74.0625 74.3750 74.6875 + 75.0000 75.3125 75.6250 75.9375 76.2500 76.5625 76.8750 77.1875 + 77.5000 77.8125 78.1250 78.4375 78.7500 79.0625 79.3750 79.6875 + 80.0000 80.3125 80.6250 80.9375 81.2500 81.5625 81.8750 82.1875 + 82.5000 82.8125 83.1250 83.4375 83.7500 84.0625 84.3750 84.6875 + 85.0000 85.3125 85.6250 85.9375 86.2500 86.5625 86.8750 87.1875 + 87.5000 87.8125 88.1250 88.4375 88.7500 89.0625 89.3750 89.6875 + 90.0000 90.3125 90.6250 90.9375 91.2500 91.5625 91.8750 92.1875 + 92.5000 92.8125 93.1250 93.4375 93.7500 94.0625 94.3750 94.6875 + 95.0000 95.3125 95.6250 95.9375 96.2500 96.5625 96.8750 97.1875 + 97.5000 97.8125 98.1250 98.4375 98.7500 99.0625 99.3750 99.6875 + 100.0000 100.3125 100.6250 100.9375 101.2500 101.5625 101.8750 102.1875 + 102.5000 102.8125 103.1250 103.4375 103.7500 104.0625 104.3750 104.6875 + 105.0000 105.3125 105.6250 105.9375 106.2500 106.5625 106.8750 107.1875 + 107.5000 107.8125 108.1250 108.4375 108.7500 109.0625 109.3750 109.6875 + 110.0000 110.3125 110.6250 110.9375 111.2500 111.5625 111.8750 112.1875 + 112.5000 112.8125 113.1250 113.4375 113.7500 114.0625 114.3750 114.6875 + 115.0000 115.3125 115.6250 115.9375 116.2500 116.5625 116.8750 117.1875 + 117.5000 117.8125 118.1250 118.4375 118.7500 119.0625 119.3750 119.6875 + 120.0000 120.3125 120.6250 120.9375 121.2500 121.5625 121.8750 122.1875 + 122.5000 122.8125 123.1250 123.4375 123.7500 124.0625 124.3750 124.6875 + 125.0000 125.3125 125.6250 125.9375 126.2500 126.5625 126.8750 127.1875 + 127.5000 127.8125 128.1250 128.4375 128.7500 129.0625 129.3750 129.6875 + 130.0000 130.3125 130.6250 130.9375 131.2500 131.5625 131.8750 132.1875 + 132.5000 132.8125 133.1250 133.4375 133.7500 134.0625 134.3750 134.6875 + 135.0000 135.3125 135.6250 135.9375 136.2500 136.5625 136.8750 137.1875 + 137.5000 137.8125 138.1250 138.4375 138.7500 139.0625 139.3750 139.6875 + 140.0000 140.3125 140.6250 140.9375 141.2500 141.5625 141.8750 142.1875 + 142.5000 142.8125 143.1250 143.4375 143.7500 144.0625 144.3750 144.6875 + 145.0000 145.3125 145.6250 145.9375 146.2500 146.5625 146.8750 147.1875 + 147.5000 147.8125 148.1250 148.4375 148.7500 149.0625 149.3750 149.6875 + 150.0000 150.3125 150.6250 150.9375 151.2500 151.5625 151.8750 152.1875 + 152.5000 152.8125 153.1250 153.4375 153.7500 154.0625 154.3750 154.6875 + 155.0000 155.3125 155.6250 155.9375 156.2500 156.5625 156.8750 157.1875 + 157.5000 157.8125 158.1250 158.4375 158.7500 159.0625 159.3750 159.6875 + 160.0000 160.3125 160.6250 160.9375 161.2500 161.5625 161.8750 162.1875 + 162.5000 162.8125 163.1250 163.4375 163.7500 164.0625 164.3750 164.6875 + 165.0000 165.3125 165.6250 165.9375 166.2500 166.5625 166.8750 167.1875 + 167.5000 167.8125 168.1250 168.4375 168.7500 169.0625 169.3750 169.6875 + 170.0000 170.3125 170.6250 170.9375 171.2500 171.5625 171.8750 172.1875 + 172.5000 172.8125 173.1250 173.4375 173.7500 174.0625 174.3750 174.6875 + 175.0000 175.3125 175.6250 175.9375 176.2500 176.5625 176.8750 177.1875 + 177.5000 177.8125 178.1250 178.4375 178.7500 179.0625 + 179.3750 179.6875 + +0.25° x 0.3125° RU latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 41.0000 41.2500 41.5000 41.7500 42.0000 42.2500 42.5000 42.7500 + 43.0000 43.2500 43.5000 43.7500 44.0000 44.2500 44.5000 44.7500 + 45.0000 45.2500 45.5000 45.7500 46.0000 46.2500 46.5000 46.7500 + 47.0000 47.2500 47.5000 47.7500 48.0000 48.2500 48.5000 48.7500 + 49.0000 49.2500 49.5000 49.7500 50.0000 50.2500 50.5000 50.7500 + 51.0000 51.2500 51.5000 51.7500 52.0000 52.2500 52.5000 52.7500 + 53.0000 53.2500 53.5000 53.7500 54.0000 54.2500 54.5000 54.7500 + 55.0000 55.2500 55.5000 55.7500 56.0000 56.2500 56.5000 56.7500 + 57.0000 57.2500 57.5000 57.7500 58.0000 58.2500 58.5000 58.7500 + 59.0000 59.2500 59.5000 59.7500 60.0000 60.2500 60.5000 60.7500 + 61.0000 61.2500 61.5000 61.7500 62.0000 62.2500 62.5000 62.7500 + 63.0000 63.2500 63.5000 63.7500 64.0000 64.2500 64.5000 64.7500 + 65.0000 65.2500 65.5000 65.7500 66.0000 66.2500 66.5000 66.7500 + 67.0000 67.2500 67.5000 67.7500 68.0000 68.2500 68.5000 68.7500 + 69.0000 69.2500 69.5000 69.7500 70.0000 70.2500 70.5000 70.7500 + 71.0000 71.2500 71.5000 71.7500 72.0000 72.2500 72.5000 72.7500 + 73.0000 73.2500 73.5000 73.7500 74.0000 74.2500 74.5000 74.7500 + 75.0000 75.2500 75.5000 75.7500 76.0000 76.2500 76.5000 76.7500 + 77.0000 77.2500 77.5000 77.7500 78.0000 78.2500 78.5000 78.7500 + 79.0000 79.2500 79.5000 79.7500 80.0000 80.2500 80.5000 80.7500 + 81.0000 81.2500 81.5000 81.7500 82.0000 82.2500 82.5000 82.7500 + 83.0000 + +.. _gcc-hgrids-nested-0125-af: + +0.125° x 0.15625° AF nested grid +-------------------------------- + +Domain: Africa + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.125x0.15625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-20.0, 52.8125] + center_at_180: true + latitude: + range: [-59.0, 16.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.125° x 0.15625° AF longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -20.00000 -19.84375 -19.68750 -19.53125 -19.37500 -19.21875 -19.06250 -18.90625 + -18.75000 -18.59375 -18.43750 -18.28125 -18.12500 -17.96875 -17.81250 -17.65625 + -17.50000 -17.34375 -17.18750 -17.03125 -16.87500 -16.71875 -16.56250 -16.40625 + -16.25000 -16.09375 -15.93750 -15.78125 -15.62500 -15.46875 -15.31250 -15.15625 + -15.00000 -14.84375 -14.68750 -14.53125 -14.37500 -14.21875 -14.06250 -13.90625 + -13.75000 -13.59375 -13.43750 -13.28125 -13.12500 -12.96875 -12.81250 -12.65625 + -12.50000 -12.34375 -12.18750 -12.03125 -11.87500 -11.71875 -11.56250 -11.40625 + -11.25000 -11.09375 -10.93750 -10.78125 -10.62500 -10.46875 -10.31250 -10.15625 + -10.00000 -9.84375 -9.68750 -9.53125 -9.37500 -9.21875 -9.06250 -8.90625 + -8.75000 -8.59375 -8.43750 -8.28125 -8.12500 -7.96875 -7.81250 -7.65625 + -7.50000 -7.34375 -7.18750 -7.03125 -6.87500 -6.71875 -6.56250 -6.40625 + -6.25000 -6.09375 -5.93750 -5.78125 -5.62500 -5.46875 -5.31250 -5.15625 + -5.00000 -4.84375 -4.68750 -4.53125 -4.37500 -4.21875 -4.06250 -3.90625 + -3.75000 -3.59375 -3.43750 -3.28125 -3.12500 -2.96875 -2.81250 -2.65625 + -2.50000 -2.34375 -2.18750 -2.03125 -1.87500 -1.71875 -1.56250 -1.40625 + -1.25000 -1.09375 -0.93750 -0.78125 -0.62500 -0.46875 -0.31250 -0.15625 + 0.00000 0.15625 0.31250 0.46875 0.62500 0.78125 0.93750 1.09375 + 1.25000 1.40625 1.56250 1.71875 1.87500 2.03125 2.18750 2.34375 + 2.50000 2.65625 2.81250 2.96875 3.12500 3.28125 3.43750 3.59375 + 3.75000 3.90625 4.06250 4.21875 4.37500 4.53125 4.68750 4.84375 + 5.00000 5.15625 5.31250 5.46875 5.62500 5.78125 5.93750 6.09375 + 6.25000 6.40625 6.56250 6.71875 6.87500 7.03125 7.18750 7.34375 + 7.50000 7.65625 7.81250 7.96875 8.12500 8.28125 8.43750 8.59375 + 8.75000 8.90625 9.06250 9.21875 9.37500 9.53125 9.68750 9.84375 + 10.00000 10.15625 10.31250 10.46875 10.62500 10.78125 10.93750 11.09375 + 11.25000 11.40625 11.56250 11.71875 11.87500 12.03125 12.18750 12.34375 + 12.50000 12.65625 12.81250 12.96875 13.12500 13.28125 13.43750 13.59375 + 13.75000 13.90625 14.06250 14.21875 14.37500 14.53125 14.68750 14.84375 + 15.00000 15.15625 15.31250 15.46875 15.62500 15.78125 15.93750 16.09375 + 16.25000 16.40625 16.56250 16.71875 16.87500 17.03125 17.18750 17.34375 + 17.50000 17.65625 17.81250 17.96875 18.12500 18.28125 18.43750 18.59375 + 18.75000 18.90625 19.06250 19.21875 19.37500 19.53125 19.68750 19.84375 + 20.00000 20.15625 20.31250 20.46875 20.62500 20.78125 20.93750 21.09375 + 21.25000 21.40625 21.56250 21.71875 21.87500 22.03125 22.18750 22.34375 + 22.50000 22.65625 22.81250 22.96875 23.12500 23.28125 23.43750 23.59375 + 23.75000 23.90625 24.06250 24.21875 24.37500 24.53125 24.68750 24.84375 + 25.00000 25.15625 25.31250 25.46875 25.62500 25.78125 25.93750 26.09375 + 26.25000 26.40625 26.56250 26.71875 26.87500 27.03125 27.18750 27.34375 + 27.50000 27.65625 27.81250 27.96875 28.12500 28.28125 28.43750 28.59375 + 28.75000 28.90625 29.06250 29.21875 29.37500 29.53125 29.68750 29.84375 + 30.00000 30.15625 30.31250 30.46875 30.62500 30.78125 30.93750 31.09375 + 31.25000 31.40625 31.56250 31.71875 31.87500 32.03125 32.18750 32.34375 + 32.50000 32.65625 32.81250 32.96875 33.12500 33.28125 33.43750 33.59375 + 33.75000 33.90625 34.06250 34.21875 34.37500 34.53125 34.68750 34.84375 + 35.00000 35.15625 35.31250 35.46875 35.62500 35.78125 35.93750 36.09375 + 36.25000 36.40625 36.56250 36.71875 36.87500 37.03125 37.18750 37.34375 + 37.50000 37.65625 37.81250 37.96875 38.12500 38.28125 38.43750 38.59375 + 38.75000 38.90625 39.06250 39.21875 39.37500 39.53125 39.68750 39.84375 + 40.00000 40.15625 40.31250 40.46875 40.62500 40.78125 40.93750 41.09375 + 41.25000 41.40625 41.56250 41.71875 41.87500 42.03125 42.18750 42.34375 + 42.50000 42.65625 42.81250 42.96875 43.12500 43.28125 43.43750 43.59375 + 43.75000 43.90625 44.06250 44.21875 44.37500 44.53125 44.68750 44.84375 + 45.00000 45.15625 45.31250 45.46875 45.62500 45.78125 45.93750 46.09375 + 46.25000 46.40625 46.56250 46.71875 46.87500 47.03125 47.18750 47.34375 + 47.50000 47.65625 47.81250 47.96875 48.12500 48.28125 48.43750 48.59375 + 48.75000 48.90625 49.06250 49.21875 49.37500 49.53125 49.68750 49.84375 + 50.00000 50.15625 50.31250 50.46875 50.62500 50.78125 50.93750 51.09375 + 51.25000 51.40625 51.56250 51.71875 51.87500 52.03125 52.18750 52.34375 + 52.50000 52.65625 52.81250 + +0.125° x 0.15625° AF latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -59.00000 -58.87500 -58.75000 -58.62500 -58.50000 -58.37500 -58.25000 -58.12500 + -58.00000 -57.87500 -57.75000 -57.62500 -57.50000 -57.37500 -57.25000 -57.12500 + -57.00000 -56.87500 -56.75000 -56.62500 -56.50000 -56.37500 -56.25000 -56.12500 + -56.00000 -55.87500 -55.75000 -55.62500 -55.50000 -55.37500 -55.25000 -55.12500 + -55.00000 -54.87500 -54.75000 -54.62500 -54.50000 -54.37500 -54.25000 -54.12500 + -54.00000 -53.87500 -53.75000 -53.62500 -53.50000 -53.37500 -53.25000 -53.12500 + -53.00000 -52.87500 -52.75000 -52.62500 -52.50000 -52.37500 -52.25000 -52.12500 + -52.00000 -51.87500 -51.75000 -51.62500 -51.50000 -51.37500 -51.25000 -51.12500 + -51.00000 -50.87500 -50.75000 -50.62500 -50.50000 -50.37500 -50.25000 -50.12500 + -50.00000 -49.87500 -49.75000 -49.62500 -49.50000 -49.37500 -49.25000 -49.12500 + -49.00000 -48.87500 -48.75000 -48.62500 -48.50000 -48.37500 -48.25000 -48.12500 + -48.00000 -47.87500 -47.75000 -47.62500 -47.50000 -47.37500 -47.25000 -47.12500 + -47.00000 -46.87500 -46.75000 -46.62500 -46.50000 -46.37500 -46.25000 -46.12500 + -46.00000 -45.87500 -45.75000 -45.62500 -45.50000 -45.37500 -45.25000 -45.12500 + -45.00000 -44.87500 -44.75000 -44.62500 -44.50000 -44.37500 -44.25000 -44.12500 + -44.00000 -43.87500 -43.75000 -43.62500 -43.50000 -43.37500 -43.25000 -43.12500 + -43.00000 -42.87500 -42.75000 -42.62500 -42.50000 -42.37500 -42.25000 -42.12500 + -42.00000 -41.87500 -41.75000 -41.62500 -41.50000 -41.37500 -41.25000 -41.12500 + -41.00000 -40.87500 -40.75000 -40.62500 -40.50000 -40.37500 -40.25000 -40.12500 + -40.00000 -39.87500 -39.75000 -39.62500 -39.50000 -39.37500 -39.25000 -39.12500 + -39.00000 -38.87500 -38.75000 -38.62500 -38.50000 -38.37500 -38.25000 -38.12500 + -38.00000 -37.87500 -37.75000 -37.62500 -37.50000 -37.37500 -37.25000 -37.12500 + -37.00000 -36.87500 -36.75000 -36.62500 -36.50000 -36.37500 -36.25000 -36.12500 + -36.00000 -35.87500 -35.75000 -35.62500 -35.50000 -35.37500 -35.25000 -35.12500 + -35.00000 -34.87500 -34.75000 -34.62500 -34.50000 -34.37500 -34.25000 -34.12500 + -34.00000 -33.87500 -33.75000 -33.62500 -33.50000 -33.37500 -33.25000 -33.12500 + -33.00000 -32.87500 -32.75000 -32.62500 -32.50000 -32.37500 -32.25000 -32.12500 + -32.00000 -31.87500 -31.75000 -31.62500 -31.50000 -31.37500 -31.25000 -31.12500 + -31.00000 -30.87500 -30.75000 -30.62500 -30.50000 -30.37500 -30.25000 -30.12500 + -30.00000 -29.87500 -29.75000 -29.62500 -29.50000 -29.37500 -29.25000 -29.12500 + -29.00000 -28.87500 -28.75000 -28.62500 -28.50000 -28.37500 -28.25000 -28.12500 + -28.00000 -27.87500 -27.75000 -27.62500 -27.50000 -27.37500 -27.25000 -27.12500 + -27.00000 -26.87500 -26.75000 -26.62500 -26.50000 -26.37500 -26.25000 -26.12500 + -26.00000 -25.87500 -25.75000 -25.62500 -25.50000 -25.37500 -25.25000 -25.12500 + -25.00000 -24.87500 -24.75000 -24.62500 -24.50000 -24.37500 -24.25000 -24.12500 + -24.00000 -23.87500 -23.75000 -23.62500 -23.50000 -23.37500 -23.25000 -23.12500 + -23.00000 -22.87500 -22.75000 -22.62500 -22.50000 -22.37500 -22.25000 -22.12500 + -22.00000 -21.87500 -21.75000 -21.62500 -21.50000 -21.37500 -21.25000 -21.12500 + -21.00000 -20.87500 -20.75000 -20.62500 -20.50000 -20.37500 -20.25000 -20.12500 + -20.00000 -19.87500 -19.75000 -19.62500 -19.50000 -19.37500 -19.25000 -19.12500 + -19.00000 -18.87500 -18.75000 -18.62500 -18.50000 -18.37500 -18.25000 -18.12500 + -18.00000 -17.87500 -17.75000 -17.62500 -17.50000 -17.37500 -17.25000 -17.12500 + -17.00000 -16.87500 -16.75000 -16.62500 -16.50000 -16.37500 -16.25000 -16.12500 + -16.00000 -15.87500 -15.75000 -15.62500 -15.50000 -15.37500 -15.25000 -15.12500 + -15.00000 -14.87500 -14.75000 -14.62500 -14.50000 -14.37500 -14.25000 -14.12500 + -14.00000 -13.87500 -13.75000 -13.62500 -13.50000 -13.37500 -13.25000 -13.12500 + -13.00000 -12.87500 -12.75000 -12.62500 -12.50000 -12.37500 -12.25000 -12.12500 + -12.00000 -11.87500 -11.75000 -11.62500 -11.50000 -11.37500 -11.25000 -11.12500 + -11.00000 -10.87500 -10.75000 -10.62500 -10.50000 -10.37500 -10.25000 -10.12500 + -10.00000 -9.87500 -9.75000 -9.62500 -9.50000 -9.37500 -9.25000 -9.12500 + -9.00000 -8.87500 -8.75000 -8.62500 -8.50000 -8.37500 -8.25000 -8.12500 + -8.00000 -7.87500 -7.75000 -7.62500 -7.50000 -7.37500 -7.25000 -7.12500 + -7.00000 -6.87500 -6.75000 -6.62500 -6.50000 -6.37500 -6.25000 -6.12500 + -6.00000 -5.87500 -5.75000 -5.62500 -5.50000 -5.37500 -5.25000 -5.12500 + -5.00000 -4.87500 -4.75000 -4.62500 -4.50000 -4.37500 -4.25000 -4.12500 + -4.00000 -3.87500 -3.75000 -3.62500 -3.50000 -3.37500 -3.25000 -3.12500 + -3.00000 -2.87500 -2.75000 -2.62500 -2.50000 -2.37500 -2.25000 -2.12500 + -2.00000 -1.87500 -1.75000 -1.62500 -1.50000 -1.37500 -1.25000 -1.12500 + -1.00000 -0.87500 -0.75000 -0.62500 -0.50000 -0.37500 -0.25000 -0.12500 + 0.00000 0.12500 0.25000 0.37500 0.50000 0.62500 0.75000 0.87500 + 1.00000 1.12500 1.25000 1.37500 1.50000 1.62500 1.75000 1.87500 + 2.00000 2.12500 2.25000 2.37500 2.50000 2.62500 2.75000 2.87500 + 3.00000 3.12500 3.25000 3.37500 3.50000 3.62500 3.75000 3.87500 + 4.00000 4.12500 4.25000 4.37500 4.50000 4.62500 4.75000 4.87500 + 5.00000 5.12500 5.25000 5.37500 5.50000 5.62500 5.75000 5.87500 + 6.00000 6.12500 6.25000 6.37500 6.50000 6.62500 6.75000 6.87500 + 7.00000 7.12500 7.25000 7.37500 7.50000 7.62500 7.75000 7.87500 + 8.00000 8.12500 8.25000 8.37500 8.50000 8.62500 8.75000 8.87500 + 9.00000 9.12500 9.25000 9.37500 9.50000 9.62500 9.75000 9.87500 + 10.00000 10.12500 10.25000 10.37500 10.50000 10.62500 10.75000 10.87500 + 11.00000 11.12500 11.25000 11.37500 11.50000 11.62500 11.75000 11.87500 + 12.00000 12.12500 12.25000 12.37500 12.50000 12.62500 12.75000 12.87500 + 13.00000 13.12500 13.25000 13.37500 13.50000 13.62500 13.75000 13.87500 + 14.00000 14.12500 14.25000 14.37500 14.50000 14.62500 14.75000 14.87500 + 15.00000 15.12500 15.25000 15.37500 15.50000 15.62500 15.75000 15.87500 + +.. _gcc-hgrids-nested-0125-as: + +0.125° x 0.15625° AS nested grid +-------------------------------- + +Domain: Asia + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.125x0.15625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [70.0, 140.0] + center_at_180: true + latitude: + range: [15.0, 55.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.125° x 0.15625° AS longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 70.00000 70.15625 70.31250 70.46875 70.62500 70.78125 70.93750 71.09375 + 71.25000 71.40625 71.56250 71.71875 71.87500 72.03125 72.18750 72.34375 + 72.50000 72.65625 72.81250 72.96875 73.12500 73.28125 73.43750 73.59375 + 73.75000 73.90625 74.06250 74.21875 74.37500 74.53125 74.68750 74.84375 + 75.00000 75.15625 75.31250 75.46875 75.62500 75.78125 75.93750 76.09375 + 76.25000 76.40625 76.56250 76.71875 76.87500 77.03125 77.18750 77.34375 + 77.50000 77.65625 77.81250 77.96875 78.12500 78.28125 78.43750 78.59375 + 78.75000 78.90625 79.06250 79.21875 79.37500 79.53125 79.68750 79.84375 + 80.00000 80.15625 80.31250 80.46875 80.62500 80.78125 80.93750 81.09375 + 81.25000 81.40625 81.56250 81.71875 81.87500 82.03125 82.18750 82.34375 + 82.50000 82.65625 82.81250 82.96875 83.12500 83.28125 83.43750 83.59375 + 83.75000 83.90625 84.06250 84.21875 84.37500 84.53125 84.68750 84.84375 + 85.00000 85.15625 85.31250 85.46875 85.62500 85.78125 85.93750 86.09375 + 86.25000 86.40625 86.56250 86.71875 86.87500 87.03125 87.18750 87.34375 + 87.50000 87.65625 87.81250 87.96875 88.12500 88.28125 88.43750 88.59375 + 88.75000 88.90625 89.06250 89.21875 89.37500 89.53125 89.68750 89.84375 + 90.00000 90.15625 90.31250 90.46875 90.62500 90.78125 90.93750 91.09375 + 91.25000 91.40625 91.56250 91.71875 91.87500 92.03125 92.18750 92.34375 + 92.50000 92.65625 92.81250 92.96875 93.12500 93.28125 93.43750 93.59375 + 93.75000 93.90625 94.06250 94.21875 94.37500 94.53125 94.68750 94.84375 + 95.00000 95.15625 95.31250 95.46875 95.62500 95.78125 95.93750 96.09375 + 96.25000 96.40625 96.56250 96.71875 96.87500 97.03125 97.18750 97.34375 + 97.50000 97.65625 97.81250 97.96875 98.12500 98.28125 98.43750 98.59375 + 98.75000 98.90625 99.06250 99.21875 99.37500 99.53125 99.68750 99.84375 + 100.00000 100.15625 100.31250 100.46875 100.62500 100.78125 100.93750 101.09375 + 101.25000 101.40625 101.56250 101.71875 101.87500 102.03125 102.18750 102.34375 + 102.50000 102.65625 102.81250 102.96875 103.12500 103.28125 103.43750 103.59375 + 103.75000 103.90625 104.06250 104.21875 104.37500 104.53125 104.68750 104.84375 + 105.00000 105.15625 105.31250 105.46875 105.62500 105.78125 105.93750 106.09375 + 106.25000 106.40625 106.56250 106.71875 106.87500 107.03125 107.18750 107.34375 + 107.50000 107.65625 107.81250 107.96875 108.12500 108.28125 108.43750 108.59375 + 108.75000 108.90625 109.06250 109.21875 109.37500 109.53125 109.68750 109.84375 + 110.00000 110.15625 110.31250 110.46875 110.62500 110.78125 110.93750 111.09375 + 111.25000 111.40625 111.56250 111.71875 111.87500 112.03125 112.18750 112.34375 + 112.50000 112.65625 112.81250 112.96875 113.12500 113.28125 113.43750 113.59375 + 113.75000 113.90625 114.06250 114.21875 114.37500 114.53125 114.68750 114.84375 + 115.00000 115.15625 115.31250 115.46875 115.62500 115.78125 115.93750 116.09375 + 116.25000 116.40625 116.56250 116.71875 116.87500 117.03125 117.18750 117.34375 + 117.50000 117.65625 117.81250 117.96875 118.12500 118.28125 118.43750 118.59375 + 118.75000 118.90625 119.06250 119.21875 119.37500 119.53125 119.68750 119.84375 + 120.00000 120.15625 120.31250 120.46875 120.62500 120.78125 120.93750 121.09375 + 121.25000 121.40625 121.56250 121.71875 121.87500 122.03125 122.18750 122.34375 + 122.50000 122.65625 122.81250 122.96875 123.12500 123.28125 123.43750 123.59375 + 123.75000 123.90625 124.06250 124.21875 124.37500 124.53125 124.68750 124.84375 + 125.00000 125.15625 125.31250 125.46875 125.62500 125.78125 125.93750 126.09375 + 126.25000 126.40625 126.56250 126.71875 126.87500 127.03125 127.18750 127.34375 + 127.50000 127.65625 127.81250 127.96875 128.12500 128.28125 128.43750 128.59375 + 128.75000 128.90625 129.06250 129.21875 129.37500 129.53125 129.68750 129.84375 + 130.00000 130.15625 130.31250 130.46875 130.62500 130.78125 130.93750 131.09375 + 131.25000 131.40625 131.56250 131.71875 131.87500 132.03125 132.18750 132.34375 + 132.50000 132.65625 132.81250 132.96875 133.12500 133.28125 133.43750 133.59375 + 133.75000 133.90625 134.06250 134.21875 134.37500 134.53125 134.68750 134.84375 + 135.00000 135.15625 135.31250 135.46875 135.62500 135.78125 135.93750 136.09375 + 136.25000 136.40625 136.56250 136.71875 136.87500 137.03125 137.18750 137.34375 + 137.50000 137.65625 137.81250 137.96875 138.12500 138.28125 138.43750 138.59375 + 138.75000 138.90625 139.06250 139.21875 139.37500 139.53125 139.68750 139.84375 + 140.00000 + +0.125° x 0.15625° AS latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 15.00000 15.12500 15.25000 15.37500 15.50000 15.62500 15.75000 15.87500 + 16.00000 16.12500 16.25000 16.37500 16.50000 16.62500 16.75000 16.87500 + 17.00000 17.12500 17.25000 17.37500 17.50000 17.62500 17.75000 17.87500 + 18.00000 18.12500 18.25000 18.37500 18.50000 18.62500 18.75000 18.87500 + 19.00000 19.12500 19.25000 19.37500 19.50000 19.62500 19.75000 19.87500 + 20.00000 20.12500 20.25000 20.37500 20.50000 20.62500 20.75000 20.87500 + 21.00000 21.12500 21.25000 21.37500 21.50000 21.62500 21.75000 21.87500 + 22.00000 22.12500 22.25000 22.37500 22.50000 22.62500 22.75000 22.87500 + 23.00000 23.12500 23.25000 23.37500 23.50000 23.62500 23.75000 23.87500 + 24.00000 24.12500 24.25000 24.37500 24.50000 24.62500 24.75000 24.87500 + 25.00000 25.12500 25.25000 25.37500 25.50000 25.62500 25.75000 25.87500 + 26.00000 26.12500 26.25000 26.37500 26.50000 26.62500 26.75000 26.87500 + 27.00000 27.12500 27.25000 27.37500 27.50000 27.62500 27.75000 27.87500 + 28.00000 28.12500 28.25000 28.37500 28.50000 28.62500 28.75000 28.87500 + 29.00000 29.12500 29.25000 29.37500 29.50000 29.62500 29.75000 29.87500 + 30.00000 30.12500 30.25000 30.37500 30.50000 30.62500 30.75000 30.87500 + 31.00000 31.12500 31.25000 31.37500 31.50000 31.62500 31.75000 31.87500 + 32.00000 32.12500 32.25000 32.37500 32.50000 32.62500 32.75000 32.87500 + 33.00000 33.12500 33.25000 33.37500 33.50000 33.62500 33.75000 33.87500 + 34.00000 34.12500 34.25000 34.37500 34.50000 34.62500 34.75000 34.87500 + 35.00000 35.12500 35.25000 35.37500 35.50000 35.62500 35.75000 35.87500 + 36.00000 36.12500 36.25000 36.37500 36.50000 36.62500 36.75000 36.87500 + 37.00000 37.12500 37.25000 37.37500 37.50000 37.62500 37.75000 37.87500 + 38.00000 38.12500 38.25000 38.37500 38.50000 38.62500 38.75000 38.87500 + 39.00000 39.12500 39.25000 39.37500 39.50000 39.62500 39.75000 39.87500 + 40.00000 40.12500 40.25000 40.37500 40.50000 40.62500 40.75000 40.87500 + 41.00000 41.12500 41.25000 41.37500 41.50000 41.62500 41.75000 41.87500 + 42.00000 42.12500 42.25000 42.37500 42.50000 42.62500 42.75000 42.87500 + 43.00000 43.12500 43.25000 43.37500 43.50000 43.62500 43.75000 43.87500 + 44.00000 44.12500 44.25000 44.37500 44.50000 44.62500 44.75000 44.87500 + 45.00000 45.12500 45.25000 45.37500 45.50000 45.62500 45.75000 45.87500 + 46.00000 46.12500 46.25000 46.37500 46.50000 46.62500 46.75000 46.87500 + 47.00000 47.12500 47.25000 47.37500 47.50000 47.62500 47.75000 47.87500 + 48.00000 48.12500 48.25000 48.37500 48.50000 48.62500 48.75000 48.87500 + 49.00000 49.12500 49.25000 49.37500 49.50000 49.62500 49.75000 49.87500 + 50.00000 50.12500 50.25000 50.37500 50.50000 50.62500 50.75000 50.87500 + 51.00000 51.12500 51.25000 51.37500 51.50000 51.62500 51.75000 51.87500 + 52.00000 52.12500 52.25000 52.37500 52.50000 52.62500 52.75000 52.87500 + 53.00000 53.12500 53.25000 53.37500 53.50000 53.62500 53.75000 53.87500 + 54.00000 54.12500 54.25000 54.37500 54.50000 54.62500 54.75000 54.87500 + 55.00000 + +.. _gcc-hgrids-nested-0125-eu: + +0.125° x 0.15625° EU nested grid +-------------------------------- + +Domain: Europe + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.125x0.15625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-15.0, 40.0 ] + center_at_180: true + latitude: + range: [9.75, 60.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.125° x 0.15625° EU longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -15.00000 -14.84375 -14.68750 -14.53125 -14.37500 -14.21875 -14.06250 -13.90625 + -13.75000 -13.59375 -13.43750 -13.28125 -13.12500 -12.96875 -12.81250 -12.65625 + -12.50000 -12.34375 -12.18750 -12.03125 -11.87500 -11.71875 -11.56250 -11.40625 + -11.25000 -11.09375 -10.93750 -10.78125 -10.62500 -10.46875 -10.31250 -10.15625 + -10.00000 -9.84375 -9.68750 -9.53125 -9.37500 -9.21875 -9.06250 -8.90625 + -8.75000 -8.59375 -8.43750 -8.28125 -8.12500 -7.96875 -7.81250 -7.65625 + -7.50000 -7.34375 -7.18750 -7.03125 -6.87500 -6.71875 -6.56250 -6.40625 + -6.25000 -6.09375 -5.93750 -5.78125 -5.62500 -5.46875 -5.31250 -5.15625 + -5.00000 -4.84375 -4.68750 -4.53125 -4.37500 -4.21875 -4.06250 -3.90625 + -3.75000 -3.59375 -3.43750 -3.28125 -3.12500 -2.96875 -2.81250 -2.65625 + -2.50000 -2.34375 -2.18750 -2.03125 -1.87500 -1.71875 -1.56250 -1.40625 + -1.25000 -1.09375 -0.93750 -0.78125 -0.62500 -0.46875 -0.31250 -0.15625 + 0.00000 0.15625 0.31250 0.46875 0.62500 0.78125 0.93750 1.09375 + 1.25000 1.40625 1.56250 1.71875 1.87500 2.03125 2.18750 2.34375 + 2.50000 2.65625 2.81250 2.96875 3.12500 3.28125 3.43750 3.59375 + 3.75000 3.90625 4.06250 4.21875 4.37500 4.53125 4.68750 4.84375 + 5.00000 5.15625 5.31250 5.46875 5.62500 5.78125 5.93750 6.09375 + 6.25000 6.40625 6.56250 6.71875 6.87500 7.03125 7.18750 7.34375 + 7.50000 7.65625 7.81250 7.96875 8.12500 8.28125 8.43750 8.59375 + 8.75000 8.90625 9.06250 9.21875 9.37500 9.53125 9.68750 9.84375 + 10.00000 10.15625 10.31250 10.46875 10.62500 10.78125 10.93750 11.09375 + 11.25000 11.40625 11.56250 11.71875 11.87500 12.03125 12.18750 12.34375 + 12.50000 12.65625 12.81250 12.96875 13.12500 13.28125 13.43750 13.59375 + 13.75000 13.90625 14.06250 14.21875 14.37500 14.53125 14.68750 14.84375 + 15.00000 15.15625 15.31250 15.46875 15.62500 15.78125 15.93750 16.09375 + 16.25000 16.40625 16.56250 16.71875 16.87500 17.03125 17.18750 17.34375 + 17.50000 17.65625 17.81250 17.96875 18.12500 18.28125 18.43750 18.59375 + 18.75000 18.90625 19.06250 19.21875 19.37500 19.53125 19.68750 19.84375 + 20.00000 20.15625 20.31250 20.46875 20.62500 20.78125 20.93750 21.09375 + 21.25000 21.40625 21.56250 21.71875 21.87500 22.03125 22.18750 22.34375 + 22.50000 22.65625 22.81250 22.96875 23.12500 23.28125 23.43750 23.59375 + 23.75000 23.90625 24.06250 24.21875 24.37500 24.53125 24.68750 24.84375 + 25.00000 25.15625 25.31250 25.46875 25.62500 25.78125 25.93750 26.09375 + 26.25000 26.40625 26.56250 26.71875 26.87500 27.03125 27.18750 27.34375 + 27.50000 27.65625 27.81250 27.96875 28.12500 28.28125 28.43750 28.59375 + 28.75000 28.90625 29.06250 29.21875 29.37500 29.53125 29.68750 29.84375 + 30.00000 30.15625 30.31250 30.46875 30.62500 30.78125 30.93750 31.09375 + 31.25000 31.40625 31.56250 31.71875 31.87500 32.03125 32.18750 32.34375 + 32.50000 32.65625 32.81250 32.96875 33.12500 33.28125 33.43750 33.59375 + 33.75000 33.90625 34.06250 34.21875 34.37500 34.53125 34.68750 34.84375 + 35.00000 35.15625 35.31250 35.46875 35.62500 35.78125 35.93750 36.09375 + 36.25000 36.40625 36.56250 36.71875 36.87500 37.03125 37.18750 37.34375 + 37.50000 37.65625 37.81250 37.96875 38.12500 38.28125 38.43750 38.59375 + 38.75000 38.90625 39.06250 39.21875 39.37500 39.53125 39.68750 39.84375 + 40.00000 + +0.125° x 0.15625° EU latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 32.75000 32.87500 33.00000 33.12500 33.25000 33.37500 33.50000 33.62500 + 33.75000 33.87500 34.00000 34.12500 34.25000 34.37500 34.50000 34.62500 + 34.75000 34.87500 35.00000 35.12500 35.25000 35.37500 35.50000 35.62500 + 35.75000 35.87500 36.00000 36.12500 36.25000 36.37500 36.50000 36.62500 + 36.75000 36.87500 37.00000 37.12500 37.25000 37.37500 37.50000 37.62500 + 37.75000 37.87500 38.00000 38.12500 38.25000 38.37500 38.50000 38.62500 + 38.75000 38.87500 39.00000 39.12500 39.25000 39.37500 39.50000 39.62500 + 39.75000 39.87500 40.00000 40.12500 40.25000 40.37500 40.50000 40.62500 + 40.75000 40.87500 41.00000 41.12500 41.25000 41.37500 41.50000 41.62500 + 41.75000 41.87500 42.00000 42.12500 42.25000 42.37500 42.50000 42.62500 + 42.75000 42.87500 43.00000 43.12500 43.25000 43.37500 43.50000 43.62500 + 43.75000 43.87500 44.00000 44.12500 44.25000 44.37500 44.50000 44.62500 + 44.75000 44.87500 45.00000 45.12500 45.25000 45.37500 45.50000 45.62500 + 45.75000 45.87500 46.00000 46.12500 46.25000 46.37500 46.50000 46.62500 + 46.75000 46.87500 47.00000 47.12500 47.25000 47.37500 47.50000 47.62500 + 47.75000 47.87500 48.00000 48.12500 48.25000 48.37500 48.50000 48.62500 + 48.75000 48.87500 49.00000 49.12500 49.25000 49.37500 49.50000 49.62500 + 49.75000 49.87500 50.00000 50.12500 50.25000 50.37500 50.50000 50.62500 + 50.75000 50.87500 51.00000 51.12500 51.25000 51.37500 51.50000 51.62500 + 51.75000 51.87500 52.00000 52.12500 52.25000 52.37500 52.50000 52.62500 + 52.75000 52.87500 53.00000 53.12500 53.25000 53.37500 53.50000 53.62500 + 53.75000 53.87500 54.00000 54.12500 54.25000 54.37500 54.50000 54.62500 + 54.75000 54.87500 55.00000 55.12500 55.25000 55.37500 55.50000 55.62500 + 55.75000 55.87500 56.00000 56.12500 56.25000 56.37500 56.50000 56.62500 + 56.75000 56.87500 57.00000 57.12500 57.25000 57.37500 57.50000 57.62500 + 57.75000 57.87500 58.00000 58.12500 58.25000 58.37500 58.50000 58.62500 + 58.75000 58.87500 59.00000 59.12500 59.25000 59.37500 59.50000 59.62500 + 59.75000 59.87500 60.00000 60.12500 60.25000 60.37500 60.50000 60.62500 + 60.75000 60.87500 61.00000 61.12500 61.25000 + +.. _gcc-hgrids-nested-0125-na: + +0.125° x 0.15625° NA nested grid +-------------------------------- + +Domain: North America + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.125x0.15625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-130.0, -60.0] + center_at_180: true + latitude: + range: [9.75, 60.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.125° x 0.15625° NA longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -130.00000 -129.84375 -129.68750 -129.53125 -129.37500 -129.21875 -129.06250 -128.90625 + -128.75000 -128.59375 -128.43750 -128.28125 -128.12500 -127.96875 -127.81250 -127.65625 + -127.50000 -127.34375 -127.18750 -127.03125 -126.87500 -126.71875 -126.56250 -126.40625 + -126.25000 -126.09375 -125.93750 -125.78125 -125.62500 -125.46875 -125.31250 -125.15625 + -125.00000 -124.84375 -124.68750 -124.53125 -124.37500 -124.21875 -124.06250 -123.90625 + -123.75000 -123.59375 -123.43750 -123.28125 -123.12500 -122.96875 -122.81250 -122.65625 + -122.50000 -122.34375 -122.18750 -122.03125 -121.87500 -121.71875 -121.56250 -121.40625 + -121.25000 -121.09375 -120.93750 -120.78125 -120.62500 -120.46875 -120.31250 -120.15625 + -120.00000 -119.84375 -119.68750 -119.53125 -119.37500 -119.21875 -119.06250 -118.90625 + -118.75000 -118.59375 -118.43750 -118.28125 -118.12500 -117.96875 -117.81250 -117.65625 + -117.50000 -117.34375 -117.18750 -117.03125 -116.87500 -116.71875 -116.56250 -116.40625 + -116.25000 -116.09375 -115.93750 -115.78125 -115.62500 -115.46875 -115.31250 -115.15625 + -115.00000 -114.84375 -114.68750 -114.53125 -114.37500 -114.21875 -114.06250 -113.90625 + -113.75000 -113.59375 -113.43750 -113.28125 -113.12500 -112.96875 -112.81250 -112.65625 + -112.50000 -112.34375 -112.18750 -112.03125 -111.87500 -111.71875 -111.56250 -111.40625 + -111.25000 -111.09375 -110.93750 -110.78125 -110.62500 -110.46875 -110.31250 -110.15625 + -110.00000 -109.84375 -109.68750 -109.53125 -109.37500 -109.21875 -109.06250 -108.90625 + -108.75000 -108.59375 -108.43750 -108.28125 -108.12500 -107.96875 -107.81250 -107.65625 + -107.50000 -107.34375 -107.18750 -107.03125 -106.87500 -106.71875 -106.56250 -106.40625 + -106.25000 -106.09375 -105.93750 -105.78125 -105.62500 -105.46875 -105.31250 -105.15625 + -105.00000 -104.84375 -104.68750 -104.53125 -104.37500 -104.21875 -104.06250 -103.90625 + -103.75000 -103.59375 -103.43750 -103.28125 -103.12500 -102.96875 -102.81250 -102.65625 + -102.50000 -102.34375 -102.18750 -102.03125 -101.87500 -101.71875 -101.56250 -101.40625 + -101.25000 -101.09375 -100.93750 -100.78125 -100.62500 -100.46875 -100.31250 -100.15625 + -100.00000 -99.84375 -99.68750 -99.53125 -99.37500 -99.21875 -99.06250 -98.90625 + -98.75000 -98.59375 -98.43750 -98.28125 -98.12500 -97.96875 -97.81250 -97.65625 + -97.50000 -97.34375 -97.18750 -97.03125 -96.87500 -96.71875 -96.56250 -96.40625 + -96.25000 -96.09375 -95.93750 -95.78125 -95.62500 -95.46875 -95.31250 -95.15625 + -95.00000 -94.84375 -94.68750 -94.53125 -94.37500 -94.21875 -94.06250 -93.90625 + -93.75000 -93.59375 -93.43750 -93.28125 -93.12500 -92.96875 -92.81250 -92.65625 + -92.50000 -92.34375 -92.18750 -92.03125 -91.87500 -91.71875 -91.56250 -91.40625 + -91.25000 -91.09375 -90.93750 -90.78125 -90.62500 -90.46875 -90.31250 -90.15625 + -90.00000 -89.84375 -89.68750 -89.53125 -89.37500 -89.21875 -89.06250 -88.90625 + -88.75000 -88.59375 -88.43750 -88.28125 -88.12500 -87.96875 -87.81250 -87.65625 + -87.50000 -87.34375 -87.18750 -87.03125 -86.87500 -86.71875 -86.56250 -86.40625 + -86.25000 -86.09375 -85.93750 -85.78125 -85.62500 -85.46875 -85.31250 -85.15625 + -85.00000 -84.84375 -84.68750 -84.53125 -84.37500 -84.21875 -84.06250 -83.90625 + -83.75000 -83.59375 -83.43750 -83.28125 -83.12500 -82.96875 -82.81250 -82.65625 + -82.50000 -82.34375 -82.18750 -82.03125 -81.87500 -81.71875 -81.56250 -81.40625 + -81.25000 -81.09375 -80.93750 -80.78125 -80.62500 -80.46875 -80.31250 -80.15625 + -80.00000 -79.84375 -79.68750 -79.53125 -79.37500 -79.21875 -79.06250 -78.90625 + -78.75000 -78.59375 -78.43750 -78.28125 -78.12500 -77.96875 -77.81250 -77.65625 + -77.50000 -77.34375 -77.18750 -77.03125 -76.87500 -76.71875 -76.56250 -76.40625 + -76.25000 -76.09375 -75.93750 -75.78125 -75.62500 -75.46875 -75.31250 -75.15625 + -75.00000 -74.84375 -74.68750 -74.53125 -74.37500 -74.21875 -74.06250 -73.90625 + -73.75000 -73.59375 -73.43750 -73.28125 -73.12500 -72.96875 -72.81250 -72.65625 + -72.50000 -72.34375 -72.18750 -72.03125 -71.87500 -71.71875 -71.56250 -71.40625 + -71.25000 -71.09375 -70.93750 -70.78125 -70.62500 -70.46875 -70.31250 -70.15625 + -70.00000 -69.84375 -69.68750 -69.53125 -69.37500 -69.21875 -69.06250 -68.90625 + -68.75000 -68.59375 -68.43750 -68.28125 -68.12500 -67.96875 -67.81250 -67.65625 + -67.50000 -67.34375 -67.18750 -67.03125 -66.87500 -66.71875 -66.56250 -66.40625 + -66.25000 -66.09375 -65.93750 -65.78125 -65.62500 -65.46875 -65.31250 -65.15625 + -65.00000 -64.84375 -64.68750 -64.53125 -64.37500 -64.21875 -64.06250 -63.90625 + -63.75000 -63.59375 -63.43750 -63.28125 -63.12500 -62.96875 -62.81250 -62.65625 + -62.50000 -62.34375 -62.18750 -62.03125 -61.87500 -61.71875 -61.56250 -61.40625 + -61.25000 -61.09375 -60.93750 -60.78125 -60.62500 -60.46875 -60.31250 -60.15625 + -60.00000 + +0.125° x 0.15625° NA latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 9.75000 9.87500 10.00000 10.12500 10.25000 10.37500 10.50000 10.62500 + 10.75000 10.87500 11.00000 11.12500 11.25000 11.37500 11.50000 11.62500 + 11.75000 11.87500 12.00000 12.12500 12.25000 12.37500 12.50000 12.62500 + 12.75000 12.87500 13.00000 13.12500 13.25000 13.37500 13.50000 13.62500 + 13.75000 13.87500 14.00000 14.12500 14.25000 14.37500 14.50000 14.62500 + 14.75000 14.87500 15.00000 15.12500 15.25000 15.37500 15.50000 15.62500 + 15.75000 15.87500 16.00000 16.12500 16.25000 16.37500 16.50000 16.62500 + 16.75000 16.87500 17.00000 17.12500 17.25000 17.37500 17.50000 17.62500 + 17.75000 17.87500 18.00000 18.12500 18.25000 18.37500 18.50000 18.62500 + 18.75000 18.87500 19.00000 19.12500 19.25000 19.37500 19.50000 19.62500 + 19.75000 19.87500 20.00000 20.12500 20.25000 20.37500 20.50000 20.62500 + 20.75000 20.87500 21.00000 21.12500 21.25000 21.37500 21.50000 21.62500 + 21.75000 21.87500 22.00000 22.12500 22.25000 22.37500 22.50000 22.62500 + 22.75000 22.87500 23.00000 23.12500 23.25000 23.37500 23.50000 23.62500 + 23.75000 23.87500 24.00000 24.12500 24.25000 24.37500 24.50000 24.62500 + 24.75000 24.87500 25.00000 25.12500 25.25000 25.37500 25.50000 25.62500 + 25.75000 25.87500 26.00000 26.12500 26.25000 26.37500 26.50000 26.62500 + 26.75000 26.87500 27.00000 27.12500 27.25000 27.37500 27.50000 27.62500 + 27.75000 27.87500 28.00000 28.12500 28.25000 28.37500 28.50000 28.62500 + 28.75000 28.87500 29.00000 29.12500 29.25000 29.37500 29.50000 29.62500 + 29.75000 29.87500 30.00000 30.12500 30.25000 30.37500 30.50000 30.62500 + 30.75000 30.87500 31.00000 31.12500 31.25000 31.37500 31.50000 31.62500 + 31.75000 31.87500 32.00000 32.12500 32.25000 32.37500 32.50000 32.62500 + 32.75000 32.87500 33.00000 33.12500 33.25000 33.37500 33.50000 33.62500 + 33.75000 33.87500 34.00000 34.12500 34.25000 34.37500 34.50000 34.62500 + 34.75000 34.87500 35.00000 35.12500 35.25000 35.37500 35.50000 35.62500 + 35.75000 35.87500 36.00000 36.12500 36.25000 36.37500 36.50000 36.62500 + 36.75000 36.87500 37.00000 37.12500 37.25000 37.37500 37.50000 37.62500 + 37.75000 37.87500 38.00000 38.12500 38.25000 38.37500 38.50000 38.62500 + 38.75000 38.87500 39.00000 39.12500 39.25000 39.37500 39.50000 39.62500 + 39.75000 39.87500 40.00000 40.12500 40.25000 40.37500 40.50000 40.62500 + 40.75000 40.87500 41.00000 41.12500 41.25000 41.37500 41.50000 41.62500 + 41.75000 41.87500 42.00000 42.12500 42.25000 42.37500 42.50000 42.62500 + 42.75000 42.87500 43.00000 43.12500 43.25000 43.37500 43.50000 43.62500 + 43.75000 43.87500 44.00000 44.12500 44.25000 44.37500 44.50000 44.62500 + 44.75000 44.87500 45.00000 45.12500 45.25000 45.37500 45.50000 45.62500 + 45.75000 45.87500 46.00000 46.12500 46.25000 46.37500 46.50000 46.62500 + 46.75000 46.87500 47.00000 47.12500 47.25000 47.37500 47.50000 47.62500 + 47.75000 47.87500 48.00000 48.12500 48.25000 48.37500 48.50000 48.62500 + 48.75000 48.87500 49.00000 49.12500 49.25000 49.37500 49.50000 49.62500 + 49.75000 49.87500 50.00000 50.12500 50.25000 50.37500 50.50000 50.62500 + 50.75000 50.87500 51.00000 51.12500 51.25000 51.37500 51.50000 51.62500 + 51.75000 51.87500 52.00000 52.12500 52.25000 52.37500 52.50000 52.62500 + 52.75000 52.87500 53.00000 53.12500 53.25000 53.37500 53.50000 53.62500 + 53.75000 53.87500 54.00000 54.12500 54.25000 54.37500 54.50000 54.62500 + 54.75000 54.87500 55.00000 55.12500 55.25000 55.37500 55.50000 55.62500 + 55.75000 55.87500 56.00000 56.12500 56.25000 56.37500 56.50000 56.62500 + 56.75000 56.87500 57.00000 57.12500 57.25000 57.37500 57.50000 57.62500 + 57.75000 57.87500 58.00000 58.12500 58.25000 58.37500 58.50000 58.62500 + 58.75000 58.87500 59.00000 59.12500 59.25000 59.37500 59.50000 59.62500 + 59.75000 59.87500 60.00000 + +.. _gcc-hgrids-nested-0125-sa: + +0.125° x 0.15625° SA nested grid +-------------------------------- + +Domain: South America + +Select this grid by specifying these settings in :ref:`cfg-gc-yml`: + +.. code-block:: yaml + + simulation: + ... + met_field: GEOSFP + ... + grid: + resolution: 0.125x0.15625 + number_of_levels: 72 # or 47 for reduced vertical grid + longitude: + range: [-87.8125, -31.25] + center_at_180: true + latitude: + range: [-59.0, 16.0] + half_size_polar_boxes: true + nested_grid_simulation: + activate: true + buffer_zone_NSEW: [3, 3, 3, 3] # or [6, 6, 6, 6] if you encounter + # non-convergence errors in chemistry + +0.125° x 0.15625° SA longitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -87.81250 -87.65625 -87.50000 -87.34375 -87.18750 -87.03125 -86.87500 -86.71875 + -86.56250 -86.40625 -86.25000 -86.09375 -85.93750 -85.78125 -85.62500 -85.46875 + -85.31250 -85.15625 -85.00000 -84.84375 -84.68750 -84.53125 -84.37500 -84.21875 + -84.06250 -83.90625 -83.75000 -83.59375 -83.43750 -83.28125 -83.12500 -82.96875 + -82.81250 -82.65625 -82.50000 -82.34375 -82.18750 -82.03125 -81.87500 -81.71875 + -81.56250 -81.40625 -81.25000 -81.09375 -80.93750 -80.78125 -80.62500 -80.46875 + -80.31250 -80.15625 -80.00000 -79.84375 -79.68750 -79.53125 -79.37500 -79.21875 + -79.06250 -78.90625 -78.75000 -78.59375 -78.43750 -78.28125 -78.12500 -77.96875 + -77.81250 -77.65625 -77.50000 -77.34375 -77.18750 -77.03125 -76.87500 -76.71875 + -76.56250 -76.40625 -76.25000 -76.09375 -75.93750 -75.78125 -75.62500 -75.46875 + -75.31250 -75.15625 -75.00000 -74.84375 -74.68750 -74.53125 -74.37500 -74.21875 + -74.06250 -73.90625 -73.75000 -73.59375 -73.43750 -73.28125 -73.12500 -72.96875 + -72.81250 -72.65625 -72.50000 -72.34375 -72.18750 -72.03125 -71.87500 -71.71875 + -71.56250 -71.40625 -71.25000 -71.09375 -70.93750 -70.78125 -70.62500 -70.46875 + -70.31250 -70.15625 -70.00000 -69.84375 -69.68750 -69.53125 -69.37500 -69.21875 + -69.06250 -68.90625 -68.75000 -68.59375 -68.43750 -68.28125 -68.12500 -67.96875 + -67.81250 -67.65625 -67.50000 -67.34375 -67.18750 -67.03125 -66.87500 -66.71875 + -66.56250 -66.40625 -66.25000 -66.09375 -65.93750 -65.78125 -65.62500 -65.46875 + -65.31250 -65.15625 -65.00000 -64.84375 -64.68750 -64.53125 -64.37500 -64.21875 + -64.06250 -63.90625 -63.75000 -63.59375 -63.43750 -63.28125 -63.12500 -62.96875 + -62.81250 -62.65625 -62.50000 -62.34375 -62.18750 -62.03125 -61.87500 -61.71875 + -61.56250 -61.40625 -61.25000 -61.09375 -60.93750 -60.78125 -60.62500 -60.46875 + -60.31250 -60.15625 -60.00000 -59.84375 -59.68750 -59.53125 -59.37500 -59.21875 + -59.06250 -58.90625 -58.75000 -58.59375 -58.43750 -58.28125 -58.12500 -57.96875 + -57.81250 -57.65625 -57.50000 -57.34375 -57.18750 -57.03125 -56.87500 -56.71875 + -56.56250 -56.40625 -56.25000 -56.09375 -55.93750 -55.78125 -55.62500 -55.46875 + -55.31250 -55.15625 -55.00000 -54.84375 -54.68750 -54.53125 -54.37500 -54.21875 + -54.06250 -53.90625 -53.75000 -53.59375 -53.43750 -53.28125 -53.12500 -52.96875 + -52.81250 -52.65625 -52.50000 -52.34375 -52.18750 -52.03125 -51.87500 -51.71875 + -51.56250 -51.40625 -51.25000 -51.09375 -50.93750 -50.78125 -50.62500 -50.46875 + -50.31250 -50.15625 -50.00000 -49.84375 -49.68750 -49.53125 -49.37500 -49.21875 + -49.06250 -48.90625 -48.75000 -48.59375 -48.43750 -48.28125 -48.12500 -47.96875 + -47.81250 -47.65625 -47.50000 -47.34375 -47.18750 -47.03125 -46.87500 -46.71875 + -46.56250 -46.40625 -46.25000 -46.09375 -45.93750 -45.78125 -45.62500 -45.46875 + -45.31250 -45.15625 -45.00000 -44.84375 -44.68750 -44.53125 -44.37500 -44.21875 + -44.06250 -43.90625 -43.75000 -43.59375 -43.43750 -43.28125 -43.12500 -42.96875 + -42.81250 -42.65625 -42.50000 -42.34375 -42.18750 -42.03125 -41.87500 -41.71875 + -41.56250 -41.40625 -41.25000 -41.09375 -40.93750 -40.78125 -40.62500 -40.46875 + -40.31250 -40.15625 -40.00000 -39.84375 -39.68750 -39.53125 -39.37500 -39.21875 + -39.06250 -38.90625 -38.75000 -38.59375 -38.43750 -38.28125 -38.12500 -37.96875 + -37.81250 -37.65625 -37.50000 -37.34375 -37.18750 -37.03125 -36.87500 -36.71875 + -36.56250 -36.40625 -36.25000 -36.09375 -35.93750 -35.78125 -35.62500 -35.46875 + -35.31250 -35.15625 -35.00000 -34.84375 -34.68750 -34.53125 -34.37500 -34.21875 + -34.06250 -33.90625 -33.75000 -33.59375 -33.43750 -33.28125 -33.12500 -32.96875 + -32.81250 -32.65625 -32.50000 -32.34375 -32.18750 -32.03125 -31.87500 -31.71875 + -31.56250 -31.40625 -31.25000 + + +0.125° x 0.15625° SA latitudes +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + -59.00000 -58.87500 -58.75000 -58.62500 -58.50000 -58.37500 -58.25000 -58.12500 + -58.00000 -57.87500 -57.75000 -57.62500 -57.50000 -57.37500 -57.25000 -57.12500 + -57.00000 -56.87500 -56.75000 -56.62500 -56.50000 -56.37500 -56.25000 -56.12500 + -56.00000 -55.87500 -55.75000 -55.62500 -55.50000 -55.37500 -55.25000 -55.12500 + -55.00000 -54.87500 -54.75000 -54.62500 -54.50000 -54.37500 -54.25000 -54.12500 + -54.00000 -53.87500 -53.75000 -53.62500 -53.50000 -53.37500 -53.25000 -53.12500 + -53.00000 -52.87500 -52.75000 -52.62500 -52.50000 -52.37500 -52.25000 -52.12500 + -52.00000 -51.87500 -51.75000 -51.62500 -51.50000 -51.37500 -51.25000 -51.12500 + -51.00000 -50.87500 -50.75000 -50.62500 -50.50000 -50.37500 -50.25000 -50.12500 + -50.00000 -49.87500 -49.75000 -49.62500 -49.50000 -49.37500 -49.25000 -49.12500 + -49.00000 -48.87500 -48.75000 -48.62500 -48.50000 -48.37500 -48.25000 -48.12500 + -48.00000 -47.87500 -47.75000 -47.62500 -47.50000 -47.37500 -47.25000 -47.12500 + -47.00000 -46.87500 -46.75000 -46.62500 -46.50000 -46.37500 -46.25000 -46.12500 + -46.00000 -45.87500 -45.75000 -45.62500 -45.50000 -45.37500 -45.25000 -45.12500 + -45.00000 -44.87500 -44.75000 -44.62500 -44.50000 -44.37500 -44.25000 -44.12500 + -44.00000 -43.87500 -43.75000 -43.62500 -43.50000 -43.37500 -43.25000 -43.12500 + -43.00000 -42.87500 -42.75000 -42.62500 -42.50000 -42.37500 -42.25000 -42.12500 + -42.00000 -41.87500 -41.75000 -41.62500 -41.50000 -41.37500 -41.25000 -41.12500 + -41.00000 -40.87500 -40.75000 -40.62500 -40.50000 -40.37500 -40.25000 -40.12500 + -40.00000 -39.87500 -39.75000 -39.62500 -39.50000 -39.37500 -39.25000 -39.12500 + -39.00000 -38.87500 -38.75000 -38.62500 -38.50000 -38.37500 -38.25000 -38.12500 + -38.00000 -37.87500 -37.75000 -37.62500 -37.50000 -37.37500 -37.25000 -37.12500 + -37.00000 -36.87500 -36.75000 -36.62500 -36.50000 -36.37500 -36.25000 -36.12500 + -36.00000 -35.87500 -35.75000 -35.62500 -35.50000 -35.37500 -35.25000 -35.12500 + -35.00000 -34.87500 -34.75000 -34.62500 -34.50000 -34.37500 -34.25000 -34.12500 + -34.00000 -33.87500 -33.75000 -33.62500 -33.50000 -33.37500 -33.25000 -33.12500 + -33.00000 -32.87500 -32.75000 -32.62500 -32.50000 -32.37500 -32.25000 -32.12500 + -32.00000 -31.87500 -31.75000 -31.62500 -31.50000 -31.37500 -31.25000 -31.12500 + -31.00000 -30.87500 -30.75000 -30.62500 -30.50000 -30.37500 -30.25000 -30.12500 + -30.00000 -29.87500 -29.75000 -29.62500 -29.50000 -29.37500 -29.25000 -29.12500 + -29.00000 -28.87500 -28.75000 -28.62500 -28.50000 -28.37500 -28.25000 -28.12500 + -28.00000 -27.87500 -27.75000 -27.62500 -27.50000 -27.37500 -27.25000 -27.12500 + -27.00000 -26.87500 -26.75000 -26.62500 -26.50000 -26.37500 -26.25000 -26.12500 + -26.00000 -25.87500 -25.75000 -25.62500 -25.50000 -25.37500 -25.25000 -25.12500 + -25.00000 -24.87500 -24.75000 -24.62500 -24.50000 -24.37500 -24.25000 -24.12500 + -24.00000 -23.87500 -23.75000 -23.62500 -23.50000 -23.37500 -23.25000 -23.12500 + -23.00000 -22.87500 -22.75000 -22.62500 -22.50000 -22.37500 -22.25000 -22.12500 + -22.00000 -21.87500 -21.75000 -21.62500 -21.50000 -21.37500 -21.25000 -21.12500 + -21.00000 -20.87500 -20.75000 -20.62500 -20.50000 -20.37500 -20.25000 -20.12500 + -20.00000 -19.87500 -19.75000 -19.62500 -19.50000 -19.37500 -19.25000 -19.12500 + -19.00000 -18.87500 -18.75000 -18.62500 -18.50000 -18.37500 -18.25000 -18.12500 + -18.00000 -17.87500 -17.75000 -17.62500 -17.50000 -17.37500 -17.25000 -17.12500 + -17.00000 -16.87500 -16.75000 -16.62500 -16.50000 -16.37500 -16.25000 -16.12500 + -16.00000 -15.87500 -15.75000 -15.62500 -15.50000 -15.37500 -15.25000 -15.12500 + -15.00000 -14.87500 -14.75000 -14.62500 -14.50000 -14.37500 -14.25000 -14.12500 + -14.00000 -13.87500 -13.75000 -13.62500 -13.50000 -13.37500 -13.25000 -13.12500 + -13.00000 -12.87500 -12.75000 -12.62500 -12.50000 -12.37500 -12.25000 -12.12500 + -12.00000 -11.87500 -11.75000 -11.62500 -11.50000 -11.37500 -11.25000 -11.12500 + -11.00000 -10.87500 -10.75000 -10.62500 -10.50000 -10.37500 -10.25000 -10.12500 + -10.00000 -9.87500 -9.75000 -9.62500 -9.50000 -9.37500 -9.25000 -9.12500 + -9.00000 -8.87500 -8.75000 -8.62500 -8.50000 -8.37500 -8.25000 -8.12500 + -8.00000 -7.87500 -7.75000 -7.62500 -7.50000 -7.37500 -7.25000 -7.12500 + -7.00000 -6.87500 -6.75000 -6.62500 -6.50000 -6.37500 -6.25000 -6.12500 + -6.00000 -5.87500 -5.75000 -5.62500 -5.50000 -5.37500 -5.25000 -5.12500 + -5.00000 -4.87500 -4.75000 -4.62500 -4.50000 -4.37500 -4.25000 -4.12500 + -4.00000 -3.87500 -3.75000 -3.62500 -3.50000 -3.37500 -3.25000 -3.12500 + -3.00000 -2.87500 -2.75000 -2.62500 -2.50000 -2.37500 -2.25000 -2.12500 + -2.00000 -1.87500 -1.75000 -1.62500 -1.50000 -1.37500 -1.25000 -1.12500 + -1.00000 -0.87500 -0.75000 -0.62500 -0.50000 -0.37500 -0.25000 -0.12500 + 0.00000 0.12500 0.25000 0.37500 0.50000 0.62500 0.75000 0.87500 + 1.00000 1.12500 1.25000 1.37500 1.50000 1.62500 1.75000 1.87500 + 2.00000 2.12500 2.25000 2.37500 2.50000 2.62500 2.75000 2.87500 + 3.00000 3.12500 3.25000 3.37500 3.50000 3.62500 3.75000 3.87500 + 4.00000 4.12500 4.25000 4.37500 4.50000 4.62500 4.75000 4.87500 + 5.00000 5.12500 5.25000 5.37500 5.50000 5.62500 5.75000 5.87500 + 6.00000 6.12500 6.25000 6.37500 6.50000 6.62500 6.75000 6.87500 + 7.00000 7.12500 7.25000 7.37500 7.50000 7.62500 7.75000 7.87500 + 8.00000 8.12500 8.25000 8.37500 8.50000 8.62500 8.75000 8.87500 + 9.00000 9.12500 9.25000 9.37500 9.50000 9.62500 9.75000 9.87500 + 10.00000 10.12500 10.25000 10.37500 10.50000 10.62500 10.75000 10.87500 + 11.00000 11.12500 11.25000 11.37500 11.50000 11.62500 11.75000 11.87500 + 12.00000 12.12500 12.25000 12.37500 12.50000 12.62500 12.75000 12.87500 + 13.00000 13.12500 13.25000 13.37500 13.50000 13.62500 13.75000 13.87500 + 14.00000 14.12500 14.25000 14.37500 14.50000 14.62500 14.75000 14.87500 + 15.00000 15.12500 15.25000 15.37500 15.50000 15.62500 15.75000 15.87500 + 16.00000 diff --git a/docs/source/supplemental-guides/nested-grid-guide.rst b/docs/source/supplemental-guides/nested-grid-guide.rst index b8524ce7f..dc72b8571 100644 --- a/docs/source/supplemental-guides/nested-grid-guide.rst +++ b/docs/source/supplemental-guides/nested-grid-guide.rst @@ -9,10 +9,11 @@ Run nested-grid simulations ########################### A **nested-grid simulation** is a GEOS-Chem Classic simulation running -at the native horizontal resolution of the GEOS-FP (0.25° x 0.3125°) -or MERRA-2 (0.5° x 0.6125°) meteorology fields over a subset of +at the native horizontal resolution of the :option:`GEOS-FP` (0.25° x +0.3125° or 0.125° x 0.15625°), :option:`GEOS-IT` (0.5° x 0.625°), or +:option:`MERRA2` (0.5° x 0.625°) meteorology fields over a subset of the globe. Nested-grid simulations use boundary conditions for -transport that are archived from a global simulatoin. +transport that are archived from a global simulation. Follow these steps to set up a GEOS-Chem Classic nested-grid simulation: @@ -241,18 +242,24 @@ How can I find which data are available for nested grid simulations? You can browse the contents of the GEOS-Chem data portals by pointing your browser to one of the following links: -- :ref:`GEOS-Chem Input Data ` - - - https://geos-chem.s3.amazonaws.com/index.html - -- :ref:`GEOS-Chem Nested Input Data ` - - - https://gcgrid.s3.amazonaws.com/index.html - -- :ref:`GCAP 2.0 meteorology @ U. Rochester ` - - - http://atmos.earth.rochester.edu/input/gc/ExtData/ - +.. list-table:: + :header-rows: 1 + + * - Portal + - Link + * - :ref:`GEOS-Chem Input Data ` + - https://geos-chem.s3.amazonaws.com/index.html + * - :ref:`GEOS-Chem Nested Input Data ` + - https://gcgrid.s3.amazonaws.com/index.html + * - :ref:`GCAP 2.0 meteorology @ U. Rochester ` + - http://atmos.earth.rochester.edu/input/gc/ExtData/ + +As of October 2025, the GEOS-Chem Nested Input Data portal stores +:option:`GEOS-FP`, :option:`GEOS-IT`, and :option:`MERRA2` meteorology +fields that have been cropped to one of the +:ref:`traditional nested-grid domains `. These +data have since been removed from the main GEOS-Chem Input Data portal. + .. _nestgrid-faq-errors: Where can I find out more info about nested grid errors? diff --git a/docs/source/supplemental-guides/run-gcc-on-aws-ec2.rst b/docs/source/supplemental-guides/run-gcc-on-aws-ec2.rst new file mode 100644 index 000000000..2bf47e772 --- /dev/null +++ b/docs/source/supplemental-guides/run-gcc-on-aws-ec2.rst @@ -0,0 +1,74 @@ +.. _run-gcc-on-aws-ec2: + +Run GC Classic on AWS EC2 +========================== + +GC Classic is an OpenMP application, meaning it runs on a single node. +Therefore, you do not need a complex cluster scheduler (like AWS ParallelCluster). +You can simply launch a single, powerful EC2 instance using our provided Amazon Machine Image (AMI). + +**Available AMIs:** + +========================= ==================== ============ =================== +AMI ID Name OS architecture +========================= ==================== ============ =================== +ami-096e8e151989dbfc5 GCC-12.3-GEOSChem alinux2023 x86_64 +========================= ==================== ============ =================== + +It contains a dedicated storage volume mounted at :literal:`/data` which contains the software environment for creating a GC Classic run directory and compiling the model. + +.. _launching_instance: + +1. Launch your EC2 Instance +---------------------------- + +1. Log in to the **AWS Console** and navigate to **EC2**. + +2. Click **Launch Instance**. + +3. **Name**: Give your instance a name (e.g., "GCC14.7-Simulation"). + +4. **Application and OS Images (AMI)**: Search the AMI ID in Community AMIs. + +5. **Instance Type**: **Recommended**: :literal:`c5n.large` (2 vCPUs, 5.3 GiB RAM) + +6. **Key Pair**: Select your SSH key pair. (Create a new .pem key pair if you don't have one.) + +7. **Configure Security Group**: Ensure the security group allows SSH access (port 22) and any other required ports for your simulation (e.g., 80, 443). + +8. **Configure storage**: + • You will see two volumes listed automatically (inherited from the AMI): + + a. **Root volume (30 GB)**: The operating system. Do not save simulation data here. + + b. **EBS volume (100 GB minimum)**: Mounted at :literal:`/data`. Use this directory for everything. + + • **Tip**: You should increase the size of the second volume (the :literal:`/data` volume) as you demand for your simulation. + +9. **Launch the instance**. You should see your instance in the EC2 console with a status of "running". + +.. _connecting_and_setup: + +2. Connect and Storage Setup +-------------------------------- + +SSH into your instance: + +.. code-block:: console + + $ ssh -i your-key.pem ec2-user@ + +**Verify the Environment**. The spack environment named :literal:`gc-env` is configured to load automatically. You can verify the compiler is ready in the spack directory :literal:`/data/spack/opt/spack`: + +.. code-block:: console + + $ which gfortran + +3. Download Code and Data +--------------------------- + +Now you can download the GC Classic source code and data files to your instance's :literal:`/data` directory. You can follow :ref:`quick` to run GCClassic. + +.. warning:: + + **Do not use your home directory (~) for simulations**. The root disk is small (30 GB). Always work inside :literal:`/data`. diff --git a/docs/source/supplemental-guides/run-script-examples.rst b/docs/source/supplemental-guides/run-script-examples.rst index d7bc9283b..9c3ab53df 100644 --- a/docs/source/supplemental-guides/run-script-examples.rst +++ b/docs/source/supplemental-guides/run-script-examples.rst @@ -37,7 +37,7 @@ Save this code to a file named :file:`geoschem.run.slurm`: ### particularly if you are running at very fine resolution (e.g. nested-grid) ############################################################################### # Source the environment file that you created - source /path/to/gcclassic.gnu10.env + source /path/to/gcclassic.gnu12.env # Set the proper # of threads for OpenMP # SLURM_CPUS_PER_TASK ensures this matches the number you set with -c above @@ -55,15 +55,15 @@ Save this code to a file named :file:`geoschem.run.slurm`: .. important:: - If you forget to define :envvar:`OMP_NUM_THREADS` in your run - script, then :program:`GEOS-Chem Classic` will execute using one - core. This can cause your simulations to take much longer than is - necessary! + If you forget to define :ref:`env-files-envvars-parallel-threads` + in your run script, then :program:`GEOS-Chem Classic` will execute + using one core. This can cause your simulations to take much + longer than is necessary! Then make :file:`geoschem.run.slurm` executable: .. code-block:: console - + $ chmod 755 geoschem.run.slurm For more information about how Slurm is set up on your particular diff --git a/docs/source/supplemental-guides/vertical-grids.rst b/docs/source/supplemental-guides/vertical-grids.rst new file mode 100644 index 000000000..fa45ff8d3 --- /dev/null +++ b/docs/source/supplemental-guides/vertical-grids.rst @@ -0,0 +1,1657 @@ +.. _gcc-vgrids: + +################################ +GEOS-Chem Classic vertical grids +################################ + +On this page we provide information about the various vertical grids +used in GEOS-Chem Classic. + +.. _gcc-grids-hybrid: + +====================== +Hybrid grid definition +====================== + +A hybrid sigma-pressure grid (aka :math:`\eta` grid) uses a +terrain-following coordinate near the surface, which then transitions +to a purely fixed-pressure coordinate. + +The pressure at the bottom edge of grid box :math:`(I,J,L)` of a +hybrid grid may be defined as: + +.. math:: + + P_{edge}(I,J,L) = A_p(L) + B_p(L) \times P_{surface}(I,J) + +where + +- :math:`(I,J,L)` are the lon, lat, and level indices of the grid box; +- :math:`P_{surface}(I,J)` is the "true" surface pressure at lon,lat + location :math:`(I,J)`; +- :math:`A_p(L)` are constants in surface pressure units (Pa or hPa), defined at level edges; +- :math:`B_p(L)` are unitless constants, defined at level edges. + +The values of :math:`A_p(L)` and :math:`B_p(L)` specify the vertical +properties of the grid. In GEOS-Chem, you may find these values in +source code file :file:`GeosUtil/pressure_mod.F90`. + +The pressure at the vertical midpoint of grid box :math:`(I,J,L)` is +computed as the average of the pressures at successive vertical edges: + +.. math:: + + P_{midpoint}(I,J,L) = \frac{P_{edge}(I,J,L) + P_{edge}(I,J,L+1)}{2} + +An :math:`\eta` coordinate can be constructed from +:math:`P_{edge}(I,J,L)` and :math:`P_{midpoint}(I,J,L)` as follows: + +.. math:: + + \eta_{edge}(I,J,L) = \frac{P_{edge}(I,J,L) - P_{top}}{P_{surface}(I,J) - P_{top}} + +.. math:: + + \eta_{midpoint}(I,J,L) = \frac{P_{midpoint}(I,J,L) - P_{top}}{P_{surface}(I,J) - P_{top}} + +where :math:`P_{top}` is pressure at the top level of the vertical +grid. + + +Specifics for GMAO vertical grids +--------------------------------- + +The the :math:`P_{edge}(I,J,L)` and :math:`P_{midpoint}(I,J,L)` values +in GMAO meteorological products vary with the topography up to 170 +hPa. Skyward of 170 hPa, :math:`P_{edge}(I,J,L)` and +:math:`P_{midpoint}(I,J,L)` remain constant for all longitudes and +latitudes :math:`(I,J)`. GMAO meteorological products use a model top +of 0.01 hPa. + +.. _gcc-vgrids_gmao: + +=================================== +Vertical grids for GMAO meteorology +=================================== + +.. _gcc-vgrids-gmao-72: + +72-level vertical grid +---------------------- + +This grid is used by the `GEOS-FP +`_, +`GEOS-IT +`_, +and `MERRA-2 +`_ +meteorological field products from NASA GMAO. It has 72 vertical +levels and 73 edges. + +.. _gcc-vgrids-gmao-72-ind: + +Indexing +~~~~~~~~ + +.. list-table:: + :header-rows: 1 + + * - Instance + - Surface level + - Top-of-atm level + - Direction + * - GEOS-Chem Classic using GMAO met + - 1 + - 72 + - :literal:`positive:up` + * - Emissions data for GEOS-Chem + - 1 + - 72 + - :literal:`positive:up` + * - Processed met fields for GEOS-Chem + - 1 + - 72 + - :literal:`positive:up` + * - Raw met fields for GEOS-Chem + - 72 + - 1 + - :literal:`positive:down` + +.. _gcc-vgrids-gmao-72-ab: + +:math:`A_p` and :math:`B_p` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists the :math:`A_p` and :math:`B_p` parameters that +define the 72-level vertical grid. The level edge indices run from 1 +(surface) to 73 (top-of atmosphere). + +.. list-table:: + :header-rows: 1 + + * - Level edge index + - :math:`A_p` (hPa) + - :math:`B_p` (unitless) + * - 1 + - 0.0 + - 1.0 + * - 2 + - 0.04804826 + - 0.984952 + * - 3 + - 6.593752 + - 0.963406 + * - 4 + - 13.1348 + - 0.941865 + * - 5 + - 19.61311 + - 0.920387 + * - 6 + - 26.09201 + - 0.898908 + * - 7 + - 32.57081 + - 0.877429 + * - 8 + - 38.98201 + - 0.856018 + * - 9 + - 45.33901 + - 0.8346609 + * - 10 + - 51.69611 + - 0.8133039 + * - 11 + - 58.05321 + - 0.7919469 + * - 12 + - 64.36264 + - 0.7706375 + * - 13 + - 70.62198 + - 0.7493782 + * - 14 + - 78.83422 + - 0.721166 + * - 15 + - 89.09992 + - 0.6858999 + * - 16 + - 99.36521 + - 0.6506349 + * - 17 + - 109.1817 + - 0.6158184 + * - 18 + - 118.9586 + - 0.5810415 + * - 19 + - 128.6959 + - 0.5463042 + * - 20 + - 142.91 + - 0.4945902 + * - 21 + - 156.26 + - 0.4437402 + * - 22 + - 169.609 + - 0.3928911 + * - 23 + - 181.619 + - 0.3433811 + * - 24 + - 193.097 + - 0.2944031 + * - 25 + - 203.259 + - 0.2467411 + * - 26 + - 212.15 + - 0.2003501 + * - 27 + - 218.776 + - 0.1562241 + * - 28 + - 223.898 + - 0.1136021 + * - 29 + - 224.363 + - 0.06372006 + * - 30 + - 216.865 + - 0.02801004 + * - 31 + - 201.192 + - 0.006960025 + * - 32 + - 176.93 + - 8.175413e-09 + * - 33 + - 150.393 + - 0.0 + * - 34 + - 127.837 + - 0.0 + * - 35 + - 108.663 + - 0.0 + * - 36 + - 92.36572 + - 0.0 + * - 37 + - 78.51231 + - 0.0 + * - 38 + - 66.60341 + - 0.0 + * - 39 + - 56.38791 + - 0.0 + * - 40 + - 47.64391 + - 0.0 + * - 41 + - 40.17541 + - 0.0 + * - 42 + - 33.81001 + - 0.0 + * - 43 + - 28.36781 + - 0.0 + * - 44 + - 23.73041 + - 0.0 + * - 45 + - 19.7916 + - 0.0 + * - 46 + - 16.4571 + - 0.0 + * - 47 + - 13.6434 + - 0.0 + * - 48 + - 11.2769 + - 0.0 + * - 49 + - 9.292942 + - 0.0 + * - 50 + - 7.619842 + - 0.0 + * - 51 + - 6.216801 + - 0.0 + * - 52 + - 5.046801 + - 0.0 + * - 53 + - 4.076571 + - 0.0 + * - 54 + - 3.276431 + - 0.0 + * - 55 + - 2.620211 + - 0.0 + * - 56 + - 2.08497 + - 0.0 + * - 57 + - 1.65079 + - 0.0 + * - 58 + - 1.30051 + - 0.0 + * - 59 + - 1.01944 + - 0.0 + * - 60 + - 0.7951341 + - 0.0 + * - 61 + - 0.6167791 + - 0.0 + * - 62 + - 0.4758061 + - 0.0 + * - 63 + - 0.3650411 + - 0.0 + * - 64 + - 0.2785261 + - 0.0 + * - 65 + - 0.211349 + - 0.0 + * - 66 + - 0.159495 + - 0.0 + * - 67 + - 0.119703 + - 0.0 + * - 68 + - 0.08934502 + - 0.0 + * - 69 + - 0.06600001 + - 0.0 + * - 70 + - 0.04758501 + - 0.0 + * - 71 + - 0.0327 + - 0.0 + * - 72 + - 0.02 + - 0.0 + * - 73 + - 0.01 + - 0.0 + +.. _gcc-vgrids-gmao-72-prs-alt: + +Pressures and altitudes +~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists pressures and altitudes of the 72 layer grid for +a column at atmospheric sea level. + +.. code-block:: text + + L Eta Edge Eta Mid Altitude Pressure + (unitless) (unitless) (km) (hPa) + ======================================================== + 0.000000 80.581 0.010 + 72 0.000005 78.146 0.015 + 0.000010 76.357 0.020 + 71 0.000016 74.594 0.026 + 0.000022 73.180 0.033 + 70 0.000030 71.812 0.040 + 0.000037 70.657 0.048 + 69 0.000046 69.440 0.057 + 0.000055 68.392 0.066 + 68 0.000067 67.243 0.078 + 0.000078 66.245 0.089 + 67 0.000093 65.115 0.105 + 0.000108 64.130 0.120 + 66 0.000128 63.004 0.140 + 0.000148 62.021 0.159 + 65 0.000173 60.902 0.185 + 0.000199 59.924 0.211 + 64 0.000232 58.816 0.245 + 0.000265 57.846 0.279 + 63 0.000308 56.752 0.322 + 0.000350 55.794 0.365 + 62 0.000405 54.717 0.420 + 0.000460 53.773 0.476 + 61 0.000529 52.716 0.546 + 0.000599 51.788 0.617 + 60 0.000687 50.754 0.706 + 0.000775 49.844 0.795 + 59 0.000886 48.835 0.907 + 0.000996 47.946 1.019 + 58 0.001135 46.962 1.160 + 0.001274 46.092 1.301 + 57 0.001446 45.134 1.476 + 0.001619 44.286 1.651 + 56 0.001834 43.355 1.868 + 0.002048 42.529 2.085 + 55 0.002312 41.627 2.353 + 0.002576 40.825 2.620 + 54 0.002900 39.951 2.948 + 0.003224 39.173 3.276 + 53 0.003619 38.328 3.677 + 0.004013 37.574 4.077 + 52 0.004492 36.759 4.562 + 0.004971 36.030 5.047 + 51 0.005548 35.244 5.632 + 0.006126 34.539 6.217 + 50 0.006818 33.782 6.918 + 0.007510 33.101 7.620 + 49 0.008336 32.372 8.456 + 0.009162 31.716 9.293 + 48 0.010141 31.015 10.285 + 0.011120 30.382 11.277 + 47 0.012287 29.701 12.460 + 0.013455 29.085 13.643 + 46 0.014844 28.423 15.050 + 0.016232 27.824 16.457 + 45 0.017878 27.180 18.124 + 0.019523 26.596 19.792 + 44 0.021467 25.971 21.761 + 0.023410 25.402 23.730 + 43 0.025699 24.794 26.049 + 0.027987 24.240 28.368 + 42 0.030673 23.648 31.089 + 0.033358 23.108 33.810 + 41 0.036499 22.531 36.993 + 0.039641 22.004 40.175 + 40 0.043326 21.438 43.910 + 0.047011 20.920 47.644 + 39 0.051326 20.364 52.016 + 0.055641 19.855 56.388 + 38 0.060682 19.309 61.496 + 0.065723 18.807 66.603 + 37 0.071600 18.269 72.558 + 0.077477 17.773 78.512 + 36 0.084313 17.243 85.439 + 0.091149 16.753 92.366 + 35 0.099191 16.222 100.514 + 0.107233 15.731 108.663 + 34 0.116695 15.198 118.250 + 0.126157 14.706 127.837 + 33 0.137287 14.170 139.115 + 0.148418 13.674 150.393 + 32 0.161513 13.134 163.661 + 0.174608 12.633 176.930 + 31 0.190061 12.086 192.587 + 0.205513 11.578 208.244 + 30 0.223772 11.021 226.745 + 0.242032 10.504 245.246 + 29 0.263587 9.936 267.087 + 0.285142 9.409 288.927 + 28 0.309854 8.846 313.966 + 0.334566 8.320 339.005 + 27 0.353349 7.943 358.038 + 0.372133 7.582 377.070 + 26 0.390927 7.237 396.112 + 0.409720 6.905 415.155 + 25 0.428528 6.585 434.212 + 0.447337 6.277 453.269 + 24 0.466153 5.980 472.335 + 0.484970 5.692 491.401 + 23 0.503795 5.413 510.475 + 0.522620 5.142 529.550 + 22 0.541449 4.879 548.628 + 0.560278 4.623 567.706 + 21 0.579115 4.375 586.793 + 0.597953 4.132 605.880 + 20 0.616790 3.896 624.967 + 0.635628 3.665 644.054 + 19 0.654471 3.439 663.146 + 0.673314 3.219 682.239 + 18 0.685878 3.074 694.969 + 0.698442 2.932 707.699 + 17 0.711006 2.792 720.429 + 0.723570 2.654 733.160 + 16 0.736134 2.517 745.890 + 0.748698 2.382 758.621 + 15 0.761265 2.249 771.354 + 0.773832 2.118 784.088 + 14 0.786400 1.988 796.822 + 0.798967 1.860 809.556 + 13 0.809021 1.759 819.743 + 0.819075 1.659 829.929 + 12 0.826616 1.584 837.570 + 0.834157 1.510 845.211 + 11 0.841698 1.436 852.852 + 0.849239 1.363 860.493 + 10 0.856781 1.290 868.135 + 0.864323 1.218 875.776 + 9 0.871864 1.146 883.418 + 0.879406 1.075 891.059 + 8 0.886948 1.004 898.701 + 0.894489 0.934 906.342 + 7 0.902031 0.864 913.984 + 0.909573 0.795 921.626 + 6 0.917116 0.726 929.268 + 0.924658 0.657 936.911 + 5 0.932200 0.589 944.553 + 0.939743 0.521 952.195 + 4 0.947285 0.454 959.837 + 0.954828 0.387 967.480 + 3 0.962370 0.320 975.122 + 0.969913 0.254 982.765 + 2 0.977456 0.189 990.408 + 0.984999 0.123 998.051 + 1 0.992500 0.058 1005.650 + 1.000000 -0.006 1013.250 + +.. _gcc-vgrids-gmao-47: + +47-layer reduced vertical grid +------------------------------ + +In order to save computational resources, GEOS-Chem Classic can collapse +the :ref:`gcc-vgrids-gmao-72` down to a 47-level grid (with 48 edges) +"on-the-fly". Groups of 2 and 4 levels are lumped together starting at +~70 hPa. See the table below for more information. + +.. _gcc-vgrids-gmao-47-ind: + +Indexing +~~~~~~~~ + +.. list-table:: + :header-rows: 1 + + * - Instance + - Surface level + - Top-of-atm level + - Direction + * - GEOS-Chem Classic using GMAO met + - 1 + - 47 + - :literal:`positive:up` + +.. _gcc-vgrids-gmao-47-lump: + +Lumping of vertical levels +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 47-level reduced vertical grid + + Bottom Bottom # levels + edge of edge prs lumped + level (hPa) together + + PTOP 0.010 + 47 0.066 4 + 46 0.211 4 + 45 0.617 4 + 44 1.651 4 + 43 4.077 4 + 42 9.293 4 + 41 19.792 4 + 40 28.368 2 + 39 40.175 2 + 38 56.388 2 + 37 78.512 2 + %%%% START LUMPING LEVELS ABOVE HERE %%%%% + 1-36 Levels are the same as in the 72-layer grid + +.. _gcc-vgrids-gmao-47-ab: + +:math:`A_p` and :math:`B_p` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists the :math:`A_p` and :math:`B_p` parameters that +define the 47 level reduced vertical grid. The level edge indices run +from 1 (surface) to 48 (top-of atmosphere). + +.. list-table:: + :header-rows: 1 + + * - Level edge index + - :math:`A_p` (hPa) + - :math:`B_p` (unitless) + * - 1 + - 0.0 + - 1.0 + * - 2 + - 0.04804826 + - 0.984952 + * - 3 + - 6.593752 + - 0.963406 + * - 4 + - 13.1348 + - 0.941865 + * - 5 + - 19.61311 + - 0.920387 + * - 6 + - 26.09201 + - 0.898908 + * - 7 + - 32.57081 + - 0.877429 + * - 8 + - 38.98201 + - 0.856018 + * - 9 + - 45.33901 + - 0.8346609 + * - 10 + - 51.69611 + - 0.8133039 + * - 11 + - 58.05321 + - 0.7919469 + * - 12 + - 64.36264 + - 0.7706375 + * - 13 + - 70.62198 + - 0.7493782 + * - 14 + - 78.83422 + - 0.721166 + * - 15 + - 89.09992 + - 0.6858999 + * - 16 + - 99.36521 + - 0.6506349 + * - 17 + - 109.1817 + - 0.6158184 + * - 18 + - 118.9586 + - 0.5810415 + * - 19 + - 128.6959 + - 0.5463042 + * - 20 + - 142.91 + - 0.4945902 + * - 21 + - 156.26 + - 0.4437402 + * - 22 + - 169.609 + - 0.3928911 + * - 23 + - 181.619 + - 0.3433811 + * - 24 + - 193.097 + - 0.2944031 + * - 25 + - 203.259 + - 0.2467411 + * - 26 + - 212.15 + - 0.2003501 + * - 27 + - 218.776 + - 0.1562241 + * - 28 + - 223.898 + - 0.1136021 + * - 29 + - 224.363 + - 0.06372006 + * - 30 + - 216.865 + - 0.02801004 + * - 31 + - 201.192 + - 0.006960025 + * - 32 + - 176.93 + - 8.175413e-09 + * - 33 + - 150.393 + - 0.0 + * - 34 + - 127.837 + - 0.0 + * - 35 + - 108.663 + - 0.0 + * - 36 + - 92.36572 + - 0.0 + * - 37 + - 78.51231 + - 0.0 + * - 38 + - 56.38791 + - 0.0 + * - 39 + - 40.17541 + - 0.0 + * - 40 + - 28.36781 + - 0.0 + * - 41 + - 19.7916 + - 0.0 + * - 42 + - 9.292942 + - 0.0 + * - 43 + - 4.076571 + - 0.0 + * - 44 + - 1.65079 + - 0.0 + * - 45 + - 0.6167791 + - 0.0 + * - 46 + - 0.211349 + - 0.0 + * - 47 + - 0.06600001 + - 0.0 + * - 48 + - 0.01 + - 0.0 + +.. _gcc-vgrids-gmao-47-prs-alt: + +Pressures and altitudes +~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists pressures and altitudes of the 47 layer grid for +a column at atmospheric sea level. + +.. code-block:: text + + L Eta Edge Eta Mid Altitude Pressure + (unitless) (unitless) (km) (hPa) + ======================================================== + 0.000000 80.581 0.010 + 47 0.000028 72.180 0.038 + 0.000055 68.392 0.066 + 46 0.000127 63.053 0.139 + 0.000199 59.924 0.211 + 45 0.000399 54.834 0.414 + 0.000599 51.788 0.617 + 44 0.001109 47.135 1.134 + 0.001619 44.286 1.651 + 43 0.002816 40.166 2.864 + 0.004013 37.574 4.077 + 42 0.006588 34.024 6.685 + 0.009162 31.716 9.293 + 41 0.014342 28.654 14.542 + 0.019523 26.596 19.792 + 40 0.023755 25.307 24.080 + 0.027987 24.240 28.368 + 39 0.033814 23.020 34.272 + 0.039641 22.004 40.175 + 38 0.047641 20.836 48.282 + 0.055641 19.855 56.388 + 37 0.066559 18.727 67.450 + 0.077477 17.773 78.512 + 36 0.084313 17.243 85.439 + 0.091149 16.753 92.366 + 35 0.099191 16.222 100.514 + 0.107233 15.731 108.663 + 34 0.116695 15.198 118.250 + 0.126157 14.706 127.837 + 33 0.137287 14.170 139.115 + 0.148418 13.674 150.393 + 32 0.161513 13.134 163.661 + 0.174608 12.633 176.930 + 31 0.190061 12.086 192.587 + 0.205513 11.578 208.244 + 30 0.223772 11.021 226.745 + 0.242032 10.504 245.246 + 29 0.263587 9.936 267.087 + 0.285142 9.409 288.927 + 28 0.309854 8.846 313.966 + 0.334566 8.320 339.005 + 27 0.353349 7.943 358.038 + 0.372133 7.582 377.070 + 26 0.390927 7.237 396.112 + 0.409720 6.905 415.155 + 25 0.428528 6.585 434.212 + 0.447337 6.277 453.269 + 24 0.466153 5.980 472.335 + 0.484970 5.692 491.401 + 23 0.503795 5.413 510.475 + 0.522620 5.142 529.550 + 22 0.541449 4.879 548.628 + 0.560278 4.623 567.706 + 21 0.579115 4.375 586.793 + 0.597953 4.132 605.880 + 20 0.616790 3.896 624.967 + 0.635628 3.665 644.054 + 19 0.654471 3.439 663.146 + 0.673314 3.219 682.239 + 18 0.685878 3.074 694.969 + 0.698442 2.932 707.699 + 17 0.711006 2.792 720.429 + 0.723570 2.654 733.160 + 16 0.736134 2.517 745.890 + 0.748698 2.382 758.621 + 15 0.761265 2.249 771.354 + 0.773832 2.118 784.088 + 14 0.786400 1.988 796.822 + 0.798967 1.860 809.556 + 13 0.809021 1.759 819.743 + 0.819075 1.659 829.929 + 12 0.826616 1.584 837.570 + 0.834157 1.510 845.211 + 11 0.841698 1.436 852.852 + 0.849239 1.363 860.493 + 10 0.856781 1.290 868.135 + 0.864323 1.218 875.776 + 9 0.871864 1.146 883.418 + 0.879406 1.075 891.059 + 8 0.886948 1.004 898.701 + 0.894489 0.934 906.342 + 7 0.902031 0.864 913.984 + 0.909573 0.795 921.626 + 6 0.917116 0.726 929.268 + 0.924658 0.657 936.911 + 5 0.932200 0.589 944.553 + 0.939743 0.521 952.195 + 4 0.947285 0.454 959.837 + 0.954828 0.387 967.480 + 3 0.962370 0.320 975.122 + 0.969913 0.254 982.765 + 2 0.977456 0.189 990.408 + 0.984999 0.123 998.051 + 1 0.992500 0.058 1005.650 + 1.000000 -0.006 1013.250 + +========================================= +Vertical grids for GCAP2/GISS meteorology +========================================= + +.. _gcc-vgrids-gcap-102: + +102-level vertical grid +----------------------- + +GCAP2/GISS meteorology is produced on a grid with 102 vertical +levels. To reduce the amount of computational overhead, GEOS-Chem +Classic can regrid this "on-the-fly" to ether a +:ref:`gcc-vgrids-gcap-74` or a :ref:`gcc-vgrids-gcap-40`. + +.. _gcc-vgrids-gcap-102-ind: + +Indexing +~~~~~~~~ + +.. list-table:: + :header-rows: 1 + + * - Instance + - Surface level + - Top-of-atm level + - Direction + * - GEOS-Chem Classic using GCAP2 met + - 1 + - 102 + - :literal:`positive:up` + +.. _gcc-vgrids-gcap-102-ab: + +:math:`A_p` and :math:`B_p` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists the :math:`A_p` and :math:`B_p` parameters that +define the 102 level vertical grid. The level edge indices run from 1 +(surface) to 103 (top-of atmosphere). + +.. list-table:: + :header-rows: 1 + + * - Level edge index + - :math:`A_p` (hPa) + - :math:`B_p` (unitless) + + * - 1 + - 0.0 + - 1.0 + * - 2 + - 2.7871507 + - 0.98192363 + * - 3 + - 5.5743014 + - 0.96384725 + * - 4 + - 8.3614521 + - 0.94577088 + * - 5 + - 11.1486028 + - 0.92769451 + * - 6 + - 13.9357536 + - 0.90961814 + * - 7 + - 16.7229043 + - 0.89154176 + * - 8 + - 19.510055 + - 0.87346539 + * - 9 + - 22.2972057 + - 0.85538902 + * - 10 + - 25.0843564 + - 0.83731265 + * - 11 + - 27.8715071 + - 0.81923627 + * - 12 + - 30.6586578 + - 0.8011599 + * - 13 + - 33.4458085 + - 0.78308353 + * - 14 + - 36.2329593 + - 0.76500716 + * - 15 + - 39.02011 + - 0.74693078 + * - 16 + - 41.8087123 + - 0.728845 + * - 17 + - 44.6089278 + - 0.71068389 + * - 18 + - 47.4534183 + - 0.69223563 + * - 19 + - 50.4082336 + - 0.67307185 + * - 20 + - 53.5662786 + - 0.65259001 + * - 21 + - 57.009571 + - 0.63025815 + * - 22 + - 60.7533531 + - 0.60597744 + * - 23 + - 64.7323011 + - 0.58017154 + * - 24 + - 68.8549615 + - 0.55343357 + * - 25 + - 73.0567364 + - 0.5261825 + * - 26 + - 77.2969797 + - 0.49868193 + * - 27 + - 81.5364973 + - 0.47118607 + * - 28 + - 85.734643 + - 0.44395854 + * - 29 + - 89.8565776 + - 0.41722528 + * - 30 + - 93.8754457 + - 0.39116047 + * - 31 + - 97.7709243 + - 0.36589591 + * - 32 + - 101.5277712 + - 0.34153047 + * - 33 + - 105.1350991 + - 0.31813474 + * - 34 + - 108.5878272 + - 0.2957417 + * - 35 + - 111.8859556 + - 0.27435132 + * - 36 + - 115.03021 + - 0.25395891 + * - 37 + - 118.0249453 + - 0.23453623 + * - 38 + - 120.8854039 + - 0.21598441 + * - 39 + - 123.6326345 + - 0.19816694 + * - 40 + - 126.2811535 + - 0.18098968 + * - 41 + - 128.8360417 + - 0.16441967 + * - 42 + - 131.2987506 + - 0.1484475 + * - 43 + - 133.6736353 + - 0.13304493 + * - 44 + - 135.9708571 + - 0.11814604 + * - 45 + - 138.2013035 + - 0.10368024 + * - 46 + - 140.3700552 + - 0.08961456 + * - 47 + - 142.481467 + - 0.07592077 + * - 48 + - 144.5457005 + - 0.06253295 + * - 49 + - 146.5692881 + - 0.04940875 + * - 50 + - 148.5464231 + - 0.03658583 + * - 51 + - 150.4712991 + - 0.02410183 + * - 52 + - 152.3497225 + - 0.01191911 + * - 53 + - 154.1875 + - 0.0 + * - 54 + - 144.546875 + - 0.0 + * - 55 + - 135.1875 + - 0.0 + * - 56 + - 126.078125 + - 0.0 + * - 57 + - 117.1914062 + - 0.0 + * - 58 + - 108.5859375 + - 0.0 + * - 59 + - 100.3671875 + - 0.0 + * - 60 + - 92.5898438 + - 0.0 + * - 61 + - 85.2265625 + - 0.0 + * - 62 + - 78.2226562 + - 0.0 + * - 63 + - 71.5546875 + - 0.0 + * - 64 + - 65.2226562 + - 0.0 + * - 65 + - 59.2226562 + - 0.0 + * - 66 + - 53.5546875 + - 0.0 + * - 67 + - 48.2226562 + - 0.0 + * - 68 + - 43.2226562 + - 0.0 + * - 69 + - 38.5546875 + - 0.0 + * - 70 + - 34.2226562 + - 0.0 + * - 71 + - 30.2226562 + - 0.0 + * - 72 + - 26.5507812 + - 0.0 + * - 73 + - 23.1875 + - 0.0 + * - 74 + - 20.078125 + - 0.0 + * - 75 + - 17.1896562 + - 0.0 + * - 76 + - 14.5684375 + - 0.0 + * - 77 + - 12.2865742 + - 0.0 + * - 78 + - 10.3573086 + - 0.0 + * - 79 + - 8.735375 + - 0.0 + * - 80 + - 7.3664922 + - 0.0 + * - 81 + - 6.2100156 + - 0.0 + * - 82 + - 5.2343633 + - 0.0 + * - 83 + - 4.4119297 + - 0.0 + * - 84 + - 3.7186797 + - 0.0 + * - 85 + - 3.1341479 + - 0.0 + * - 86 + - 2.6404328 + - 0.0 + * - 87 + - 2.2207877 + - 0.0 + * - 88 + - 1.8587369 + - 0.0 + * - 89 + - 1.5477125 + - 0.0 + * - 90 + - 1.2782115 + - 0.0 + * - 91 + - 1.0427319 + - 0.0 + * - 92 + - 0.8367716 + - 0.0 + * - 93 + - 0.6514691 + - 0.0 + * - 94 + - 0.4772511 + - 0.0 + * - 95 + - 0.3168814 + - 0.0 + * - 96 + - 0.1785988 + - 0.0 + * - 97 + - 0.1 + - 0.0 + * - 98 + - 0.056 + - 0.0 + * - 99 + - 0.032 + - 0.0 + * - 100 + - 0.018 + - 0.0 + * - 101 + - 0.01 + - 0.0 + * - 102 + - 0.005 + - 0.0 + * - 103 + - 0.002 + - 0.0 + +.. _gcc-vgrids-gcap-74: + +74-level reduced vertical grid +------------------------------ + +In order to save computational resources, GEOS-Chem Classic can collapse +the :ref:`gcc-vgrids-gcap-102` down to a 74-level grid (with 75 edges) +"on-the-fly". Groups of 2 and 4 levels are lumped together starting at +~85 hPa. See the table below for more information. + +.. _gcc-vgrids-gcap-74-ind: + +Indexing +~~~~~~~~ + +.. list-table:: + :header-rows: 1 + + * - Instance + - Surface level + - Top-of-atm level + - Direction + * - GEOS-Chem Classic using GCAP2 met + - 1 + - 74 + - :literal:`positive:up` + +.. _gcc-vgrids-gcap-74-lump: + +Lumping of vertical levels +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: text + + 74-level GISS grid (condensed from 102-layer grid) + + Bottom Bottom # levels + edge of edge prs lumped + level (hPa) together + + PTOP 0.0020000 + 74 0.0320000 4 + 73 0.3168814 4 + 72 1.0427319 4 + 71 2.2207877 4 + 70 4.4119297 4 + 69 8.7353750 4 + 68 17.1896562 4 + 67 23.1875000 2 + 66 30.2226562 2 + 65 38.5546875 2 + 64 48.2226562 2 + 63 59.2226562 2 + 62 71.5546875 2 + 61 85.2265625 2 + %%%% START LUMPING LEVELS ABOVE HERE %%%%% + 1-60 Levels are the same as for the 102 level vertical grid + +.. _gcc-vgrids-gcap-74-ab: + +:math:`A_p` and :math:`B_p` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists the :math:`A_p` and :math:`B_p` parameters that +define the 74-level vertical grid. The level edge indices run from 1 +(surface) to 75 (top-of atmosphere). + +.. list-table:: + :header-rows: 1 + + * - Level edge index + - :math:`A_p` (hPa) + - :math:`B_p` (unitless) + * - 1 + - 0.0 + - 1.0 + * - 2 + - 2.7871507 + - 0.98192363 + * - 3 + - 5.5743014 + - 0.96384725 + * - 4 + - 8.3614521 + - 0.94577088 + * - 5 + - 11.1486028 + - 0.92769451 + * - 6 + - 13.9357536 + - 0.90961814 + * - 7 + - 16.7229043 + - 0.89154176 + * - 8 + - 19.510055 + - 0.87346539 + * - 9 + - 22.2972057 + - 0.85538902 + * - 10 + - 25.0843564 + - 0.83731265 + * - 11 + - 27.8715071 + - 0.81923627 + * - 12 + - 30.6586578 + - 0.8011599 + * - 13 + - 33.4458085 + - 0.78308353 + * - 14 + - 36.2329593 + - 0.76500716 + * - 15 + - 39.02011 + - 0.74693078 + * - 16 + - 41.8087123 + - 0.728845 + * - 17 + - 44.6089278 + - 0.71068389 + * - 18 + - 47.4534183 + - 0.69223563 + * - 19 + - 50.4082336 + - 0.67307185 + * - 20 + - 53.5662786 + - 0.65259001 + * - 21 + - 57.009571 + - 0.63025815 + * - 22 + - 60.7533531 + - 0.60597744 + * - 23 + - 64.7323011 + - 0.58017154 + * - 24 + - 68.8549615 + - 0.55343357 + * - 25 + - 73.0567364 + - 0.5261825 + * - 26 + - 77.2969797 + - 0.49868193 + * - 27 + - 81.5364973 + - 0.47118607 + * - 28 + - 85.734643 + - 0.44395854 + * - 29 + - 89.8565776 + - 0.41722528 + * - 30 + - 93.8754457 + - 0.39116047 + * - 31 + - 97.7709243 + - 0.36589591 + * - 32 + - 101.5277712 + - 0.34153047 + * - 33 + - 105.1350991 + - 0.31813474 + * - 34 + - 108.5878272 + - 0.2957417 + * - 35 + - 111.8859556 + - 0.27435132 + * - 36 + - 115.03021 + - 0.25395891 + * - 37 + - 118.0249453 + - 0.23453623 + * - 38 + - 120.8854039 + - 0.21598441 + * - 39 + - 123.6326345 + - 0.19816694 + * - 40 + - 126.2811535 + - 0.18098968 + * - 41 + - 128.8360417 + - 0.16441967 + * - 42 + - 131.2987506 + - 0.1484475 + * - 43 + - 133.6736353 + - 0.13304493 + * - 44 + - 135.9708571 + - 0.11814604 + * - 45 + - 138.2013035 + - 0.10368024 + * - 46 + - 140.3700552 + - 0.08961456 + * - 47 + - 142.481467 + - 0.07592077 + * - 48 + - 144.5457005 + - 0.06253295 + * - 49 + - 146.5692881 + - 0.04940875 + * - 50 + - 148.5464231 + - 0.03658583 + * - 51 + - 150.4712991 + - 0.02410183 + * - 52 + - 152.3497225 + - 0.01191911 + * - 53 + - 154.1875 + - 0.0 + * - 54 + - 144.546875 + - 0.0 + * - 55 + - 135.1875 + - 0.0 + * - 56 + - 126.078125 + - 0.0 + * - 57 + - 117.1914062 + - 0.0 + * - 58 + - 108.5859375 + - 0.0 + * - 59 + - 100.3671875 + - 0.0 + * - 60 + - 92.5898438 + - 0.0 + * - 61 + - 85.2265625 + - 0.0 + * - 62 + - 71.5546875 + - 0.0 + * - 63 + - 59.2226562 + - 0.0 + * - 64 + - 48.2226562 + - 0.0 + * - 65 + - 38.5546875 + - 0.0 + * - 66 + - 30.2226562 + - 0.0 + * - 67 + - 23.1875 + - 0.0 + * - 68 + - 17.1896562 + - 0.0 + * - 69 + - 8.735375 + - 0.0 + * - 70 + - 4.4119297 + - 0.0 + * - 71 + - 2.2207877 + - 0.0 + * - 72 + - 1.0427319 + - 0.0 + * - 73 + - 0.3168814 + - 0.0 + * - 74 + - 0.032 + - 0.0 + * - 75 + - 0.002 + - 0.0 + +.. _gcc-vgrids-gcap-40: + +40-level reduced vertical grid +------------------------------- + +In order to save computational resources, GEOS-Chem Classic can collapse +the :ref:`gcc-vgrids-gcap-102` down to a 40-level grid (with 41 edges) +"on-the-fly". + +.. _gcc-vgrids-gcap-40-ind: + +Indexing +~~~~~~~~ + +.. list-table:: + :header-rows: 1 + + * - Instance + - Surface level + - Top-of-atm level + - Direction + * - GEOS-Chem Classic using GCAP2 met + - 1 + - 40 + - :literal:`positive:up` + +.. _gcc-vgrids-gcap-40-ab: + +:math:`A_p` and :math:`B_p` +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The table below lists the :math:`A_p` and :math:`B_p` parameters that +define the 40-level vertical grid. The level edge indices run from 1 +(surface) to 41 (top-of atmosphere). + +.. list-table:: + :header-rows: 1 + + * - Level edge index + - :math:`A_p` (hPa) + - :math:`B_p` (unitless) + * - 1 + - 0.0 + - 1.0 + * - 2 + - 3.597122 + - 0.97601918 + * - 3 + - 7.553957 + - 0.94964029 + * - 4 + - 12.05036 + - 0.91966427 + * - 5 + - 16.906475 + - 0.88729017 + * - 6 + - 22.302158 + - 0.85131894 + * - 7 + - 28.597122 + - 0.80935252 + * - 8 + - 35.791367 + - 0.76139089 + * - 9 + - 43.884892 + - 0.70743405 + * - 10 + - 52.517986 + - 0.6498801 + * - 11 + - 61.510791 + - 0.58992806 + * - 12 + - 70.683453 + - 0.52877698 + * - 13 + - 80.035971 + - 0.46642686 + * - 14 + - 89.028777 + - 0.40647482 + * - 15 + - 97.661871 + - 0.34892086 + * - 16 + - 105.755396 + - 0.29496403 + * - 17 + - 113.309353 + - 0.24460432 + * - 18 + - 120.143885 + - 0.19904077 + * - 19 + - 126.258993 + - 0.15827338 + * - 20 + - 131.834532 + - 0.12110312 + * - 21 + - 136.870504 + - 0.08752998 + * - 22 + - 141.546763 + - 0.05635492 + * - 23 + - 145.863309 + - 0.02757794 + * - 24 + - 150.0 + - 0.0 + * - 25 + - 128.0 + - 0.0 + * - 26 + - 108.0 + - 0.0 + * - 27 + - 90.0 + - 0.0 + * - 28 + - 73.0 + - 0.0 + * - 29 + - 57.0 + - 0.0 + * - 30 + - 43.0 + - 0.0 + * - 31 + - 31.0 + - 0.0 + * - 32 + - 20.0 + - 0.0 + * - 33 + - 10.0 + - 0.0 + * - 34 + - 5.62 + - 0.0 + * - 35 + - 3.16 + - 0.0 + * - 36 + - 1.78 + - 0.0 + * - 37 + - 1.0 + - 0.0 + * - 38 + - 0.562 + - 0.0 + * - 39 + - 0.316 + - 0.0 + * - 40 + - 0.178 + - 0.0 + * - 41 + - 0.1 + - 0.0 diff --git a/src/GEOS-Chem b/src/GEOS-Chem index 3671d504c..df4592e84 160000 --- a/src/GEOS-Chem +++ b/src/GEOS-Chem @@ -1 +1 @@ -Subproject commit 3671d504cab09196ee960447a361b36ec41fe926 +Subproject commit df4592e84561d3400950250e6fb57cd5b4bc90e7 diff --git a/src/HEMCO b/src/HEMCO index 28e6d8e27..e23c43b89 160000 --- a/src/HEMCO +++ b/src/HEMCO @@ -1 +1 @@ -Subproject commit 28e6d8e27dfd059f5c6e3ceee0c0844523a0689f +Subproject commit e23c43b89a754668d25744fa9827f8cfd7fa181f