reorganize dataset chapters

source/dataset-CN/CN-block/index.md → source/dataset/CN-block/index.md

@@ -12,16 +12,20 @@ CN-block 数据提供了中国大陆及周边活动地块数据，是 GMT 中文
 :width: 80%
 ```
 
-## 数据文件
+## 数据下载
 
-CN-block 数据提供了三个数据文件:
+- 项目主页： <https://github.com/gmt-china/china-geospatial-data>
+- 下载地址： <https://github.com/gmt-china/china-geospatial-data/releases>
+
+macOS/Linux 用户请下载数据 {file}`china-geospatial-data-UTF8.zip`（UTF8 编码），
+Windows 用户请下载数据 {file}`china-geospatial-data-GB2312.zip`（GB2312 编码）。
+
+数据包中提供了三个地块有关的数据文件:
 
 - {file}`CN-block-L1.gmt`：一级地块边界数据
 - {file}`CN-block-L1-deduced.gmt`：一级地块推断边界数据
 - {file}`CN-block-L2.gmt`：二级地块边界数据
 
-具体的下载地址和使用方式请见: {doc}`/dataset-CN/index`。
-
 ## 示例图
 
 ```{eval-rst}

source/dataset-CN/CN-border.md → source/dataset/CN-border.md

@@ -27,16 +27,20 @@ CN-border 是 GMT 中文社区为用户提供的一套基本准确的数字化
 欢迎用户共享更准确的国界数据。
 :::
 
-## 数据文件
+## 数据下载
 
-CN-border 数据提供了三个数据文件：
+- 项目主页： <https://github.com/gmt-china/china-geospatial-data>
+- 下载地址： <https://github.com/gmt-china/china-geospatial-data/releases>
+
+macOS/Linux 用户请下载数据 {file}`china-geospatial-data-UTF8.zip`（UTF8 编码），
+Windows 用户请下载数据 {file}`china-geospatial-data-GB2312.zip`（GB2312 编码）。
+
+数据包中提供了三个数据文件：
 
 - {file}`CN-border-La.gmt`：中国国界、省界、十段线以及南海诸岛数据
 - {file}`CN-border-L1.gmt`：中国国界、十段线以及南海诸岛数据，不含省界数据
 - {file}`ten-dash-line.gmt`：仅十段线数据
 
-具体的下载地址和使用方式请见：{doc}`/dataset-CN/index`。
-
 ## 示例图
 
 使用等距圆锥投影（**-JD**）绘制中国国界省界数据：

source/dataset-CN/CN-faults.md → source/dataset/CN-faults.md

@@ -9,11 +9,15 @@ CN-faults 数据来自于邓起东院士编制的《中国活动构造图（1:40
 数据包含了中国区域内主要断层的地理位置以及断层属性，
 如断层名称、长度、走向、倾向、倾角、断层性质、最晚活动年代等。
 
-## 数据文件
+## 数据下载
 
-CN-faults 提供了一个数据文件 {file}`CN-faults.gmt`：中国区域主要断层
+- 项目主页： <https://github.com/gmt-china/china-geospatial-data>
+- 下载地址： <https://github.com/gmt-china/china-geospatial-data/releases>
 
-具体的下载地址和使用方式请见：{doc}`/dataset-CN/index`。
+macOS/Linux 用户请下载数据 {file}`china-geospatial-data-UTF8.zip`（UTF8 编码），
+Windows 用户请下载数据 {file}`china-geospatial-data-GB2312.zip`（GB2312 编码）。
+
+数据包中的数据文件 {file}`CN-faults.gmt` 即为中国区域主要断层。
 
 ## 示例图
 

source/dataset-CN/geo3al/index.md → source/dataset/geo3al/index.md

