deploy: 4521456

GenericMappingTools · Nov 6, 2023 · 537d5a2 · 537d5a2
commit 537d5a2
Show file tree

Hide file tree

Showing 194 changed files with 12,707 additions and 0 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: c6f21f207ec740edd3f5da968539cd58
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/.nojekyll b/.nojekyll
diff --git a/_images/EarthByte_logo_small.png b/_images/EarthByte_logo_small.png
diff --git a/_images/GMT_earth_age.png b/_images/GMT_earth_age.png
diff --git a/_images/GMT_earth_age_thumbnail.jpg b/_images/GMT_earth_age_thumbnail.jpg
diff --git a/_images/GMT_earth_daynight.jpg b/_images/GMT_earth_daynight.jpg
diff --git a/_images/GMT_earth_daynight_thumbnail.jpg b/_images/GMT_earth_daynight_thumbnail.jpg
diff --git a/_images/GMT_earth_edefl.jpg b/_images/GMT_earth_edefl.jpg
diff --git a/_images/GMT_earth_edefl_thumbnail.jpg b/_images/GMT_earth_edefl_thumbnail.jpg
diff --git a/_images/GMT_earth_faa.jpg b/_images/GMT_earth_faa.jpg
diff --git a/_images/GMT_earth_faa_thumbnail.jpg b/_images/GMT_earth_faa_thumbnail.jpg
diff --git a/_images/GMT_earth_faaerror.jpg b/_images/GMT_earth_faaerror.jpg
diff --git a/_images/GMT_earth_faaerror_thumbnail.jpg b/_images/GMT_earth_faaerror_thumbnail.jpg
diff --git a/_images/GMT_earth_gebco.jpg b/_images/GMT_earth_gebco.jpg
diff --git a/_images/GMT_earth_gebco_thumbnail.jpg b/_images/GMT_earth_gebco_thumbnail.jpg
diff --git a/_images/GMT_earth_geoid.jpg b/_images/GMT_earth_geoid.jpg
diff --git a/_images/GMT_earth_geoid_thumbnail.jpg b/_images/GMT_earth_geoid_thumbnail.jpg
diff --git a/_images/GMT_earth_mag.jpg b/_images/GMT_earth_mag.jpg
diff --git a/_images/GMT_earth_mag_thumbnail.jpg b/_images/GMT_earth_mag_thumbnail.jpg
diff --git a/_images/GMT_earth_mask.png b/_images/GMT_earth_mask.png
diff --git a/_images/GMT_earth_mask_thumbnail.jpg b/_images/GMT_earth_mask_thumbnail.jpg
diff --git a/_images/GMT_earth_mdt.jpg b/_images/GMT_earth_mdt.jpg
diff --git a/_images/GMT_earth_mdt_thumbnail.jpg b/_images/GMT_earth_mdt_thumbnail.jpg
diff --git a/_images/GMT_earth_mss.jpg b/_images/GMT_earth_mss.jpg
diff --git a/_images/GMT_earth_mss_thumbnail.jpg b/_images/GMT_earth_mss_thumbnail.jpg
diff --git a/_images/GMT_earth_ndefl.jpg b/_images/GMT_earth_ndefl.jpg
diff --git a/_images/GMT_earth_ndefl_thumbnail.jpg b/_images/GMT_earth_ndefl_thumbnail.jpg
diff --git a/_images/GMT_earth_relief.jpg b/_images/GMT_earth_relief.jpg
diff --git a/_images/GMT_earth_relief_thumbnail.jpg b/_images/GMT_earth_relief_thumbnail.jpg
diff --git a/_images/GMT_earth_vgg.jpg b/_images/GMT_earth_vgg.jpg
diff --git a/_images/GMT_earth_vgg_thumbnail.jpg b/_images/GMT_earth_vgg_thumbnail.jpg
diff --git a/_images/GMT_earth_wdmam.jpg b/_images/GMT_earth_wdmam.jpg
diff --git a/_images/GMT_earth_wdmam_thumbnail.jpg b/_images/GMT_earth_wdmam_thumbnail.jpg
diff --git a/_images/GMT_mars_relief.jpg b/_images/GMT_mars_relief.jpg
diff --git a/_images/GMT_mars_relief_thumbnail.jpg b/_images/GMT_mars_relief_thumbnail.jpg
diff --git a/_images/GMT_mercury_relief.jpg b/_images/GMT_mercury_relief.jpg
diff --git a/_images/GMT_mercury_relief_thumbnail.jpg b/_images/GMT_mercury_relief_thumbnail.jpg
diff --git a/_images/GMT_moon_relief.jpg b/_images/GMT_moon_relief.jpg
diff --git a/_images/GMT_moon_relief_thumbnail.jpg b/_images/GMT_moon_relief_thumbnail.jpg
diff --git a/_images/GMT_pluto_relief.jpg b/_images/GMT_pluto_relief.jpg
diff --git a/_images/GMT_pluto_relief_thumbnail.jpg b/_images/GMT_pluto_relief_thumbnail.jpg
diff --git a/_images/GMT_venus_relief.jpg b/_images/GMT_venus_relief.jpg
diff --git a/_images/GMT_venus_relief_thumbnail.jpg b/_images/GMT_venus_relief_thumbnail.jpg
diff --git a/_images/cnes.jpg b/_images/cnes.jpg
diff --git a/_images/igpp.png b/_images/igpp.png
diff --git a/_images/nasa-logo-web-rgb.png b/_images/nasa-logo-web-rgb.png
diff --git a/_images/usgs.png b/_images/usgs.png
diff --git a/_sources/changes.rst.txt b/_sources/changes.rst.txt
@@ -0,0 +1,55 @@
+Changelog
+---------
+
+2023-08-24
+^^^^^^^^^^
+
+- ``earth_relief``: Update dataset source from 2.4 to 2.5.5.
+
+
+2023-08-19
+^^^^^^^^^^
+
+- ``earth_synbath``: Update dataset source from version 1.2 to 2.0.
+- ``earth_gebco``: Update dataset source from version 2021 to 2023.[`GEBCO Compilation Group, 2023, GEBCO 2023 Grid <https://www.gebco.net/data_and_products/gridded_bathymetry_data/>`_].
+- ``earth_gebcosi``: Update dataset source from version 2021 to 2023.[`GEBCO Compilation Group, 2023, GEBCO 2023 Grid <https://www.gebco.net/data_and_products/gridded_bathymetry_data/>`_].
+
+
+2023-08-17
+^^^^^^^^^^
+
+- ``earth_faa``: Update dataset source from version 31 to 32.
+- ``earth_vgg``: Update dataset source from version 31 to 32.
+
+2023-08-15
+^^^^^^^^^^
+
+- ``earth_wdmam``: Update dataset source from version 2.0 to 2.1 [`Choi et al., 2023 <https://www.wdmam.org/>`_].
+
+2022-04-01
+^^^^^^^^^^
+
+- ``earth_relief``: Update citation for SRTM15+V2.4 [`Tozer et al., 2019 <https://doi.org/10.1029/2019EA000658>`_].
+- ``earth_relief``: Fix 30s topography grids [`Issue #32 <https://github.com/GenericMappingTools/remote-datasets/issues/32>`_].
+
+2022-03-22
+^^^^^^^^^^
+
+- ``earth_relief``: Update dataset source from SRTM15+V2.3 to SRTM15+V2.4 [`Tozer et al., 2019 <https://doi.org/10.1029/2019EA000658>`_].
+
+2022-01-28
+^^^^^^^^^^
+
+- ``earth_geoid``: Add new dataset 'EGM2008 Earth Geoid Anomalies' [`Pavlis et al., 2012 <https://doi.org/10.1029/2011JB008916>`_].
+- ``earth_mag4km``: Add new dataset 'EMAG2v3 at 4km altitude Earth Magnetic Anomalies' [`Meyer et al., 2017 <https://doi.org/10.7289/V5H70CVX>`_].
+- ``earth_mag``: Add new dataset 'EMAG2v3 at sea-level Earth Magnetic Anomalies' [`Meyer et al., 2017 <https://doi.org/10.7289/V5H70CVX>`_].
+- ``earth_gebco``: Add new dataset 'GEBCO Earth Relief' [`GEBCO Compilation Group, 2021 GEBCO 2021 Grid <https://www.gebco.net/data_and_products/gridded_bathymetry_data/>`_].
+- ``earth_gebcosi``: Add new dataset 'GEBCO Sub-Ice Earth Relief' [`GEBCO Compilation Group, 2021 GEBCO 2021 Grid <https://www.gebco.net/data_and_products/gridded_bathymetry_data/>`_].
+- ``earth_faa``: Add new dataset 'IGPP Earth Free Air Gravity Anomalies v31' [`Sandwell et al., 2019 <https://doi.org/10.1016/j.asr.2019.09.011>`_; `Pavlis et al., 2012 <https://doi.org/10.1029/2011JB008916>`_].
+- ``earth_vgg``: Add new dataset 'IGPP Earth Vertical Gravity Gradient Anomalies v31' [`Sandwell et al., 2019 <https://doi.org/10.1016/j.asr.2019.09.011>`_; `Pavlis et al., 2012 <https://doi.org/10.1029/2011JB008916>`_].
+- ``earth_synbath``: Add new dataset 'SYNBATH Earth Relief' [`Sandwell et al., 2022 <https://doi.org/10.1002/essoar.10508279.1>`_].
+- ``earth_wdmam``: Add new dataset 'WDMAM Earth Magnetic Anomalies' [`Lesur et al., 2016 <https://doi.org/10.1186/s40623-016-0404-6>`_].
+- ``earth_relief``: Update dataset source from SRTM15+V2.1 to SRTM15+V2.3 [`Sandwell et al., 2022 <https://doi.org/10.1002/essoar.10508279.1>`_].
+- ``earth_age``: Update dataset name from 'Earth Seafloor Crustal Age Models' to 'EarthByte Earth Seafloor Age'.
+- ``earth_mask``: Update dataset name from 'Earth Masks for ocean/land/lake/island/pond' to 'GSHHG Earth Mask'.
+- ``earth_relief``: Update dataset name from 'Earth Digital Elevation Models' to 'IGPP Global Earth Relief'.
diff --git a/_sources/earth-age.rst.txt b/_sources/earth-age.rst.txt
@@ -0,0 +1,64 @@
+EarthByte Earth Seafloor Crustal Age
+------------------------------------
+.. figure:: /_static/EarthByte_logo_small.png
+   :align: right
+   :scale: 20 %
+
+.. figure:: /_static/GMT_earth_age.png
+   :width: 710 px
+   :align: center
+
+Numerous geodynamic and geophysical studies consider both the seafloor depth and
+the seafloor crustal age. `EarthByte <https://www.earthbyte.org/>`_ has pioneered
+the creation of crustal age grids since 1997 and we offer their latest version for
+remote use in GMT.
+
+Usage
+~~~~~
+
+You access a global crustal age grid by specifying the special name
+
+   @earth_age[_\ *rru*\ [_\ *reg*\ ]]
+
+The following codes for *rr*\ *u* and the optional *reg* are supported (dimensions and sizes are listed
+for pixel-registered grids; gridline-registered grids increment dimensions by one):
+
+.. _tbl-earth_age:
+
+.. table:: EarthByte Global Earth Seafloor Crustal Age. An asterisk denotes tiled datasets.
+
+  ==== ================= === =======  ==================================================
+  Code Dimensions        Reg Size     Description
+  ==== ================= === =======  ==================================================
+  01d       360 x    180 g,p   73 KB  1 arc degree global seafloor ages (1 min @ 315 km)
+  30m       720 x    360 g,p  204 KB  30 arc minute global seafloor ages (1 min @ 157 km)
+  20m      1080 x    540 g,p  401 KB  20 arc minute global seafloor ages (1 min @ 105 km)
+  15m      1440 x    720 g,p  658 KB  15 arc minute global seafloor ages (1 min @ 79 km)
+  10m      2160 x   1080 g,p  1.3 MB  10 arc minute global seafloor ages (1 min @ 52 km)
+  06m      3600 x   1800 g,p  3.0 MB  6 arc minute global seafloor ages (1 min @ 32 km)
+  05m*     4320 x   2160 g,p  4.6 MB  5 arc minute global seafloor ages (1 min @ 26 km)
+  04m*     5400 x   2700 g,p  5.8 MB  4 arc minute global seafloor ages (1 min @ 21 km)
+  03m*     7200 x   3600 g,p   11 MB  3 arc minute global seafloor ages (1 min @ 16 km)
+  02m*    10800 x   5400 g,p   18 MB  2 arc minute global seafloor ages (1 min @ 11 km)
+  01m*    21600 x  10800 g     50 MB  1 arc minute global seafloor ages (1 min original)
+  ==== ================= === =======  ==================================================
+
+See :gmt-docs:`GMT remote dataset usage <datasets/remote-data.html#usage>` for when resolution codes are optional or required.
+All of these data will, when downloaded, be placed in your ~/.gmt/server directory, with
+the earth_age files being placed in an ``earth/earth_age`` sub-directory. If you do not
+specify a CPT, the default CPT for this dataset (*@earth_age.cpt*) will be used.
+
+Technical Information
+~~~~~~~~~~~~~~~~~~~~~
+
+We scale and reformat the original data to take up very little space so that downloads
+from the servers are as fast as possible. For the seafloor crustal age grid this means
+we chose 0.01 Myr as the smallest data unit, which is well below the uncertainties in the
+model. Data are scaled and shifted to fit in a short integer grid that is highly compressed
+by netCDF lossless compression and chunking. The data are reported in Myr relative
+to the 2012 Geological Time Scale.
+
+Data References
+~~~~~~~~~~~~~~~
+
+#. Seton et al., 2020: [https://doi.org/10.1029/2020GC009214].
diff --git a/_sources/earth-daynight.rst.txt b/_sources/earth-daynight.rst.txt
@@ -0,0 +1,76 @@
+NASA Earth Day/Night Images
+---------------------------
+.. figure:: /_static/nasa-logo-web-rgb.png
+   :align: right
+   :scale: 20 %
+
+.. figure:: /_static/GMT_earth_daynight.jpg
+   :height: 888 px
+   :width: 1774 px
+   :align: center
+   :scale: 40 %
+
+We serve two NASA image products: The Blue and Black marble mosaics.
+We have filtered and down-ampled those as well at the same resolutions that are
+available for the Earth DEMs. However, all images are pixel-registered only.
+These images may be plotted with :gmt-docs:`grdimage` or :gmt-docs:`grdview` and manipulated
+by :gmt-docs:`grdmix`. The above example mixes both images according to a day-night
+mask and adds illumination from a corresponding Earth DEM.
+
+Usage
+~~~~~
+
+You access a global daytime image by specifying the special names
+
+   @earth_day[_\ *rru*]
+
+Similarly for the nighttime view:
+
+   @earth_night[_\ *rru*]
+
+The following codes for *rr*\ *u* are supported. The sizes refers to the earth_day version
+(the earth_night ranges from 33% smaller for the highest resolution up to 44% bigger for
+the lowest resolution):
+
+.. _tbl-earth_daynight:
+
+.. table:: NASA Global Earth Day/Night Images.
+
+  ==== ================= =======  ===========================================================
+  Code Dimensions        Size     Description
+  ==== ================= =======  ===========================================================
+  01d       360 x    180   73 KB  1 arc degree image view (Blue|Black Marble mosaic @ 315 km)
+  30m       720 x    360  263 KB  30 arc minute image view (Blue|Black Marble mosaic @ 157 km)
+  20m      1080 x    540  568 KB  20 arc minute image view (Blue|Black Marble mosaic @ 105 km)
+  15m      1440 x    720  1.0 MB  15 arc minute image view (Blue|Black Marble mosaic @ 79 km)
+  10m      2160 x   1080  1.9 MB  10 arc minute image view (Blue|Black Marble mosaic @ 52 km)
+  06m      3600 x   1800  5.1 MB  6 arc minute image view (Blue|Black Marble mosaic @ 32 km)
+  05m      4320 x   2160  7.2 MB  5 arc minute image view (Blue|Black Marble mosaic @ 26 km)
+  04m      5400 x   2700   11 MB  4 arc minute image view (Blue|Black Marble mosaic @ 21 km)
+  03m      7200 x   3600   20 MB  3 arc minute image view (Blue|Black Marble mosaic @ 16 km)
+  02m     10800 x   5400   44 MB  2 arc minute image view (Blue|Black Marble mosaic @ 11 km)
+  01m     21600 x  10800  171 MB  1 arc minute image view (Blue|Black Marble mosaic @ 1.9 km)
+  30s     43200 x  21600  622 MB  30 arc second image view (Blue|Black Marble mosaic original)
+  ==== ================= =======  ===========================================================
+
+See :gmt-docs:`GMT remote dataset usage <datasets/remote-data.html#usage>` for when resolution codes are optional or required.
+All of these images will, when downloaded, be placed in your ~/.gmt/server directory under
+the ``earth/earth_day`` and ``earth/earth_night`` sub-directories.
+
+Technical Information
+~~~~~~~~~~~~~~~~~~~~~
+
+The 01m and lower resolution images are derivatives of NASA's Blue and Black marble image mosaics.
+We have downsampled them via Cartesian Gaussian filtering to prevent aliasing while preserving
+the latitude-dependent resolution in the original images. The full (6 sigma) filter-widths are
+indicated in parenthesis.
+The dimensions above reflect the number of nodes covered by the global images and the sizes refer
+to the geotiff "day" files on the remote server. **Note**: This data set is experimental and the
+format and delivery is likely to change in the future (e.g., via image tiles). To make the
+files as small as possible we have also downgraded them from 24-bit to 8-bit indexed images.
+
+Data References
+~~~~~~~~~~~~~~~
+
+#. Blue Marble: [https://visibleearth.nasa.gov/images/57752/blue-marble-land-surface-shallow-water-and-shaded-topography].
+#. Black Marble: [https://earthobservatory.nasa.gov/features/NightLights/page3.php].
diff --git a/_sources/earth-edefl.rst.txt b/_sources/earth-edefl.rst.txt
@@ -0,0 +1,68 @@
+IGPP Earth East-West Deflections
+--------------------------------
+.. figure:: /_static/igpp.png
+   :align: right
+   :scale: 20 %
+
+.. figure:: /_static/GMT_earth_edefl.jpg
+   :width: 710 px
+   :align: center
+
+Both geodynamic and geophysical studies have an interest in the study of the Earth's
+gravity field and are often used in conjunctions with bathymetric or topographic relief
+to assess the degree of isostasy.
+`David Sandwell and colleagues <https://topex.ucsd.edu/marine_grav/mar_grav.html>`_
+have provided altimetry-based marine FAA and similar grids since 1995. The latest version 32 is now
+available for remote use in GMT. Over land these grids are filled in by the EGM2008 model
+[Pavlis et al., 2012].This data set contains the east-west deflections of the vertical
+in micro-radians. Polar regions beyond ±80˚ are not covered and are set to NaN.
+
+Usage
+~~~~~
+
+You access a global east-west deflection (edefl) grid by specifying the special name
+
+   @earth_edefl[_\ *rru*\ [_\ *reg*\ ]]
+
+The following codes for *rr*\ *u* and the optional *reg* are supported (dimensions are listed
+for pixel-registered grids; gridline-registered grids increment dimensions by one):
+
+.. _tbl-earth_edefl:
+
+.. table:: IGPP Earth East-West Deflections. An asterisk denotes tiled datasets.
+
+  ==== ================= === =======  ===========================================
+  Code Dimensions        Reg Size     Description
+  ==== ================= === =======  ===========================================
+  01d       360 x    180 g,p  101 KB  1 arc degree global EDEFL (1 min @ 315 km)
+  30m       720 x    360 g,p  349 KB  30 arc minute global EDEFL (1 min @ 157 km)
+  20m      1080 x    540 g,p  750 KB  20 arc minute global EDEFL (1 min @ 105 km)
+  15m      1440 x    720 g,p  1.3 MB  15 arc minute global EDEFL (1 min @ 79 km)
+  10m      2160 x   1080 g,p  2.8 MB  10 arc minute global EDEFL (1 min @ 52 km)
+  06m      3600 x   1800 g,p  7.4 MB  6 arc minute global EDEFL (1 min @ 32 km)
+  05m*     4320 x   2160 g,p   10 MB  5 arc minute global EDEFL (1 min @ 26 km)
+  04m*     5400 x   2700 g,p   16 MB  4 arc minute global EDEFL (1 min @ 21 km)
+  03m*     7200 x   3600 g,p   27 MB  3 arc minute global EDEFL (1 min @ 16 km)
+  02m*    10800 x   5400 g,p   59 MB  2 arc minute global EDEFL (1 min @ 11 km)
+  01m*    21600 x  10800   p  219 MB  1 arc minute global EDEFL (1 min original)
+  ==== ================= === =======  ===========================================
+
+See :gmt-docs:`GMT remote dataset usage <datasets/remote-data.html#usage>` for when resolution codes are optional or required.
+All of these data will, when downloaded, be placed in your ~/.gmt/server directory, with
+the earth_faa files being placed in an ``earth/earth_faa`` sub-directory. If you do not
+specify a CPT, the default CPT for this dataset (*@earth_defl.cpt*) will be used.
+
+Technical Information
+~~~~~~~~~~~~~~~~~~~~~
+
+We scale and reformat the original data to take up very little space so that downloads
+from the servers are as fast as possible. For the EDEFL grid this means
+we chose 1/32 micro-radians as the smallest data unit, which is well below the uncertainties in the
+model. Data are scaled and shifted to fit in a short integer grid that is highly compressed
+by netCDF lossless compression and chunking. The data are reported in micro-radians.
+
+Data References
+~~~~~~~~~~~~~~~
+
+#. Sandwell, D.T., Harper, H., Tozer, B. and Smith, W.H., 2019: [https://doi.org/10.1016/j.asr.2019.09.011].
+#. Pavlis, N.K., Holmes, S.A., Kenyon, S.C. and Factor, J.K., 2012: [https://doi.org/10.1029/2011JB008916].
diff --git a/_sources/earth-faa.rst.txt b/_sources/earth-faa.rst.txt
@@ -0,0 +1,67 @@
+IGPP Earth Free-Air Anomaly
+---------------------------
+.. figure:: /_static/igpp.png
+   :align: right
+   :scale: 20 %
+
+.. figure:: /_static/GMT_earth_faa.jpg
+   :width: 710 px
+   :align: center
+
+Both geodynamic and geophysical studies have an interest in the study of the Earth's
+gravity field and are often used in conjunctions with bathymetric or topographic relief
+to assess the degree of isostasy.
+`David Sandwell and colleagues <https://topex.ucsd.edu/marine_grav/mar_grav.html>`_
+have provided altimetry-based marine FAA and similar grids since 1995. The latest version 32 is now
+available for remote use in GMT. Over land these grids are filled in by the EGM2008 model [Pavlis et al., 2012].
+Polar regions beyond ±80˚ are not covered and are set to NaN.
+
+Usage
+~~~~~
+
+You access a global free-air (faa) grid by specifying the special name
+
+   @earth_faa[_\ *rru*\ [_\ *reg*\ ]]
+
+The following codes for *rr*\ *u* and the optional *reg* are supported (dimensions are listed
+for pixel-registered grids; gridline-registered grids increment dimensions by one):
+
+.. _tbl-earth_faa:
+
+.. table:: IGPP Global Earth Free-Air Anomaly. An asterisk denotes tiled datasets.
+
+  ==== ================= === =======  =======================================
+  Code Dimensions        Reg Size     Description
+  ==== ================= === =======  =======================================
+  01d       360 x    180 g,p  101 KB  1 arc degree global FAA (FAA @ 315 km)
+  30m       720 x    360 g,p  349 KB  30 arc minute global FAA (FAA @ 157 km)
+  20m      1080 x    540 g,p  750 KB  20 arc minute global FAA (FAA @ 105 km)
+  15m      1440 x    720 g,p  1.3 MB  15 arc minute global FAA (FAA @ 79 km)
+  10m      2160 x   1080 g,p  2.8 MB  10 arc minute global FAA (FAA @ 52 km)
+  06m      3600 x   1800 g,p  7.4 MB  6 arc minute global FAA (FAA @ 32 km)
+  05m*     4320 x   2160 g,p   10 MB  5 arc minute global FAA (FAA @ 26 km)
+  04m*     5400 x   2700 g,p   16 MB  4 arc minute global FAA (FAA @ 21 km)
+  03m*     7200 x   3600 g,p   27 MB  3 arc minute global FAA (FAA @ 16 km)
+  02m*    10800 x   5400 g,p   59 MB  2 arc minute global FAA (FAA @ 11 km)
+  01m*    21600 x  10800   p  219 MB  1 arc minute global FAA (original)
+  ==== ================= === =======  =======================================
+
+See :gmt-docs:`GMT remote dataset usage <datasets/remote-data.html#usage>` for when resolution codes are optional or required.
+All of these data will, when downloaded, be placed in your ~/.gmt/server directory, with
+the earth_faa files being placed in an ``earth/earth_faa`` sub-directory. If you do not
+specify a CPT, the default CPT for this dataset (*@earth_faa.cpt*) will be used.
+
+Technical Information
+~~~~~~~~~~~~~~~~~~~~~
+
+We scale and reformat the original data to take up very little space so that downloads
+from the servers are as fast as possible. For the FAA grid this means
+we chose 0.025 mGal as the smallest data unit, which is well below the uncertainties in the
+model. Data are scaled and shifted to fit in a short integer grid that is highly compressed
+by netCDF lossless compression and chunking. The data are reported in mGal.
+
+Data References
+~~~~~~~~~~~~~~~
+
+#. Sandwell, D.T., Harper, H., Tozer, B. and Smith, W.H., 2019: [https://doi.org/10.1016/j.asr.2019.09.011].
+#. Pavlis, N.K., Holmes, S.A., Kenyon, S.C. and Factor, J.K., 2012: [https://doi.org/10.1029/2011JB008916].