@@ -8,13 +8,19 @@ geo3al 数据是由 U.S. Geological Survey (USGS) 提供的中国及邻区地质
 是“[世界地质地图](https://certmapper.cr.usgs.gov/data/apps/world-maps/)”的一部分，
 数据分辨率为 1:5,000,000。
 
-## 数据文件
+## 数据下载
 
-中文社区提供了可供 GMT 直接使用的数据文件：
+**下载数据**
 
-- {file}`geo3al.gmt`：中国及邻区地质图数据
+- 项目主页： <https://github.com/gmt-china/china-geospatial-data>
+- 下载地址： <https://github.com/gmt-china/china-geospatial-data/releases>
+
+macOS/Linux 用户请下载数据 {file}`china-geospatial-data-UTF8.zip`（UTF8 编码），
+Windows 用户请下载数据 {file}`china-geospatial-data-GB2312.zip`（GB2312 编码）。
 
-数据的具体下载地址和使用方式请见：{doc}`/dataset-CN/index`。
+数据包中提供了可供 GMT 直接使用的数据文件：
+
+- {file}`geo3al.gmt`：中国及邻区地质图数据
 
 数据中包含了如下非空间元信息（可以参考
 [geo3al.shp.xml](https://www.sciencebase.gov/catalog/file/get/60abc7f9d34ea221ce51e5ee?f=__disk__8d%2Fb6%2Fc0%2F8db6c0b602ae57f8aaacfb088b6e33c4019de3e8)

source/dataset/index.md

@@ -1,81 +1,70 @@
 # 地学数据集
 
 使用 GMT 绘图时，经常用到一些特定的地学数据，如国界线、地形起伏数据等。
-这些数据一般不需要任何改动即可用在多种图件中。根据使用方法的不同，分为三类：
+这些数据一般不需要任何改动即可用在多种图件中。为方便用户，
+GMT 已提供了一些内置数据，对于占用空间较大的无法内置的数据，则提供了远程数据。
+GMT 内置数据和远程数据并不能满足所有用户的需求，GMT 中文整理了一些中国和全球的地学数据集。
+数据由 GMT 用户提供，并由 GMT 中文社区收集和维护。所有数据列表如下所示：
 
-1. GMT 内置数据：GMT 官方整理的内置于 GMT 软件包中的数据
-2. GMT 远程数据：GMT 官方整理的保存在远程 GMT 数据服务器中的数据
-3. 自定义数据：用户自行准备的数据
+```{toctree}
+:maxdepth: 1
 
-```{rubric} GMT 内置数据
+gshhg
+dcw/index
+remote-dataset
+CN-border
+CN-faults
+CN-block/index
+geo3al/index
+gadm/index
+PB2002/index
+global_tectonics/index
+WSM_2016/index
 ```
 
-GMT 内置了如下数据，可以直接在 GMT 中使用：
+用户还可以在网上找到更多其他地学相关数据。可根据需求自行下载，并使用 GDAL 提供的
+{ref}`ogr2ogr` 或 {ref}`gdal_translate` 命令转换为 GMT 可识别的数据格式。
+下面列出了其他未经整理的地学数据集，用户可从对应网址中下载并使用：
 
-- {doc}`gshhg`
-- {doc}`dcw/index`
+- 中国区域地表热流：<https://doi.org/10.1016/j.tecto.2019.01.006>
+- 1:100万全国标准基础地理数据: <https://gmt-china.org/blog/national-geographic-database/>
+- 美国地质图：<https://mrdata.usgs.gov/geology/state/>
+- 全球布格重力异常：<https://bgi.obs-mip.fr/grids-and-models-2/>
 
-```{rubric} GMT 远程数据
-```
 
-GMT 远程数据位于 GMT 数据服务器，在 GMT 中使用时会自动下载。
-以下列出了 GMT 提供的所有远程数据类型。默认情况下，所有数据均为最新版本，
-但在原始数据发布新版本时，GMT 提供数据可能会稍有延迟。
-
-| 数据类型                                                                                              | 数据名称                              | 默认 CPT        | 说明                                      |
-|-------------------------------------------------------------------------------------------------------|---------------------------------------|-----------------|-------------------------------------------|
-| [地球地形起伏](https://www.generic-mapping-tools.org/remote-datasets/earth-relief.html)               | `earth_relief` 或 <br>`earth_synbath` | geo             | 由 IGPP 对 Scripps SRTM15+V2.6 重采样得到 |
-| [地球 GEBCO 地形起伏](https://www.generic-mapping-tools.org/remote-datasets/earth-gebco.html)         | `earth_gebco` 或 <br>`earth_gebcosi`  | geo             | 海底地形部分来自 GEBCO 项目               |
-| [地球大地水准面](https://www.generic-mapping-tools.org/remote-datasets/earth-geoid.html)              | `earth_geoid`                         | 无              | 来自 NGA 发布的 EGM2008 超高阶重力场模型  |
-| [地球自由空气重力异常](https://www.generic-mapping-tools.org/remote-datasets/earth-faa.html)          | `earth_faa`                           | @earth_faa      | 来自 IGPP，范围：±80˚                     |
-| [地球自由空气重力异常误差](https://www.generic-mapping-tools.org/remote-datasets/earth-faaerror.html) | `earth_faaerror`                      | @earth_faa      | 为 `earth_faa` 的伴随数据                 |
-| [地球垂直重力梯度异常](https://www.generic-mapping-tools.org/remote-datasets/earth-vgg.html)          | `earth_vgg`                           | @earth_vgg      | 来自 IGPP，范围：±80˚                     |
-| [地球垂线偏差东西向分量](https://www.generic-mapping-tools.org/remote-datasets/earth-edefl.html)      | `earth_edefl`                         | @earth_defl     | 来自 IGPP，范围：±80˚                     |
-| [地球垂线偏差南北向分量](https://www.generic-mapping-tools.org/remote-datasets/earth-ndefl.html)      | `earth_ndefl`                         | @earth_defl     | 来自 IGPP，范围：±80˚                     |
-| [地球磁异常](https://www.generic-mapping-tools.org/remote-datasets/earth-mag.html)                    | `earth_mag` 或 <br>`earth_mga4km`     | @earth_mag      | EMAG2 模型                                |
-| [地球数字磁异常](https://www.generic-mapping-tools.org/remote-datasets/earth-wdmam.html)              | `earth_wdmam`                         | @earth_wdman    | 来自 WDMAM 项目                           |
-| [地球洋壳年龄](https://www.generic-mapping-tools.org/remote-datasets/earth-age.html)                  | `earth_age`                           | @earth_age      | 来自 EarthByte                            |
-| [地球平均稳态海面地形](https://www.generic-mapping-tools.org/remote-datasets/earth-mdt.html)          | `earth_mdt`                           | @earth_mdt      | CNES 发布，IGPP 重处理                    |
-| [地球平均海平面](https://www.generic-mapping-tools.org/remote-datasets/earth-mss.html)                | `earth_mss`                           | @earth_mss      | CNES 发布，IGPP 重处理                    |
-| [地球水陆掩膜](https://www.generic-mapping-tools.org/remote-datasets/earth-mask.html)                 | `earth_mask`                          |                 | 由 {doc}`/module/grdlandmask` 计算得到    |
-| [地球到海岸线距离](https://www.generic-mapping-tools.org/remote-datasets/earth-dist.html)             | `earth_dist`                          | @earth_dist     | 由 {doc}`/module/grdmath` 计算得到        |
-| [地球昼夜卫星影像](https://www.generic-mapping-tools.org/remote-datasets/earth-daynight.html)         | `earth_day` 或 <br>`earth_night`      |                 | 来自 NASA                                 |
-| [火星地形起伏](https://www.generic-mapping-tools.org/remote-datasets/mars-relief.html)                | `mars_relief`                         | @mars_relief    | 来自 NASA                                 |
-| [水星地形起伏](https://www.generic-mapping-tools.org/remote-datasets/mercury-relief.html)             | `mercury_relief`                      | @mercury_relief | 来自 USGS                                 |
-| [月球地形起伏](https://www.generic-mapping-tools.org/remote-datasets/moon-relief.html)                | `moon_relief`                         | @moon_relief    | 来自 USGS                                 |
-| [冥王星地形起伏](https://www.generic-mapping-tools.org/remote-datasets/pluto-relief.html)             | `pluto_relief`                        | @pluto_relief   | 来自 USGS                                 |
-| [金星地形起伏](https://www.generic-mapping-tools.org/remote-datasets/venus-relief.html)               | `venus_relief`                        | @venus_relief   | 来自 NASA                                 |
-
-
-```{rubric} 自定义数据
-```
+(setup-database)=
+**建立数据库**
 
-用户可以自行在网络上找到更多地学数据，建立 GMT 数据库，供 GMT 使用。
-GMT 中文社区整理了一些自定义数据，供用户选用：
+对于 GMT 中文社区维护的或用户自有的数据，用户可选择创建数据库以方便使用。
+使用自定义数据（即建立 GMT 数据库）的方法很简单，只要将数据集中放在任意一个目录下，
+然后修改环境变量 **GMT_DATADIR** 使得其包含该目录即可。
+在使用数据库里的数据时，就可以直接指定数据文件名，GMT 会自动到 **GMT_DATADIR**
+所指定的目录中寻找该数据，而无需指定数据文件的完整路径。
 
-- {doc}`gadm/index`
-- {doc}`PB2002/index`
-- {doc}`global_tectonics/index`
-- {doc}`WSM_2016/index`
+Linux 和 macOS 用户可以把数据放在 {file}`~/GMTDB`目录下，
+然后在 {file}`~/.bashrc` 中添加如下语句:
 
-用户还可以在网上找到更多其他地学相关数据。可根据需求自行下载，并使用 GDAL 提供的
-{ref}`ogr2ogr` 或 {ref}`gdal_translate` 命令转换为 GMT 可识别的数据格式。
-下面列出一些地学数据的链接：
+```
+export GMT_DATADIR=~/GMTDB
+```
 
-- 美国地质图：<https://mrdata.usgs.gov/geology/state/>
-- 全球布格重力异常：<https://bgi.obs-mip.fr/grids-and-models-2/>
-- 中国区域地表热流：<https://doi.org/10.1016/j.tecto.2019.01.006>
-- 1:100万全国标准基础地理数据: <https://gmt-china.org/blog/national-geographic-database/>
+Windows 用户可以把数据放在 **D:\\GMTDB** （路径最好不要有空格）目录下，
+然后打开“我的电脑”->“属性”->“高级”->“环境变量”，添加环境变量，变量名为 **GMT_DATADIR**，
+值为 **D:\\GMTDB**，最后可能需要重启电脑使得环境变量生效。
 
-```{toctree}
-:hidden: true
-:maxdepth: 1
+如果喜欢将不同的数据分类放在不同的目录下，则可以向 **GMT_DATADIR** 添加多个目录。
+多个目录之间用逗号 **,** 分隔。例如:
 
-usage
-gshhg
-dcw/index
-gadm/index
-PB2002/index
-global_tectonics/index
-WSM_2016/index
 ```
+export GMT_DATADIR=~/GMTDB/data1,~/GMTDB/data2
+```
+
+Linux 和 macOS 用户，可以进一步简化为:
+
+```
+export GMT_DATADIR=~/GMTDB/
+```
+
+**GMT_DATADIR** 中的目录若以 **/** 结尾，GMT 则会在 {file}`~/GMTDB` 及其子目录下递归地
+寻找文件。注意，Windows 不支持这一功能。
+